DAdatadog
Usage Metering

Get all custom metrics by hourly average

Get all custom metrics by hourly average. Use the month parameter to get a month-to-date data resolution or use the day parameter to get a daily resolution. One of the two is required, and only one of the two is allowed.

get/api/v1/usage/top_avg_metrics

Request

  • Base URL
    https://api.datadoghq.com
  • URL
    https://api.datadoghq.com/api/v1/usage/top_avg_metrics
  • Auth
    • API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY
    • or OAuth 2
      Authorization code: /oauth2/v1/authorize
      Token URL: /oauth2/v1/token scopes: usage_read

Query parameters

monthstring date-time

Datetime in ISO-8601 format, UTC, precise to month: [YYYY-MM] for usage beginning at this hour. (Either month or day should be specified, but not both)

daystring date-time

Datetime in ISO-8601 format, UTC, precise to day: [YYYY-MM-DD] for usage beginning at this hour. (Either month or day should be specified, but not both)

namesstring[]

Comma-separated list of metric names.

limitinteger

Maximum number of results to return (between 1 and 5000) - defaults to 500 results if limit not specified.

next_record_idstring

List following results with a next_record_id provided in the previous query.

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.