Issuing CAQL Queries

The Circonus Analytics Query Language (CAQL) allows the user to issue complex queries against metric data residing in IRONdb. The CAQL Reference provides comprehensive documentation about functionality offered by the language.







Parameters can be submitted as url-encoded query string parameters or as JSON payload.

The following parameters are supported:

  • query : The query to execute.

  • start : The start time from which to pull data, represented in seconds since the epoch. This value is inclusive (data for the given start time will be pulled).

  • end : The end time up to which data is pulled, represented in seconds since the epoch. This value is exclusive (data up to, but not including, the given end time will be pulled).

  • period : The period, in seconds, for which to get data rollups.

  • _timeout : Specify a timeout for CAQL processing in seconds. Optional. Default = 4.5.


echo '{
}' | curl --data @-

Equivalently we can pass the paraemeters via the query string:

curl  ''



results matching ""

    No results matching ""