Configurazione del tracciamento di ".NET " sui container " Docker "

Modifica online

Configurare il tracciamento di .NET per le applicazioni in esecuzione nei container Docker utilizzando immagini di base Instana preconfigurate oppure tramite configurazione manuale.

Importante: le immagini di base di Instana e .NET sono disponibili a partire dalla versione .NET Core Tracer 1.319.7. Queste immagini offrono una configurazione di tracciamento predefinita ed eliminano la necessità di una configurazione manuale per le applicazioni containerizzate di .NET.

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

Scegliere il metodo di configurazione

Modifica online

È possibile configurare il tracciamento di ".NET " su Docker utilizzando uno dei seguenti metodi, in base alle proprie esigenze:

  • Utilizzo delle immagini di base Instana .NET : utilizzare immagini preconfigurate Docker con un agente di tracciamento Instana integrato. Questo approccio elimina la configurazione manuale e semplifica l'impostazione del tracciamento. Disponibile a partire dal modello Tracer 1.319.7 di .NET Core. Per ulteriori dettagli, consultare la guida "Configurazione del tracciamento di .NET su Docker con immagini di base Instana ".
  • Utilizzo dei pacchetti " NuGet " e configurazione del Dockerfile (configurazione manuale): installare i pacchetti " NuGet " e configurare le variabili d'ambiente nel proprio Dockerfile. Utilizza questo metodo se hai bisogno di una configurazione personalizzata o se stai utilizzando versioni di Tracer di .NET Core precedenti a 1.319.7.

Configurazione manuale del tracciamento di .NET su Docker

Modifica online

Per abilitare il tracciamento di “.NET ” per le applicazioni in esecuzione nei container “ Docker ”, procedere come segue:

Prerequisiti

Modifica online

Prima di abilitare il tracciamento di ".NET " per i container, assicurati che siano soddisfatti i seguenti prerequisiti:

Installazione dei pacchetti " NuGet " e configurazione delle variabili d'ambiente

Modifica online

Per le applicazioni e i servizi in esecuzione all'interno di container, procedere come segue:

  1. Installa i seguenti pacchetti NuGet nella tua applicazione .NET :

    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 pacchetto al tuo progetto oppure aggiungerlo prima della pubblicazione.

  2. Configura il tuo Dockerfile: aggiungi le variabili d'ambiente necessarie al tuo Dockerfile. L'esempio seguente mostra un Dockerfile con le variabili d'ambiente necessarie:

    ### your docker-image and application-build/-publish here

# set CoreCLR tracing environment variables
ENV DOTNET_STARTUP_HOOKS=/app/Instana.Tracing.Core.dll
ENV CORECLR_ENABLE_PROFILING=1
ENV CORECLR_PROFILER={cf0d821e-299b-5307-a3d8-b283c03916dd}
ENV CORECLR_PROFILER_PATH=/app/instana_tracing/CoreProfiler.so

# provide agent-endpoint
ENV INSTANA_AGENT_HOST=host_or_other_container_name_or_ip
ENV INSTANA_AGENT_PORT=42699
ENTRYPOINT ["dotnet", "YourApp.dll","some","parameters"]

    Sostituisci i seguenti valori:

    • host_or_other_container_name_or_ip: Il nome host, il nome del container o l'indirizzo IP su cui è in esecuzione l'agente Instana.
    • 42699: La porta su cui è in ascolto l'agente di Instana.
    • YourApp.dll: Il nome della DLL della tua applicazione.
    • some,parameters: Eventuali parametri aggiuntivi richiesti dalla tua applicazione.
  3. Crea ed esegui il tuo container.

L'applicazione è strumentata e l'agente Instana raccoglie e visualizza automaticamente i dati di tracciamento nell'interfaccia utente di Instana.

Per verificare se il tracciamento funziona, accedi alla tua dashboard su Instana. Si possono vedere le prime tracce.

Per una configurazione semplificata, utilizzare invece le immagini di bas Instana. Guarda le immagini di base Instana.