Back to Collection Items
' This example assumes the Chilkat API to have been previously unlocked.
' See Global Unlock Sample for sample code.
Dim http As New Chilkat.Http
Dim success As Boolean
Dim queryParams As New Chilkat.JsonObject
queryParams.UpdateString("start_month","1991-02-02T07:22:34.204Z")
queryParams.UpdateString("end_month","1991-02-02T07:22:34.204Z")
queryParams.UpdateString("fields","dbm_queries_usage")
queryParams.UpdateString("sort_direction","desc")
queryParams.UpdateString("sort_name","dbm_queries_usage")
queryParams.UpdateString("tag_breakdown_keys","tempor Ut sed velit")
queryParams.UpdateString("next_record_id","tempor Ut sed velit")
queryParams.UpdateString("include_descendants","true")
http.SetRequestHeader("Accept","application/json;datetime-format=rfc3339")
Dim resp As Chilkat.HttpResponse = http.QuickRequestParams("GET","https://api.app.ddog-gov.com/api/v1/usage/monthly-attribution",queryParams)
If (http.LastMethodSuccess = False) Then
Debug.WriteLine(http.LastErrorText)
Exit Sub
End If
Dim sbResponseBody As New Chilkat.StringBuilder
resp.GetBodySb(sbResponseBody)
Dim jResp As New Chilkat.JsonObject
jResp.LoadSb(sbResponseBody)
jResp.EmitCompact = False
Debug.WriteLine("Response Body:")
Debug.WriteLine(jResp.Emit())
Dim respStatusCode As Integer = resp.StatusCode
Debug.WriteLine("Response Status Code = " & respStatusCode)
If (respStatusCode >= 400) Then
Debug.WriteLine("Response Header:")
Debug.WriteLine(resp.Header)
Debug.WriteLine("Failed.")
Exit Sub
End If
' Sample JSON response:
' (Sample code for parsing the JSON response is shown below)
' {
' "metadata": {
' "aggregates": [
' {
' "agg_type": "sum",
' "field": "custom_timeseries_usage",
' "value": -75872274.11279911
' },
' {
' "agg_type": "sum",
' "field": "custom_timeseries_usage",
' "value": 62426608.270860344
' }
' ],
' "pagination": {
' "next_record_id": "in velit esse"
' }
' },
' "usage": [
' {
' "month": "2002-08-13T15:07:13.466Z",
' "org_name": "elit reprehenderit",
' "public_id": "minim ipsum anim ",
' "region": "eu incididunt sint ut",
' "tag_config_source": "irure laboris culpa",
' "tags": {
' "dolore62": [
' "datadog-integrations-lab",
' "datadog-integrations-lab"
' ]
' },
' "updated_at": "2006-01-20T21:37:20.788Z",
' "values": {
' "api_percentage": -42977723.76246902,
' "api_usage": 95397982.7763887,
' "apm_fargate_percentage": 98784807.55202839,
' "apm_fargate_usage": -5570111.678832486,
' "apm_host_percentage": -56965575.051769115,
' "apm_host_usage": 6024527.554351345,
' "apm_usm_percentage": -44347230.916792005,
' "apm_usm_usage": -53614973.50940212,
' "appsec_fargate_percentage": -63949646.084028535,
' "appsec_fargate_usage": -13950059.836552203,
' "appsec_percentage": 77503688.59718463,
' "appsec_usage": -2749536.490563825,
' "browser_percentage": -57610165.63884018,
' "browser_usage": -61629554.27924777,
' "ci_visibility_itr_percentage": 9801397.272425354,
' "ci_visibility_itr_usage": 86901082.07052395,
' "container_excl_agent_percentage": -94758211.3791813,
' "container_excl_agent_usage": 47871386.536788315,
' "container_percentage": 77684191.36010852,
' "container_usage": 42244878.990811646,
' "cspm_containers_percentage": -27358203.524139896,
' "cspm_containers_usage": 7194834.822350323,
' "cspm_hosts_percentage": -58400939.80376841,
' "cspm_hosts_usage": -13088798.55443798,
' "custom_ingested_timeseries_percentage": 25418473.141955733,
' "custom_ingested_timeseries_usage": -6930274.896374792,
' "custom_timeseries_percentage": 57087072.053094536,
' "custom_timeseries_usage": -96533528.35676041,
' "cws_containers_percentage": 38802199.2161935,
' "cws_containers_usage": -48037945.78847249,
' "cws_hosts_percentage": -38139753.73665444,
' "cws_hosts_usage": 99175833.09167394,
' "dbm_hosts_percentage": -89557128.20902187,
' "dbm_hosts_usage": -2062788.2317033857,
' "dbm_queries_percentage": -81088882.42935035,
' "dbm_queries_usage": 1723401.8763353676,
' "estimated_indexed_logs_percentage": 19494055.047132045,
' "estimated_indexed_logs_usage": 10830691.252756879,
' "estimated_indexed_spans_percentage": 62593562.02511239,
' "estimated_indexed_spans_usage": -47185922.657971926,
' "estimated_ingested_logs_percentage": 87624062.51598707,
' "estimated_ingested_logs_usage": -35910323.49944707,
' "estimated_ingested_spans_percentage": -26620688.87925279,
' "estimated_ingested_spans_usage": -55965088.442498125,
' "estimated_rum_sessions_percentage": -89351036.0053822,
' "estimated_rum_sessions_usage": 69102190.52327245,
' "fargate_percentage": 31062755.564841017,
' "fargate_usage": 47033739.82451412,
' "functions_percentage": 53367355.86064315,
' "functions_usage": 11045136.755249456,
' "infra_host_percentage": -54626318.30325018,
' "infra_host_usage": 5481953.102816388,
' "invocations_percentage": 27641232.88982962,
' "invocations_usage": -23217061.12940158,
' "npm_host_percentage": -70428889.89530578,
' "npm_host_usage": 75035524.55544943,
' "obs_pipeline_bytes_percentage": 95030078.61571154,
' "obs_pipeline_bytes_usage": 16308063.424261168,
' "profiled_container_percentage": -47294745.9171313,
' "profiled_container_usage": 91333575.12025896,
' "profiled_fargate_percentage": 1159081.2940575331,
' "profiled_fargate_usage": 46737078.93751609,
' "profiled_host_percentage": -16133546.561951116,
' "profiled_host_usage": -55598728.99167555,
' "sds_scanned_bytes_percentage": 41324136.36835453,
' "sds_scanned_bytes_usage": 56766327.929751456,
' "snmp_percentage": -88823427.70029327,
' "snmp_usage": 32225665.615818232,
' "universal_service_monitoring_percentage": -79287423.3883524,
' "universal_service_monitoring_usage": -2355924.928932488,
' "vuln_management_hosts_percentage": -16935520.54186198,
' "vuln_management_hosts_usage": 74036018.8908129
' }
' },
' {
' "month": "1959-07-18T20:29:56.664Z",
' "org_name": "aliquip magna dolor",
' "public_id": "et iru",
' "region": "ut est esse ex",
' "tag_config_source": "sint",
' "tags": {
' "elit276": [
' "datadog-integrations-lab",
' "datadog-integrations-lab"
' ],
' "minim63": [
' "datadog-integrations-lab",
' "datadog-integrations-lab"
' ],
' "pariatur_d4": [
' "datadog-integrations-lab",
' "datadog-integrations-lab"
' ]
' },
' "updated_at": "1950-10-12T07:16:52.126Z",
' "values": {
' "api_percentage": -67093975.89355124,
' "api_usage": 22892492.134701967,
' "apm_fargate_percentage": 86445539.6960246,
' "apm_fargate_usage": 96626296.86785325,
' "apm_host_percentage": -17829260.52661082,
' "apm_host_usage": 99024863.04694226,
' "apm_usm_percentage": 15052506.96019815,
' "apm_usm_usage": -51446462.70068289,
' "appsec_fargate_percentage": -59920029.75633368,
' "appsec_fargate_usage": -12417338.286942497,
' "appsec_percentage": 33591696.66073081,
' "appsec_usage": 25137188.487309366,
' "browser_percentage": 97940358.7215335,
' "browser_usage": -52673885.905316986,
' "ci_visibility_itr_percentage": -88219975.69687605,
' "ci_visibility_itr_usage": -9447846.575050354,
' "container_excl_agent_percentage": -46735760.53814248,
' "container_excl_agent_usage": -73167643.29069096,
' "container_percentage": 69642254.33344507,
' "container_usage": 41091259.60962516,
' "cspm_containers_percentage": 42210153.5692417,
' "cspm_containers_usage": 75649568.34254551,
' "cspm_hosts_percentage": 32418249.39784172,
' "cspm_hosts_usage": 69540549.39095044,
' "custom_ingested_timeseries_percentage": -68775982.9429293,
' "custom_ingested_timeseries_usage": 76963891.89494428,
' "custom_timeseries_percentage": 60837059.719377786,
' "custom_timeseries_usage": -18989551.834226012,
' "cws_containers_percentage": -72647861.32948461,
' "cws_containers_usage": 99339681.5271622,
' "cws_hosts_percentage": -83440078.50328308,
' "cws_hosts_usage": 14084142.169001937,
' "dbm_hosts_percentage": 82967791.28126338,
' "dbm_hosts_usage": 25758868.864204437,
' "dbm_queries_percentage": -66889696.73566167,
' "dbm_queries_usage": 82584001.9588587,
' "estimated_indexed_logs_percentage": 18445591.7106888,
' "estimated_indexed_logs_usage": 95113838.43812409,
' "estimated_indexed_spans_percentage": -60446633.38281309,
' "estimated_indexed_spans_usage": -35817307.54312336,
' "estimated_ingested_logs_percentage": -78223744.53046979,
' "estimated_ingested_logs_usage": -69451886.32509902,
' "estimated_ingested_spans_percentage": 40809724.25659558,
' "estimated_ingested_spans_usage": -8599266.75406441,
' "estimated_rum_sessions_percentage": -50403382.65600939,
' "estimated_rum_sessions_usage": -56068159.05777034,
' "fargate_percentage": -58215167.93972128,
' "fargate_usage": 66587355.106164634,
' "functions_percentage": -47256769.918816224,
' "functions_usage": 1210604.9136780202,
' "infra_host_percentage": -15651911.45215477,
' "infra_host_usage": 83986438.03159028,
' "invocations_percentage": -72916419.47570357,
' "invocations_usage": -99391776.91322954,
' "npm_host_percentage": -26689735.74485798,
' "npm_host_usage": -58545960.56280492,
' "obs_pipeline_bytes_percentage": -18838497.449270487,
' "obs_pipeline_bytes_usage": -15181917.208459169,
' "profiled_container_percentage": -69415049.22818953,
' "profiled_container_usage": -22422349.354449615,
' "profiled_fargate_percentage": -88757833.10218939,
' "profiled_fargate_usage": -48134372.15719563,
' "profiled_host_percentage": -82357525.04911637,
' "profiled_host_usage": 50907558.67759526,
' "sds_scanned_bytes_percentage": -72420339.71282078,
' "sds_scanned_bytes_usage": 54343122.17874324,
' "snmp_percentage": -38192297.57339508,
' "snmp_usage": 26362518.073974475,
' "universal_service_monitoring_percentage": -97356790.37923175,
' "universal_service_monitoring_usage": -42030474.203919254,
' "vuln_management_hosts_percentage": -74076816.34914787,
' "vuln_management_hosts_usage": -25114557.39136301
' }
' }
' ]
' }
' Sample code for parsing the JSON response...
' Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code
Dim agg_type As String
Dim field As String
Dim value As String
Dim month As String
Dim org_name As String
Dim public_id As String
Dim region As String
Dim tag_config_source As String
Dim updated_at As String
Dim Api_percentage As String
Dim Api_usage As String
Dim Apm_fargate_percentage As String
Dim Apm_fargate_usage As String
Dim Apm_host_percentage As String
Dim Apm_host_usage As String
Dim Apm_usm_percentage As String
Dim Apm_usm_usage As String
Dim Appsec_fargate_percentage As String
Dim Appsec_fargate_usage As String
Dim Appsec_percentage As String
Dim Appsec_usage As String
Dim Browser_percentage As String
Dim Browser_usage As String
Dim Ci_visibility_itr_percentage As String
Dim Ci_visibility_itr_usage As String
Dim Container_excl_agent_percentage As String
Dim Container_excl_agent_usage As String
Dim Container_percentage As String
Dim Container_usage As String
Dim Cspm_containers_percentage As String
Dim Cspm_containers_usage As String
Dim Cspm_hosts_percentage As String
Dim Cspm_hosts_usage As String
Dim Custom_ingested_timeseries_percentage As String
Dim Custom_ingested_timeseries_usage As String
Dim Custom_timeseries_percentage As String
Dim Custom_timeseries_usage As String
Dim Cws_containers_percentage As String
Dim Cws_containers_usage As String
Dim Cws_hosts_percentage As String
Dim Cws_hosts_usage As String
Dim Dbm_hosts_percentage As String
Dim Dbm_hosts_usage As String
Dim Dbm_queries_percentage As String
Dim Dbm_queries_usage As String
Dim Estimated_indexed_logs_percentage As String
Dim Estimated_indexed_logs_usage As String
Dim Estimated_indexed_spans_percentage As String
Dim Estimated_indexed_spans_usage As String
Dim Estimated_ingested_logs_percentage As String
Dim Estimated_ingested_logs_usage As String
Dim Estimated_ingested_spans_percentage As String
Dim Estimated_ingested_spans_usage As String
Dim Estimated_rum_sessions_percentage As String
Dim Estimated_rum_sessions_usage As String
Dim Fargate_percentage As String
Dim Fargate_usage As String
Dim Functions_percentage As String
Dim Functions_usage As String
Dim Infra_host_percentage As String
Dim Infra_host_usage As String
Dim Invocations_percentage As String
Dim Invocations_usage As String
Dim Npm_host_percentage As String
Dim Npm_host_usage As String
Dim Obs_pipeline_bytes_percentage As String
Dim Obs_pipeline_bytes_usage As String
Dim Profiled_container_percentage As String
Dim Profiled_container_usage As String
Dim Profiled_fargate_percentage As String
Dim Profiled_fargate_usage As String
Dim Profiled_host_percentage As String
Dim Profiled_host_usage As String
Dim Sds_scanned_bytes_percentage As String
Dim Sds_scanned_bytes_usage As String
Dim Snmp_percentage As String
Dim Snmp_usage As String
Dim Universal_service_monitoring_percentage As String
Dim Universal_service_monitoring_usage As String
Dim Vuln_management_hosts_percentage As String
Dim Vuln_management_hosts_usage As String
Dim j As Integer
Dim count_j As Integer
Dim strVal As String
Dim Next_record_id As String = jResp.StringOf("metadata.pagination.next_record_id")
Dim i As Integer = 0
Dim count_i As Integer = jResp.SizeOfArray("metadata.aggregates")
While i < count_i
jResp.I = i
agg_type = jResp.StringOf("metadata.aggregates[i].agg_type")
field = jResp.StringOf("metadata.aggregates[i].field")
value = jResp.StringOf("metadata.aggregates[i].value")
i = i + 1
End While
i = 0
count_i = jResp.SizeOfArray("usage")
While i < count_i
jResp.I = i
month = jResp.StringOf("usage[i].month")
org_name = jResp.StringOf("usage[i].org_name")
public_id = jResp.StringOf("usage[i].public_id")
region = jResp.StringOf("usage[i].region")
tag_config_source = jResp.StringOf("usage[i].tag_config_source")
updated_at = jResp.StringOf("usage[i].updated_at")
Api_percentage = jResp.StringOf("usage[i].values.api_percentage")
Api_usage = jResp.StringOf("usage[i].values.api_usage")
Apm_fargate_percentage = jResp.StringOf("usage[i].values.apm_fargate_percentage")
Apm_fargate_usage = jResp.StringOf("usage[i].values.apm_fargate_usage")
Apm_host_percentage = jResp.StringOf("usage[i].values.apm_host_percentage")
Apm_host_usage = jResp.StringOf("usage[i].values.apm_host_usage")
Apm_usm_percentage = jResp.StringOf("usage[i].values.apm_usm_percentage")
Apm_usm_usage = jResp.StringOf("usage[i].values.apm_usm_usage")
Appsec_fargate_percentage = jResp.StringOf("usage[i].values.appsec_fargate_percentage")
Appsec_fargate_usage = jResp.StringOf("usage[i].values.appsec_fargate_usage")
Appsec_percentage = jResp.StringOf("usage[i].values.appsec_percentage")
Appsec_usage = jResp.StringOf("usage[i].values.appsec_usage")
Browser_percentage = jResp.StringOf("usage[i].values.browser_percentage")
Browser_usage = jResp.StringOf("usage[i].values.browser_usage")
Ci_visibility_itr_percentage = jResp.StringOf("usage[i].values.ci_visibility_itr_percentage")
Ci_visibility_itr_usage = jResp.StringOf("usage[i].values.ci_visibility_itr_usage")
Container_excl_agent_percentage = jResp.StringOf("usage[i].values.container_excl_agent_percentage")
Container_excl_agent_usage = jResp.StringOf("usage[i].values.container_excl_agent_usage")
Container_percentage = jResp.StringOf("usage[i].values.container_percentage")
Container_usage = jResp.StringOf("usage[i].values.container_usage")
Cspm_containers_percentage = jResp.StringOf("usage[i].values.cspm_containers_percentage")
Cspm_containers_usage = jResp.StringOf("usage[i].values.cspm_containers_usage")
Cspm_hosts_percentage = jResp.StringOf("usage[i].values.cspm_hosts_percentage")
Cspm_hosts_usage = jResp.StringOf("usage[i].values.cspm_hosts_usage")
Custom_ingested_timeseries_percentage = jResp.StringOf("usage[i].values.custom_ingested_timeseries_percentage")
Custom_ingested_timeseries_usage = jResp.StringOf("usage[i].values.custom_ingested_timeseries_usage")
Custom_timeseries_percentage = jResp.StringOf("usage[i].values.custom_timeseries_percentage")
Custom_timeseries_usage = jResp.StringOf("usage[i].values.custom_timeseries_usage")
Cws_containers_percentage = jResp.StringOf("usage[i].values.cws_containers_percentage")
Cws_containers_usage = jResp.StringOf("usage[i].values.cws_containers_usage")
Cws_hosts_percentage = jResp.StringOf("usage[i].values.cws_hosts_percentage")
Cws_hosts_usage = jResp.StringOf("usage[i].values.cws_hosts_usage")
Dbm_hosts_percentage = jResp.StringOf("usage[i].values.dbm_hosts_percentage")
Dbm_hosts_usage = jResp.StringOf("usage[i].values.dbm_hosts_usage")
Dbm_queries_percentage = jResp.StringOf("usage[i].values.dbm_queries_percentage")
Dbm_queries_usage = jResp.StringOf("usage[i].values.dbm_queries_usage")
Estimated_indexed_logs_percentage = jResp.StringOf("usage[i].values.estimated_indexed_logs_percentage")
Estimated_indexed_logs_usage = jResp.StringOf("usage[i].values.estimated_indexed_logs_usage")
Estimated_indexed_spans_percentage = jResp.StringOf("usage[i].values.estimated_indexed_spans_percentage")
Estimated_indexed_spans_usage = jResp.StringOf("usage[i].values.estimated_indexed_spans_usage")
Estimated_ingested_logs_percentage = jResp.StringOf("usage[i].values.estimated_ingested_logs_percentage")
Estimated_ingested_logs_usage = jResp.StringOf("usage[i].values.estimated_ingested_logs_usage")
Estimated_ingested_spans_percentage = jResp.StringOf("usage[i].values.estimated_ingested_spans_percentage")
Estimated_ingested_spans_usage = jResp.StringOf("usage[i].values.estimated_ingested_spans_usage")
Estimated_rum_sessions_percentage = jResp.StringOf("usage[i].values.estimated_rum_sessions_percentage")
Estimated_rum_sessions_usage = jResp.StringOf("usage[i].values.estimated_rum_sessions_usage")
Fargate_percentage = jResp.StringOf("usage[i].values.fargate_percentage")
Fargate_usage = jResp.StringOf("usage[i].values.fargate_usage")
Functions_percentage = jResp.StringOf("usage[i].values.functions_percentage")
Functions_usage = jResp.StringOf("usage[i].values.functions_usage")
Infra_host_percentage = jResp.StringOf("usage[i].values.infra_host_percentage")
Infra_host_usage = jResp.StringOf("usage[i].values.infra_host_usage")
Invocations_percentage = jResp.StringOf("usage[i].values.invocations_percentage")
Invocations_usage = jResp.StringOf("usage[i].values.invocations_usage")
Npm_host_percentage = jResp.StringOf("usage[i].values.npm_host_percentage")
Npm_host_usage = jResp.StringOf("usage[i].values.npm_host_usage")
Obs_pipeline_bytes_percentage = jResp.StringOf("usage[i].values.obs_pipeline_bytes_percentage")
Obs_pipeline_bytes_usage = jResp.StringOf("usage[i].values.obs_pipeline_bytes_usage")
Profiled_container_percentage = jResp.StringOf("usage[i].values.profiled_container_percentage")
Profiled_container_usage = jResp.StringOf("usage[i].values.profiled_container_usage")
Profiled_fargate_percentage = jResp.StringOf("usage[i].values.profiled_fargate_percentage")
Profiled_fargate_usage = jResp.StringOf("usage[i].values.profiled_fargate_usage")
Profiled_host_percentage = jResp.StringOf("usage[i].values.profiled_host_percentage")
Profiled_host_usage = jResp.StringOf("usage[i].values.profiled_host_usage")
Sds_scanned_bytes_percentage = jResp.StringOf("usage[i].values.sds_scanned_bytes_percentage")
Sds_scanned_bytes_usage = jResp.StringOf("usage[i].values.sds_scanned_bytes_usage")
Snmp_percentage = jResp.StringOf("usage[i].values.snmp_percentage")
Snmp_usage = jResp.StringOf("usage[i].values.snmp_usage")
Universal_service_monitoring_percentage = jResp.StringOf("usage[i].values.universal_service_monitoring_percentage")
Universal_service_monitoring_usage = jResp.StringOf("usage[i].values.universal_service_monitoring_usage")
Vuln_management_hosts_percentage = jResp.StringOf("usage[i].values.vuln_management_hosts_percentage")
Vuln_management_hosts_usage = jResp.StringOf("usage[i].values.vuln_management_hosts_usage")
j = 0
count_j = jResp.SizeOfArray("usage[i].tags.dolore62")
While j < count_j
jResp.J = j
strVal = jResp.StringOf("usage[i].tags.dolore62[j]")
j = j + 1
End While
j = 0
count_j = jResp.SizeOfArray("usage[i].tags.elit276")
While j < count_j
jResp.J = j
strVal = jResp.StringOf("usage[i].tags.elit276[j]")
j = j + 1
End While
j = 0
count_j = jResp.SizeOfArray("usage[i].tags.minim63")
While j < count_j
jResp.J = j
strVal = jResp.StringOf("usage[i].tags.minim63[j]")
j = j + 1
End While
j = 0
count_j = jResp.SizeOfArray("usage[i].tags.pariatur_d4")
While j < count_j
jResp.J = j
strVal = jResp.StringOf("usage[i].tags.pariatur_d4[j]")
j = j + 1
End While
i = i + 1
End While
Curl Command
curl -G -d "start_month=1991-02-02T07%3A22%3A34.204Z"
-d "end_month=1991-02-02T07%3A22%3A34.204Z"
-d "fields=dbm_queries_usage"
-d "sort_direction=desc"
-d "sort_name=dbm_queries_usage"
-d "tag_breakdown_keys=tempor%20Ut%20sed%20velit"
-d "next_record_id=tempor%20Ut%20sed%20velit"
-d "include_descendants=true"
-H "Accept: application/json;datetime-format=rfc3339"
https://api.app.ddog-gov.com/api/v1/usage/monthly-attribution
Postman Collection Item JSON
{
"name": "Get monthly usage attribution",
"request": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json;datetime-format=rfc3339"
}
],
"url": {
"raw": "{{baseUrl}}/api/v1/usage/monthly-attribution?start_month=1991-02-02T07:22:34.204Z&end_month=1991-02-02T07:22:34.204Z&fields=dbm_queries_usage&sort_direction=desc&sort_name=dbm_queries_usage&tag_breakdown_keys=tempor Ut sed velit&next_record_id=tempor Ut sed velit&include_descendants=true",
"host": [
"{{baseUrl}}"
],
"path": [
"api",
"v1",
"usage",
"monthly-attribution"
],
"query": [
{
"key": "start_month",
"value": "1991-02-02T07:22:34.204Z",
"description": "(Required) Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for usage beginning in this month.\nMaximum of 15 months ago."
},
{
"key": "end_month",
"value": "1991-02-02T07:22:34.204Z",
"description": "Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for usage ending this month."
},
{
"key": "fields",
"value": "dbm_queries_usage",
"description": "(Required) Comma-separated list of usage types to return, or `*` for all usage types."
},
{
"key": "sort_direction",
"value": "desc",
"description": "The direction to sort by: `[desc, asc]`."
},
{
"key": "sort_name",
"value": "dbm_queries_usage",
"description": "The field to sort by."
},
{
"key": "tag_breakdown_keys",
"value": "tempor Ut sed velit",
"description": "Comma separated list of tag keys used to group usage. If no value is provided the usage will not be broken down by tags.\n\nTo see which tags are available, look for the value of `tag_config_source` in the API response."
},
{
"key": "next_record_id",
"value": "tempor Ut sed velit",
"description": "List following results with a next_record_id provided in the previous query."
},
{
"key": "include_descendants",
"value": "true",
"description": "Include child org usage in the response. Defaults to `true`."
}
]
},
"description": "Get monthly usage attribution. Multi-region data is available starting March 1, 2023.\n\nThis API endpoint is paginated. To make sure you receive all records, check if the value of `next_record_id` is\nset in the response. If it is, make another request and pass `next_record_id` as a parameter.\nPseudo code example:\n\n```\nresponse := GetMonthlyUsageAttribution(start_month)\ncursor := response.metadata.pagination.next_record_id\nWHILE cursor != null BEGIN\n sleep(5 seconds) # Avoid running into rate limit\n response := GetMonthlyUsageAttribution(start_month, next_record_id=cursor)\n cursor := response.metadata.pagination.next_record_id\nEND\n```"
},
"response": [
{
"name": "OK",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json;datetime-format=rfc3339"
},
{
"description": "Added as a part of security scheme: apikey",
"key": "DD-API-KEY",
"value": "<API Key>"
}
],
"url": {
"raw": "{{baseUrl}}/api/v1/usage/monthly-attribution?start_month=1991-02-02T07:22:34.204Z&end_month=1991-02-02T07:22:34.204Z&fields=dbm_queries_usage&sort_direction=desc&sort_name=dbm_queries_usage&tag_breakdown_keys=tempor Ut sed velit&next_record_id=tempor Ut sed velit&include_descendants=true",
"host": [
"{{baseUrl}}"
],
"path": [
"api",
"v1",
"usage",
"monthly-attribution"
],
"query": [
{
"key": "start_month",
"value": "1991-02-02T07:22:34.204Z",
"description": "(Required) Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for usage beginning in this month.\nMaximum of 15 months ago."
},
{
"key": "end_month",
"value": "1991-02-02T07:22:34.204Z",
"description": "Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for usage ending this month."
},
{
"key": "fields",
"value": "dbm_queries_usage",
"description": "(Required) Comma-separated list of usage types to return, or `*` for all usage types."
},
{
"key": "sort_direction",
"value": "desc",
"description": "The direction to sort by: `[desc, asc]`."
},
{
"key": "sort_name",
"value": "dbm_queries_usage",
"description": "The field to sort by."
},
{
"key": "tag_breakdown_keys",
"value": "tempor Ut sed velit",
"description": "Comma separated list of tag keys used to group usage. If no value is provided the usage will not be broken down by tags.\n\nTo see which tags are available, look for the value of `tag_config_source` in the API response."
},
{
"key": "next_record_id",
"value": "tempor Ut sed velit",
"description": "List following results with a next_record_id provided in the previous query."
},
{
"key": "include_descendants",
"value": "true",
"description": "Include child org usage in the response. Defaults to `true`."
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json;datetime-format=rfc3339"
}
],
"cookie": [
],
"body": "{\n \"metadata\": {\n \"aggregates\": [\n {\n \"agg_type\": \"sum\",\n \"field\": \"custom_timeseries_usage\",\n \"value\": -75872274.11279911\n },\n {\n \"agg_type\": \"sum\",\n \"field\": \"custom_timeseries_usage\",\n \"value\": 62426608.270860344\n }\n ],\n \"pagination\": {\n \"next_record_id\": \"in velit esse\"\n }\n },\n \"usage\": [\n {\n \"month\": \"2002-08-13T15:07:13.466Z\",\n \"org_name\": \"elit reprehenderit\",\n \"public_id\": \"minim ipsum anim \",\n \"region\": \"eu incididunt sint ut\",\n \"tag_config_source\": \"irure laboris culpa\",\n \"tags\": {\n \"dolore62\": [\n \"datadog-integrations-lab\",\n \"datadog-integrations-lab\"\n ]\n },\n \"updated_at\": \"2006-01-20T21:37:20.788Z\",\n \"values\": {\n \"api_percentage\": -42977723.76246902,\n \"api_usage\": 95397982.7763887,\n \"apm_fargate_percentage\": 98784807.55202839,\n \"apm_fargate_usage\": -5570111.678832486,\n \"apm_host_percentage\": -56965575.051769115,\n \"apm_host_usage\": 6024527.554351345,\n \"apm_usm_percentage\": -44347230.916792005,\n \"apm_usm_usage\": -53614973.50940212,\n \"appsec_fargate_percentage\": -63949646.084028535,\n \"appsec_fargate_usage\": -13950059.836552203,\n \"appsec_percentage\": 77503688.59718463,\n \"appsec_usage\": -2749536.490563825,\n \"browser_percentage\": -57610165.63884018,\n \"browser_usage\": -61629554.27924777,\n \"ci_visibility_itr_percentage\": 9801397.272425354,\n \"ci_visibility_itr_usage\": 86901082.07052395,\n \"container_excl_agent_percentage\": -94758211.3791813,\n \"container_excl_agent_usage\": 47871386.536788315,\n \"container_percentage\": 77684191.36010852,\n \"container_usage\": 42244878.990811646,\n \"cspm_containers_percentage\": -27358203.524139896,\n \"cspm_containers_usage\": 7194834.822350323,\n \"cspm_hosts_percentage\": -58400939.80376841,\n \"cspm_hosts_usage\": -13088798.55443798,\n \"custom_ingested_timeseries_percentage\": 25418473.141955733,\n \"custom_ingested_timeseries_usage\": -6930274.896374792,\n \"custom_timeseries_percentage\": 57087072.053094536,\n \"custom_timeseries_usage\": -96533528.35676041,\n \"cws_containers_percentage\": 38802199.2161935,\n \"cws_containers_usage\": -48037945.78847249,\n \"cws_hosts_percentage\": -38139753.73665444,\n \"cws_hosts_usage\": 99175833.09167394,\n \"dbm_hosts_percentage\": -89557128.20902187,\n \"dbm_hosts_usage\": -2062788.2317033857,\n \"dbm_queries_percentage\": -81088882.42935035,\n \"dbm_queries_usage\": 1723401.8763353676,\n \"estimated_indexed_logs_percentage\": 19494055.047132045,\n \"estimated_indexed_logs_usage\": 10830691.252756879,\n \"estimated_indexed_spans_percentage\": 62593562.02511239,\n \"estimated_indexed_spans_usage\": -47185922.657971926,\n \"estimated_ingested_logs_percentage\": 87624062.51598707,\n \"estimated_ingested_logs_usage\": -35910323.49944707,\n \"estimated_ingested_spans_percentage\": -26620688.87925279,\n \"estimated_ingested_spans_usage\": -55965088.442498125,\n \"estimated_rum_sessions_percentage\": -89351036.0053822,\n \"estimated_rum_sessions_usage\": 69102190.52327245,\n \"fargate_percentage\": 31062755.564841017,\n \"fargate_usage\": 47033739.82451412,\n \"functions_percentage\": 53367355.86064315,\n \"functions_usage\": 11045136.755249456,\n \"infra_host_percentage\": -54626318.30325018,\n \"infra_host_usage\": 5481953.102816388,\n \"invocations_percentage\": 27641232.88982962,\n \"invocations_usage\": -23217061.12940158,\n \"npm_host_percentage\": -70428889.89530578,\n \"npm_host_usage\": 75035524.55544943,\n \"obs_pipeline_bytes_percentage\": 95030078.61571154,\n \"obs_pipeline_bytes_usage\": 16308063.424261168,\n \"profiled_container_percentage\": -47294745.9171313,\n \"profiled_container_usage\": 91333575.12025896,\n \"profiled_fargate_percentage\": 1159081.2940575331,\n \"profiled_fargate_usage\": 46737078.93751609,\n \"profiled_host_percentage\": -16133546.561951116,\n \"profiled_host_usage\": -55598728.99167555,\n \"sds_scanned_bytes_percentage\": 41324136.36835453,\n \"sds_scanned_bytes_usage\": 56766327.929751456,\n \"snmp_percentage\": -88823427.70029327,\n \"snmp_usage\": 32225665.615818232,\n \"universal_service_monitoring_percentage\": -79287423.3883524,\n \"universal_service_monitoring_usage\": -2355924.928932488,\n \"vuln_management_hosts_percentage\": -16935520.54186198,\n \"vuln_management_hosts_usage\": 74036018.8908129\n }\n },\n {\n \"month\": \"1959-07-18T20:29:56.664Z\",\n \"org_name\": \"aliquip magna dolor\",\n \"public_id\": \"et iru\",\n \"region\": \"ut est esse ex\",\n \"tag_config_source\": \"sint\",\n \"tags\": {\n \"elit276\": [\n \"datadog-integrations-lab\",\n \"datadog-integrations-lab\"\n ],\n \"minim63\": [\n \"datadog-integrations-lab\",\n \"datadog-integrations-lab\"\n ],\n \"pariatur_d4\": [\n \"datadog-integrations-lab\",\n \"datadog-integrations-lab\"\n ]\n },\n \"updated_at\": \"1950-10-12T07:16:52.126Z\",\n \"values\": {\n \"api_percentage\": -67093975.89355124,\n \"api_usage\": 22892492.134701967,\n \"apm_fargate_percentage\": 86445539.6960246,\n \"apm_fargate_usage\": 96626296.86785325,\n \"apm_host_percentage\": -17829260.52661082,\n \"apm_host_usage\": 99024863.04694226,\n \"apm_usm_percentage\": 15052506.96019815,\n \"apm_usm_usage\": -51446462.70068289,\n \"appsec_fargate_percentage\": -59920029.75633368,\n \"appsec_fargate_usage\": -12417338.286942497,\n \"appsec_percentage\": 33591696.66073081,\n \"appsec_usage\": 25137188.487309366,\n \"browser_percentage\": 97940358.7215335,\n \"browser_usage\": -52673885.905316986,\n \"ci_visibility_itr_percentage\": -88219975.69687605,\n \"ci_visibility_itr_usage\": -9447846.575050354,\n \"container_excl_agent_percentage\": -46735760.53814248,\n \"container_excl_agent_usage\": -73167643.29069096,\n \"container_percentage\": 69642254.33344507,\n \"container_usage\": 41091259.60962516,\n \"cspm_containers_percentage\": 42210153.5692417,\n \"cspm_containers_usage\": 75649568.34254551,\n \"cspm_hosts_percentage\": 32418249.39784172,\n \"cspm_hosts_usage\": 69540549.39095044,\n \"custom_ingested_timeseries_percentage\": -68775982.9429293,\n \"custom_ingested_timeseries_usage\": 76963891.89494428,\n \"custom_timeseries_percentage\": 60837059.719377786,\n \"custom_timeseries_usage\": -18989551.834226012,\n \"cws_containers_percentage\": -72647861.32948461,\n \"cws_containers_usage\": 99339681.5271622,\n \"cws_hosts_percentage\": -83440078.50328308,\n \"cws_hosts_usage\": 14084142.169001937,\n \"dbm_hosts_percentage\": 82967791.28126338,\n \"dbm_hosts_usage\": 25758868.864204437,\n \"dbm_queries_percentage\": -66889696.73566167,\n \"dbm_queries_usage\": 82584001.9588587,\n \"estimated_indexed_logs_percentage\": 18445591.7106888,\n \"estimated_indexed_logs_usage\": 95113838.43812409,\n \"estimated_indexed_spans_percentage\": -60446633.38281309,\n \"estimated_indexed_spans_usage\": -35817307.54312336,\n \"estimated_ingested_logs_percentage\": -78223744.53046979,\n \"estimated_ingested_logs_usage\": -69451886.32509902,\n \"estimated_ingested_spans_percentage\": 40809724.25659558,\n \"estimated_ingested_spans_usage\": -8599266.75406441,\n \"estimated_rum_sessions_percentage\": -50403382.65600939,\n \"estimated_rum_sessions_usage\": -56068159.05777034,\n \"fargate_percentage\": -58215167.93972128,\n \"fargate_usage\": 66587355.106164634,\n \"functions_percentage\": -47256769.918816224,\n \"functions_usage\": 1210604.9136780202,\n \"infra_host_percentage\": -15651911.45215477,\n \"infra_host_usage\": 83986438.03159028,\n \"invocations_percentage\": -72916419.47570357,\n \"invocations_usage\": -99391776.91322954,\n \"npm_host_percentage\": -26689735.74485798,\n \"npm_host_usage\": -58545960.56280492,\n \"obs_pipeline_bytes_percentage\": -18838497.449270487,\n \"obs_pipeline_bytes_usage\": -15181917.208459169,\n \"profiled_container_percentage\": -69415049.22818953,\n \"profiled_container_usage\": -22422349.354449615,\n \"profiled_fargate_percentage\": -88757833.10218939,\n \"profiled_fargate_usage\": -48134372.15719563,\n \"profiled_host_percentage\": -82357525.04911637,\n \"profiled_host_usage\": 50907558.67759526,\n \"sds_scanned_bytes_percentage\": -72420339.71282078,\n \"sds_scanned_bytes_usage\": 54343122.17874324,\n \"snmp_percentage\": -38192297.57339508,\n \"snmp_usage\": 26362518.073974475,\n \"universal_service_monitoring_percentage\": -97356790.37923175,\n \"universal_service_monitoring_usage\": -42030474.203919254,\n \"vuln_management_hosts_percentage\": -74076816.34914787,\n \"vuln_management_hosts_usage\": -25114557.39136301\n }\n }\n ]\n}"
},
{
"name": "Forbidden - User is not authorized",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json;datetime-format=rfc3339"
},
{
"description": "Added as a part of security scheme: apikey",
"key": "DD-API-KEY",
"value": "<API Key>"
}
],
"url": {
"raw": "{{baseUrl}}/api/v1/usage/monthly-attribution?start_month=1991-02-02T07:22:34.204Z&end_month=1991-02-02T07:22:34.204Z&fields=dbm_queries_usage&sort_direction=desc&sort_name=dbm_queries_usage&tag_breakdown_keys=tempor Ut sed velit&next_record_id=tempor Ut sed velit&include_descendants=true",
"host": [
"{{baseUrl}}"
],
"path": [
"api",
"v1",
"usage",
"monthly-attribution"
],
"query": [
{
"key": "start_month",
"value": "1991-02-02T07:22:34.204Z",
"description": "(Required) Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for usage beginning in this month.\nMaximum of 15 months ago."
},
{
"key": "end_month",
"value": "1991-02-02T07:22:34.204Z",
"description": "Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for usage ending this month."
},
{
"key": "fields",
"value": "dbm_queries_usage",
"description": "(Required) Comma-separated list of usage types to return, or `*` for all usage types."
},
{
"key": "sort_direction",
"value": "desc",
"description": "The direction to sort by: `[desc, asc]`."
},
{
"key": "sort_name",
"value": "dbm_queries_usage",
"description": "The field to sort by."
},
{
"key": "tag_breakdown_keys",
"value": "tempor Ut sed velit",
"description": "Comma separated list of tag keys used to group usage. If no value is provided the usage will not be broken down by tags.\n\nTo see which tags are available, look for the value of `tag_config_source` in the API response."
},
{
"key": "next_record_id",
"value": "tempor Ut sed velit",
"description": "List following results with a next_record_id provided in the previous query."
},
{
"key": "include_descendants",
"value": "true",
"description": "Include child org usage in the response. Defaults to `true`."
}
]
}
},
"status": "Forbidden",
"code": 403,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json;datetime-format=rfc3339"
}
],
"cookie": [
],
"body": "{\n \"errors\": [\n \"Bad Request\",\n \"Bad Request\"\n ]\n}"
},
{
"name": "Too many requests",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json;datetime-format=rfc3339"
},
{
"description": "Added as a part of security scheme: apikey",
"key": "DD-API-KEY",
"value": "<API Key>"
}
],
"url": {
"raw": "{{baseUrl}}/api/v1/usage/monthly-attribution?start_month=1991-02-02T07:22:34.204Z&end_month=1991-02-02T07:22:34.204Z&fields=dbm_queries_usage&sort_direction=desc&sort_name=dbm_queries_usage&tag_breakdown_keys=tempor Ut sed velit&next_record_id=tempor Ut sed velit&include_descendants=true",
"host": [
"{{baseUrl}}"
],
"path": [
"api",
"v1",
"usage",
"monthly-attribution"
],
"query": [
{
"key": "start_month",
"value": "1991-02-02T07:22:34.204Z",
"description": "(Required) Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for usage beginning in this month.\nMaximum of 15 months ago."
},
{
"key": "end_month",
"value": "1991-02-02T07:22:34.204Z",
"description": "Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for usage ending this month."
},
{
"key": "fields",
"value": "dbm_queries_usage",
"description": "(Required) Comma-separated list of usage types to return, or `*` for all usage types."
},
{
"key": "sort_direction",
"value": "desc",
"description": "The direction to sort by: `[desc, asc]`."
},
{
"key": "sort_name",
"value": "dbm_queries_usage",
"description": "The field to sort by."
},
{
"key": "tag_breakdown_keys",
"value": "tempor Ut sed velit",
"description": "Comma separated list of tag keys used to group usage. If no value is provided the usage will not be broken down by tags.\n\nTo see which tags are available, look for the value of `tag_config_source` in the API response."
},
{
"key": "next_record_id",
"value": "tempor Ut sed velit",
"description": "List following results with a next_record_id provided in the previous query."
},
{
"key": "include_descendants",
"value": "true",
"description": "Include child org usage in the response. Defaults to `true`."
}
]
}
},
"status": "Too Many Requests",
"code": 429,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json;datetime-format=rfc3339"
}
],
"cookie": [
],
"body": "{\n \"errors\": [\n \"Bad Request\",\n \"Bad Request\"\n ]\n}"
}
]
}
