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

Export do Sentry

Sentry je nástroj pro monitoring softwaru, který vývojářům pomáhá odhalovat a ladit problémy s výkonem a chyby. Od distribuovaného trasování až po monitoring výkonu poskytuje Sentry pozorovatelnost na úrovni kódu, díky které snadno diagnostikujete problémy a průběžně sledujete stav kódu vaší aplikace napříč systémy a službami. Exportem telemetrie vaší aplikace Cloudflare Workers do Sentry můžete:

• Dotazování logů a trasovacích záznamů v Sentry
• Vytváření vlastních upozornění a dashboardů pro sledování Workers

Tento průvodce vás provede exportem trasovacích dat a protokolů kompatibilních s OpenTelemetry do Sentry z vaší aplikace Cloudflare Worker

Než začnete, ujistěte se, že máte:

• Mají zaregistrovaný účet Sentry ↗ (k dispozici je bezplatná úroveň)
• Nasazený Worker, který chcete sledovat

Pokud ještě nemáte projekt Sentry, kam by se data odesílala, budete si muset jeden vytvořit, abyste mohli začít odesílat telemetrii aplikace Cloudflare Workers do Sentry.

1. Přihlaste se ke svému účet Sentry ↗
2. Přejděte na Insights > Projects v postranním navigačním panelu. Otevře se tím seznam vašich projektů.
3. Klikněte na Nový projekt ↗
4. Vyplňte formulář pro vytvoření projektu a klikněte na Create Project pro dokončení procesu.

Sentry poskytuje samostatné koncové body OTLP pro trasování a protokoly, které můžete použít k odesílání telemetrických dat do Sentry.

• Trasování: https://{HOST}/api/{PROJECT_ID}/integration/otlp/v1/traces
• Protokoly: https://{HOST}/api/{PROJECT_ID}/integration/otlp/v1/logs

Své OTLP koncové body najdete v nastavení projektu.

1. Přejděte na Settings > Projects ↗ stránku v Sentry.
2. Vyberte svůj projekt ze seznamu a kliknutím na název projektu otevřete jeho nastavení.
3. Přejděte na podstránku „Client Keys (DSN)“ tohoto projektu v sekci „SDK Setup“.

Tam najdete koncové body OTLP logs a OTLP traces vašeho projektu Sentry, stejně jako autentizační hlavičky pro tyto koncové body. Nezapomeňte si koncové body a autentizační hlavičky zkopírovat.

Podrobnosti o použití OTLP endpointů Sentry najdete v Dokumentace OTLP od Sentry ↗.

Chcete-li v Cloudflare dashboardu nastavit cíl, přejděte v rámci svého účtu Cloudflare do Workers Observability ↗ sekce. Poté klikněte na Přidat cíl a nakonfigurujte cíl pro trasování nebo protokoly.

Chcete-li nakonfigurovat cíl trasování, klikněte na Přidat cíl a nakonfigurujte následující:

• Název cíle: sentry-traces (nebo jakýkoli popisný název)
• Typ cíle: Vyberte Trasování
• OTLP Endpoint: Váš koncový bod trasování Sentry OTLP (např. https://{HOST}/api/{PROJECT_ID}/integration/otlp/v1/traces)
• Vlastní hlavičky: Přidejte autentizační hlavičku Sentry:
  • Název hlavičky: x-sentry-auth
  • Hodnota hlavičky: sentry sentry_key={SENTRY_PUBLIC_KEY} kde {SENTRY_PUBLIC_KEY} je veřejný klíč vašeho projektu Sentry

Chcete-li nakonfigurovat cíl protokolů, klikněte na Přidat cíl a nakonfigurujte následující:

• Název cíle: sentry-logs (nebo jakýkoli popisný název)
• Typ cíle: Vyberte Protokoly
• OTLP Endpoint: Váš koncový bod protokolů Sentry OTLP (např. https://{HOST}/api/{PROJECT_ID}/integration/otlp/v1/logs)
• Vlastní hlavičky: Přidejte autentizační hlavičku Sentry:
  • Název hlavičky: x-sentry-auth
  • Hodnota hlavičky: sentry sentry_key={SENTRY_PUBLIC_KEY} kde {SENTRY_PUBLIC_KEY} je veřejný klíč vašeho projektu Sentry

Jakmile máte v Cloudflare dashboardu vytvořené destinations, upravte konfiguraci svého Workeru tak, aby povolila export telemetrie.

{
  "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" ]

Po úpravě konfigurace nasaďte Worker, aby se změny projevily.