API Documentation | Data
The data extraction API is a (beta) read only endpoint to pull the values of a single data point for a given time range.
A string containing a data cid
One or more data structures as defined in the examples
The data endpoint provides a simple way to extact data from Circonus. Please note that this is a BETA API endpoint, and is subject to change without notice.
To extract data you need perform a HTTP GET request on the data cid.
This follows the format /data/[check_id]_[metric_name] (it has the same format
as a ruleset cid but with
/data instead of
You must also provide the following parameters:
- The type of data you wish to extract. This must be
- The start time, in epoch seconds, of the duration you wish to export data from
- The end time, in epoch seconds, of the duration you wish to export data from
- For numeric and histogram types only, and not text. The resolution of
data you want to get back (in seconds), valid values are:
Extracting Numeric Metric Data
Numeric data uses objects to return the compiled statistics for the various datapoints:
For numeric data you may also optionally provide the following fields to format your output:
- The format of the data you wish to extract. This can be:
legacy- original format where each record is [<timestamp>, <object of values>] (see example below)
tuple- where each record is a JSON array of just numeric value fields with no field identifiers
object- where each record is a JSON object with field identifier.
- When format is not
legacythis will control which fields come back in the output and their order. Valid fields are listed under the first example below.
Extracting Histogram Metric Data
Histogram data uses objects to return the histogram information. The keys of the object are stringified numbers that represent the lower-bound of a bucket where the upper range is the next value expressible in base 10 with two digits of precision. (e.g "0.12" expresses [0.12,0.13) and "990" expresses [990, 1000))
Extracting Text Metric Data
Text data can be extracted in a similar way, but you do not pass the period parameter. The returned data structure only contains entries where the data changes
Circonus Keyboard Shortcuts
- Jump to the user documentation.
- Show this keyboard help screen.
- Close help screens and dialogs.
- Focus on any available search field.
- Refresh content on the page without reloading the entire page; currently works on graphs, worksheets, and dashboards.
Graph Grid Shortcuts
- On a worksheet, hold it down to invert the current legend hover
On “My Graphs” and the “Trending & Analytics Dash,” hold it down to show the legend when hovering over a graph.
- Hold down to show the date shifting toolbar for modifying the start date. Can be combined with <period>.
- Hold down to show the date shifting toolbar for modifying the end date. Can be combined with <comma>.
- Nudge the date range for the current graph(s) backward.
- Nudge the date range for the current graph(s) forward.
- Toggle the display of histogram sparklines (shown upon hovering over a graph when viewing or when on a dashboard).
- Hold down to unlock graph hovering datapoint selection, allowing mouse hovering to select nearby datapoints. The heads-up legend will also show on the graph while this shortcut is held down.
Mousewheel & Touchpad Shortcuts
- Hold down while scrolling to zoom graphs' Y axes.
- Hold down while scrolling to zoom graphs' X axis.
- Hold down while scrolling to shift graphs' X axis.
- Hold down while scrolling to shift graphs' X axis start dates. Can be combined with <period>.
- Hold down while scrolling to shift graphs' X axis end dates. Can be combined with <comma>.