Configurazione di OpenTelemetry per la registrazione
Le impostazioni di configurazione di OpenTelemetry riportate di seguito sono disponibili nella sezione BasicSettings del file platform-settings.json.
Impostazione
Tipo
Valore di default
Descrizione
EnableOpenTelemetryForLogging
BOOLEAN
false
Impostare il valore su true per attivare il raccoglitore OpenTelemetry.
All'avvio del server ThingWorx Platform, il raccoglitore OpenTelemetry stabilisce una connessione con il server ThingWorx Platform.
DisableFileLogging
BOOLEAN
false
Quando si imposta questo valore su true, si verifica quanto segue:
I log non vengono scritti nella cartella /ThingworxStorage/logs.
I log non vengono visualizzati nella pagina Composer > Monitoraggio.
Viene visualizzato il seguente messaggio nella pagina Composer > Monitoraggio:
Logging is disabled. Please refer to ThingWorx Platform configuration file to enable it.
Questa impostazione arresta solo i log ThingWorx interni. I log configurati tramite logback.xml, ad esempio i log esterni, continuano a funzionare.
I log Console logs e HTTP.out non sono interessati da questa impostazione e continuano a funzionare.
Se DisableFileLogging è impostato su true ed EnableOpenTelemetryForLogging è impostato su false, si verifica quanto segue:
Viene visualizzato il seguente messaggio nella pagina Composer > Monitoraggio:
Logging is disabled. Please refer to platform configuration file to enable it.
L'opzione Strategia di recupero log viene impostata su DefaultLogRetrievalStrategy.
Se DisableFileLogging è impostato su false ed EnableOpenTelemetryForLogging è impostato su true, i log sono disponibili nei file di log di ThingWorx nella piattaforma e nel software di terze parti integrato con OpenTelemetry.
Configurazione dell'SDK OpenTelemetry
Le impostazioni di configurazione di OpenTelemetry riportate di seguito sono disponibili nella sezione OpenTelemetrySettings del file platform-settings.json.
Impostazione
Valore di default
Descrizione
BatchLogProcessorMaxQueueSize
2048
Numero massimo di record di log che è possibile inserire in coda prima dell'elaborazione e dell'esportazione. Valori di dimensioni maggiori migliorano il throughput, ma richiedono più memoria.
BatchLogProcessorScheduledDelay
10 millisecondi
Numero di millisecondi di attesa del processore prima di esportare un nuovo batch di log, anche se il batch non è pieno.
BatchLogProcessorMaxExportBatchSize
512
Numero massimo di voci di log inviate in un singolo batch di esportazione. Questa impostazione consente di controllare la dimensione del payload e l'utilizzo della rete.
BatchLogProcessorExportTimeout
1000 millisecondi
Numero di millisecondi in cui il sistema attende il completamento di una richiesta di esportazione di log prima del timeout.
OtlpGRPCLogExporterEndpoint
URL dell'endpoint OTLP gRPC in cui ThingWorx Platform esporta i log (ad esempio, http://localhost:4317). Obbligatorio per l'inserimento remoto dei log tramite il raccoglitore OpenTelemetry o qualsiasi back-end compatibile con OTLP gRPC.
OtlpGRPCEnableSSL
false
Consente di attivare o disattivare SSL/TLS per l'esportazione di log OTLP gRPC.
true
- Utilizza la trasmissione protetta
false - Utilizza testo normale
OtlpGRPCTrustStorePath
N/D
Percorso del file truststore contenente i certificati attendibili per la convalida del raccoglitore OpenTelemetry o del back-end di destinazione durante la comunicazione SSL.
OtlpGRPCTrustStorePassword
N/D
Password per l'accesso al truststore configurato in OtlpGRPCTrustStorePath.
OtlpGRPCKeyStorePath
N/D
Percorso del file keystore contenente il certificato client e la chiave privata per TLS reciproco (mTLS).
OtlpGRPCKeyStorePassword
N/D
Password per l'accesso al keystore configurato in OtlpGRPCKeyStorePath.
RetryOtlpGRPCLogExporterMaxAttempts
5
Numero massimo di tentativi quando l'esportazione di log ha esito negativo a causa di errori temporanei.
RetryOtlpGRPCLogExporterBackOffMultiplier
1.5
Moltiplicatore utilizzato per calcolare il backoff esponenziale. Per ogni tentativo non riuscito di esportazione dei dati, il tempo di attesa continua ad aumentare in base a questo fattore.
RetryOtlpGRPCLogExporterInitialBackOff
1 secondo
Quantità di tempo in secondi prima del primo tentativo.
RetryOtlpGRPCLogExporterMaxBackOff
5 secondi
Numero di secondi tra i tentativi durante il backoff esponenziale.
OtlpGRPCMetricExporterEndpoint
N/D
URL dell'endpoint OTLP gRPC in cui ThingWorx Platform esporta le metriche (ad esempio, http://localhost:4317). Questo URL è obbligatorio per l'inserimento delle metriche tramite il raccoglitore OpenTelemetry o qualsiasi back-end compatibile con OTLP gRPC.
EnableOpenTelemetryInternalMetrics
true
Consente l'invio di metriche alla piattaforma di osservabilità tramite il raccoglitore OpenTelemetry.
Argomenti correlati
È stato utile?