Tracing Module provides a tracing stack for SIGHUP Distribution (SD).
If you are new to SD please refer to the official documentation on how to get started with SD.
Tracing Module uses a collection of open source tools to provide a resilient and robust tracing stack for the cluster, built around Grafana Tempo. All the components are deployed in the tracing namespace.
The following packages are included in Tracing Module:
| Package | Version | Description |
|---|---|---|
| tempo-distributed | 2.10.8 |
Distributed Tempo deployment |
| minio-ha | RELEASE.2026-07-17T12-07-51Z |
Three nodes HA MinIO deployment |
Click on each package to see its full documentation.
| Kubernetes Version | Compatibility | Notes |
|---|---|---|
1.33.x |
✅ | No known issues |
1.34.x |
✅ | No known issues |
1.35.x |
✅ | No known issues |
1.36.x |
✅ | No known issues |
Check the compatibility matrix for additional information about previous releases of the modules.
Tracing Module is part of SIGHUP Distribution (SD) and is deployed automatically by furyctl when you create or update a cluster. You don't need to download, vendor or install its packages manually.
You configure the module under spec.distribution.modules.tracing in your furyctl.yaml. The type field selects whether the tracing stack is deployed: tempo to deploy Grafana Tempo (the default), or none to disable the module. The other fields are optional and fall back to sensible defaults.
apiVersion: kfd.sighup.io/v1alpha2
kind: KFDDistribution
spec:
distribution:
modules:
tracing:
type: tempo
minio:
storageSize: "20Gi"See the configuration reference for your cluster kind for the full list of available options: EKSCluster, KFDDistribution or OnPremises.
To install SD from scratch, follow the Getting started guide.
To send traces from an instrumented application to Tempo, point the application to the Distributor's service:
tempo-distributed-distributor.tracing.svc.cluster.local:4317
Note
4317 is the port for the OpenTelemetry Protocol (OTLP). The Distributor supports other protocols, but OTLP is recommended for performance reasons.
Warning
For production workloads, it is better to use something like the OpenTelemetry Collector instead of pushing traces directly to Tempo, so the application can offload traces quickly and minimize the impact on its performance.
Before contributing, please read first the Contributing Guidelines.
In case you experience any problem with the module, please open a new issue.
This module is open-source and it's released under the following LICENSE.