Configurazione del tracciamento di ".NET " su IIS

Modifica online

È possibile configurare il tracciamento per le applicazioni di..NET, ospitate su Internet Information Services (IIS), utilizzando InstanaAutoTrace oppure configurando manualmente le variabili d'ambiente.

Per ulteriori dettagli sul funzionamento del monitoraggio di ".NET ", consultare la sezione "Come funziona il monitoraggio di '.NET '".

Prima di iniziare

Modifica online

Per configurare il tracciamento dell'.NET Core e su IIS, procedere come segue:

  • Assicurarsi che l'agente di Instana sia in esecuzione sul computer host. Vedi i prerequisiti per il monitoraggio dell'.NET Core.
  • Verificare che PCP ( Instana ) sia in esecuzione sul computer host. Per verificare se il PCP di Instana è in esecuzione, utilizzare Task Manager all'indirizzo Windows.
  • Installa un sensore .NET Core 1.0.56 o versione successiva.
  • Controlla le informazioni sull'assistenza.

Abilitazione della traccia

Modifica online

Attivare il tracciamento di ".NET " su Windows utilizzando uno dei seguenti metodi:

Metodo 1: Abilitazione del tracciamento automatico

Modifica online

Per abilitare Instana AutoTrace,, procedere come segue:

  1. Modifica il file dell'agente configuration.yaml come illustrato nell'esempio seguente:

    # netcore Tracing
com.instana.plugin.netcore:
  tracing:
    enabled: true

  2. Esegui il ripristino di IIS per assicurarti che i processi di lavoro di IIS carichino la strumentazione:

    iisreset
    Nota: se IIS non viene riavviato, i processi di IIS non vengono monitorati e non è possibile tracciare le applicazioni ospitate su IIS. È necessario reimpostare IIS anche se l'applicazione era stata precedentemente strumentata.

  3. Avviare l'applicazione. All'avvio della fase di rilevamento, il sensore attiva automaticamente la tracciatura.

Metodo 2: Abilitazione manuale della tracciatura

Modifica online

Per le applicazioni .NET Core ospitate su IIS, è possibile configurare manualmente la tracciatura aggiungendo variabili d'ambiente al Web.config file.

Per abilitare manualmente il tracciamento, segui questi passaggi:

  1. Installa i seguenti pacchetti nella tua applicazione:

    Quando i pacchetti vengono distribuiti tramite NuGet.org, è possibile installarli senza dover ricompilare l'applicazione. Utilizza uno dei seguenti metodi:

    • nuget.exe Disponibile: ripristinare i pacchetti utilizzando nuget.exe senza compilare il progetto da strumentare.
    • nuget.exe non disponibile: scarica direttamente i pacchetti, estraili e poi imposta le variabili d'ambiente in modo che puntino ai file estratti, come descritto nel passaggio seguente.
    Nota: puoi aggiungere il Instana.Tracing.Core.Rewriter.Windows pacchetto al tuo progetto oppure aggiungerlo prima della pubblicazione.

  2. Aggiungere le seguenti variabili d'ambiente nel Web.config file dell'applicazione:

    <aspNetCore>
    <environmentVariables>
        <environmentVariable name="CORECLR_ENABLE_PROFILING" value="1" />
        <environmentVariable name="CORECLR_PROFILER" value="{FA8F1DFF-0B62-4F84-887F-ECAC69A65DD3}" />
        <environmentVariable name="CORECLR_PROFILER_PATH_64" value="[Path_to_your_app]/instana_tracing/CoreRewriter_x64.dll" />
        <environmentVariable name="CORECLR_PROFILER_PATH_32" value="[Path_to_your_app]/instana_tracing/CoreRewriter_x86.dll" />
        <environmentVariable name="DOTNET_STARTUP_HOOKS" value="[Path_to_your_app]/Instana.Tracing.Core.dll" />
    </environmentVariables>
</aspNetCore>

    Sostituisci [Path_to_your_app] con il percorso effettivo della directory dell'applicazione.

  3. Una volta aggiunte le variabili, eseguire il iisreset comando per ricaricare i processi di lavoro di IIS:

    iisreset
    Nota: se IIS non viene riavviato, i processi di IIS non vengono monitorati e non è possibile tracciare le applicazioni ospitate su IIS. È necessario reimpostare IIS anche se l'applicazione era stata precedentemente strumentata.