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

Export do Axiom

Axiom je bezserverová platforma pro analýzu protokolů, která pomáhá ukládat, vyhledávat a analyzovat obrovské množství dat. Když exportujete telemetrii své aplikace Cloudflare Workers do Axiomu, můžete:

• Ukládejte a dotazujte logy a trasování ve velkém měřítku
• Vytváření dashboardů a upozornění pro sledování Workers

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

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

• Aktivní Účet Axiom ↗ (k dispozici je bezplatná úroveň)
• Nasazený Worker, který chcete sledovat
• Dataset Axiom, do kterého se mají odesílat data

Pokud ještě nemáte dataset, kam by se data odesílala:

1. Přihlaste se ke svému Účet Axiom ↗
2. Přejděte na Datové sady v levém postranním panelu
3. Klikněte na Nový dataset
4. Zadejte název (například cloudflare-workers-otel)
5. Klikněte na Create Dataset

1. Přejděte na Nastavení v levém postranním panelu
2. Klikněte na API Tokens
3. Klikněte na Create API Token
4. Nakonfigurujte svůj API token:
   • Název: Zadejte popisný název (např. cloudflare-workers-otel)
   • Oprávnění: Vyberte Ingest oprávnění (vyžadováno pro odesílání telemetrických dat)
   • Datové sady: Vyberte, do kterých datových sad může tento token zapisovat, nebo vyberte All Datasets
5. Klikněte na Vytvořit
6. Důležité: Zkopírujte API token ihned a uložte ho na bezpečné místo, protože ho už znovu neuvidíte

Token API bude vypadat nějak takto: xaat-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

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

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

• Trasování: https://api.axiom.co/v1/traces
• Protokoly: https://api.axiom.co/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: axiom-traces (nebo jakýkoli popisný název)
   • Typ cíle: Vyberte Trasování
   • OTLP Endpoint: https://api.axiom.co/v1/traces (nebo /v1/logs)
   • Vlastní hlavičky: Přidejte dvě povinné hlavičky:
     • Ověřovací hlavička
       • Název hlavičky: Authorization
       • Hodnota hlavičky: Bearer <your-api-token>
     • Záhlaví datové sady:
       • Název hlavičky: X-Axiom-Dataset
       • Hodnota hlavičky: Název vašeho datasetu (např. cloudflare-workers-otel)
4. 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": ["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" ]

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