Esportazione della telemetria senza raccoglitore utilizzando Distro for (ADOT) SDK AWS OpenTelemetry - Amazon CloudWatch
PrerequisitoImpostazione delle autorizzazioni IAM per il ruoloConfigurazione dei provider delle credenziali Abilitare ADOT SDKs

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Esportazione della telemetria senza raccoglitore utilizzando Distro for (ADOT) SDK AWS OpenTelemetry

È possibile utilizzare ADOT per non utilizzare più raccoglitori e SDKs inviare tracce e log direttamente agli endpoint OTLP.

Nota

Application Signals include le funzionalità Transaction Search. Per evitare costi duplicati, disattiva Application Signals nell'SDK ADOT e mantieni l'impostazione OTEL_AWS_APPLICATION_SIGNALS_ENABLED su “false” (impostazione predefinita).

Prerequisito

Assicurati che Transaction Search sia abilitato per inviare intervalli all'endpoint OTLP X-Ray. Per ulteriori informazioni, consulta Getting started with Transaction Search.

Impostazione delle autorizzazioni IAM per il ruolo

Attieniti alla seguente procedura per collegare le policy IAM necessarie al tuo ruolo:

Tracce:

  1. Aprire la console IAM all'indirizzo https://console.aws.amazon.com/iam/.

  2. Scegli Ruoli, quindi trova e seleziona il ruolo configurato.

  3. Nella scheda Autorizzazioni, scegli Aggiungi autorizzazioni, quindi Collega policy.

  4. Utilizzando la casella di ricerca, cerca AWSXrayWriteOnlyPolicy.

  5. Seleziona la policy AWSXrayWriteOnlyPolicy, quindi scegli Aggiungi autorizzazioni.

Log:

  1. Aprire la console IAM all'indirizzo https://console.aws.amazon.com/iam/.

  2. Scegli Ruoli, quindi trova e seleziona il ruolo configurato.

  3. Nella scheda Autorizzazioni, scegli Aggiungi autorizzazioni, quindi Crea policy inline.

  4. Seleziona CloudWatch Registri per il servizio e in Azioni consentite, filtra e seleziona:

    logs:PutLogEvents
logs:DescribeLogGroups
logs:DescribeLogStreams

  5. Di seguito è riportata una policy IAM di esempio che concede le autorizzazioni necessarie:

    JSON
    {
    "Version":"2012-10-17",		 	 	 		 	 	 
    "Statement": [
        {
            "Sid": "CloudWatchLogsAccess",
            "Effect": "Allow",
            "Action": [
                "logs:PutLogEvents",
                "logs:DescribeLogGroups",
                "logs:DescribeLogStreams"
               
            ],
            "Resource": [
                "arn:aws:logs:*:*:log-group:*"
            ]
        }
    ]
}

Configurazione dei provider delle credenziali

ADOT lo utilizza AWS SDKs per scoprire automaticamente le credenziali valide necessarie per esportare i dati di telemetria in. AWS Per indicazioni sulla configurazione delle credenziali per il tuo ambiente specifico, consulta la documentazione su come l'SDKS recupera le credenziali. AWS

Configurazione delle credenziali IAM per gli host on-premises:

Configura AWS le tue credenziali nell'host locale inserendo il seguente comando. Sostituisci ACCESS_KEY_ID e SECRET_ACCESS_KEY con le credenziali per l'utente o il ruolo IAM configurato.

$ aws configure
AWS Access Key ID [None]: ACCESS_KEY_ID
AWS Secret Access Key [None]: SECRET_ACCESS_ID
Default region name [None]: MY_REGION
Default output format [None]: json

Abilitare ADOT SDKs

Puoi abilitare l'invio di log e tracce per la tua applicazione direttamente agli endpoint OTLP da AWS Distro for OpenTelemetry (ADOT) SDK su Java, Node.js, Python e.Net.

Java
Nota

Per rendere disponibili queste funzionalità, è necessario utilizzare ADOT Java Agent versione 2.11.2 o successive.

  1. Scarica l'ultima versione dell'agente di strumentazione automatica AWS Distro for OpenTelemetry Java. Puoi scaricare la versione più recente utilizzando questo comando:

    curl -L -O https://github.com/aws-observability/aws-otel-java-instrumentation/releases/latest/download/aws-opentelemetry-agent.jar

    È possibile visualizzare informazioni su tutte le versioni rilasciate in Releases. aws-otel-java-instrumentation

  2. Per abilitare l'esportatore diverso che invia direttamente la telemetria agli endpoint OTLP e ottimizzare i vantaggi, utilizza le seguenti variabili di ambiente prima di avviare l'applicazione:

    Tracce:

    • Imposta OTEL_EXPORTER_OTLP_TRACES_ENDPOINT per specificare l'endpoint delle tracce OTLP di X-Ray: https://xray.[AWSRegion].amazonaws.com/v1/traces

      Ad esempio:

      export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="https://xray.us-west-2.amazonaws.com/v1/traces"

    • Imposta OTEL_TRACES_EXPORTER su otlp (facoltativo; corrisponde al valore predefinito se questa variabile di ambiente non è impostata).

    • Imposta la variabile OTEL_EXPORTER_OTLP_TRACES_PROTOCOL su http/protobuf (facoltativo; corrisponde al valore predefinito se questa variabile di ambiente non è impostata).

    • Imposta la variabile OTEL_RESOURCE_ATTRIBUTES per specificare le seguenti informazioni come coppie chiave-valore: Queste variabili di ambiente vengono utilizzate da Application Signals e convertite in annotazioni di tracce a raggi X e CloudWatch dimensioni metriche. :

      • (Facoltativo) service.name imposta il nome del servizio. Questo verrà visualizzato come nome del servizio per l'applicazione nei pannelli di controllo di Application Signals. Se non si fornisce un valore per questa chiave, viene utilizzato il valore predefinito di UnknownService.

      • (Facoltativo) deployment.environment imposta l'ambiente in cui viene eseguita l'applicazione. Questo verrà visualizzato come ambiente Ospitato in dell'applicazione.

      • (Facoltativo) Per abilitare la correlazione dei log, in OTEL_RESOURCE_ATTRIBUTES, imposta una variabile di ambiente aggiuntiva aws.log.group.names per i gruppi di log dell'applicazione. In questo modo, le tracce e le metriche dell'applicazione possono essere correlate alle voci di log pertinenti di questi gruppi di log. Per questa variabile, sostituisci $YOUR_APPLICATION_LOG_GROUP con i nomi dei gruppi di log dell'applicazione. Se hai più gruppi di log, puoi usare una e commerciale (&) per separarli come in questo esempio: aws.log.group.names=log-group-1&log-group-2. Per abilitare la correlazione tra metrica e log, è sufficiente impostare questa variabile di ambiente corrente. Per ulteriori informazioni, consulta Abilitazione della correlazione tra metrica e log. Per abilitare la correlazione tra traccia e log, dovrai anche modificare la configurazione di registrazione nell'applicazione. Per ulteriori informazioni, consulta Abilitazione della correlazione tra traccia e log.

    Log:

    • Impostato OTEL_EXPORTER_OTLP_LOGS_ENDPOINT per specificare l'endpoint dei log CloudWatch OTLP: https://logs.[AWSRegion].amazonaws.com/v1/logs

      Ad esempio:

      export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT="https://logs.us-west-2.amazonaws.com/v1/logs"

    • Imposta OTEL_EXPORTER_OTLP_LOGS_HEADERS per specificare il gruppo di log e il flusso di log (nota: devono essere creati prima di eseguire ADOT) in cui vuoi esportare i log: x-aws-log-group=[CW-LOG-GROUP-NAME],x-aws-log-stream=[CW-LOG-STREAM-NAME]

      Ad esempio:

      export OTEL_EXPORTER_OTLP_LOGS_HEADERS=x-aws-log-group=MyLogGroup,x-aws-log-stream=default

    • Imposta OTEL_LOGS_EXPORTER su otlp (facoltativo; corrisponde al valore predefinito se questa variabile di ambiente non è impostata).

    • Imposta la variabile OTEL_EXPORTER_OTLP_LOGS_PROTOCOL su http/protobuf (facoltativo; corrisponde al valore predefinito se questa variabile di ambiente non è impostata).

  3. Impostato JAVA_TOOL_OPTIONS per specificare il percorso in cui è archiviato l'agente di strumentazione automatica AWS Distro for OpenTelemetry Java. Ad esempio:

    export JAVA_TOOL_OPTIONS=" -javaagent:$AWS_ADOT_JAVA_INSTRUMENTATION_PATH"
export AWS_ADOT_JAVA_INSTRUMENTATION_PATH="./aws-opentelemetry-agent.jar"

  4. Ora l'applicazione dovrebbe essere in esecuzione con l'instrumentazione Java ADOT e dovrebbe iniziare a generare intervalli e log. Gli intervalli verranno archiviati nel gruppo di aws/spans CloudWatch log, mentre i log verranno archiviati nel gruppo di log specificato nell'intestazione. OTEL_EXPORTER_OTLP_LOGS_HEADERS Puoi anche visualizzare i log e le metriche correlati agli intervalli nella console di Traces and Metrics. CloudWatch

  5. Avvia l'applicazione con le variabili di ambiente elencate nel passaggio precedente. Di seguito è riportato un esempio di script di avvio.

    JAVA_TOOL_OPTIONS=" -javaagent:$AWS_ADOT_JAVA_INSTRUMENTATION_PATH" \
OTEL_METRICS_EXPORTER=none \
OTEL_TRACES_EXPORTER=otlp \
OTEL_EXPORTER_OTLP_TRACES_PROTOCOL=http/protobuf \
OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://xray.us-east-1.amazonaws.com/v1/traces \
OTEL_LOGS_EXPORTER=otlp \
OTEL_EXPORTER_OTLP_LOGS_PROTOCOL=http/protobuf \
OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=https://logs.us-east-1.amazonaws.com/v1/logs \
OTEL_EXPORTER_OTLP_LOGS_HEADERS=x-aws-log-group=MyLogGroup,x-aws-log-stream=default 
OTEL_RESOURCE_ATTRIBUTES="service.name=$YOUR_SVC_NAME" \
java -jar $MY_JAVA_APP.jar
Node.js
Nota

È necessario utilizzare la JavaScript versione 0.7.0 o successiva di ADOT per rendere disponibili queste funzionalità.

  1. Scarica l'ultima versione di AWS Distro per la strumentazione OpenTelemetry JavaScript automatica. Installarlo eseguendo il seguente comando .

    npm install @aws/aws-distro-opentelemetry-node-autoinstrumentation

    È possibile visualizzare informazioni su tutte le versioni rilasciate in Releases. aws-otel-js-instrumentation

  2. Per abilitare l'esportatore diverso che invia direttamente la telemetria agli endpoint OTLP e ottimizzare i vantaggi, utilizza le seguenti variabili di ambiente prima di avviare l'applicazione:

    Tracce:

    • Imposta OTEL_EXPORTER_OTLP_TRACES_ENDPOINT per specificare l'endpoint delle tracce OTLP di X-Ray: https://xray.[AWSRegion].amazonaws.com/v1/traces

      Ad esempio:

      export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="https://xray.us-west-2.amazonaws.com/v1/traces"

    • Imposta OTEL_TRACES_EXPORTER su otlp (facoltativo; corrisponde al valore predefinito se questa variabile di ambiente non è impostata).

    • Imposta la variabile OTEL_EXPORTER_OTLP_TRACES_PROTOCOL su http/protobuf (facoltativo; corrisponde al valore predefinito se questa variabile di ambiente non è impostata).

    • Imposta la variabile OTEL_RESOURCE_ATTRIBUTES per specificare le seguenti informazioni come coppie chiave-valore: Queste variabili di ambiente vengono utilizzate da Application Signals e convertite in annotazioni di tracce a raggi X e CloudWatch dimensioni metriche. :

      • (Facoltativo) service.name imposta il nome del servizio. Questo verrà visualizzato come nome del servizio per l'applicazione nei pannelli di controllo di Application Signals. Se non si fornisce un valore per questa chiave, viene utilizzato il valore predefinito di UnknownService.

      • (Facoltativo) deployment.environment imposta l'ambiente in cui viene eseguita l'applicazione. Questo verrà visualizzato come ambiente Ospitato in dell'applicazione.

      • (Facoltativo) Per abilitare la correlazione dei log, in OTEL_RESOURCE_ATTRIBUTES, imposta una variabile di ambiente aggiuntiva aws.log.group.names per i gruppi di log dell'applicazione. In questo modo, le tracce e le metriche dell'applicazione possono essere correlate alle voci di log pertinenti di questi gruppi di log. Per questa variabile, sostituisci $YOUR_APPLICATION_LOG_GROUP con i nomi dei gruppi di log dell'applicazione. Se hai più gruppi di log, puoi usare una e commerciale (&) per separarli come in questo esempio: aws.log.group.names=log-group-1&log-group-2. Per abilitare la correlazione tra metrica e log, è sufficiente impostare questa variabile di ambiente corrente. Per ulteriori informazioni, consulta Abilitazione della correlazione tra metrica e log. Per abilitare la correlazione tra traccia e log, dovrai anche modificare la configurazione di registrazione nell'applicazione. Per ulteriori informazioni, consulta Abilitazione della correlazione tra traccia e log.

    Log:

    • Impostato OTEL_EXPORTER_OTLP_LOGS_ENDPOINT per specificare l'endpoint dei log CloudWatch OTLP: https://logs.[AWSRegion].amazonaws.com/v1/logs

      Ad esempio:

      export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT="https://logs.us-west-2.amazonaws.com/v1/logs"

    • Imposta OTEL_EXPORTER_OTLP_LOGS_HEADERS per specificare il gruppo di log e il flusso di log (nota: devono essere creati prima di eseguire ADOT) in cui vuoi esportare i log: x-aws-log-group=[CW-LOG-GROUP-NAME],x-aws-log-stream=[CW-LOG-STREAM-NAME]

      Ad esempio:

      export OTEL_EXPORTER_OTLP_LOGS_HEADERS=x-aws-log-group=MyLogGroup,x-aws-log-stream=default

    • Imposta OTEL_LOGS_EXPORTER su otlp (facoltativo; corrisponde al valore predefinito se questa variabile di ambiente non è impostata).

    • Imposta la variabile OTEL_EXPORTER_OTLP_LOGS_PROTOCOL su http/protobuf (facoltativo; corrisponde al valore predefinito se questa variabile di ambiente non è impostata).

  3. L'applicazione dovrebbe ora funzionare con la JavaScript strumentazione ADOT e genererà intervalli e log. Gli intervalli verranno archiviati nel gruppo di aws/spans CloudWatch log, mentre i log verranno archiviati nel gruppo di log specificato nell'intestazione. OTEL_EXPORTER_OTLP_LOGS_HEADERS Puoi anche visualizzare i log e le metriche correlati agli intervalli nella console di Traces and Metrics. CloudWatch

  4. Avvia l'applicazione con le variabili di ambiente elencate nel passaggio precedente. Di seguito è riportato un esempio di script di avvio.

    Sostituisci $SVC_NAME con il nome della tua applicazione. Questo verrà visualizzato come nome dell'applicazione.

    OTEL_METRICS_EXPORTER=none \
OTEL_TRACES_EXPORTER=otlp \
OTEL_EXPORTER_OTLP_TRACES_PROTOCOL=http/protobuf \
OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://xray.us-east-1.amazonaws.com/v1/traces \
OTEL_LOGS_EXPORTER=otlp \
OTEL_EXPORTER_OTLP_LOGS_PROTOCOL=http/protobuf \
OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=https://logs.us-east-1.amazonaws.com/v1/logs \
OTEL_EXPORTER_OTLP_LOGS_HEADERS=x-aws-log-group=MyLogGroup,x-aws-log-stream=default 
OTEL_RESOURCE_ATTRIBUTES="service.name=$YOUR_SVC_NAME" \
node --require '@aws/aws-distro-opentelemetry-node-autoinstrumentation/register' your-application.js
Python
Nota

Affinché queste funzionalità siano disponibili, è necessario utilizzare ADOT Python versione 0.10.0 o successive e avere installato botocore.

  1. Scarica l'ultima versione della strumentazione automatica AWS Distro for OpenTelemetry Python. Installarlo eseguendo il seguente comando .

    pip install aws-opentelemetry-distro

    È possibile visualizzare informazioni su tutte le versioni rilasciate in Releases. aws-otel-python-instrumentation

  2. Per abilitare l'esportatore diverso che invia direttamente la telemetria agli endpoint OTLP e ottimizzare i vantaggi, utilizza le seguenti variabili di ambiente prima di avviare l'applicazione:

    Sia per le configurazioni delle tracce sia per quelle dei log, è necessario impostare le seguenti variabili di ambiente:

    • OTEL_PYTHON_DISTRO Da a aws_distro

    • OTEL_PYTHON_CONFIGURATOR Da a aws_configurator

    Tracce:

    • Imposta OTEL_EXPORTER_OTLP_TRACES_ENDPOINT per specificare l'endpoint delle tracce OTLP di X-Ray: https://xray.[AWSRegion].amazonaws.com/v1/traces

      Ad esempio:

      export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="https://xray.us-west-2.amazonaws.com/v1/traces"

    • Imposta OTEL_TRACES_EXPORTER su otlp (facoltativo; corrisponde al valore predefinito se questa variabile di ambiente non è impostata).

    • Imposta la variabile OTEL_EXPORTER_OTLP_TRACES_PROTOCOL su http/protobuf (facoltativo; corrisponde al valore predefinito se questa variabile di ambiente non è impostata).

    • Imposta la variabile OTEL_RESOURCE_ATTRIBUTES per specificare le seguenti informazioni come coppie chiave-valore: Queste variabili di ambiente vengono utilizzate da Application Signals e convertite in annotazioni di tracce a raggi X e CloudWatch dimensioni metriche. :

      • (Facoltativo) service.name imposta il nome del servizio. Questo verrà visualizzato come nome del servizio per l'applicazione nei pannelli di controllo di Application Signals. Se non si fornisce un valore per questa chiave, viene utilizzato il valore predefinito di UnknownService.

      • (Facoltativo) deployment.environment imposta l'ambiente in cui viene eseguita l'applicazione. Questo verrà visualizzato come ambiente Ospitato in dell'applicazione.

      • (Facoltativo) Per abilitare la correlazione dei log, in OTEL_RESOURCE_ATTRIBUTES, imposta una variabile di ambiente aggiuntiva aws.log.group.names per i gruppi di log dell'applicazione. In questo modo, le tracce e le metriche dell'applicazione possono essere correlate alle voci di log pertinenti di questi gruppi di log. Per questa variabile, sostituisci $YOUR_APPLICATION_LOG_GROUP con i nomi dei gruppi di log dell'applicazione. Se hai più gruppi di log, puoi usare una e commerciale (&) per separarli come in questo esempio: aws.log.group.names=log-group-1&log-group-2. Per abilitare la correlazione tra metrica e log, è sufficiente impostare questa variabile di ambiente corrente. Per ulteriori informazioni, consulta Abilitazione della correlazione tra metrica e log. Per abilitare la correlazione tra traccia e log, dovrai anche modificare la configurazione di registrazione nell'applicazione. Per ulteriori informazioni, consulta Abilitazione della correlazione tra traccia e log.

    Log:

    • Imposta OTEL_PYTHON_LOGGING_AUTO_INSTRUMENTATION_ENABLED su true

    • Impostato OTEL_EXPORTER_OTLP_LOGS_ENDPOINT per specificare l'endpoint dei log CloudWatch OTLP: https://logs.[AWSRegion].amazonaws.com/v1/logs

      Ad esempio:

      export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT="https://logs.us-west-2.amazonaws.com/v1/logs"

    • Imposta OTEL_EXPORTER_OTLP_LOGS_HEADERS per specificare il gruppo di log e il flusso di log (nota: devono essere creati prima di eseguire ADOT) in cui vuoi esportare i log: x-aws-log-group=[CW-LOG-GROUP-NAME],x-aws-log-stream=[CW-LOG-STREAM-NAME]

      Ad esempio:

      export OTEL_EXPORTER_OTLP_LOGS_HEADERS=x-aws-log-group=MyLogGroup,x-aws-log-stream=default

    • Imposta OTEL_LOGS_EXPORTER su otlp (facoltativo; corrisponde al valore predefinito se questa variabile di ambiente non è impostata).

    • Imposta la variabile OTEL_EXPORTER_OTLP_LOGS_PROTOCOL su http/protobuf (facoltativo; corrisponde al valore predefinito se questa variabile di ambiente non è impostata).

  3. Ora l'applicazione dovrebbe essere in esecuzione con l'instrumentazione Python ADOT e dovrebbe iniziare a generare intervalli e log. Gli intervalli verranno archiviati nel gruppo di aws/spans CloudWatch log, mentre i log verranno archiviati nel gruppo di log specificato nell'intestazione. OTEL_EXPORTER_OTLP_LOGS_HEADERS Puoi anche visualizzare i log e le metriche correlati agli intervalli nella console di Traces and Metrics. CloudWatch

  4. Avvia l'applicazione con le variabili di ambiente elencate nel passaggio precedente. Di seguito è riportato un esempio di script di avvio.

    Sostituisci $SVC_NAME con il nome della tua applicazione. Questo verrà visualizzato come nome dell'applicazione.

    Sostituisci $PYTHON_APP con la posizione e il nome della tua applicazione.

    OTEL_METRICS_EXPORTER=none \
OTEL_TRACES_EXPORTER=otlp \
OTEL_EXPORTER_OTLP_TRACES_PROTOCOL=http/protobuf \
OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://xray.us-east-1.amazonaws.com/v1/traces \
OTEL_LOGS_EXPORTER=otlp \
OTEL_EXPORTER_OTLP_LOGS_PROTOCOL=http/protobuf \
OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=https://logs.us-east-1.amazonaws.com/v1/logs \
OTEL_EXPORTER_OTLP_LOGS_HEADERS=x-aws-log-group=MyLogGroup,x-aws-log-stream=default
OTEL_PYTHON_LOGGING_AUTO_INSTRUMENTATION_ENABLED=true
OTEL_RESOURCE_ATTRIBUTES="service.name=$YOUR_SVC_NAME" \
opentelemetry-instrument python $MY_PYTHON_APP.py
.Net
Nota

  • Affinché queste funzionalità siano disponibili, è necessario ADOT .NET 1.8.0 o versioni successive.

  • La compressione non è attualmente supportata.

  • Logs attualmente non è supportato.

Scarica l'ultima versione del pacchetto di strumentazione automatica AWS Distro for OpenTelemetry .NET. È possibile visualizzare informazioni su tutte le versioni rilasciate in Releases. aws-otel-dotnet-instrumentation

Per consentire ai diversi esportatori di inviare direttamente la telemetria agli endpoint OTLP e ottimizzare i vantaggi, utilizza le seguenti variabili di ambiente prima di avviare l'applicazione (sostituisci dotnet-service-name nella variabile di ambiente OTEL_RESOURCE_ATTRIBUTES con il nome del servizio che preferisci):

Tracce:

  • È NECESSARIO impostare OTEL_TRACES_EXPORTER su none

  • È NECESSARIO impostare OTEL_AWS_SIG_V4_ENABLED su true

    Questa funzionalità non è abilitata automaticamente in .NET. La variabile di ambiente è richiesta specificamente per identificare questo caso d'uso all'interno dell'instrumentazione .NET. Questo requisito è esclusivo di .NET e non si applica ad altri linguaggi supportati.

Di seguito è riportato un esempio di configurazione per Linux.

export INSTALL_DIR=OpenTelemetryDistribution
export CORECLR_ENABLE_PROFILING=1
export CORECLR_PROFILER={918728DD-259F-4A6A-AC2B-B85E1B658318}
export CORECLR_PROFILER_PATH=${INSTALL_DIR}/linux-x64/OpenTelemetry.AutoInstrumentation.Native.so
export DOTNET_ADDITIONAL_DEPS=${INSTALL_DIR}/AdditionalDeps
export DOTNET_SHARED_STORE=${INSTALL_DIR}/store
export DOTNET_STARTUP_HOOKS=${INSTALL_DIR}/net/OpenTelemetry.AutoInstrumentation.StartupHook.dll
export OTEL_DOTNET_AUTO_HOME=${INSTALL_DIR}

export OTEL_DOTNET_AUTO_PLUGINS="AWS.Distro.OpenTelemetry.AutoInstrumentation.Plugin, AWS.Distro.OpenTelemetry.AutoInstrumentation"
export OTEL_TRACES_EXPORTER=none
export OTEL_AWS_SIG_V4_ENABLED=true

export OTEL_RESOURCE_ATTRIBUTES=service.name=dotnet-service-name
export OTEL_METRICS_EXPORTER=none
export OTEL_LOGS_EXPORTER=none
export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://xray.us-east-1.amazonaws.com/v1/traces

Di seguito è riportato un esempio di configurazione per Windows Server:

$env:INSTALL_DIR = "OpenTelemetryDistribution" 
$env:CORECLR_ENABLE_PROFILING = 1 
$env:CORECLR_PROFILER = "{918728DD-259F-4A6A-AC2B-B85E1B658318}" 
$env:CORECLR_PROFILER_PATH = Join-Path $env:INSTALL_DIR "win-x64/OpenTelemetry.AutoInstrumentation.Native.dll" 
$env:DOTNET_ADDITIONAL_DEPS = Join-Path $env:INSTALL_DIR "AdditionalDeps" 
$env:DOTNET_SHARED_STORE = Join-Path $env:INSTALL_DIR "store" 
$env:DOTNET_STARTUP_HOOKS = Join-Path $env:INSTALL_DIR "net/OpenTelemetry.AutoInstrumentation.StartupHook.dll" 
$env:OTEL_DOTNET_AUTO_HOME = $env:INSTALL_DIR 
$env:OTEL_DOTNET_AUTO_PLUGINS = "AWS.Distro.OpenTelemetry.AutoInstrumentation.Plugin, AWS.Distro.OpenTelemetry.AutoInstrumentation"

$env:OTEL_TRACES_EXPORTER=none
$env:OTEL_AWS_SIG_V4_ENABLED=true

$env:OTEL_RESOURCE_ATTRIBUTES=service.name=dotnet-service-name
$env:OTEL_METRICS_EXPORTER=none
$env:OTEL_LOGS_EXPORTER=none
$env:OTEL_EXPORTER_OTLP_TRACES_PROTOCOL=http/protobuf
$env:OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://xray.us-east-1.amazonaws.com/v1/traces

  1. Avvia l'applicazione con le variabili di ambiente elencate nel passaggio precedente.

  2. (Facoltativo) In alternativa, è possibile utilizzare gli script di installazione forniti per facilitare l'installazione e la configurazione del pacchetto di strumentazione automatica AWS Distro for OpenTelemetry .NET.

    Per Linux, scarica e installa lo script di installazione di Bash dalla pagina delle versioni: GitHub 

    # Download and Install
curl -L -O https://github.com/aws-observability/aws-otel-dotnet-instrumentation/releases/latest/download/aws-otel-dotnet-install.sh
chmod +x ./aws-otel-dotnet-install.sh
./aws-otel-dotnet-install.sh
# Instrument
. $HOME/.otel-dotnet-auto/instrument.shexport OTEL_RESOURCE_ATTRIBUTES=service.name=dotnet-service-name

    Per Windows Server, scarica e installa lo script di PowerShell installazione dalla pagina delle GitHub versioni:

    # Download and Install
$module_url = "https://github.com/aws-observability/aws-otel-dotnet-instrumentation/releases/latest/download/AWS.Otel.DotNet.Auto.psm1"
$download_path = Join-Path $env:temp "AWS.Otel.DotNet.Auto.psm1"
Invoke-WebRequest -Uri $module_url -OutFile $download_path
Import-Module $download_path
Install-OpenTelemetryCore
# Instrument
Import-Module $download_path
Register-OpenTelemetryForCurrentSession -OTelServiceName "dotnet-service-name"
Register-OpenTelemetryForIIS

    Puoi trovare il NuGet pacchetto del pacchetto di strumentazione automatica AWS Distro for OpenTelemetry .NET nel repository ufficiale. NuGet Assicurati di controllare le istruzioni contenute nel file README.