Was macht sentry-otel-exporter-setup?
Konfigurieren Sie den OpenTelemetry Collector mit dem Sentry Exporter für Multi-Projekt-Routing und automatische Projekterstellung. Verwenden Sie dies beim Einrichten von OTel mit Sentry, beim Konfigurieren von Collector-Pipelines für Traces und Logs oder beim Routen von Telemetriedaten mehrerer Dienste zu Sentry-Projekten.
Übersicht
Dieses Skill erstellt Konfigurationsdateien für den OpenTelemetry Collector, die es ermöglichen, Telemetriedaten basierend auf dem Dienstnamen an verschiedene Sentry-Projekte weiterzuleiten. Es unterstützt die automatische Projekterstellung in Sentry für neue Dienste und die Verwaltung von Projekt-APIs und DSNs.
Voraussetzungen
- Ein Sentry-Konto mit Administratorzugriff
- Ein Sentry-Auth-Token mit der Berechtigung
project:write - OpenTelemetry Collector, der läuft oder bereit zur Konfiguration ist
Verwendung
1. Konfigurationsdatei erstellen
Erstellen Sie eine YAML-Datei (z. B. collector-config.yaml):
receivers:
otlp:
protocols:
grpc:
http:
exporters:
sentry:
dsn: https://[email protected]/123456
environment: production
traces_sample_rate: 1.0
processors:
batch:
service:
pipelines:
traces:
receivers: [otlp]
processors: [batch]
exporters: [sentry]
logs:
receivers: [otlp]
processors: [batch]
exporters: [sentry]
2. Projekte automatisch erstellen
Das Skill kann automatisch Sentry-Projekte für jeden neuen Dienstnamen erstellen. Setzen Sie dazu die Umgebungsvariable SENTRY_AUTH_TOKEN und konfigurieren Sie die Projektzuordnung:
exporters:
sentry:
dsn: https://[email protected]/123456
# Mapping von Dienstname zu Sentry-Projekt
projects:
service-a: project-a
service-b: project-b
# Automatische Projekterstellung aktivieren
auto_create_project: true
3. Multi-Projekt-Routing
Um Telemetriedaten verschiedener Dienste an unterschiedliche Sentry-Projekte weiterzuleiten, konfigurieren Sie die Routing-Regeln:
exporters:
sentry:
dsn: https://[email protected]/123456
routing:
rules:
- service: service-*
project: project-{namespace}
Konfigurationsoptionen
| Option | Beschreibung | Standard |
|---|---|---|
dsn | Sentry DSN für die Verbindung | Erforderlich |
environment | Umgebung (z. B. production, staging) | "" |
traces_sample_rate | Sampling-Rate für Traces (0.0 - 1.0) | 1.0 |
projects | Mapping von Dienstname zu Sentry-Projekt | {} |
auto_create_project | Neue Projekte automatisch erstellen | false |
routing | Routing-Regeln für Multi-Projekt | [] |
Beispiel mit HCL
Das Skill unterstützt auch HCL-Konfiguration:
exporter "sentry" "default" {
dsn = "https://[email protected]/123456"
environment = "production"
traces_sample_rate = 0.5
}
Fehlerbehandlung
- Wenn ein Auth-Token fehlt, wird beim Erstellen eines neuen Projekts ein Fehler angezeigt.
- Wenn ein DSN ungültig ist, werden keine Daten gesendet.
- Routing-Regeln, die nicht zu einem existierenden Projekt führen, werden ignoriert.
Limitierungen
- Automatische Projekterstellung funktioniert nur, wenn ein gültiges Auth-Token gesetzt ist.
- Jeder OpenTelemetry Collector kann nur eine einzige Konfiguration für den Sentry Exporter haben.
- Das Skill unterstützt keine Kubernetes-spezifischen Konfigurationen.
Weitere Informationen
Lizenz
MIT