Grafana Cloud Prometheus
Configuring the Grafana Cloud Prometheus backend (Managed)
Getting Started
These instructions are for the Grafana Cloud managed Prometheus service. If you run a self hosted Prometheus instance, please follow the instructions on the Prometheus page.
You can use Grafana Cloud managed service as a backend for Odigos to store your logs, metrics, and traces. This page describes how to configure Odigos to use Grafana Cloud Prometheus as a metrics backend.
All the connection details can be found at grafana.com under My Account
Then, under the “GRAFANA CLOUD” title, select your Grafana Stuck, browser to the “Prometheus” card and click “Send Metrics”
Resource Attributes as Metrics Labels
To use resource attributes as labels in your data points, you can set the resource attribute names in the Resource Attributes as Labels
multi-input config option in the destination page in the Odigos UI.
Cluster Static Labels
You can set static labels for each metric data pointsent exported to Grafana Cloud Prometheus from the cluster by setting the External Labels
configuration with lable keys and values.
Configuring Destination Fields
- GRAFANA_CLOUD_PROMETHEUS_RW_ENDPOINT
string
: Prometheus Remote Write Endpoint. This is the URL of the Prometheus service. From the grafana cloud UI, Prometheus page, make sure you copy the URL from “Remote Write Endpoint” section, and not the first Endpoint which is used for queries- This field is required
- Example:
https://{hostname}.grafana.net/api/prom/push
- GRAFANA_CLOUD_PROMETHEUS_USERNAME
string
: Username / Instance ID. You can find the Username / Instance ID on the Prometheus page. Value is a number.- This field is required
- Example:
12345678
- GRAFANA_CLOUD_PROMETHEUS_PASSWORD
string
: Password / Api Token. This field is refered to as “password” or “Grafana.com API Token” in the Grafana Cloud UI. You can manage tokens in your “Account Settings” page under the “SECURITY” section in the “Access Policies” page. Make sure your token scope includesmetrics:write
scope.- This field is required
- Example:
glc_eyJvIj...
- PROMETHEUS_RESOURCE_ATTRIBUTES_LABELS
string[]
: Resource Attributes Labels. use these OpenTelemetry resource attributes as prometheus labels for each metric data point- This field is optional and defaults to
["k8s.container.name", "k8s.pod.name", "k8s.namespace.name"]
- This field is optional and defaults to
- PROMETHEUS_RESOURCE_EXTERNAL_LABELS
{ key: string; value: string; }[]
: External Labels. map of labels names and values to be attached to each metric data point- This field is optional
Adding Destination to Odigos
There are two primary methods for configuring destinations in Odigos:
Using the UI
Use the Odigos CLI to access the UI
Click on Add Destination
, select Grafana Cloud Prometheus
and follow the on-screen instructions
Using Kubernetes manifests
Save the YAML below to a file (e.g. grafanacloudprometheus.yaml
)
Apply the YAML using kubectl