Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions .github/CODEOWNERS
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,8 @@ manifest.json @DataDog/documentation @DataDog/agent-integrations
/datadog_cluster_agent/*.md @DataDog/container-integrations @DataDog/agent-integrations @DataDog/documentation
/datadog_csi_driver/ @DataDog/container-platform @DataDog/agent-integrations
/datadog_csi_driver/*.md @DataDog/container-platform @DataDog/agent-integrations @DataDog/documentation
/datadog_dogstatsd/ @DataDog/agent-metric-pipelines @DataDog/agent-integrations
/datadog_dogstatsd/*.md @DataDog/agent-metric-pipelines @DataDog/agent-integrations @DataDog/documentation
/datadog_operator/ @DataDog/container-ecosystems @DataDog/agent-integrations
/datadog_operator/*.md @DataDog/container-ecosystems @DataDog/agent-integrations @DataDog/documentation
/docker_daemon/ @DataDog/container-integrations @DataDog/agent-integrations
Expand Down
4 changes: 4 additions & 0 deletions .github/workflows/config/labeler.yml
Original file line number Diff line number Diff line change
Expand Up @@ -422,6 +422,10 @@ integration/datadog_csi_driver:
- changed-files:
- any-glob-to-any-file:
- datadog_csi_driver/**/*
integration/datadog_dogstatsd:
- changed-files:
- any-glob-to-any-file:
- datadog_dogstatsd/**/*
integration/datadog_operator:
- changed-files:
- any-glob-to-any-file:
Expand Down
7 changes: 7 additions & 0 deletions datadog_dogstatsd/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# CHANGELOG - Datadog DogStatsD

## 1.0.0 / 2026-05-01

***Added***:

* Initial release of the Datadog DogStatsD integration.
35 changes: 35 additions & 0 deletions datadog_dogstatsd/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
# Datadog DogStatsD

## Overview

This integration surfaces the [client-side telemetry][2] emitted by Datadog's official [DogStatsD][1] client libraries. The metrics are produced by the clients themselves, covering the full lifecycle of metric submission: how many metrics, events, and service checks were sent to the client by the application, how many payloads and bytes were successfully delivered to the Agent, and how many were dropped — whether due to a full sender queue or a writer error. When client-side aggregation is enabled, aggregation context counts are also reported.

## Setup

### Installation

Please see the documentation for [DogStatsD][1].

## Data Collected

### Metrics

See [metadata.csv][3] for a list of metrics provided by this check.

### Events

The Datadog DogStatsD integration does not include any events.

### Service Checks

See [service_checks.json][4] for a list of service checks provided by this integration.

## Troubleshooting

Need help? Contact [Datadog support][5].

[1]: https://docs.datadoghq.com/developers/dogstatsd/
[2]: https://docs.datadoghq.com/extend/dogstatsd/high_throughput/#client-side-telemetry
[3]: https://github.com/DataDog/integrations-core/blob/master/datadog_dogstatsd/metadata.csv
[4]: https://github.com/DataDog/integrations-core/blob/master/datadog_dogstatsd/assets/service_checks.json
[5]: https://docs.datadoghq.com/help/
500 changes: 500 additions & 0 deletions datadog_dogstatsd/assets/dashboards/dogstatsd_overview.json

Large diffs are not rendered by default.

5 changes: 5 additions & 0 deletions datadog_dogstatsd/assets/dataflows.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
provides:
- id: datadog-dogstatsd-metrics
always_on: true
data_type: metrics
direction: inbound
1 change: 1 addition & 0 deletions datadog_dogstatsd/assets/service_checks.json
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
[]
47 changes: 47 additions & 0 deletions datadog_dogstatsd/manifest.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
{
"manifest_version": "2.0.0",
"app_uuid": "185e4205-b486-463f-a33b-55af8d4ffd3a",
"app_id": "datadog-dogstatsd",
"owner": "agent-onboarding",
"display_on_public_website": false,
"tile": {
"overview": "README.md#Overview",
"configuration": "README.md#Setup",
"support": "README.md#Support",
"changelog": "CHANGELOG.md",
"description": "Monitor DogStatsD",
"title": "Datadog DogStatsD",
"media": [],
"classifier_tags": [
"Category::Metrics",
"Supported OS::Linux",
"Supported OS::Windows",
"Supported OS::macOS",
"Offering::Integration"
]
},
"assets": {
"dashboards": {
"Datadog DogStatsD Overview": "assets/dashboards/dogstatsd_overview.json"
},
"integration": {
"source_type_name": "Datadog DogStatsD",
"metrics": {
"prefix": "datadog.dogstatsd.client.",
"check": "datadog.dogstatsd.client.metrics",
"metadata_path": "metadata.csv"
},
"service_checks": {
"metadata_path": "assets/service_checks.json"
},
"source_type_id": 10342,
"auto_install": true
}
},
"author": {
"support_email": "help@datadoghq.com",
"name": "Datadog",
"homepage": "https://www.datadoghq.com",
"sales_email": "info@datadoghq.com"
}
}
16 changes: 16 additions & 0 deletions datadog_dogstatsd/metadata.csv
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
metric_name,metric_type,interval,unit_name,per_unit_name,description,orientation,integration,short_name,curated_metric
datadog.dogstatsd.client.metrics,count,,metric,,Total number of metrics sent by the client before aggregation and sampling,0,datadog_dogstatsd,client_metrics,
datadog.dogstatsd.client.metrics_by_type,count,,metric,,Number of metrics sent by the client before aggregation and sampling broken down by metric type (tag: metrics_type),0,datadog_dogstatsd,client_metrics_by_type,
datadog.dogstatsd.client.events,count,,event,,Total number of events sent by the client before aggregation and sampling,0,datadog_dogstatsd,client_events,
datadog.dogstatsd.client.service_checks,count,,,,Total number of service checks sent by the client before aggregation and sampling,0,datadog_dogstatsd,client_service_checks,
datadog.dogstatsd.client.metric_dropped_on_receive,count,,metric,,Total number of metrics/events/service checks dropped when using ChannelMode,-1,datadog_dogstatsd,client_metric_dropped_on_receive,
datadog.dogstatsd.client.packets_sent,count,,packet,,Total number of payloads successfully sent by the client,0,datadog_dogstatsd,client_packets_sent,
datadog.dogstatsd.client.packets_dropped,count,,packet,,Total number of payloads dropped by the client (sum of queue-full and writer drops),-1,datadog_dogstatsd,client_packets_dropped,
datadog.dogstatsd.client.packets_dropped_queue,count,,packet,,Total number of payloads dropped because the sender queue was full,-1,datadog_dogstatsd,client_packets_dropped_queue,
datadog.dogstatsd.client.packets_dropped_writer,count,,packet,,Total number of payloads dropped by the writer due to network timeout or error,-1,datadog_dogstatsd,client_packets_dropped_writer,
datadog.dogstatsd.client.bytes_sent,count,,byte,,Total number of bytes successfully sent by the client,0,datadog_dogstatsd,client_bytes_sent,
datadog.dogstatsd.client.bytes_dropped,count,,byte,,Total number of bytes dropped by the client (sum of queue-full and writer drops),-1,datadog_dogstatsd,client_bytes_dropped,
datadog.dogstatsd.client.bytes_dropped_queue,count,,byte,,Total number of bytes dropped because the sender queue was full,-1,datadog_dogstatsd,client_bytes_dropped_queue,
datadog.dogstatsd.client.bytes_dropped_writer,count,,byte,,Total number of bytes dropped by the writer due to network timeout or error,-1,datadog_dogstatsd,client_bytes_dropped_writer,
datadog.dogstatsd.client.aggregated_context,count,,,,Total number of contexts flushed by the aggregator when client-side aggregation is enabled,0,datadog_dogstatsd,client_aggregated_context,
datadog.dogstatsd.client.aggregated_context_by_type,count,,,,Number of contexts flushed by the aggregator broken down by metric type (tag: metrics_type),0,datadog_dogstatsd,client_aggregated_context_by_type,
Loading