Skip to content

datadog get-monthly-usage-attribution

Get monthly usage attribution

Description

Get monthly usage attribution

Synopsis

datadog get-monthly-usage-attribution
    [--site <site>]
    --start <start>
    [--end <end>]
    --fields <fields>
    [--sort_direction <sort_direction>]
    [--sort_name <sort_name>]
    [--tag_breakdown <tag_breakdown>]
    [--next <next>]
    [--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 in this month, max 15 months
     Example: --start "2019-10-12T07:20:50.52Z"
     Default: 6 months ago      Attributes: required

end - (string)

     For usage ending this month
     Example: --end "end-1"
     Default: _None_      Attributes: optional

fields - (string)

     usage types to return, or * for all usage types
     Example: --fields "fields-1"
     Default: _None_      Attributes: required, multiple allowed

     Validation:
         allowed values: api_usage, api_percentage, apm_fargate_usage, apm_fargate_percentage, appsec_fargate_usage, appsec_fargate_percentage, apm_host_usage, apm_host_percentage, appsec_usage, appsec_percentage, browser_usage, browser_percentage, container_usage, container_percentage, cspm_containers_percentage, cspm_containers_usage, cspm_hosts_percentage, cspm_hosts_usage, custom_timeseries_usage, custom_timeseries_percentage, cws_containers_percentage, cws_containers_usage, cws_hosts_percentage, cws_hosts_usage, dbm_hosts_percentage, dbm_hosts_usage, dbm_queries_percentage, dbm_queries_usage, estimated_indexed_logs_usage, estimated_indexed_logs_percentage, estimated_ingested_logs_usage, estimated_ingested_logs_percentage, estimated_indexed_spans_usage, estimated_indexed_spans_percentage, estimated_ingested_spans_usage, estimated_ingested_spans_percentage, fargate_usage, fargate_percentage, functions_usage, functions_percentage, indexed_logs_usage, indexed_logs_percentage, infra_host_usage, infra_host_percentage, invocations_usage, invocations_percentage, npm_host_usage, npm_host_percentage, profiled_container_usage, profiled_container_percentage, profiled_host_usage, profiled_host_percentage, snmp_usage, snmp_percentage, estimated_rum_sessions_usage, estimated_rum_sessions_percentage, cont_usage, cont_percentage, *

sort_direction - (string)

     The direction to sort by
     Example: --sort_direction "sort_direction-1"
     Default: _None_      Attributes: optional

     Validation:
         allowed values: desc, asc

sort_name - (string)

     The field to sort by
     Example: --sort_name "sort_name-1"
     Default: _None_      Attributes: optional

     Validation:
         allowed values: api_usage, api_percentage, apm_fargate_usage, apm_fargate_percentage, appsec_fargate_usage, appsec_fargate_percentage, apm_host_usage, apm_host_percentage, appsec_usage, appsec_percentage, browser_usage, browser_percentage, container_usage, container_percentage, cspm_containers_percentage, cspm_containers_usage, cspm_hosts_percentage, cspm_hosts_usage, custom_timeseries_usage, custom_timeseries_percentage, cws_containers_percentage, cws_containers_usage, cws_hosts_percentage, cws_hosts_usage, dbm_hosts_percentage, dbm_hosts_usage, dbm_queries_percentage, dbm_queries_usage, estimated_indexed_logs_usage, estimated_indexed_logs_percentage, estimated_ingested_logs_usage, estimated_ingested_logs_percentage, estimated_indexed_spans_usage, estimated_indexed_spans_percentage, estimated_ingested_spans_usage, estimated_ingested_spans_percentage, fargate_usage, fargate_percentage, functions_usage, functions_percentage, indexed_logs_usage, indexed_logs_percentage, infra_host_usage, infra_host_percentage, invocations_usage, invocations_percentage, npm_host_usage, npm_host_percentage, profiled_container_usage, profiled_container_percentage, profiled_host_usage, profiled_host_percentage, snmp_usage, snmp_percentage, estimated_rum_sessions_usage, estimated_rum_sessions_percentage, cont_usage, cont_percentage, *

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

next - (string)

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

exclude_descendants - (bool)

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

Examples

Input:

!datadog get-monthly-usage-attribution --fields "*" --start_month "2 month ago"
Output:
ID      ORG-NAME    MONTH                         TAG-SOURCE      TAGS
98513     testOrg     2022-12-19T12:55:07.000Z    testOrg:::tag1  tag1,tag2

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.