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

Экспорт в Honeycomb

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

• Визуализируйте трассировки, чтобы понимать потоки запросов и находить узкие места производительности
• Запрашивайте и анализируйте журналы с неограниченной размерностью по любому атрибуту
• Создание собственных запросов и дашбордов для мониторинга Workers

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

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

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

1. Войдите в свой Аккаунт Honeycomb ↗
2. Перейдите в настройки аккаунта, нажав на значок профиля в правом верхнем углу
3. Выберите Team Settings
4. В левой боковой панели нажмите Окружения и нажмите на значок шестерёнки
5. Найдите своё окружение (например, production, test) или создайте новый
6. В разделе API Keys, нажмите Создать ключ Ingest API
7. Настройте свой API-ключ:
   • Название: Введите понятное название (например, cloudflare-workers-otel)
   • Разрешения: Выберите Может создавать сервисы и наборы данных (обязательно для приёма OTLP)
8. Нажмите Создание
9. Важно: Скопируйте API-ключ сразу же и сохраните его в надёжном месте. Повторно увидеть его будет невозможно

API-ключ будет выглядеть примерно так: hcaik_01hq...

Теперь вы создадите в панели управления Cloudflare назначения, которые указывают на Honeycomb.

Honeycomb предоставляет отдельные конечные точки OTLP для трассировок и логов:

• Трассировки: https://api.honeycomb.io/v1/traces
• Журналы: https://api.honeycomb.io/v1/logs

1. Перейдите в раздел аккаунта Cloudflare Workers Observability ↗ раздел
2. Нажмите Добавить назначение
3. Настройте назначение для трассировки:
   • Имя назначения: honeycomb-traces (или любое описательное имя)
   • Тип назначения: Выберите Трассировки
   • OTLP Endpoint: https://api.honeycomb.io/v1/traces
   • Пользовательские заголовки: Добавьте заголовок аутентификации:
     • Имя заголовка: x-honeycomb-team
     • Значение заголовка: ваш API-ключ Honeycomb (например, hcaik_01hq...)
4. Нажмите Save

Повторите этот процесс для логов:

1. Нажмите Добавить назначение снова
2. Настройте назначение для логов:
   • Имя назначения: honeycomb-logs (или любое описательное имя)
   • Тип назначения: Выберите Журналы
   • OTLP Endpoint: https://api.honeycomb.io/v1/logs
   • Пользовательские заголовки: Добавьте заголовок аутентификации:
     • Имя заголовка: x-honeycomb-team
     • Значение заголовка: ваш API-ключ Honeycomb (такой же, как указан выше)
3. Нажмите Save

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

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

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

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

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