pyroscope-monitoring

A Helm chart for monitoring Grafana Pyroscope. This helm chart uses otel-lgtm to monitor the health of the Grafana Pyroscope backend.

⚠️ Note: This monitoring setup is not production grade and is intended for development and testing purposes only.

Dashboards

This chart provisions the following Grafana dashboards under the "Pyroscope" folder:

• operational - General operational metrics dashboard
• v2-metastore - Metastore-related metrics dashboard (only relevant with v2 storage layer)
• v2-read-path - Read path performance dashboard (focusing on v2 storage layer)
• v2-write-path - Write path performance dashboard (focusing on v2 storage layer)

Native vs classic histograms

Set dashboards.nativeHistograms (default: true) to control which PromQL query style is used:

• true — native histogram functions (histogram_sum, histogram_count, histogram_quantile, histogram_avg). Requires scrape_native_histograms: true in the Prometheus scrape config for Pyroscope.
• false — classic suffix queries (_bucket, _sum, _count).

The committed JSON files under operations/monitoring/dashboards/ (native) and operations/monitoring/dashboards-classic-histogram/ (classic) are generated by make helm/check and should not be edited directly.

Requirements

Repository	Name	Version
https://grafana.github.io/helm-charts	monitoring(k8s-monitoring)	3.8.8

Values

Key	Type	Default	Description
affinity	object	{}
dashboards.cadvisorSelector	string	"job=~\"(.*/)?cadvisor\""
dashboards.cloudBackendGateway	bool	false
dashboards.cloudBackendGatewaySelector	string	"container=~\"cortex-gw(-internal)?\""
dashboards.cluster	string	"pyroscope-dev"
dashboards.ingestNamespaceSelector	string	"namespace=~\"$namespace\""
dashboards.ingestSelector	string	`"container=~"pyroscope	distributor
dashboards.kubeStateMetricsSelector	string	"job=~\"(.*/)?kube-state-metrics\""
dashboards.namespace	string	"default"
dashboards.namespaceRegex	string	".*"
dashboards.namespaceRegexPerDashboard	object	{}
dashboards.nativeHistograms	bool	true
dashboards.tenantQuery	string	"sum by (tenant, slug, org_name, environment) (\n {{- if .Values.dashboards.nativeHistograms }}\n histogram_sum(rate(pyroscope_distributor_received_decompressed_bytes{cluster=~\"$cluster\",namespace=~\"$namespace\"}[$__rate_interval]))\n {{- else }}\n rate(pyroscope_distributor_received_decompressed_bytes_sum{cluster=~\"$cluster\",namespace=~\"$namespace\"}[$__rate_interval])\n {{- end }}\n)\n"
fullnameOverride	string	""
image.pullPolicy	string	"IfNotPresent"
image.repository	string	"grafana/otel-lgtm"
image.tag	string	"0.11.10"
imagePullSecrets	list	[]
nameOverride	string	""
nodeSelector	object	{}
podAnnotations	object	{}
podLabels	object	{}
podSecurityContext	object	{}
replicaCount	int	1
resources	object	{}
securityContext	object	{}
service.deployStaticName	bool	true
service.type	string	"ClusterIP"
tolerations	list	[]