Osservabilità di ThingWorx
ThingWorx Platform utilizza OpenTelemetry (OTel), un framework di osservabilità open source che genera e gestisce i dati di telemetria, tra cui tracce, metriche e log. OpenTelemetry è indipendente dal fornitore e dallo strumento, quindi è compatibile con più strumenti di osservabilità back-end.
OpenTelemetry fornisce funzionalità per generare, raccogliere, gestire ed esportare dati di telemetria. È possibile utilizzare applicazioni o sistemi indipendentemente dal linguaggio, dall'infrastruttura o dall'ambiente di esecuzione.
ThingWorx Platform si integra con OpenTelemetry tramite i componenti seguenti:
• SDK OpenTelemetry - Integrato con ThingWorx Platform durante l'installazione.
• Raccoglitore OpenTelemetry - Funge da intermediario tra ThingWorx Platform e gli strumenti di osservabilità e gestisce batch, crittografia e filtraggio di dati sensibili.
SDK OpenTelemetry e il raccoglitore OTel non memorizzano né visualizzano i dati di telemetria. Questi task vengono gestiti da strumenti esterni. ThingWorx Platform utilizza OpenTelemetry per i seguenti elementi:
• Registrazione - Acquisisce i log negli ambienti applicativi. Per ulteriori informazioni, vedere Supporto di OpenTelemetry per la registrazione in ThingWorx Platform.
• Metriche - Monitorano lo stato del sistema e le metriche delle prestazioni. Per ulteriori informazioni, vedere Supporto di OpenTelemetry per le metriche in ThingWorx Platform.
• Traccia - Fornisce visibilità end-to-end dei flussi di richiesta tra i servizi. Per ulteriori informazioni, vedere Supporto di OpenTelemetry per la traccia in ThingWorx Platform.
Distribuzione del raccoglitore OpenTelemetry
È possibile distribuire il raccoglitore OpenTelemetry come contenitore ausiliario, utilizzando Docker o tramite installazione manuale.
• Distribuzione Docker - Il file docker-compose-otel-collector.override.yml è incluso nei file di immagine Docker di ThingWorx. È possibile scaricarlo dalla pagina PTC Software Download.
• Installazione manuale - Scaricare il raccoglitore OpenTelemetry dalla pagina Install the Collector del sito Web OpenTelemetry.
Esempi di distribuzione:
• Distribuzione di server indipendente
◦ Il raccoglitore OpenTelemetry riceve, elabora ed esporta i dati di telemetria.
◦ Esempi di back-end di osservabilità includono Sumo Logic, Datadog o Splunk.
• Distribuzione a disponibilità elevata
◦ Il raccoglitore OpenTelemetry riceve, elabora ed esporta i dati di telemetria.
◦ Esempi di back-end di osservabilità includono Sumo Logic, Datadog o Splunk.
Configurazione SSL
È necessario configurare il raccoglitore OpenTelemetry con SSL (Secure Sockets Layer). In base alla distribuzione, ottenere un certificato SSL e un truststore.
Nella configurazione del raccoglitore OpenTelemetry sono disponibili le impostazioni seguenti:
tls:
insecure: false
ca_file: server.crt
cert_file: client.crt
key_file: client.key
min_version: "1.1"
max_version: "1.2"
Per ulteriori informazioni, vedere la documentazione ufficiale di OpenTelemetry alla pagina Configuration.