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

Export do Honeycomb

Honeycomb je observabilní platforma určená pro data s vysokou kardinalitou, která vám pomáhá porozumět vašim aplikacím a ladit je. Exportem telemetrie vaší aplikace Cloudflare Workers do Honeycomb získáte možnost:

• Vizualizujte trasování a pochopte tok požadavků a odhalte úzká místa výkonu
• Dotazujte a analyzujte logy s neomezenou dimenzionalitou napříč libovolným atributem
• Vytváření vlastních dotazů a dashboardů pro sledování Workers

Tento průvodce vás provede konfigurací vaší aplikace Cloudflare Worker tak, aby exportovala trasovací data a protokoly kompatibilní s OpenTelemetry do Honeycomb.

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

• Aktivní Účet Honeycomb ↗ (k dispozici je bezplatná úroveň)
• Nasazený Worker, který chcete sledovat

1. Přihlaste se ke svému Účet Honeycomb ↗
2. Do nastavení účtu přejdete kliknutím na ikonu profilu vpravo nahoře
3. Vyberte Team Settings
4. V levém postranním panelu klikněte na Prostředí a klikněte na ikonu ozubeného kola
5. Najděte své prostředí (např., production, test) nebo vytvořte nový
6. V části API Keys, klikněte na Create Ingest API Key
7. Nakonfigurujte svůj API klíč:
   • Název: Zadejte popisný název (např. cloudflare-workers-otel)
   • Oprávnění: Vyberte Může vytvářet služby/datové sady (povinné pro příjem OTLP)
8. Klikněte na Vytvořit
9. Důležité: Zkopírujte API klíč ihned a uložte ho na bezpečné místo, protože ho už znovu neuvidíte

Klíč API bude vypadat nějak takto: hcaik_01hq...

Nyní v Cloudflare dashboardu vytvoříte cíle, které směřují do Honeycomb.

Honeycomb poskytuje samostatné koncové body OTLP pro trasování a protokoly:

• Trasování: https://api.honeycomb.io/v1/traces
• Protokoly: https://api.honeycomb.io/v1/logs

1. Přejděte do svého účtu Cloudflare Workers Observability ↗ sekce
2. Klikněte na Přidat cíl
3. Nakonfigurujte cíl svého trasování:
   • Název cíle: honeycomb-traces (nebo jakýkoli popisný název)
   • Typ cíle: Vyberte Trasování
   • OTLP Endpoint: https://api.honeycomb.io/v1/traces
   • Vlastní hlavičky: Přidejte autentizační hlavičku:
     • Název hlavičky: x-honeycomb-team
     • Hodnota hlavičky: váš API klíč Honeycomb (např. hcaik_01hq...)
4. Klikněte na Save

Stejný postup zopakujte pro logy:

1. Klikněte na Přidat cíl znovu
2. Nakonfigurujte cíl svých logů:
   • Název cíle: honeycomb-logs (nebo jakýkoli popisný název)
   • Typ cíle: Vyberte Protokoly
   • OTLP Endpoint: https://api.honeycomb.io/v1/logs
   • Vlastní hlavičky: Přidejte autentizační hlavičku:
     • Název hlavičky: x-honeycomb-team
     • Hodnota hlavičky: váš API klíč Honeycomb (stejný jako výše)
3. Klikněte na Save

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": ["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" ]

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