Azure App Services Tracciamento per .NET

Per abilitare la strumentazione per le varianti di App Services basate su.NET Framework,.NET Core e.NET su Windows, è necessario che un agente di Instana sia in esecuzione nell'ambiente in cui si intende monitorare App Services.

Per ulteriori informazioni su come configurare l'agente Instana per il monitoraggio di Azure, consultare la sezione Monitoraggio e strumentazione di Microsoft Azure.

Per configurare i carichi di lavoro di un Windows, procedere come segue:

1. Nel portale 'Microsoft Azure, cercare il 'App Service ' .Net che si desidera strumentare.

2. Aprire il App Service.Net nel portale Azure.

3. Dal menu di navigazione, fare clic su Estensioni. Nella pagina Estensioni è possibile aggiungere una nuova estensione, controllare le estensioni installate, aggiornare o rimuovere un'estensione.

   

4. Installa l 'estensione "Tracing App Service " di Instana. Dopo l'installazione, è necessario configurare l'estensione prima di utilizzarla.

5. Go alla pagina delle estensioni.

6. Fai clic sull'icona " URL " relativa all'estensione " Instana Tracing App Service " nell'elenco delle estensioni installate. Viene visualizzata la finestra "Tracciamento di Instana per AppServices ", in cui è possibile configurare l'estensione Instana.

   

7. Completare le seguenti configurazioni:

   1. Per attivare la funzione di tracciamento di Instana, impostare "Abilita tracciamento" su "On".

   2. Per selezionare 32 bit per l'applicazione App Services, impostare Abilita 64 bit su Off. Per selezionare 64 bit per l'applicazione App Services, impostare Abilita 64 bit su On. Per ulteriori informazioni, vedere Bitness dell'applicazione.

   3. Nel campo " Chiave agente ", inserisci la chiave di licenza del tuo agente host di Instana.

   4. Nel campo " URL " dell'endpoint, inserisci l' URL dell'endpoint per il monitoraggio serverless.

      Nota: per le installazioni self-hosted, inserire l'endpoint nel https://<IP address of the Instana backend>/serverless formato e impostare il INSTANA_DISABLE_CA_CHECK parametro su true o 1.

   5. Nel campo Livello registro, inserire il livello di registro che si desidera utilizzare. I valori che si possono inserire sono 'NONE, 'DEBUG, 'INFO, 'WARN e 'ERROR.

      Le informazioni di log vengono generate nella cartella principale dell'applicazione App Service.

8. Dopo aver inserito tutte le informazioni, fare clic su Aggiorna configurazione. Le informazioni vengono salvate nel contesto dell'App Service.

9. Dalla Dashboard dell'App Service, riavviare l'App Service. Quando si esegue l'applicazione, viene associato ad essa un rewriter di Instana e Instana inizia a raccogliere le tracce.

Per visualizzare le tracce nell'interfaccia utente di Instana, procedere come segue:

1. Nell'interfaccia utente di Instana, apri la dashboard della tua entità App Service.

2. Fare clic su Upstream / Downstream. Vengono visualizzate le tracce raccolte per questa entità.

   

Per abilitare la strumentazione per le applicazioni.NET Core e.NET in esecuzione su App Service basati su Linux, è necessario che un agente Instana sia in esecuzione nell'ambiente in cui si intende monitorare l' App Service. Per ulteriori informazioni su come configurare l'agente Instana per il monitoraggio di Azure, consultare la sezione Monitoraggio e strumentazione di Microsoft Azure.

Per catturare le tracce, completare i seguenti passaggi:

1. Aggiungi il pacchetto di tracciamento NuGet al tuo progetto: Instana.Tracing.Core.Rewriter.Linux

2. Dopo aver aggiunto il pacchetto NuGet di tracciamento, distribuire nuovamente l'applicazione su Azure App Service.

3. Una volta reinstallata l'applicazione, il tracciamento di " Instana " diventa parte integrante dell'applicazione. Per attivare il tracciamento, configurare il motore CLR come segue:

   1. Go alla sezione "Configurazione" nella dashboard di Azure App Service.

   2. Aggiungi le seguenti variabili di ambiente:

      CORECLR_ENABLE_PROFILING = 1
      CORECLR_PROFILER = {cf0d821e-299b-5307-a3d8-b283c03916dd}
      CORECLR_PROFILER_PATH = /home/site/wwwroot/instana_tracing/CoreProfiler.so
      DOTNET_STARTUP_HOOKS = /home/site/wwwroot/Instana.Tracing.Core.dll
      INSTANA_AGENT_KEY = the license key of your Instana host agent
      INSTANA_ENDPOINT_URL = one of the following [endpoint URL for serverless monitoring](../../../setup_and_manage/endpoints_and_keys.html#endpoints-for-serverless-monitoring)
      

4. Riavviare l'applicazione. Per assicurarsi che le modifiche siano attive, procedere come segue:

   1. Arrestare l'applicazione.
   2. Attendere 1-2 minuti per cancellare gli stati memorizzati nella cache.
   3. Avviare nuovamente l'applicazione.

   Ora è possibile visualizzare le tracce nell'interfaccia utente di Instana.

Quando si configura la strumentazione di Instana utilizzando l'estensione installata su Azure, è visibile una casella di controllo "Abilita 64 bit ". A seconda della versione bit dell'applicazione, è necessario allegare il rewriter appropriato.

Per impostazione predefinita, quando si distribuisce l'applicazione tramite Visual Studio su Azure App Service, l'applicazione viene installata in modalità a 32 bit. Le impostazioni della versione bit possono essere modificate nella configurazione dell'App Service andando su Configurazione > Impostazioni generali:

Se si utilizza la modalità a 64 bit, selezionare «64 bit» nella configurazione dell'estensione «Tracing» di « Instana » ( App Service ). In caso contrario, non è possibile collegare e raccogliere le tracce.

Se il tracciamento non funziona, completare i passaggi seguenti:

1. Verificare che la versione del bit sia configurata correttamente sia nella configurazione di App Service sia nella configurazione dell'estensione Instana Tracing App Service.

2. Assicurati che la chiave dell'agente e l'endpoint URL siano impostati correttamente nella pagina "Tracciamento per App Services" all'indirizzo Instana. Per ulteriori informazioni, consultare Endpoint URL per il monitoraggio serverless.

3. Per verificare la presenza di errori nel registro eventi, fare clic su Diagnosi e risoluzione dei problemi > Registri eventi applicazioni.

   

4. Aprite Kudu Process Explorer facendo clic su Strumenti avanzati nel menu di navigazione. Controllare se il processo 'w3wp è collegato al modulo Instana.Profiler_x64.dll

   

   

5. Recupera i log di debug di « Instana » dallo strumento Kudu. Nello strumento Kudu, passare alla Console di debug e quindi alla cartella 'C:\home\site\wwwroot>. Nella cartella sono presenti due tipi di file di registro:

• Registri di debug del CLR: 1.log_YYYY-MM-DD-HH_MM_SS
• Registri della strumentazione: YYYY-MM-DD_HH_MM_SSPID