> ## Documentation Index
> Fetch the complete documentation index at: https://www.traceloop.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# LLM Observability with Grafana and OpenLLMetry

First, go to the Grafana Cloud account page under `https://grafana.com/orgs/<your org name>`,
and click on **Send Traces** under Tempo. In **Grafana Data Source settings**,
note the `URL` value. Click **Generate now** to generate an API key and copy it.
Note also the `Stack ID` value (you can find it in the URL `https://grafana.com/orgs/<Your Org Name>/stacks/<Stack ID>`).

## With Grafana Agent

Make sure you have an agent installed and running in your cluster.
The host to target your traces is constructed is the hostname of the `URL` noted above, without the `https://` and the trailing `/tempo`.

Add this to the configuration of your agent:

```yaml theme={null}
traces:
  configs:
    - name: default
      remote_write:
        - endpoint: <Grafana Hostname>:443
          basic_auth:
            username: <Stack ID from Grafana Cloud>
            password: <Grafana Cloud API Token>
      receivers:
        otlp:
          protocols:
            grpc:
```

<Warning>
  Note the endpoint. The URL you need to use is without `https` and the trailing
  `/`. So `https://tempo-us-central1.grafana.net/tempo` should be used as
  `tempo-us-central1.grafana.net:443`.
</Warning>

Set this as an environment variable in your app:

```bash theme={null}
TRACELOOP_BASE_URL=<grafana-agent-hostname>:4317
```

## Without Grafana Agent

Grafana cloud currently only supports sending traces to some of its regions.
Before you begin, [check out this list](https://grafana.com/docs/grafana-cloud/monitor-infrastructure/otlp/send-data-otlp/)
and make sure your region is supported.

In a terminal, type:

```bash theme={null}
echo -n "<your stack id>:<your api key>" | base64
```

Note the result which is a base64 encoding of your user id and api key.

The URL you'll use as the destination for the traces depends on your region/zone. For example, for AWS US Central this will be `prod-us-central-0`.
See [here](https://grafana.com/docs/grafana-cloud/monitor-infrastructure/otlp/send-data-otlp/#before-you-begin) for the names of the zones you should use below.

Then, you can set the following environment variables when running your app with Traceloop SDK installed:

```bash theme={null}
TRACELOOP_BASE_URL=https://otlp-gateway-<zone>.grafana.net/otlp
TRACELOOP_HEADERS="Authorization=Basic%20<base64 encoded stack id and api key>"
```