← Cloudflare Workers / workers / observability / exporting-opentelemetry-data

Экспорт в Grafana Cloud

Grafana Cloud представляет собой полностью управляемую платформу наблюдаемости, которая предоставляет визуализацию, оповещения и аналитику ваших данных телеметрии. Экспортируя телеметрию Cloudflare Workers в Grafana Cloud, вы сможете:

• Визуализируйте распределённые трассировки в Grafana Tempo чтобы понимать потоки запросов и узкие места производительности
• Запрашивайте и анализируйте журналы в Grafana Loki вместе с вашими трейсами

Это руководство поможет настроить Cloudflare Workers для экспорта трасс и журналов, совместимых с OpenTelemetry, в стек Grafana Cloud.

Прежде чем начать, убедитесь, что у вас есть:

• Активный аккаунт Grafana Cloud ↗ (доступен бесплатный тариф)
• Развернутый Worker, который вы хотите отслеживать

1. Войдите в свой портал Grafana Cloud ↗
2. На домашней странице вашей организации перейдите к Соединения → Добавить новое подключение
3. Найдите "OpenTelemetry" и выберите OpenTelemetry (OTLP)
4. Выберите Быстрый старт затем выберите JavaScript
5. Нажмите Создайте новый токен
6. Введите имя токена (например, cloudflare-workers-otel) и нажмите создать токен
7. Нажмите на Закрыть без копирования токена
8. Скопируйте и сохраните значение для OTEL_EXPORTER_OTLP_ENDPOINT и OTEL_EXPORTER_OTLP_HEADERS в Environment variables блок кода в качестве конечной точки OTel и значения заголовка Auth соответственно

1. Перейдите в раздел аккаунта Cloudflare Workers Observability ↗ раздел
2. Нажмите Добавить назначение и укажите имя назначения (например, grafana-tracing)
3. В Grafana скопируйте эндпоинт Otel, заголовок авторизации и значение авторизации

• Ваш OTEL endpoint будет выглядеть примерно так: https://otlp-gateway-prod-us-east-2.grafana.net/otlp (добавьте /v1/traces для трассировок и /v1/logs для логов)
• Ваш пользовательский заголовок должен включать:
  • Имя вашего заголовка авторизации Authorization
  • Значение вашего заголовка авторизации Basic MTMxxx...

Создав destination в Cloudflare dashboard, обновите конфигурацию Worker, чтобы включить экспорт телеметрии.

{
  "observability": {
    "traces": {
      "enabled": true,
      // Must match the destination name in the dashboard
      "destinations": ["grafana-traces"]
    },
    "logs": {
      "enabled": true,
      // Must match the destination name in the dashboard
      "destinations": ["grafana-logs"]
    }
  }
}

[observability.traces]
enabled = true
destinations = [ "grafana-traces" ]

[observability.logs]
enabled = true
destinations = [ "grafana-logs" ]

После обновления конфигурации разверните Worker, чтобы изменения вступили в силу.