Risoluzione dei problemi relativi alla distribuzione di Instana di OpenTelemetry Collector
Consulta le soluzioni ai problemi comuni che potresti incontrare durante l'utilizzo della distribuzione Instana di OpenTelemetry Collector.
Il collettore non riesce a connettersi
Il Collector non riesce a connettersi al backend dell' Instana.
Soluzione : verificare la configurazione di rete e assicurarsi che il collettore possa raggiungere il backend Instana. Controlla le regole del firewall, le impostazioni del proxy e le configurazioni delle porte e verifica che sia in uso la chiave Instana corretta.
Il collector non riesce a connettersi alla piattaforma Red Hat OpenShift con Instana Self-Hosted Custom Edition
Se si utilizza la piattaforma Red Hat OpenShift con Instana Self-Hosted Custom Edition e si verificano errori di connessione o errori dell'endpoint OTLP (come indicato nei log del pod otlp-collector), è necessario creare manualmente le rotte su Red Hat OpenShift. Per ulteriori informazioni sulla creazione di percorsi, consultare Configurazione degli endpoint sul backend dell' Instana e su Red Hat OpenShift. La creazione del percorso non avviene automaticamente.
Il collettore non si avvia
Il Collector non si avvia a causa di errori di configurazione.
Soluzione : convalidare il file di configurazione utilizzando il --config-check flag prima di avviare il collettore. Ad esempio, ./otelcol --config config.yaml --config-check
Il servizio Collector non si avvia
Il servizio Collector non si avvia dopo l'installazione.
Soluzione : controllare i registri di servizio per verificare la presenza di errori e verificare che i parametri di configurazione in config.env siano corretti.
Il collettore non viene visualizzato nell'interfaccia utente di Instana
Il Collector è in esecuzione ma non viene visualizzato nell'interfaccia utente di Instana.
Soluzione : la pagina delle entità dell'interfaccia utente di Instana elenca i componenti in base all'attributo entity.type resource. Se il tuo collettore non è visibile, verifica che entity.type l'attributo sia configurato correttamente nel tuo file di configurazione. Assicurarsi che il collettore sia correttamente connesso al backend dell' Instana e e verificare che non vi siano problemi di autenticazione o connettività.
Esempio di configurazione degli attributi delle risorse:
telemetry:
resource:
entity.type: otel-collector
Problemi relativi al servizio di supervisione
- Il collector si riavvia ripetutamente nonostante il servizio di supervisione sia in esecuzione.
Soluzione : controllare i registri del supervisore per verificare la presenza di errori e verificare che la configurazione del collettore sia valida.
- Il servizio di supervisione non si avvia.
Soluzione : verificare che la configurazione del supervisore in config.env sia corretta e controllare i registri di sistema per eventuali errori.
Posizioni dei log per Linux
Registri del collettore : per impostazione predefinita, /opt/instana/collector/logs/collector.log.
Registri supervisore : per impostazione predefinita, /opt/instana/collector/logs/supervisor.log.
Il collettore non può accedere alle metriche di sistema o ai file di log
Il Collector non può accedere alle metriche di sistema o ai file di log.
Soluzione : assicurarsi che il processo di raccolta disponga delle autorizzazioni appropriate. Potrebbe essere necessario eseguirlo con privilegi elevati o aggiungerlo a gruppi specifici.
Comportamento strano del collezionista
I registri del Collector mostrano dati telemetrici anomali.
Soluzione : riavviare il servizio di raccolta utilizzando ./instana_collector_service.sh restart nel percorso di installazione per risolvere eventuali problemi. Se il problema persiste, controllare i log del collettore per eventuali anomalie.
Problemi relativi ai certificati autofirmati in ambienti self-hosted
Il collector non è in grado di connettersi al backend Instana a causa di errori di convalida dei certificati in ambienti self-hosted con certificati autofirmati.
Soluzione : esportare il certificato dal server Instana e aggiungerlo all'archivio dei certificati attendibili del sistema:
- Esporta il file PEM dal server Instana.
- Se necessario, convertire il file in un
.crtfile. - Aggiungi il certificato all'archivio dei certificati attendibili del tuo sistema. Copia il tuo
.crtfile nelle seguenti posizioni in base al tuo sistema operativo:- RHEL, CentOS, o Fedora : Copiare il
.crtfile nella/usr/share/pki/ca-trust-source/anchors/posizione. - Debian oppure Ubuntu : Copiare il
.crtfile nella/usr/local/share/ca-certificates/posizione.
- RHEL, CentOS, o Fedora : Copiare il
- Riavvia il servizio di raccolta.
Problemi relativi allo stato dello span: HTTP Codici di stato 4xx contrassegnati come errori
Problema : gli span con codici di stato 4xx dell' HTTP (ad esempio, 400 Bad Request) vengono contrassegnati come errori, ma si tratta di un comportamento previsto nella tua applicazione.
Soluzione : la specifica OpenTelemetry consente agli strumenti di impostare lo stato dell'intervallo in modo più preciso in base al contesto. Se desideri filtrare specifiche risposte dell' 4xx e che non costituiscono errori effettivi nel tuo caso d'uso, configura il blocco transform processore nella configurazione del tuo collettore in modo che contenga le seguenti impostazioni, quindi aggiungilo alla pipeline.
transform/span_parse:
error_mode: ignore
trace_statements:
- context: span
statements:
- set(status.code, STATUS_CODE_OK) where attributes["http.status_code"] >= 400 and attributes["http.status_code"] < 500Con questa configurazione, è possibile impostare lo stato dello span su OK per specifici codici di stato dell' HTTP.