StackState version 4.3 (EOL)
👤
Use
🔧
Configure
Prometheus mirror
Pull telemetry from Prometheus using mirroring
This page describes StackState version 4.3.
The StackState 4.3 version range is End of Life (EOL) and no longer supported. We encourage customers still running the 4.3 version range to upgrade to a more recent release.
Overview
Prometheus mirror is a gateway between StackState and Prometheus that enables Prometheus telemetry in StackState.
Prerequisites
The Prometheus Mirror has the following prerequisites:
- The mirror must be reachable from StackState
- Prometheus must be reachable from the mirror without authentication
Helm
The Prometheus mirror is available via the StackState helm repository. Configure your helm with these 2 commands:
1
helm repo add stackstate https://helm.stackstate.io
2
helm repo update
Copied!
Install the Prometheus mirror with the following command:
1
helm install prometheusmirror stackstate/prometheusmirror --set global.apiKey=API_KEY
Copied!
Alternatively, you can use the docker container directly:
1
docker pull stackstate/prometheusmirror:latest
Copied!
Mirror configuration
The Prometheus mirror is configured using the following parameters:
global.apiKey- the API key used to authenticate communication between the mirror and StackStateworkers- number of workers processes (default:20)port- the port the mirror is listening on (default:9900)
StackState configuration
In order to start using Prometheus mirror in StackState one has to create Mirror Datasource
Configure Mirror Datasource
Create a new Mirror datasource:
- Api Key - should be the same key as specified by
global.apiKeymirror configuration - Connection Details JSON - the mirror configuration json, for example:1{2"host": "<prometheus host>",3"port": <prometheus port>,4"requestTimeout": 200005}Copied!Prometheus host/port refers to the actual Prometheus host/port (not the mirror).
Query Configuration
Prometheus Counter
Counter queries fetch counter metrics from Prometheus. The retrieved counter values are transformed to a rate.
The following are sample parameters for a counter query:
- __counter__ = go_memstats_lookups_total
- job = payment-service
- name = payment
- instance = 127.0.0.1:80
Prometheus Gauge
Gauge queries fetch gauge metrics from Prometheus.
The following are sample parameters for a gauge query:
- __gauge__ = go_gc_duration_seconds
- job = payment-service
- name = payment
- instance = 127.0.0.1:80
Prometheus Histogram and Summary
Prometheus histogram and summary queries are not supported from the query interface. They still can be configured using tilda-query.
Tilda ~ query
The query allows arbitrary Prometheus queries, for example:
1
~ = histogram_quantile(0.95, sum(rate(request_duration_seconds_bucket{instance='127.0.0.1:80', name='payment-service'}[1m])) by (name, le)) * 1000
Copied!
See also
Last modified 2mo ago