Documentationbreadcrumb arrow Grafana Cloudbreadcrumb arrow AI and machine learningbreadcrumb arrow Grafana AI Observabilitybreadcrumb arrow Get startedbreadcrumb arrow Grafana Cloud
Grafana Cloud

Use AI Observability on Grafana Cloud

Grafana Cloud provides a managed AI Observability deployment. You enable the plugin, configure your SDK to point at the Cloud endpoint, and start sending data.

Note

AI Observability is referred to as “Sigil” in SDKs, package names, and configuration. For example, the Python package is sigil-sdk and environment variables use the SIGIL_ prefix.

Before you begin

  • A Grafana Cloud account. If you don’t have one, sign up at grafana.com.
  • Administrator access to your Grafana Cloud stack.

Enable the plugin

An administrator must enable the plugin for your stack:

  1. Sign in to Grafana Cloud as an administrator.
  2. Navigate to Observability > AI Observability.
  3. Review and accept the terms.
  4. Click Save.

After you enable the plugin, AI Observability is available under Observability in the left sidebar.

Get your endpoint credentials

You need your Cloud endpoint URL, instance ID, and API key to configure your SDK.

  1. In the AI Observability plugin, navigate to Configuration.
  2. Note the API URL — this is your CLOUD_ENDPOINT.
  3. Note the Instance ID — this is your INSTANCE_ID.
  4. Create a Grafana Cloud API key with AI Observability write permissions — this is your API_KEY.

Configure your SDK

Point your SDK at the Cloud endpoint using basic auth. For example, in Python:

Python 
from sigil_sdk import Client, ClientConfig
from sigil_sdk.config import GenerationExportConfig, AuthConfig

client = Client(
    ClientConfig(
        generation_export=GenerationExportConfig(
            protocol="http",
            endpoint="<CLOUD_ENDPOINT>/api/v1/generations:export",
            auth=AuthConfig(
                mode="basic",
                tenant_id="<INSTANCE_ID>",
                basic_password="<API_KEY>",
            ),
        ),
    )
)

Replace CLOUD_ENDPOINT, INSTANCE_ID, and API_KEY with the values from your stack.

Verify data

Run your instrumented agent and open Conversations in the AI Observability plugin. Your first generation should appear within a few seconds.

Try the demo

If you want to explore AI Observability before instrumenting your own agent, seed the built-in demo data:

  1. Navigate to Observability > AI Observability.
  2. On the onboarding screen, click One-click demo.

AI Observability seeds sample conversations, agents, and evaluation rules so you can explore every feature immediately. Demo resources display a demo badge throughout the UI.

Next steps