Skip to content

Commit

Permalink
Update tempo docs
Browse files Browse the repository at this point in the history
  • Loading branch information
josunect committed Dec 13, 2023
1 parent 4e60042 commit 9fd04c8
Show file tree
Hide file tree
Showing 2 changed files with 28 additions and 8 deletions.
36 changes: 28 additions & 8 deletions content/en/docs/Configuration/p8s-jaeger-grafana/tracing/tempo.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand All @@ -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:
Expand All @@ -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)
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 9fd04c8

Please sign in to comment.