Menu
Open source
Enable multi-tenancy
Tempo is a multi-tenant distributed tracing backend. It supports multi-tenancy through the use
of a header: X-Scope-OrgID
.
If you’re interested in setting up multi-tenancy, consult the multi-tenant example in the repository. This example uses the following settings to achieve multi-tenancy in Tempo.
Note
Multi-tenancy on ingestion is currently only working with GPRC and this may never change. It’s strongly recommended to use the OpenTelemetry Collector to support multi-tenancy.
Configure multi-tenancy
Configure the OTEL Collector to attach the
X-Scope-OrgID
header on push:exporters: otlp: headers: x-scope-orgid: foo-bar-baz
Configure the Tempo data source in Grafana to pass the tenant with the same header:
- name: Tempo-Multitenant jsonData: httpHeaderName1: 'X-Scope-OrgID' secureJsonData: httpHeaderValue1: 'foo-bar-baz'
Enable multi-tenancy on the Tempo backend by setting the following configuration value on all Tempo components:
multitenancy_enabled: true
or from the command line:
--multitenancy.enabled=true
This option forces all Tempo components to require the
X-Scope-OrgID
header.
Was this page helpful?
Related documentation
Related resources from Grafana Labs
Additional helpful documentation, links, and articles:
60 min
Getting started with tracing and Grafana Tempo
In this webinar, we'll show you how to get started setting up Grafana Tempo, our open source, easy-to-use and high-volume distributed tracing backend.
Video
Scaling your distributed tracing with Grafana Tempo
In this demo, we’ll show how Grafana Tempo allows you to scale tracing as far as possible with less operational cost and complexity than ever before.
How Grafana and Tempo 2.0 make it easier to explore distributed traces
Learn best practices for operating Grafana Tempo and tips and tricks to find and visualize "needle in the haystack" traces with TraceQL.