micrometer-metrics/micrometer

Support Datadog HTTP API v2

Open

#5469 opened on Sep 10, 2024

View on GitHub
 (7 comments) (0 reactions) (0 assignees)Java (4,220 stars) (935 forks)batch import
enhancementhelp wantedregistry: datadog

Description

Due to various issues when transmitting metrics, I contacted datadog and was told to upgrade the API version.

So, after checking to resolve the issue, I found that datadog-related APIs were hard-coded into the code.

code line

Are you planning to upgrade the API version? The recommended content is to transfer to /api/v2/series rather than /api/v1/series.

Related information will be attached below. Datadog says that transmission efficiency and stability have improved due to the upgrade.

POST https://api.datadoghq.com/api/v1/series
The metrics end-point allows you to post time-series data that can be graphed on Datadog’s dashboards. The maximum payload size is 3.2 megabytes (3200000 bytes). Compressed payloads must have a decompressed size of less than 62 megabytes (62914560 bytes).

If you’re submitting metrics directly to the Datadog API without using DogStatsD, expect:

- 64 bits for the timestamp
- 64 bits for the value
- 40 bytes for the metric names
- 50 bytes for the timeseries
- The full payload is approximately 100 bytes. However, with the DogStatsD API, compression is applied, which reduces the payload size.

-----

POST https://api.datadoghq.com/api/v2/series
The metrics end-point allows you to post time-series data that can be graphed on Datadog’s dashboards. The maximum payload size is 500 kilobytes (512000 bytes). Compressed payloads must have a decompressed size of less than 5 megabytes (5242880 bytes).

If you’re submitting metrics directly to the Datadog API without using DogStatsD, expect:

- 64 bits for the timestamp
- 64 bits for the value
- 20 bytes for the metric names
- 50 bytes for the timeseries
- The full payload is approximately 100 bytes.

Contributor guide

Tech stack
javarest api
Domain
backendapiobservability
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
needs maintainer response
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
JavaHTTP APIDatadog API v2 specification
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
60
Research direction
Investigate the Datadog API v2 endpoint at https://docs.datadoghq.com/api/latest/metrics/#submit metrics and compare payload format with current implementation in DatadogMeterRegistry.java. Update the endpoint URL from /api/v1/series to /api/v2/series and adjust request payload if necessary. Check for any changes in authentication or response handling.