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

# Grafana Cloud Loki

> Configuring the Grafana Cloud Loki backend (Managed)

### Getting Started

<img src="https://d15jtxgb40qetw.cloudfront.net/grafana.svg" alt="grafanacloudloki" className="not-prose h-20" />

<Note>
  These instructions are for the Grafana Cloud **managed** Loki service. If you run a self hosted Loki instance, please follow the instructions on the [Loki](../backends/loki) page.
</Note>

You can use Grafana Cloud managed service as a backend for Odigos to store your logs, metrics, and traces. This page describes how to configure Odigos to use Grafana Cloud Loki as a **logs** backend.

All the connection details can be found at [grafana.com](https://grafana.com) under **My Account**

<Frame>
  <img src="https://mintcdn.com/odigos/pHE1teVWLrD8x6Wa/snippets/shared/backends/images/grafanacloud1.png?fit=max&auto=format&n=pHE1teVWLrD8x6Wa&q=85&s=1e83df72b7b02521187f810d913bbd5f" alt="Grafana labs website" width="1248" height="65" data-path="snippets/shared/backends/images/grafanacloud1.png" />
</Frame>

Then, under the "GRAFANA CLOUD" title, select your Grafana Stuck, browser to the "Loki" card and click "Send Logs"

<Frame>
  <img src="https://mintcdn.com/odigos/pHE1teVWLrD8x6Wa/snippets/shared/backends/images/grafanacloud2.png?fit=max&auto=format&n=pHE1teVWLrD8x6Wa&q=85&s=1c379a219e7e4e9ad698f8fb2f70d815" alt="Loki managed service configuration" width="516" height="203" data-path="snippets/shared/backends/images/grafanacloud2.png" />
</Frame>

**Loki Labels**

Read about setting grafana loki labels in the [Loki](../backends/loki#loki-labels) page.

### Configuring Destination Fields

<Accordion title="Supported Signals:">
  ❌ Traces
  ❌ Metrics
  ✅ Logs
  ❌ Profiles
</Accordion>

* **GRAFANA\_CLOUD\_LOKI\_ENDPOINT** `string` : Endpoint. The endpoint of your Grafana Cloud Loki instance
  * This field is required
  * Example: `https://logs-prod-{REGION/SHARD}.grafana.net/otlp`
* **GRAFANA\_CLOUD\_LOKI\_USERNAME** `string` : Username. You can find the loki username in the "Grafana Data Source settings" section as "User" value. The username is a number.
  * This field is required
  * Example: `1234567`
* **GRAFANA\_CLOUD\_LOKI\_PASSWORD** `string` : Password (Api Token). This field is refered to as "password" or "Grafana.com API Token" in the Grafana Cloud UI. You can manage tokens in your "Account Settings" page under the "SECURITY" section in the "Access Policies" page. Make sure your token scope includes `logs:write` scope
  * This field is required
  * Example: `glc_eyJvIj...`
* **GRAFANA\_CLOUD\_LOKI\_LABELS** `string[]` : Labels. Use these OpenTelemetry resource attributes as Loki labels for each log record
  * This field is optional and defaults to `["k8s.container.name", "k8s.pod.name", "k8s.namespace.name"]`

<Info>
  The supported Loki version is V3. Please make sure you are using the correct version, and that you have enabled native OTLP support. As part of this version, the path `/loki/api/v1/push` has been deprecated and replaced with `/otlp`.
</Info>

### Adding Destination to Odigos

There are two primary methods for configuring destinations in Odigos:

##### **Using the UI**

<Steps>
  <Step>
    Use the [Odigos CLI](https://docs.odigos.io/cli/odigos_ui) to access the UI

    ```bash theme={null}
    odigos ui
    ```
  </Step>

  <Step>
    Click on `Add Destination`, select `Grafana Cloud Loki` and follow the on-screen instructions
  </Step>
</Steps>

##### **Using Kubernetes manifests**

<Steps>
  <Step>
    Save the YAML below to a file (e.g. `grafanacloudloki.yaml`)

    ```yaml theme={null}
    apiVersion: odigos.io/v1alpha1
    kind: Destination
    metadata:
      name: grafanacloudloki-example
      namespace: odigos-system
    spec:
      data:
        GRAFANA_CLOUD_LOKI_ENDPOINT: <Endpoint>
        GRAFANA_CLOUD_LOKI_USERNAME: <Username>
        # Note: The commented fields below are optional.
        # GRAFANA_CLOUD_LOKI_LABELS: <Labels (default: ["k8s.container.name", "k8s.pod.name", "k8s.namespace.name"])>
      destinationName: grafanacloudloki
      secretRef:
        name: grafanacloudloki-secret
      signals:
      - LOGS
      type: grafanacloudloki

    ---

    apiVersion: v1
    data:
      GRAFANA_CLOUD_LOKI_PASSWORD: <Base64 Password (Api Token)>
    kind: Secret
    metadata:
      name: grafanacloudloki-secret
      namespace: odigos-system
    type: Opaque
    ```
  </Step>

  <Step>
    Apply the YAML using `kubectl`

    ```bash theme={null}
    kubectl apply -f grafanacloudloki.yaml
    ```
  </Step>
</Steps>