Chilkat Online Tools

PureBasic / Datadog API Collection / Query timeseries points

Back to Collection Items

IncludeFile "CkJsonObject.pb"
IncludeFile "CkStringBuilder.pb"
IncludeFile "CkHttp.pb"
IncludeFile "CkHttpResponse.pb"

Procedure ChilkatExample()

    ; This example assumes the Chilkat API to have been previously unlocked.
    ; See Global Unlock Sample for sample code.

    http.i = CkHttp::ckCreate()
    If http.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success.i

    queryParams.i = CkJsonObject::ckCreate()
    If queryParams.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkJsonObject::ckUpdateInt(queryParams,"from",-62147425)
    CkJsonObject::ckUpdateInt(queryParams,"to",-62147425)
    CkJsonObject::ckUpdateString(queryParams,"query","tempor Ut sed velit")

    CkHttp::ckSetRequestHeader(http,"Accept","application/json")

    resp.i = CkHttp::ckQuickRequestParams(http,"GET","https://api.app.ddog-gov.com/api/v1/query",queryParams)
    If CkHttp::ckLastMethodSuccess(http) = 0
        Debug CkHttp::ckLastErrorText(http)
        CkHttp::ckDispose(http)
        CkJsonObject::ckDispose(queryParams)
        ProcedureReturn
    EndIf

    sbResponseBody.i = CkStringBuilder::ckCreate()
    If sbResponseBody.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkHttpResponse::ckGetBodySb(resp,sbResponseBody)

    jResp.i = CkJsonObject::ckCreate()
    If jResp.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkJsonObject::ckLoadSb(jResp,sbResponseBody)
    CkJsonObject::setCkEmitCompact(jResp, 0)

    Debug "Response Body:"
    Debug CkJsonObject::ckEmit(jResp)

    respStatusCode.i = CkHttpResponse::ckStatusCode(resp)
    Debug "Response Status Code = " + Str(respStatusCode)
    If respStatusCode >= 400
        Debug "Response Header:"
        Debug CkHttpResponse::ckHeader(resp)
        Debug "Failed."
        CkHttpResponse::ckDispose(resp)

        CkHttp::ckDispose(http)
        CkJsonObject::ckDispose(queryParams)
        CkStringBuilder::ckDispose(sbResponseBody)
        CkJsonObject::ckDispose(jResp)
        ProcedureReturn
    EndIf

    CkHttpResponse::ckDispose(resp)

    ; Sample JSON response:
    ; (Sample code for parsing the JSON response is shown below)

    ; {
    ;   "error": "officia dolor dolor enim Ut",
    ;   "from_date": 74851718,
    ;   "group_by": [
    ;     "Ut sint veniam voluptate id",
    ;     "laborum dolore fugiat quis"
    ;   ],
    ;   "message": "commodo Duis dolore",
    ;   "query": "irure nulla",
    ;   "res_type": "time_series",
    ;   "series": [
    ;     {
    ;       "aggr": "avg",
    ;       "display_name": "system.cpu.idle",
    ;       "end": 40693612,
    ;       "expression": "system.cpu.idle{host:foo,env:test}",
    ;       "interval": 40405386,
    ;       "length": -62156772,
    ;       "metric": "system.cpu.idle",
    ;       "pointlist": [
    ;         [
    ;           1681683300000,
    ;           77.62145685254418
    ;         ]
    ;       ],
    ;       "query_index": -41586801,
    ;       "scope": "host:foo,env:test",
    ;       "start": -45245073,
    ;       "tag_set": [
    ;         "aute incididunt enim",
    ;         "dolore mollit amet esse"
    ;       ],
    ;       "unit": [
    ;         {
    ;           "family": "time",
    ;           "name": "minute",
    ;           "plural": "minutes",
    ;           "scale_factor": 60,
    ;           "short_name": "min"
    ;         },
    ;         {
    ;           "family": "time",
    ;           "name": "minute",
    ;           "plural": "minutes",
    ;           "scale_factor": 60,
    ;           "short_name": "min"
    ;         }
    ;       ]
    ;     },
    ;     {
    ;       "aggr": "avg",
    ;       "display_name": "system.cpu.idle",
    ;       "end": -49813044,
    ;       "expression": "system.cpu.idle{host:foo,env:test}",
    ;       "interval": -86046844,
    ;       "length": 71311767,
    ;       "metric": "system.cpu.idle",
    ;       "pointlist": [
    ;         [
    ;           1681683300000,
    ;           77.62145685254418
    ;         ]
    ;       ],
    ;       "query_index": -70553970,
    ;       "scope": "host:foo,env:test",
    ;       "start": 3842833,
    ;       "tag_set": [
    ;         "sit enim consectetur",
    ;         "Duis"
    ;       ],
    ;       "unit": [
    ;         {
    ;           "family": "time",
    ;           "name": "minute",
    ;           "plural": "minutes",
    ;           "scale_factor": 60,
    ;           "short_name": "min"
    ;         },
    ;         {
    ;           "family": "time",
    ;           "name": "minute",
    ;           "plural": "minutes",
    ;           "scale_factor": 60,
    ;           "short_name": "min"
    ;         }
    ;       ]
    ;     }
    ;   ],
    ;   "status": "ok",
    ;   "to_date": 39411541
    ; }

    ; Sample code for parsing the JSON response...
    ; Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code

    strVal.s
    aggr.s
    display_name.s
    v_end.i
    expression.s
    interval.i
    length.i
    metric.s
    query_index.i
    scope.s
    start.i
    j.i
    count_j.i
    k.i
    count_k.i
    intVal.i
    family.s
    name.s
    plural.s
    scale_factor.i
    short_name.s

    error.s = CkJsonObject::ckStringOf(jResp,"error")
    from_date.i = CkJsonObject::ckIntOf(jResp,"from_date")
    message.s = CkJsonObject::ckStringOf(jResp,"message")
    query.s = CkJsonObject::ckStringOf(jResp,"query")
    res_type.s = CkJsonObject::ckStringOf(jResp,"res_type")
    status.s = CkJsonObject::ckStringOf(jResp,"status")
    to_date.i = CkJsonObject::ckIntOf(jResp,"to_date")
    i.i = 0
    count_i.i = CkJsonObject::ckSizeOfArray(jResp,"group_by")
    While i < count_i
        CkJsonObject::setCkI(jResp, i)
        strVal = CkJsonObject::ckStringOf(jResp,"group_by[i]")
        i = i + 1
    Wend
    i = 0
    count_i = CkJsonObject::ckSizeOfArray(jResp,"series")
    While i < count_i
        CkJsonObject::setCkI(jResp, i)
        aggr = CkJsonObject::ckStringOf(jResp,"series[i].aggr")
        display_name = CkJsonObject::ckStringOf(jResp,"series[i].display_name")
        v_end = CkJsonObject::ckIntOf(jResp,"series[i].end")
        expression = CkJsonObject::ckStringOf(jResp,"series[i].expression")
        interval = CkJsonObject::ckIntOf(jResp,"series[i].interval")
        length = CkJsonObject::ckIntOf(jResp,"series[i].length")
        metric = CkJsonObject::ckStringOf(jResp,"series[i].metric")
        query_index = CkJsonObject::ckIntOf(jResp,"series[i].query_index")
        scope = CkJsonObject::ckStringOf(jResp,"series[i].scope")
        start = CkJsonObject::ckIntOf(jResp,"series[i].start")
        j = 0
        count_j = CkJsonObject::ckSizeOfArray(jResp,"series[i].pointlist")
        While j < count_j
            CkJsonObject::setCkJ(jResp, j)
            k = 0
            count_k = CkJsonObject::ckSizeOfArray(jResp,"series[i].pointlist[j]")
            While k < count_k
                CkJsonObject::setCkK(jResp, k)
                intVal = CkJsonObject::ckIntOf(jResp,"series[i].pointlist[j][k]")
                k = k + 1
            Wend
            j = j + 1
        Wend
        j = 0
        count_j = CkJsonObject::ckSizeOfArray(jResp,"series[i].tag_set")
        While j < count_j
            CkJsonObject::setCkJ(jResp, j)
            strVal = CkJsonObject::ckStringOf(jResp,"series[i].tag_set[j]")
            j = j + 1
        Wend
        j = 0
        count_j = CkJsonObject::ckSizeOfArray(jResp,"series[i].unit")
        While j < count_j
            CkJsonObject::setCkJ(jResp, j)
            family = CkJsonObject::ckStringOf(jResp,"series[i].unit[j].family")
            name = CkJsonObject::ckStringOf(jResp,"series[i].unit[j].name")
            plural = CkJsonObject::ckStringOf(jResp,"series[i].unit[j].plural")
            scale_factor = CkJsonObject::ckIntOf(jResp,"series[i].unit[j].scale_factor")
            short_name = CkJsonObject::ckStringOf(jResp,"series[i].unit[j].short_name")
            j = j + 1
        Wend
        i = i + 1
    Wend


    CkHttp::ckDispose(http)
    CkJsonObject::ckDispose(queryParams)
    CkStringBuilder::ckDispose(sbResponseBody)
    CkJsonObject::ckDispose(jResp)


    ProcedureReturn
EndProcedure

Curl Command

curl -G -d "from=-62147425"
	-d "to=-62147425"
	-d "query=tempor%20Ut%20sed%20velit"
	-H "Accept: application/json"
https://api.app.ddog-gov.com/api/v1/query

Postman Collection Item JSON

{
  "name": "Query timeseries points",
  "request": {
    "method": "GET",
    "header": [
      {
        "key": "Accept",
        "value": "application/json"
      }
    ],
    "url": {
      "raw": "{{baseUrl}}/api/v1/query?from=-62147425&to=-62147425&query=tempor Ut sed velit",
      "host": [
        "{{baseUrl}}"
      ],
      "path": [
        "api",
        "v1",
        "query"
      ],
      "query": [
        {
          "key": "from",
          "value": "-62147425",
          "description": "(Required) Start of the queried time period, seconds since the Unix epoch."
        },
        {
          "key": "to",
          "value": "-62147425",
          "description": "(Required) End of the queried time period, seconds since the Unix epoch."
        },
        {
          "key": "query",
          "value": "tempor Ut sed velit",
          "description": "(Required) Query string."
        }
      ]
    },
    "description": "Query timeseries points."
  },
  "response": [
    {
      "name": "OK",
      "originalRequest": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          },
          {
            "description": "Added as a part of security scheme: apikey",
            "key": "DD-API-KEY",
            "value": "<API Key>"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/v1/query?from=-62147425&to=-62147425&query=tempor Ut sed velit",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v1",
            "query"
          ],
          "query": [
            {
              "key": "from",
              "value": "-62147425",
              "description": "(Required) Start of the queried time period, seconds since the Unix epoch."
            },
            {
              "key": "to",
              "value": "-62147425",
              "description": "(Required) End of the queried time period, seconds since the Unix epoch."
            },
            {
              "key": "query",
              "value": "tempor Ut sed velit",
              "description": "(Required) Query string."
            }
          ]
        }
      },
      "status": "OK",
      "code": 200,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n  \"error\": \"officia dolor dolor enim Ut\",\n  \"from_date\": 74851718,\n  \"group_by\": [\n    \"Ut sint veniam voluptate id\",\n    \"laborum dolore fugiat quis\"\n  ],\n  \"message\": \"commodo Duis dolore\",\n  \"query\": \"irure nulla\",\n  \"res_type\": \"time_series\",\n  \"series\": [\n    {\n      \"aggr\": \"avg\",\n      \"display_name\": \"system.cpu.idle\",\n      \"end\": 40693612,\n      \"expression\": \"system.cpu.idle{host:foo,env:test}\",\n      \"interval\": 40405386,\n      \"length\": -62156772,\n      \"metric\": \"system.cpu.idle\",\n      \"pointlist\": [\n        [\n          1681683300000,\n          77.62145685254418\n        ]\n      ],\n      \"query_index\": -41586801,\n      \"scope\": \"host:foo,env:test\",\n      \"start\": -45245073,\n      \"tag_set\": [\n        \"aute incididunt enim\",\n        \"dolore mollit amet esse\"\n      ],\n      \"unit\": [\n        {\n          \"family\": \"time\",\n          \"name\": \"minute\",\n          \"plural\": \"minutes\",\n          \"scale_factor\": 60,\n          \"short_name\": \"min\"\n        },\n        {\n          \"family\": \"time\",\n          \"name\": \"minute\",\n          \"plural\": \"minutes\",\n          \"scale_factor\": 60,\n          \"short_name\": \"min\"\n        }\n      ]\n    },\n    {\n      \"aggr\": \"avg\",\n      \"display_name\": \"system.cpu.idle\",\n      \"end\": -49813044,\n      \"expression\": \"system.cpu.idle{host:foo,env:test}\",\n      \"interval\": -86046844,\n      \"length\": 71311767,\n      \"metric\": \"system.cpu.idle\",\n      \"pointlist\": [\n        [\n          1681683300000,\n          77.62145685254418\n        ]\n      ],\n      \"query_index\": -70553970,\n      \"scope\": \"host:foo,env:test\",\n      \"start\": 3842833,\n      \"tag_set\": [\n        \"sit enim consectetur\",\n        \"Duis\"\n      ],\n      \"unit\": [\n        {\n          \"family\": \"time\",\n          \"name\": \"minute\",\n          \"plural\": \"minutes\",\n          \"scale_factor\": 60,\n          \"short_name\": \"min\"\n        },\n        {\n          \"family\": \"time\",\n          \"name\": \"minute\",\n          \"plural\": \"minutes\",\n          \"scale_factor\": 60,\n          \"short_name\": \"min\"\n        }\n      ]\n    }\n  ],\n  \"status\": \"ok\",\n  \"to_date\": 39411541\n}"
    },
    {
      "name": "Bad Request",
      "originalRequest": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          },
          {
            "description": "Added as a part of security scheme: apikey",
            "key": "DD-API-KEY",
            "value": "<API Key>"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/v1/query?from=-62147425&to=-62147425&query=tempor Ut sed velit",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v1",
            "query"
          ],
          "query": [
            {
              "key": "from",
              "value": "-62147425",
              "description": "(Required) Start of the queried time period, seconds since the Unix epoch."
            },
            {
              "key": "to",
              "value": "-62147425",
              "description": "(Required) End of the queried time period, seconds since the Unix epoch."
            },
            {
              "key": "query",
              "value": "tempor Ut sed velit",
              "description": "(Required) Query string."
            }
          ]
        }
      },
      "status": "Bad Request",
      "code": 400,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n  \"errors\": [\n    \"Bad Request\",\n    \"Bad Request\"\n  ]\n}"
    },
    {
      "name": "Forbidden",
      "originalRequest": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          },
          {
            "description": "Added as a part of security scheme: apikey",
            "key": "DD-API-KEY",
            "value": "<API Key>"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/v1/query?from=-62147425&to=-62147425&query=tempor Ut sed velit",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v1",
            "query"
          ],
          "query": [
            {
              "key": "from",
              "value": "-62147425",
              "description": "(Required) Start of the queried time period, seconds since the Unix epoch."
            },
            {
              "key": "to",
              "value": "-62147425",
              "description": "(Required) End of the queried time period, seconds since the Unix epoch."
            },
            {
              "key": "query",
              "value": "tempor Ut sed velit",
              "description": "(Required) Query string."
            }
          ]
        }
      },
      "status": "Forbidden",
      "code": 403,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "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"
          },
          {
            "description": "Added as a part of security scheme: apikey",
            "key": "DD-API-KEY",
            "value": "<API Key>"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/v1/query?from=-62147425&to=-62147425&query=tempor Ut sed velit",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v1",
            "query"
          ],
          "query": [
            {
              "key": "from",
              "value": "-62147425",
              "description": "(Required) Start of the queried time period, seconds since the Unix epoch."
            },
            {
              "key": "to",
              "value": "-62147425",
              "description": "(Required) End of the queried time period, seconds since the Unix epoch."
            },
            {
              "key": "query",
              "value": "tempor Ut sed velit",
              "description": "(Required) Query string."
            }
          ]
        }
      },
      "status": "Too Many Requests",
      "code": 429,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n  \"errors\": [\n    \"Bad Request\",\n    \"Bad Request\"\n  ]\n}"
    }
  ]
}