Use the Grafana integration to visualize time series data.

The following diagram shows the time series metrics dataflow between the Cortex Data Lake to the Grafana server:

Grafana image

Version compatibility

Supported Grafana version: 7.5.0 or later

Prerequisites

  • OpsRamp API available
  • OpsRamp OAuth2 API Credentials from OpsRamp integrations page and Client Unique ID
  • Installed Grafana

Constraints

Per unique metric series, a maximum of 11000 datapoints can be scraped, per interval. For example, the metrics aws_ec2_cpu_utilization{host=lab1,region=us-east-1} and aws_ec2_cpu_utilization{host=dev2, region=us-east-2a} are both novel metric series. We support 11000 datapoints, or instances, of these metrics, per scrape.

Create and configure data source

  1. Log in to the Grafana server with your Grafana login credentials.
  2. Configure the data source using the configuration editor:
Grafana image
Data Source PropertyDescription
NameOpsRamp cloud instance name. Enter name or select default name.
Metrics URLApplication server URL, format: https://{my-organization}.app.opsramp.com
Client UniqueIdOrganization client ID
Client API KeyClient API key
Client API SecretClient secret API key

Configure visualization

Use the Query Editor to specify the PromQL query that fetches the time series data:

Grafana image

Query Editor:

Grafana image
Query Editor PropertyDescription
MetricsMetric name with hostname, example: `cassandra_cache_requests{host="1arc-pcassd28"`.
Min stepLower limit of duration for fetching data points, in seconds. [TBD - improve]
ResolutionFractional data point resolution value: 1/nth data points. [TBD - improve]
Legend[TBD - need better definition]
FormatDisplay chart type:
  • Time series
  • Table
  • Heatmap
InstantSelect Instant to get only the latest value for the requested time series.

Examples

Time series chart

Specify {{host}} as the Legend to display only host label values in a time series chart:

Grafana image

Table chart

Grafana image

Heatmap chart

Grafana image