data

Return records for a data type

Return records for a data type

Takes a compact subset of PromQL and returns individual records for a data type.

The subset of PromQL supports:

  • Instant and Range Vector Selectors
  • @ and offset modifiers
  • = and != label matchers on id, tag, and source
  • Matcher grouping on or
  • last_over_time() over a Range Vector, returning only the most recent matching record in the range

User-defined data types are queried with a __name__ matcher, since PromQL metric names can't contain /: {__name__="Event/<uuid>"}[1d]. Other matchers combine with it as usual ({__name__="Event/<uuid>", tag="..."}); with or, repeat the __name__ matcher in every group.

Instant Vectors deviate from typical Prometheus behavior. An un-anchored Instant Vector will return the latest record with an infinite lookback window. Anchored Instant Vectors return any records that match or fall within a duration.

Returned record schema for individual data types is available from the catalog API: data/v1/catalog/{data_type}/v1/schema

get/data/v1/records

Request

  • Base URL: https://api.fulcradynamics.com
  • URL: https://api.fulcradynamics.com/data/v1/records
  • Auth: HTTP bearer

Query parameters

fulcra_useridstring uuid nullable

User ID of the Fulcra User to query records for

Example:cee68121-ce1b-4f6d-94a5-325643cd21e8
format'json' | 'csv'

Format to return records in

qstring required

PromQL query

Example:HeartRate[5m]

Response

Successful Response

Changes

No recorded changes to this operation across all 1 revision of this API.