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

Экспорт в Sentry

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

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

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

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

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

Если у вас ещё нет проекта Sentry для отправки данных, потребуется его создать, чтобы начать отправку телеметрии приложения Cloudflare Workers в Sentry.

1. Войдите в свой Учетная запись Sentry ↗
2. В боковой панели навигации откройте раздел Insights > Projects, чтобы увидеть список своих проектов.
3. Нажмите New Project ↗
4. Заполните форму создания проекта и нажмите Создать проект чтобы завершить процесс.

Sentry предоставляет отдельные конечные точки OTLP для трассировок и логов, которые можно использовать для отправки телеметрии в Sentry.

• Трассировки: https://{HOST}/api/{PROJECT_ID}/integration/otlp/v1/traces
• Журналы: https://{HOST}/api/{PROJECT_ID}/integration/otlp/v1/logs

Конечные точки OTLP можно найти в настройках проекта.

1. Перейдите в Settings > Projects ↗ странице в Sentry.
2. Выберите свой проект из списка и нажмите на его название, чтобы открыть настройки проекта.
3. Перейдите на подстраницу «Client Keys (DSN)» этого проекта в разделе «SDK Setup».

Там вы найдёте эндпоинты OTLP logs и OTLP traces вашего проекта Sentry, а также заголовки аутентификации для этих эндпоинтов. Обязательно скопируйте эндпоинты и заголовки аутентификации.

Подробнее о том, как использовать конечные точки OTLP Sentry, см. в Документация Sentry по OTLP ↗.

Чтобы настроить назначение в дашборде Cloudflare, откройте в своей учётной записи Cloudflare раздел Workers Observability ↗ раздел. Затем нажмите Добавить назначение и настройте назначение для трассировок или логов.

Чтобы настроить назначение для трейсов, нажмите Добавить назначение и настройте следующее:

• Имя назначения: sentry-traces (или любое описательное имя)
• Тип назначения: Выберите Трассировки
• OTLP Endpoint: Конечная точка трассировок Sentry OTLP (например, https://{HOST}/api/{PROJECT_ID}/integration/otlp/v1/traces)
• Пользовательские заголовки: Добавьте заголовок аутентификации Sentry:
  • Имя заголовка: x-sentry-auth
  • Значение заголовка: sentry sentry_key={SENTRY_PUBLIC_KEY} где {SENTRY_PUBLIC_KEY} это открытый ключ вашего проекта Sentry

Чтобы настроить назначение для логов, нажмите Добавить назначение и настройте следующее:

• Имя назначения: sentry-logs (или любое описательное имя)
• Тип назначения: Выберите Журналы
• OTLP Endpoint: Конечная точка логов Sentry OTLP (например, https://{HOST}/api/{PROJECT_ID}/integration/otlp/v1/logs)
• Пользовательские заголовки: Добавьте заголовок аутентификации Sentry:
  • Имя заголовка: x-sentry-auth
  • Значение заголовка: sentry sentry_key={SENTRY_PUBLIC_KEY} где {SENTRY_PUBLIC_KEY} это открытый ключ вашего проекта Sentry

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

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

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

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

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