ThingWorx Beobachtbarkeit > OpenTelemetry-Unterstützung für die Protokollierung in ThingWorx Platform > OpenTelemetry-Konfiguration für die Protokollierung
OpenTelemetry-Konfiguration für die Protokollierung
Die folgenden OpenTelemetry-Konfigurationseinstellungen sind im Abschnitt BasicSettings der Datei platform-settings.json verfügbar.
Einstellung
Typ
Standardwert
Beschreibung
EnableOpenTelemetryForLogging
BOOLEAN
false
Legen Sie den Wert auf true fest, um den OpenTelemetry Collector zu aktivieren.
Wenn der ThingWorx Platform Server gestartet wird, stellt der OpenTelemetry Collector eine Verbindung mit dem ThingWorx Platform Server her.
DisableFileLogging
BOOLEAN
false
Wenn Sie diesen Wert auf true festlegen:
• Werden Protokolle nicht in den Ordner /ThingworxStorage/logs geschrieben.
• Werden Protokolle nicht auf der Seite Composer > Überwachung angezeigt.
• Wird die folgende Meldung auf der Seite Composer > Überwachung angezeigt:
Logging is disabled. Please refer to ThingWorx Platform configuration file to enable it.
Diese Einstellung beendet nur interne ThingWorx Protokolle. Über logback.xml konfigurierte Protokolle, z.B. externe Protokolle, funktionieren weiterhin.
Console logs und HTTP.out-Protokolle sind davon nicht betroffen und funktionieren weiterhin.
Wenn DisableFileLogging auf true und EnableOpenTelemetryForLogging auf false festgelegt ist:
• Wird die folgende Meldung auf der Seite Composer > Überwachung angezeigt:
Logging is disabled. Please refer to platform configuration file to enable it.
• Die Protokollabruf-Strategie wird auf DefaultLogRetrievalStrategy festgelegt.
Wenn DisableFileLogging auf false und EnableOpenTelemetryForLogging auf true festgelegt ist, sind Protokolle in ThingWorx Protokolldateien in der Plattform und der Drittanbieter-Software verfügbar, in die OpenTelemetry integriert ist.
OpenTelemetry SDK-Konfiguration
Die folgenden OpenTelemetry-Konfigurationseinstellungen sind im Abschnitt OpenTelemetrySettings der Datei platform-settings.json verfügbar.
Einstellung
Standardwert
Beschreibung
BatchLogProcessorMaxQueueSize
2048
Die maximale Anzahl von Protokolldatensätzen, die vor der Verarbeitung und dem Export in die Warteschlange gestellt werden können. Größere Werte erhöhen den Durchsatz, erfordern jedoch mehr Arbeitsspeicher.
BatchLogProcessorScheduledDelay
10 Millisekunden
Die Anzahl der Millisekunden, die der Prozessor wartet, bevor er einen neuen Batch von Protokollen exportiert, selbst wenn der Batch nicht voll ist.
BatchLogProcessorMaxExportBatchSize
512
Die maximale Anzahl von Protokolleinträgen, die in einem einzelnen Export-Batch gesendet werden. Diese Einstellung ist für die Steuerung der Payload-Größe und Netzwerknutzung hilfreich.
BatchLogProcessorExportTimeout
1000 Millisekunden
Die Anzahl der Millisekunden, die das System auf den Abschluss einer Protokollexportanforderung wartet, bevor es zu einem Timeout kommt.
OtlpGRPCLogExporterEndpoint
Die OTLP-gRPC-Endpunkt-URL, an die ThingWorx Platform Protokolle exportiert (z.B. http://localhost:4317). Erforderlich für die Remote-Protokollerfassung über den OpenTelemetry Collector oder ein beliebiges OTLP-gRPC-kompatibles Backend.
OtlpGRPCEnableSSL
false
Ermöglicht es Ihnen, SSL/TLS für den OTLP-gRPC-Protokollexport zu aktivieren oder zu deaktivieren.
• true
– verwendet eine sichere Übertragung
• false – verwendet Nur-Text
OtlpGRPCTrustStorePath
Nicht verfügbar
Der Pfad zur Vertrauensspeicher-Datei, die vertrauenswürdige Zertifikate für die Validierung des OpenTelemetry Collector oder des Ziel-Backends während der SSL-Kommunikation enthält.
OtlpGRPCTrustStorePassword
Nicht verfügbar
Passwort für den Zugriff auf den in OtlpGRPCTrustStorePath konfigurierten Vertrauensspeicher.
OtlpGRPCKeyStorePath
Nicht verfügbar
Der Pfad zur Keystore-Datei, die das Client-Zertifikat und den privaten Schlüssel für Mutual TLS (mTLS) enthält.
OtlpGRPCKeyStorePassword
Nicht verfügbar
Passwort für den Zugriff auf den in OtlpGRPCKeyStorePath konfigurierten Keystore.
RetryOtlpGRPCLogExporterMaxAttempts
5
Die maximale Anzahl von Wiederholungsversuchen, wenn der Protokollexport aufgrund transienter Fehler fehlschlägt.
RetryOtlpGRPCLogExporterBackOffMultiplier
1.5
Der Multiplikator, der zur Berechnung des exponentialen Backoffs verwendet wird. Nach jedem fehlgeschlagenen Versuch des Datenexports verlängert sich die Wartezeit um diesen Faktor.
RetryOtlpGRPCLogExporterInitialBackOff
1 Sekunde
Die Zeit in Sekunden bis zum ersten Wiederholungsversuch.
RetryOtlpGRPCLogExporterMaxBackOff
5 Sekunden
Die Anzahl von Sekunden zwischen Wiederholungsversuchen während des exponentialen Backoffs.
OtlpGRPCMetricExporterEndpoint
Nicht verfügbar
Die OTLP-gRPC-Endpunkt-URL, an die ThingWorx Platform Metriken exportiert (z.B. http://localhost:4317). Diese URL ist für die Erfassung von Metriken über den OpenTelemetry Collector oder ein OTLP-gRPC-kompatibles Backend erforderlich.
EnableOpenTelemetryInternalMetrics
true
Aktiviert das Senden von Metriken an die Beobachtbarkeitsplattform über den OpenTelemetry Collector.
Zugehörige Themen
War dies hilfreich?