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

Экспорт в Axiom

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

• Храните журналы и трассировки и выполняйте запросы к ним в большом масштабе
• Создание дашбордов и оповещений для мониторинга Workers

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

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

• Активный Учётная запись Axiom ↗ (доступен бесплатный тариф)
• Развернутый Worker, который вы хотите отслеживать
• Набор данных Axiom, в который отправляются данные

Если у вас ещё нет набора данных для отправки:

1. Войдите в свой Учётная запись Axiom ↗
2. Перейдите в Наборы данных в левой боковой панели
3. Нажмите New Dataset
4. Введите имя (например, cloudflare-workers-otel)
5. Нажмите Создать набор данных

1. Перейдите в Настройки в левой боковой панели
2. Нажмите на API-токены
3. Нажмите Создать API-токен
4. Настройте свой API-токен:
   • Название: Введите понятное название (например, cloudflare-workers-otel)
   • Разрешения: Выберите Приём разрешение (требуется для отправки данных телеметрии)
   • Наборы данных: Выберите наборы данных, в которые сможет записывать этот токен, либо выберите All Datasets
5. Нажмите Создание
6. Важно: Скопируйте API-токен сразу же и сохраните его в надёжном месте. Повторно увидеть его будет невозможно

API-токен будет выглядеть примерно так: xaat-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

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

Axiom предоставляет отдельные конечные точки OTLP для трассировок и журналов:

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

1. Перейдите в раздел аккаунта Cloudflare Workers Observability ↗ раздел
2. Нажмите Добавить назначение
3. Настройте назначение для трассировки:
   • Имя назначения: axiom-traces (или любое описательное имя)
   • Тип назначения: Выберите Трассировки
   • OTLP Endpoint: https://api.axiom.co/v1/traces (или /v1/logs)
   • Пользовательские заголовки: Добавьте два обязательных заголовка:
     • Заголовок аутентификации
       • Имя заголовка: Authorization
       • Значение заголовка: Bearer <your-api-token>
     • Заголовок набора данных:
       • Имя заголовка: X-Axiom-Dataset
       • Значение заголовка: имя вашего датасета (например, cloudflare-workers-otel)
4. Нажмите Save

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

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

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

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

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