Skip to content

datadog get-hourly-usage-attribution

Get hourly usage attribution

Description

Get hourly usage attribution

Synopsis

datadog get-hourly-usage-attribution
    [--site <site>]
    --start <start>
    [--end <end>]
    --usage <usage>
    [--next <next>]
    [--tag_breakdown <tag_breakdown>]
    [--exclude_descendants]

Arguments

site - (string)

     Site where this command will be executed
     Example: --site "site-1"
     Default: input.site      Attributes: optional

start - (time)

     For usage beginning at this hour
     Example: --start "2019-10-12T07:20:50.52Z"
     Default: 3 days ago      Attributes: required

end - (time)

     For usage ending before this hour
     Example: --end "2019-10-12T07:20:50.52Z"
     Default: _None_      Attributes: optional

usage - (string)

     Usage type to retrieve
     Example: --usage "usage-1"
     Default: _None_      Attributes: required

     Validation:
         allowed values: api, apm_fargate, apm_host, appsec_fargate, appsec, browser, container, cspm_containers, cspm_hosts, custom_timeseries, cws_containers, cws_hosts, dbm_hosts, dbm_queries, estimated_indexed_logs, estimated_ingested_logs, estimated_indexed_spans, estimated_ingested_spans, fargate, functions, indexed_logs, infra_host, invocations, npm_host, profiled_container, profiled_host, snmp, estimated_rum_sessions, cont

next - (string)

     List following results with a next_record_id provided in the previous query
     Example: --next "next-1"
     Default: _None_      Attributes: optional

tag_breakdown - (string)

     If no value is provided the usage will not be broken down by tags
     Example: --tag_breakdown "tag_breakdown-1"
     Default: _None_      Attributes: optional, multiple allowed

exclude_descendants - (bool)

     Include child org usage in the response
     Example: --exclude_descendants
     Default: false      Attributes: optional

Examples

Input: 

!datadog get-hourly-usage-attribution --start "5 month ago" --usage "api_usage"
Output: 
ID      ORG-NAME    HOUR                      TAG-SOURCE     TOTAL-USAGE USAGE-TYPE
45623     testOrg     2022-12-29T15:25:03.000Z  testOrg:::tag1 23          api_usage

Access Control

To use this command, you need access to the following:

Field Value
Action "read"
Service Type "datadog"
Service Instance
Namespace
Object Type "usage"
Object ID

Please see Access Control for details.