27.2. Integration with Grafana Tempo #

This section explains how to provide tracing by integrating PPEM with Grafana Tempo.

Important

Grafana Tempo is used as an example to demonstrate the integration process. You can select any other supported trace storage based on your organization's requirements.

Within this integration, PPEM sends tracing data using OTLP via HTTP to Grafana Tempo for storing and processing. If required, tracing data is then sent to the Grafana visualization system to be represented in the form of graphs.

Before performing this instruction, install and set up Grafana and Grafana Tempo. For more information, refer to the official Grafana and Grafana Tempo documentation.

To integrate PPEM with Grafana Tempo:

  1. Configure Grafana Tempo to receive tracing data.

    In the Grafana Tempo configuration file, specify:

    distributor:
        receivers:
            otlp:
                protocols:
                    http:
                      endpoint: "receiver_endpoint_URL"
    

    Where endpoint is the endpoint URL of the tracing data receiver, for example, 0.0.0.0:4318.

  2. Configure the manager and agents to export tracing data.

    In the ppem-manager.yml manager and ppem-agent.yml agent configuration files, specify:

    otlp:
      traces:
        exporter:
          protocol: "http"
          endpoint_url: "exporter_endpoint_URL"
    

    Where endpoint_url is the endpoint URL of the tracing data exporter, for example, http://tempo.example.org:4318/v1/traces.

  3. Configure Grafana to work with Grafana Tempo:

    1. Go to HomeConnectionsData sources.

    2. Click Add new data source.

    3. From Data source type, select Tempo.

    4. Enter the data source name, for example, tempo-1.

    5. In Connection URL, enter the endpoint URL of the tracing data exporter, for example, http://tempo.example.org.

    6. (Optional) To view the list of traces:

      1. Go to HomeExplore.

      2. Select the previously created data source.