diff --git a/content/en/docs/Configuration/p8s-jaeger-grafana/tracing/tempo.md b/content/en/docs/Configuration/p8s-jaeger-grafana/tracing/tempo.md index a75514f1..5ec589ae 100644 --- a/content/en/docs/Configuration/p8s-jaeger-grafana/tracing/tempo.md +++ b/content/en/docs/Configuration/p8s-jaeger-grafana/tracing/tempo.md @@ -9,12 +9,19 @@ weight: 2 There are two possibilities to integrate Kiali with Grafana Tempo: -- Using the Grafana Tempo API: This option returns the traces from the Tempo API in OpenTelemetry format. -- Using the Jaeger frontend with the Grafana Tempo backend. +- [Using the Grafana Tempo API](#using-the-grafana-tempo-api): This option returns the traces from the Tempo API in OpenTelemetry format. +- [Using the Jaeger frontend](#using-the-jaeger-frontend-with-grafana-tempo-tracing-backend) with the Grafana Tempo backend. ### Using the Grafana Tempo API -This is a configuration example to setup Kiali tracing with Grafana Tempo: +There are two steps to set up Kiali and Grafana Tempo: + +- [Set up the Kiali CR](#set-up-the-kiali-cr) updating the Tracing and Grafana sections. +- [Set up a Tempo data source](#set-up-a-tempo-datasource-in-grafana) in Grafana. + +#### Set up the Kiali CR + +This is a configuration example to set up Kiali tracing with Grafana Tempo: ```yaml spec: @@ -26,11 +33,11 @@ spec: # Tempo service name is "query-frontend" and is in the "tempo" namespace. # Make sure the URL you provide corresponds to the non-GRPC enabled endpoint # It does not support grpc yet, so make sure "use_grpc" is set to false. - in_cluster_url: "http://query-frontend.tempo:3200" + in_cluster_url: "http://tempo-tempo-query-frontend.tempo.svc.cluster.local:3200/" provider: "tempo" use_grpc: false - # Public facing URL of Grafana - url: "http://my-tempo-host:3200" + # Public facing URL of Tempo + url: "https://tempo-tempo-query-frontend-tempo.apps-crc.testing/" ``` The default UI for Grafana Tempo is Grafana, so we should also set the Grafana url in the configuration: @@ -40,13 +47,26 @@ spec: external_services: grafana: in_cluster_url: http://grafana.istio-system:3000 - url: http://my-grafana-host + url: https://grafana.apps-crc.testing/ ``` -We also need to set up a default [Tempo datasource](https://grafana.com/docs/grafana/latest/datasources/tempo/) in Grafana. +#### Set up a Tempo Datasource in Grafana + +We also need to set up a default [Tempo datasource](https://grafana.com/docs/grafana/latest/datasources/tempo/) in Grafana: ![Kiali grafana_tempo](/images/documentation/configuration/grafana_tempo_ds.png) +For this, we go to the Home menu in Grafana, click in _data sources_, and then in the _Add data source_. Select the Tempo data source and fill the values: + +![Kiali grafana_tempo](/images/documentation/configuration/tempo_ds.png) + +The most important values to set up are the following: + +- Mark the data source as default, so the url from Kiali redirects properly to the Tempo data source. +- Update the http url. This is the internal url of the http tempo frontend service. E.g. `http://tempo-tempo-query-frontend.tempo.svc.cluster.local:3200/` + +#### Additional configuration + The _Traces_ tab will show your traces in a bubble chart: ![Kiali grafana_tempo](/images/documentation/configuration/grafana_tempo.png) diff --git a/static/images/documentation/configuration/tempo_ds.png b/static/images/documentation/configuration/tempo_ds.png new file mode 100644 index 00000000..46589e47 Binary files /dev/null and b/static/images/documentation/configuration/tempo_ds.png differ