Risoluzione dei problemi relativi al tracciamento di .NET su Windows

Sintomi: l'applicazione mostra le metriche ma non le tracce; alcuni servizi generano rapporti, mentre altri no; oppure il tracciamento si interrompe dopo una distribuzione o un aggiornamento.

Procedura di risoluzione dei problemi:

1. Verificare che la versione dell'applicazione ".NET " sia supportata:

   • .NET Core Versione di Runtime 5.0 o o successive
2. Verificare che il tracciamento sia abilitato nel file dell'agente configuration.yaml .
3. Raccogli i log di tracciamento utilizzando Log Collector oppure raccogliendoli manualmente.

4. Controlla i log di tracciamento dell' Instana :

   • Se i log sono vuoti o non sono visibili tracce, l'applicazione non sta generando span.
   • Se nei log sono presenti tracce ma mancano alcune informazioni (ad esempio, l'host), il problema riguarda il livello di tracciamento di .NET.
   • Se nei log sono presenti tracce contenenti informazioni che non compaiono nell'interfaccia utente, il problema si è verificato nel backend di Instana o nell'agente.

Sintomo: l'applicazione non si avvia correttamente quando è in esecuzione l'agente di Instana.

Procedura di risoluzione dei problemi:

1. Verificare che la versione dell'applicazione ".NET " sia supportata:

   • .NET Core Versione di Runtime 5.0 o o successive
2. Raccogli i registri di Event Viewer utilizzando Log Collector oppure raccogliendoli manualmente.

3. Controlla i registri del Visualizzatore eventi di Instana :

   • Verifica se nei registri è presente un errore o un avviso. Un evento contiene informazioni dettagliate, tra cui timestamp e codici di errore, che possono aiutare a diagnosticare i problemi.
   • Se compare un errore che indica InstanaPCP.exe che l'operazione non è andata a buon fine, significa che l'operazione InstanaPCP non è riuscita. Controlla gli eventi che l'hanno preceduto e approfondisci la questione.
4. Acquisire un dump di memoria dell'applicazione in questione.

Sintomo: l'applicazione ".NET " non viene monitorata dall'agente " Instana " e non è presente nell'interfaccia utente.

Procedura di risoluzione dei problemi:

1. Verificare che l'agente di Instana sia in esecuzione con privilegi di amministratore.
2. Verificare che l'agente di Instana disponga delle autorizzazioni necessarie per l'applicazione.

3. Verificare che PCP ( Instana ) sia in esecuzione:

   • InstanaPCPApri Gestione attività su Windows e cerca.

4. Raccogli i log degli agenti d Instana utilizzando Log Collector oppure raccogliendoli manualmente.

   • Nei log dell'agente di Instana dovrebbe essere presente la seguente riga:

     com.instana.agent-process-handling - 1.0.35 |  | InstanaPCP.exe passed early window; marked RUNNING

5. Verificare che i sensori siano stati attivati correttamente nei log dell'agente:

   com.instana.sensor-clr - 1.1.141 |  | Activated Sensor

6. Verificare che il processo ".NET " sia avviato dopo l'agente " Instana ".

Sintomo: l'applicazione " InstanaPCP " o ".NET " mostra un utilizzo della CPU insolitamente elevato dopo l'attivazione della tracciatura.

Procedura di risoluzione dei problemi:

1. Verifica se il problema è legato all'applicazione o a un processo in esecuzione controllando l InstanaPCP.

2. Se il problema riguarda InstanaPCP:

   • Abilita i log di debug per InstanaPCP. Vedi "Raccolta dei registri ".
   • Controlla i log alla ricerca di messaggi ricorrenti relativi a contatori di prestazioni mancanti o eccezioni.

3. Se il problema è un picco di utilizzo della memoria dell'applicazione:

   • Raccogliere i registri degli eventi e i registri di ".NET " utilizzando Log Collector oppure raccogliendoli manualmente.
   • Controlla i registri degli eventi e i registri di ".NET " per individuare eventuali eccezioni relative alla memoria.
   • Verificare se il problema è causato da una strumentazione dell' Instana.
   • Acquisire un file di dump di ".NET " per un'ulteriore analisi. Go Accedere a Gestione attività, fare clic con il pulsante destro del mouse sul processo e creare un file di dump.

Log Collector è un'applicazione autonoma che consente di raccogliere i log da Instana. È possibile avviare Log Collector dalle seguenti posizioni:

• Instana Interfaccia utente
• Console

Il Log Collector raccoglie i seguenti log:

• Registri di tracciamento delle applicazioni
• Instana Registri PCP
• Log di debug CLR
• Registri del Visualizzatore eventi
• Instana log di debug dell'agente
• Instana l'agente registra i log

In alternativa, è possibile raccogliere i log manualmente. Completa i seguenti passi:

1. Abilita i log di debug:

   1. Aggiungere le variabili d'ambiente utilizzando una delle seguenti opzioni:

      Nota: assicurarsi che i percorsi siano validi, accessibili al processo o all'applicazione e corretti.

      • Impostare manualmente le seguenti variabili d'ambiente a livello di sistema:

        INSTANA_NET_LOG_PATH: "C:\dc_net_log"
        INSTANA_NET_LOG_LEVEL: DEBUG
        INSTANA_NET_CORE_LOG_LEVEL: DEBUG
        INSTANA_NET_FF_LOG_LEVEL: DEBUG
        INSTANA_NET_PCP_LOG_LEVEL: DEBUG
        INSTANA_TRACER_ENTEREXIT_LOGGING: 1
        INSTANA_EXTENDED_DEBUG: 1

      • Apri il prompt dei comandi come amministratore ed esegui il seguente comando per aggiungere le variabili d'ambiente:

        setx INSTANA_NET_LOG_PATH "C:\dc_net_log" /M
        setx INSTANA_NET_LOG_LEVEL "DEBUG" /M
        setx INSTANA_NET_CORE_LOG_LEVEL "DEBUG" /M
        setx INSTANA_NET_FF_LOG_LEVEL "DEBUG" /M
        setx INSTANA_NET_PCP_LOG_LEVEL "DEBUG" /M
        setx INSTANA_TRACER_ENTEREXIT_LOGGING "1" /M
        setx INSTANA_EXTENDED_DEBUG "1" /M

   2. Configurare la seguente chiave di registro di sistema Windows :

      CLRDebugLog: "C:\dc_clr_debug_log\clr_"

   3. Riavviare l'applicazione.

2. Raccogliere i log degli agenti dell' Instana :

   1. Arrestare l'agente <instana_install_dir>/bin/stop.sh oppure, se l'agente è stato avviato come servizio, arrestare il servizio.

   2. Rimuovere i file di log: eliminare tutti i file presenti nella directory dei log per ricominciare da zero eseguendo il seguente comando:

      rm -rf <instana_install_dir>/data/log/*

   3. Imposta il livello di registrazione su "Debug": modifica il livello di gravità della registrazione nel file dell'agente configuration.yaml . Per ulteriori informazioni, consultare la sezione "Impostazione del file di configurazione dell'agente".
   4. Avvia l'agente <instana_install_dir>/bin/start.sh o avvia il servizio.
   5. Riprodurre il problema: lasciare che il problema si verifichi ed eseguire l'agente per circa 15 minuti.

   6. Raccogli i log: comprimi la directory dei log per l'invio eseguendo il seguente comando:

      cd <instana_install_dir>/data/logs
      zip -r instana_agent_debug_logs.zip *

3. Raccogliere i log di tracciamento dell' Instana :

   1. com.instana.agent.main.sender.File.cfgGo per [agent-dir]\etc\instana e aprire il file.

   2. Aggiungi le seguenti righe nel file:

      prefix=instanaTraces
      type=traces

      Questa configurazione genera un file di log che contiene tutte le tracce con [agent-dir]/data/log il instanaTraces prefisso.

   3. Riavvia l'agente di Instana.
   4. Lasciare in funzione l'applicazione per circa 15 minuti.

   5. Raccogliere i log dai seguenti percorsi:

      • Percorso specificato dalla variabile INSTANA_NET_LOG_PATH
      • instana-agent-installation-folder/data/log

4. Raccogliere i log di debug CLR:

   1. Apri l'Editor del Registro di sistema.
   2. Naviga a Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Instana\
   3. C:\temp\clr_Aggiungi la chiave CLRDebugLog di registro come stringa con valore, ad esempio.

   4. In alternativa, apri il prompt dei comandi come amministratore ed esegui il seguente comando:

      reg add "HKLM\SOFTWARE\Instana" /v CLRDebugLog /t REG_SZ /d "C:\temp\clr_" /f