SignalFx Developers Guide

Retrieving Data

Metrics

The API lets you retrieve all the metrics timeseries data for your organization. This includes:

  • Data you send using the https://ingest.{REALM}.signalfx.com/v2/datapoint and https://backfill.{REALM}.signalfx.com/v1/backfill endpoints

  • Data SignalFx receives from integrations with services such as AWS

  • Event and incident data

  • Use the https://api.{REALM}.signalfx.com/v2/timeserieswindow endpoint to retrieve datapoints for an MTS.

  • Use the https://api.{REALM}.signalfx.com/v2/metrics endpoint to create, retrieve, or update metrics and metadata.

  • Use the https://api.{REALM}.signalfx.com/v2/dimension endpoint to retrieve or update dimensions.

  • Use the https://api.{REALM}.signalfx.com/v2/tag endpoint to update tag metadata.

To learn more about metrics, see The SignalFx Data Model.

Events

When detectors detect anomalous conditions, they create events that provide a permanent record of the conditions at the time of detection. Detectors also create events when they detect that the condition is no longer true (the condition has cleared).

The collection of events generated by a detector is known as an incident.

Two APIs are available for retrieving events:

  • To retrieve events for the detector with the identifier DETECTOR_ID, use the operation GET https://api.{REALM}.signalfx.com/v2/detector/{DETECTOR_ID}/events

  • To retrieve incidents for the detector with the identifier DETECTOR_ID, use the operation GET https://api.{REALM}.signalfx.com/v2/detector/{DETECTOR_ID}/incidents

To find the ID for a detector:

  • Use the web UI to find the detector and its ID

  • Use the operation GET https://api.{REALM}.signalfx.com/v2/detector?parms to search for one or more detectors based on criteria specified in the endpoint’s query parameters. You can do a name search or a search on tags associated with the detector.

Tracing

You can also retrieve tracing data. This is covered in the APM Tracing topic.

© Copyright 2019 SignalFx.

Third-party license information