Get monthly usage attribution
GET {{baseUrl}}/api/v1/usage/monthly-attribution?start_month=1992-04-06T18:39:52.088Z&end_month=1992-04-06T18:39:52.088Z&fields=ci_pipeline_indexed_spans_percentage&sort_direction=desc&sort_name=ci_pipeline_indexed_spans_percentage&tag_breakdown_keys=exercitation consequat&next_record_id=exercitation consequat&include_descendants=true
Get monthly usage attribution. Multi-region data is available starting March 1, 2023.
This API endpoint is paginated. To make sure you receive all records, check if the value of next_record_id is
set in the response. If it is, make another request and pass next_record_id as a parameter.
Pseudo code example:
response := GetMonthlyUsageAttribution(start_month)
cursor := response.metadata.pagination.next_record_id
WHILE cursor != null BEGIN
sleep(5 seconds) # Avoid running into rate limit
response := GetMonthlyUsageAttribution(start_month, next_record_id=cursor)
cursor := response.metadata.pagination.next_record_id
END
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
start_month | string | (Required) Datetime in ISO-8601 format, UTC, precise to month: [YYYY-MM] for usage beginning in this month. | |
| Maximum of 15 months ago. | |||
end_month | string | Datetime in ISO-8601 format, UTC, precise to month: [YYYY-MM] for usage ending this month. | |
fields | string | (Required) Comma-separated list of usage types to return, or * for all usage types. | |
sort_direction | string | The direction to sort by: [desc, asc]. | |
sort_name | string | The field to sort by. | |
tag_breakdown_keys | string | Comma separated list of tag keys used to group usage. If no value is provided the usage will not be broken down by tags. |
To see which tags are available, look for the value of tag_config_source in the API response. |
| next_record_id | string | | List following results with a next_record_id provided in the previous query. |
| include_descendants | boolean | | Include child org usage in the response. Defaults to true. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"metadata":{"aggregates":[{"agg_type":"sum","field":"custom_timeseries_usage","value":-22538358.589279592},{"agg_type":"sum","field":"custom_timeseries_usage","value":73376776.19677171}],"pagination":{"next_record_id":"ad eiu"}},"usage":[{"month":"1978-11-15T11:35:23.014Z","org_name":"Excepteur culpa","public_id":"in incididunt","region":"qui magna","tag_config_source":"eiusmod","tags":{"in_82d":["datadog-integrations-lab","datadog-integrations-lab"],"aliqua2":["datadog-integrations-lab","datadog-integrations-lab"]},"updated_at":"2011-06-02T08:07:11.667Z","values":{"api_percentage":-89224644.23672132,"api_usage":80412170.5647429,"apm_fargate_percentage":61431516.571835846,"apm_fargate_usage":8028570.434315532,"apm_host_percentage":-77401178.46557313,"apm_host_usage":-35788717.63357992,"apm_usm_percentage":-98687413.42147036,"apm_usm_usage":7121960.276529819,"appsec_fargate_percentage":70578439.56170252,"appsec_fargate_usage":12490488.538193613,"appsec_percentage":42003027.23925859,"appsec_usage":-58195834.93255247,"asm_serverless_traced_invocations_percentage":91063980.16927847,"asm_serverless_traced_invocations_usage":81569889.55442387,"browser_percentage":57663182.311534256,"browser_usage":63092582.41372672,"ci_pipeline_indexed_spans_percentage":5246217.89555186,"ci_pipeline_indexed_spans_usage":-4246235.942059591,"ci_test_indexed_spans_percentage":-1754175.2547010481,"ci_test_indexed_spans_usage":91270986.48577604,"ci_visibility_itr_percentage":12085777.676667541,"ci_visibility_itr_usage":-46994758.24092012,"cloud_siem_percentage":5964221.58139886,"cloud_siem_usage":34524745.7385962,"container_excl_agent_percentage":33313295.37541996,"container_excl_agent_usage":-90820435.65347387,"container_percentage":-73954487.27958441,"container_usage":79063287.0151613,"cspm_containers_percentage":72448474.38281754,"cspm_containers_usage":-52023419.87855505,"cspm_hosts_percentage":17209508.191311777,"cspm_hosts_usage":17533521.01337011,"custom_event_percentage":-77536908.2779164,"custom_event_usage":51111918.692870975,"custom_ingested_timeseries_percentage":15742380.390644908,"custom_ingested_timeseries_usage":-33372406.49655904,"custom_timeseries_percentage":79832788.11989704,"custom_timeseries_usage":-45405209.880577944,"cws_containers_percentage":97707811.62074992,"cws_containers_usage":-45684175.50472157,"cws_hosts_percentage":-41492694.738534294,"cws_hosts_usage":-84800642.60590842,"dbm_hosts_percentage":-42151452.61132283,"dbm_hosts_usage":33576083.21477206,"dbm_queries_percentage":47820284.220276386,"dbm_queries_usage":-13259791.683031797,"error_tracking_percentage":-51212796.25226492,"error_tracking_usage":89316455.49417815,"estimated_indexed_logs_percentage":89225483.44968084,"estimated_indexed_logs_usage":-5716868.822539121,"estimated_indexed_spans_percentage":47273783.31878543,"estimated_indexed_spans_usage":59682571.68687895,"estimated_ingested_logs_percentage":-87632973.68542741,"estimated_ingested_logs_usage":-71004044.82775167,"estimated_ingested_spans_percentage":-28364073.850947544,"estimated_ingested_spans_usage":-3817997.800232172,"estimated_rum_sessions_percentage":89419155.97198516,"estimated_rum_sessions_usage":-41536515.476371475,"fargate_percentage":74239669.16897711,"fargate_usage":-91658238.69417755,"functions_percentage":75701536.027695,"functions_usage":3545038.1883271635,"incident_management_monthly_active_users_percentage":-63717964.6537906,"incident_management_monthly_active_users_usage":57370701.74733648,"indexed_spans_percentage":98910268.87913191,"indexed_spans_usage":16173037.30241102,"infra_host_percentage":71124726.79545122,"infra_host_usage":-55316678.7006393,"ingested_logs_bytes_percentage":-57936902.441127546,"ingested_logs_bytes_usage":66155149.247971326,"ingested_spans_bytes_percentage":-92274602.158618,"ingested_spans_bytes_usage":54177850.811816126,"invocations_percentage":39538342.80968365,"invocations_usage":56824888.645193905,"lambda_traced_invocations_percentage":-9011774.61567597,"lambda_traced_invocations_usage":-85244878.12642966,"logs_indexed_15day_percentage":-61760209.491091,"logs_indexed_15day_usage":93321950.05082494,"logs_indexed_180day_percentage":45070618.01981264,"logs_indexed_180day_usage":85440280.05770373,"logs_indexed_1day_percentage":-95653418.01892631,"logs_indexed_1day_usage":20045146.28656797,"logs_indexed_30day_percentage":-96417122.679459,"logs_indexed_30day_usage":-83590659.2898871,"logs_indexed_360day_percentage":23189902.0566082,"logs_indexed_360day_usage":-36607263.07124955,"logs_indexed_3day_percentage":55135359.9088355,"logs_indexed_3day_usage":-83328947.0760343,"logs_indexed_45day_percentage":-12042233.666975692,"logs_indexed_45day_usage":-68388552.73165976,"logs_indexed_60day_percentage":66675382.772575706,"logs_indexed_60day_usage":-85518628.76991083,"logs_indexed_7day_percentage":-74772434.82612024,"logs_indexed_7day_usage":21779612.425989598,"logs_indexed_90day_percentage":-43048715.16494315,"logs_indexed_90day_usage":60867507.540263206,"logs_indexed_custom_retention_percentage":18372919.19522266,"logs_indexed_custom_retention_usage":-27798005.529205933,"mobile_app_testing_percentage":-33723393.98755688,"mobile_app_testing_usage":-14267701.898392275,"ndm_netflow_percentage":-27542832.036018,"ndm_netflow_usage":22708137.93024437,"npm_host_percentage":-90716392.02546659,"npm_host_usage":80803392.45847669,"obs_pipeline_bytes_percentage":-19419681.710054442,"obs_pipeline_bytes_usage":-62878235.032146536,"obs_pipelines_vcpu_percentage":15883148.367215768,"obs_pipelines_vcpu_usage":-2236116.587063104,"online_archive_percentage":-47398079.822681226,"online_archive_usage":38971912.01378223,"profiled_container_percentage":6782665.7507907,"profiled_container_usage":45819232.848005414,"profiled_fargate_percentage":2553934.2390898913,"profiled_fargate_usage":2079375.9294120371,"profiled_host_percentage":28354618.639856532,"profiled_host_usage":15529808.382017583,"rum_browser_mobile_sessions_percentage":74792859.92819068,"rum_browser_mobile_sessions_usage":97316711.70463389,"rum_replay_sessions_percentage":-32332478.462061465,"rum_replay_sessions_usage":-62642074.614796475,"sds_scanned_bytes_percentage":-92565784.3386242,"sds_scanned_bytes_usage":61439610.732251644,"serverless_apps_percentage":-418983.10973738134,"serverless_apps_usage":42016860.917963326,"siem_ingested_bytes_percentage":-28253714.790234104,"siem_ingested_bytes_usage":-51701527.097608045,"snmp_percentage":31155617.837134525,"snmp_usage":-37117951.25793591,"universal_service_monitoring_percentage":-13525632.488353029,"universal_service_monitoring_usage":70308037.26593119,"vuln_management_hosts_percentage":-68985890.15415464,"vuln_management_hosts_usage":-78729039.20193535,"workflow_executions_percentage":-77110856.82394505,"workflow_executions_usage":-1552342.6820546836}},{"month":"1990-05-21T12:09:15.540Z","org_name":"officia eiusmod","public_id":"ullamco magna mollit enim","region":"consectetur aliquip","tag_config_source":"dolore pariatur qui Du","tags":{"ea_64":["datadog-integrations-lab","datadog-integrations-lab"],"amet_4f":["datadog-integrations-lab","datadog-integrations-lab"],"ad_7ef":["datadog-integrations-lab","datadog-integrations-lab"]},"updated_at":"2010-12-13T17:12:31.461Z","values":{"api_percentage":-60682746.48060488,"api_usage":-47454323.17806615,"apm_fargate_percentage":-98884044.19430335,"apm_fargate_usage":49489175.398109585,"apm_host_percentage":90452883.68316,"apm_host_usage":34152620.48527157,"apm_usm_percentage":5884346.5769844055,"apm_usm_usage":-45138994.91263418,"appsec_fargate_percentage":-90712908.48740911,"appsec_fargate_usage":-83542475.97843978,"appsec_percentage":-83049219.6343386,"appsec_usage":5805639.93254742,"asm_serverless_traced_invocations_percentage":-74428790.26372409,"asm_serverless_traced_invocations_usage":-3387523.4001009315,"browser_percentage":-39803172.98586345,"browser_usage":95586559.88169762,"ci_pipeline_indexed_spans_percentage":62549607.3955237,"ci_pipeline_indexed_spans_usage":46441683.527844846,"ci_test_indexed_spans_percentage":22194074.511463404,"ci_test_indexed_spans_usage":82894031.42939892,"ci_visibility_itr_percentage":-45190734.41118549,"ci_visibility_itr_usage":-60098034.92108672,"cloud_siem_percentage":19005806.492707804,"cloud_siem_usage":-91906977.99588823,"container_excl_agent_percentage":75218846.30265966,"container_excl_agent_usage":64276528.299931765,"container_percentage":-72040877.69269769,"container_usage":-83423964.80000831,"cspm_containers_percentage":-27051484.670576587,"cspm_containers_usage":-2094139.5304947495,"cspm_hosts_percentage":-92085607.66075334,"cspm_hosts_usage":8767828.82162787,"custom_event_percentage":88133691.75445595,"custom_event_usage":8894180.379359007,"custom_ingested_timeseries_percentage":23653806.24239251,"custom_ingested_timeseries_usage":7281752.230102569,"custom_timeseries_percentage":-21395374.111018434,"custom_timeseries_usage":-32561372.167353258,"cws_containers_percentage":-26069603.397357628,"cws_containers_usage":-72457708.26322211,"cws_hosts_percentage":-58806220.37581062,"cws_hosts_usage":59238147.57152185,"dbm_hosts_percentage":-66356530.77161967,"dbm_hosts_usage":-39452902.468711495,"dbm_queries_percentage":-31656756.167504787,"dbm_queries_usage":-99846083.46688755,"error_tracking_percentage":-82720029.55518265,"error_tracking_usage":68173666.36410677,"estimated_indexed_logs_percentage":88561161.65977222,"estimated_indexed_logs_usage":-50704471.13155448,"estimated_indexed_spans_percentage":94257286.43487799,"estimated_indexed_spans_usage":60431609.53489855,"estimated_ingested_logs_percentage":-24536002.530485317,"estimated_ingested_logs_usage":43831281.111981064,"estimated_ingested_spans_percentage":23493975.336322144,"estimated_ingested_spans_usage":-59444152.09346898,"estimated_rum_sessions_percentage":-44446693.803266205,"estimated_rum_sessions_usage":-63836526.05942442,"fargate_percentage":-46588081.63763988,"fargate_usage":73317237.30062535,"functions_percentage":-85910490.15611829,"functions_usage":-51625805.29045986,"incident_management_monthly_active_users_percentage":31310859.827720657,"incident_management_monthly_active_users_usage":79138824.62379137,"indexed_spans_percentage":-92600173.90320763,"indexed_spans_usage":42595157.12691563,"infra_host_percentage":47380295.10557169,"infra_host_usage":90772751.82130995,"ingested_logs_bytes_percentage":-7261314.366862908,"ingested_logs_bytes_usage":-56686016.37898099,"ingested_spans_bytes_percentage":53445856.204707146,"ingested_spans_bytes_usage":-30294517.532791063,"invocations_percentage":36178230.404844314,"invocations_usage":-64961536.77594685,"lambda_traced_invocations_percentage":42728498.522010654,"lambda_traced_invocations_usage":-66110451.44591867,"logs_indexed_15day_percentage":-40999464.57264867,"logs_indexed_15day_usage":-75778253.24076745,"logs_indexed_180day_percentage":-76344083.49282894,"logs_indexed_180day_usage":-47544925.02450138,"logs_indexed_1day_percentage":55215401.213550985,"logs_indexed_1day_usage":-61343065.05180293,"logs_indexed_30day_percentage":-58126809.77319475,"logs_indexed_30day_usage":69555196.15737966,"logs_indexed_360day_percentage":-10630094.691021472,"logs_indexed_360day_usage":-97021562.72657043,"logs_indexed_3day_percentage":56133157.47208506,"logs_indexed_3day_usage":50181024.08615956,"logs_indexed_45day_percentage":-36890030.574709386,"logs_indexed_45day_usage":-99249410.29943208,"logs_indexed_60day_percentage":-34231144.49813776,"logs_indexed_60day_usage":-50604215.7192585,"logs_indexed_7day_percentage":-94307884.90989332,"logs_indexed_7day_usage":-78141098.06331882,"logs_indexed_90day_percentage":-51520723.32953774,"logs_indexed_90day_usage":-5062394.004844651,"logs_indexed_custom_retention_percentage":-95465662.48842883,"logs_indexed_custom_retention_usage":73724145.35105905,"mobile_app_testing_percentage":68519750.19975519,"mobile_app_testing_usage":-15219234.33409506,"ndm_netflow_percentage":18001397.310899973,"ndm_netflow_usage":-75392754.67267421,"npm_host_percentage":-46638974.68142184,"npm_host_usage":-73748939.03667283,"obs_pipeline_bytes_percentage":-73996107.54437354,"obs_pipeline_bytes_usage":51886538.46760011,"obs_pipelines_vcpu_percentage":-38418798.6182051,"obs_pipelines_vcpu_usage":55384258.540741086,"online_archive_percentage":92777502.49145281,"online_archive_usage":40044235.56800735,"profiled_container_percentage":-46547793.24424125,"profiled_container_usage":69948338.52907401,"profiled_fargate_percentage":-82211705.01069003,"profiled_fargate_usage":40238170.53619924,"profiled_host_percentage":92571479.31851482,"profiled_host_usage":49978539.49532059,"rum_browser_mobile_sessions_percentage":-81137255.87607697,"rum_browser_mobile_sessions_usage":3724754.0375643224,"rum_replay_sessions_percentage":56447908.099354506,"rum_replay_sessions_usage":56152729.95138061,"sds_scanned_bytes_percentage":-20997527.040521875,"sds_scanned_bytes_usage":-32894919.152945198,"serverless_apps_percentage":76892987.72999766,"serverless_apps_usage":92247527.41662443,"siem_ingested_bytes_percentage":41980910.945032656,"siem_ingested_bytes_usage":16269446.394961923,"snmp_percentage":28444229.64061582,"snmp_usage":26913447.8439025,"universal_service_monitoring_percentage":-82576083.07390769,"universal_service_monitoring_usage":28965577.11892256,"vuln_management_hosts_percentage":-44837148.10622144,"vuln_management_hosts_usage":13189130.641022965,"workflow_executions_percentage":27676443.78949319,"workflow_executions_usage":-26584403.72877738}}]}