Configuring Grafana Phlare tracing
Grafana Phlare uses Jaeger to implement distributed tracing. Jaeger is a valuable tool for troubleshooting the behavior of Grafana Phlare in production.
Set up Jaeger deployment to collect and store traces from Grafana Phlare. A deployment includes either the Jaeger all-in-one binary, or a distributed system of agents, collectors, and queriers. If you run Grafana Phlare on Kubernetes, refer to Jaeger Kubernetes.
To configure Grafana Phlare to send traces, perform the following steps:
- Set the
JAEGER_AGENT_HOSTenvironment variable in all components to point to the Jaeger agent.
- Enable sampling in the appropriate components:
- The ingester self-initiate traces and should have sampling explicitly enabled.
- Sampling for the distributor and querier can be enabled in Grafana Phlare or in an upstream service, like a proxy or gateway running in front of Grafana Phlare.
To enable sampling in Grafana Phlare components you can specify either
JAEGER_SAMPLER_MANAGER_HOST_PORT for remote sampling, or
JAEGER_SAMPLER_PARAM to manually set sampling
configuration. Refer to Jaeger Client Go
for the full list of environment variables you can configure.
Note that you must specify one of
JAEGER_SAMPLER_MANAGER_HOST_PORT in each component for Jaeger to be enabled,
even if you plan to use the default values.