OpenTelemetry

NoSpamProxy unterstützt den Export von Telemetriedaten über OpenTelemetry. OpenTelemetry ist ein offener Standard zur Erfassung und Weitergabe von Metriken, Traces und weiteren Diagnosedaten. Dadurch können Betriebsdaten von NoSpamProxy in externe Monitoring- und Observability-Plattformen integriert werden. Zur Übertragung nutzt OpenTelemetry das OpenTelemetry Protocol (OTLP).

Eine typische OpenTelemetry-Architektur besteht aus drei Komponenten:

NoSpamProxy
     │
     │ OTLP
     ▼
OpenTelemetry Collector
     │
     ├── Grafana
     ├── Prometheus
     ├── Azure Monitor
     ├── Datadog
     └── weitere Systeme

NoSpamProxy sendet seine Telemetriedaten an einen OpenTelemetry Collector. Der Collector verarbeitet die Daten und leitet sie an die gewünschte Monitoring-Plattform weiter. Der Einsatz eines Collectors wird von OpenTelemetry ausdrücklich empfohlen.

OpenTelemetry in NoSpamProxy aktivieren

NoSpamProxy exportiert Telemetriedaten nur, wenn ein OpenTelemetry-Endpunkt konfiguriert wurde. Die Konfiguration erfolgt über Systemumgebungsvariablen in Windows.

HINWEIS: Konfigurieren Sie die erforderlichen OpenTelemetry-Systemumgebungsvariablen auf allen Systemen, auf denen NoSpamProxy-Komponenten ausgeführt werden, die Telemetriedaten exportieren sollen.

Allgemeiner OTLP-Endpunkt

OTEL_EXPORTER_OTLP_ENDPOINT

Über diese Variable wird ein gemeinsamer Endpunkt für alle OpenTelemetry-Signale definiert. Dazu gehören beispielsweise Metriken und Traces.

OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4317

Separate Endpunkte

NoSpamProxy unterstützt außerdem die von OpenTelemetry definierten Umgebungsvariablen für separate Endpunkte.

OTEL_EXPORTER_OTLP_TRACES_ENDPOINT

OTEL_EXPORTER_OTLP_METRICS_ENDPOINT

OTEL_EXPORTER_OTLP_LOGS_ENDPOINT

Durch die Nutzung von separaten Endpunkten können Sie Traces, Metriken und Logs an verschiedene Endpunkte senden.

OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=http://tempo:4317

OTEL_EXPORTER_OTLP_METRICS_ENDPOINT=http://prometheus-gateway:4317

OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=http://loki:4317

TIP: In den meisten Umgebungen reicht die Verwendung eines einzigen gemeinsamen Endpunkts.

HINWEIS: Sollten sowohl ein allgemeiner als auch spezifische Endpunkte konfiguriert sein, so haben die spezifischen Endpunkte Priorität. Weitere Informationen zu Endpunkten finden Sie in der OpenTelemetry-Dokumentation.

Protokoll und Standardport

NoSpamProxy verwendet für OpenTelemetry das Protokoll OTLP/HTTP und nutzt den Port 4318. OTLP/HTTP verwendet standardmäßig Port 4318. Wird kein abweichender Port angegeben, erwartet NoSpamProxy einen OTLP/HTTP-Endpunkt auf diesem Port.

NoSpamProxy unterstützt bei der OpenTelemetry-Kommunikation grundsätzlich HTTPS, falls der angesprochene Server dies anbietet.

Was ist OTLP?

OTLP (OpenTelemetry Protocol) ist das standardisierte Übertragungsprotokoll von OpenTelemetry. Es wird verwendet, um Telemetriedaten wie Metriken, Traces und Logs von Anwendungen an einen OpenTelemetry Collector oder ein anderes OpenTelemetry-kompatibles Zielsystem zu senden.

Was ist ein OpenTelemetry Collector?

Der OpenTelemetry Collector ist ein eigenständiger Dienst zum Empfang, zur Verarbeitung und zur Weiterleitung von Telemetriedaten. Er dient als zentrale Sammelstelle zwischen Anwendungen und den eigentlichen Monitoring-Systemen.

Ein OpenTelemetry Collector bietet die folgenden Vorteile:

• Er fungiert als zentrale Verwaltungsstelle für Telemetriedaten.

• Er ermöglicht

  • die Weiterleitung an mehrere Zielsysteme,

  • Pufferung und Wiederholungsversuche bei Netzwerkausfällen,

  • die Filterung oder Anreicherung von Daten sowie

  • die einfache Anpassung der Monitoring-Infrastruktur ohne Änderungen an NoSpamProxy.

TIP: Weitere Informationen zu OpenTelemetry Collectors finden Sie in der OpenTelemetry-Dokumentation.