Esportazione della telemetria senza raccoglitore utilizzando Distro for (ADOT) SDK AWS OpenTelemetry - Amazon CloudWatch
PrerequisitoConfigura le autorizzazioni IAM per il tuo ruoloConfigura i tuoi fornitori di credenzialiAbilitare 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 funzionalità di ricerca delle transazioni. Per evitare costi duplicati, disattiva Application Signals in ADOT SDK 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 Guida introduttiva a Transaction Search.

Configura le autorizzazioni IAM per il tuo ruolo

Segui questi passaggi per associare le politiche IAM necessarie al tuo ruolo:

Tracce:

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

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

  3. Nella scheda Autorizzazioni, scegli Aggiungi autorizzazioni, quindi Allega politiche.

  4. Utilizzando la casella di ricerca, cerca il. AWSXrayWriteOnlyPolicy

  5. Seleziona la AWSXrayWriteOnlyPolicy politica e scegli Aggiungi autorizzazioni.

Registri:

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

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

  3. Nella scheda Autorizzazioni, scegli Aggiungi autorizzazioni, quindi Crea politica in linea.

  4. Seleziona CloudWatch i registri del servizio e in Azioni consentite, filtra e seleziona:

    logs:PutLogEvents
logs:DescribeLogGroups
logs:DescribeLogStreams

  5. Di seguito è riportato un esempio di policy IAM che concede le autorizzazioni richieste:

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

Configura i tuoi fornitori di 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 locali:

Configura AWS le tue credenziali nel tuo host locale inserendo il seguente comando. Sostituisci ACCESS_KEY_ID e SECRET_ACCESS_KEY con le credenziali per il ruolo o l'utente 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

È necessario utilizzare ADOT Java Agent versione 2.11.2 o successiva per rendere disponibili queste funzionalità.

  1. Scarica l'ultima versione dell'agente di strumentazione automatica AWS Distro for OpenTelemetry Java. È possibile scaricare l'ultima versione 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 aws-otel-java-instrumentation Releases.

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

    Tracce:

    • Impostato OTEL_EXPORTER_OTLP_TRACES_ENDPOINT per specificare l'endpoint delle tracce OTLP a raggi X: https://xray.[AWSRegion].amazonaws.com/v1/traces

      Per esempio:

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

    • Imposta su OTEL_TRACES_EXPORTER otlp (è facoltativo ed è il valore predefinito se questa variabile di ambiente non è impostata).

    • Imposta la OTEL_EXPORTER_OTLP_TRACES_PROTOCOL variabile su http/protobuf (questo è facoltativo ed è il valore predefinito se questa variabile di ambiente non è impostata).

    • Imposta la OTEL_RESOURCE_ATTRIBUTES variabile 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 dashboard 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 Hosted In dell'applicazione.

      • (Facoltativo) Per abilitare la correlazione dei logOTEL_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 registro pertinenti di questi gruppi di log. Per questa variabile, sostituitela $YOUR_APPLICATION_LOG_GROUP con i nomi dei gruppi di log dell'applicazione. Se hai più gruppi di log, puoi usare un ampersand (&) 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 ambientale corrente. Per ulteriori informazioni, consulta Abilitare la metrica per registrare la correlazione. Per abilitare la correlazione tra traccia e registro, dovrai anche modificare la configurazione di registrazione nell'applicazione. Per ulteriori informazioni, consulta Abilitare la correlazione tra traccia e log.

    Registri:

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

      Per 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 in: x-aws-log-group=[CW-LOG-GROUP-NAME],x-aws-log-stream=[CW-LOG-STREAM-NAME]

      Per esempio:

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

    • Imposta su OTEL_LOGS_EXPORTER otlp (è facoltativo ed è il valore predefinito se questa variabile di ambiente non è impostata).

    • Imposta la OTEL_EXPORTER_OTLP_LOGS_PROTOCOL variabile su http/protobuf (questo è facoltativo ed è il 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. Per esempio:

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

  4. L'applicazione dovrebbe ora essere in esecuzione con la strumentazione Java 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

  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 il diverso esportatore che invia direttamente la telemetria agli endpoint OTLP e ottimizzare i vantaggi, utilizzate le seguenti variabili di ambiente prima di avviare l'applicazione:

    Tracce:

    • Impostato OTEL_EXPORTER_OTLP_TRACES_ENDPOINT per specificare l'endpoint delle tracce OTLP a raggi X: https://xray.[AWSRegion].amazonaws.com/v1/traces

      Per esempio:

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

    • Imposta su OTEL_TRACES_EXPORTER otlp (è facoltativo ed è il valore predefinito se questa variabile di ambiente non è impostata).

    • Imposta la OTEL_EXPORTER_OTLP_TRACES_PROTOCOL variabile su http/protobuf (questo è facoltativo ed è il valore predefinito se questa variabile di ambiente non è impostata).

    • Imposta la OTEL_RESOURCE_ATTRIBUTES variabile 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 dashboard 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 Hosted In dell'applicazione.

      • (Facoltativo) Per abilitare la correlazione dei logOTEL_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 registro pertinenti di questi gruppi di log. Per questa variabile, sostituitela $YOUR_APPLICATION_LOG_GROUP con i nomi dei gruppi di log dell'applicazione. Se hai più gruppi di log, puoi usare un ampersand (&) 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 ambientale corrente. Per ulteriori informazioni, consulta Abilitare la metrica per registrare la correlazione. Per abilitare la correlazione tra traccia e registro, dovrai anche modificare la configurazione di registrazione nell'applicazione. Per ulteriori informazioni, consulta Abilitare la correlazione tra traccia e log.

    Registri:

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

      Per 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 in: x-aws-log-group=[CW-LOG-GROUP-NAME],x-aws-log-stream=[CW-LOG-STREAM-NAME]

      Per esempio:

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

    • Imposta su OTEL_LOGS_EXPORTER otlp (è facoltativo ed è il valore predefinito se questa variabile di ambiente non è impostata).

    • Imposta la OTEL_EXPORTER_OTLP_LOGS_PROTOCOL variabile su http/protobuf (questo è facoltativo ed è il valore predefinito se questa variabile di ambiente non è impostata).

  3. L'applicazione dovrebbe ora essere in esecuzione 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. 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

È necessario utilizzare ADOT Python versione 0.10.0 o successiva e botocoreaverlo installato affinché queste funzionalità siano disponibili.

  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 il diverso esportatore che invia direttamente la telemetria agli endpoint OTLP e ottimizzare i vantaggi, utilizzate le seguenti variabili di ambiente prima di avviare l'applicazione:

    Sia per le configurazioni delle tracce che 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:

    • Impostato OTEL_EXPORTER_OTLP_TRACES_ENDPOINT per specificare l'endpoint delle tracce OTLP a raggi X: https://xray.[AWSRegion].amazonaws.com/v1/traces

      Per esempio:

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

    • Imposta su OTEL_TRACES_EXPORTER otlp (è facoltativo ed è il valore predefinito se questa variabile di ambiente non è impostata).

    • Imposta la OTEL_EXPORTER_OTLP_TRACES_PROTOCOL variabile su http/protobuf (questo è facoltativo ed è il valore predefinito se questa variabile di ambiente non è impostata).

    • Imposta la OTEL_RESOURCE_ATTRIBUTES variabile 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 dashboard 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 Hosted In dell'applicazione.

      • (Facoltativo) Per abilitare la correlazione dei logOTEL_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 registro pertinenti di questi gruppi di log. Per questa variabile, sostituitela $YOUR_APPLICATION_LOG_GROUP con i nomi dei gruppi di log dell'applicazione. Se hai più gruppi di log, puoi usare un ampersand (&) 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 ambientale corrente. Per ulteriori informazioni, consulta Abilitare la metrica per registrare la correlazione. Per abilitare la correlazione tra traccia e registro, dovrai anche modificare la configurazione di registrazione nell'applicazione. Per ulteriori informazioni, consulta Abilitare la correlazione tra traccia e log.

    Registri:

    • Impostato su OTEL_PYTHON_LOGGING_AUTO_INSTRUMENTATION_ENABLED true

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

      Per 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 in: x-aws-log-group=[CW-LOG-GROUP-NAME],x-aws-log-stream=[CW-LOG-STREAM-NAME]

      Per esempio:

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

    • Imposta su OTEL_LOGS_EXPORTER otlp (è facoltativo ed è il valore predefinito se questa variabile di ambiente non è impostata).

    • Imposta la OTEL_EXPORTER_OTLP_LOGS_PROTOCOL variabile su http/protobuf (questo è facoltativo ed è il valore predefinito se questa variabile di ambiente non è impostata).

  3. L'applicazione dovrebbe ora funzionare con la strumentazione ADOT Python e genererà intervalli e log. Gli intervalli verranno archiviati nel gruppo di log, mentre i aws/spans CloudWatch 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. Verrà visualizzato come nome dell'applicazione.

    Sostituiscilo $PYTHON_APP con la posizione e il 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_PYTHON_LOGGING_AUTO_INSTRUMENTATION_ENABLED=true
OTEL_RESOURCE_ATTRIBUTES="service.name=$YOUR_SVC_NAME" \
opentelemetry-instrument python $MY_PYTHON_APP.py
.Net
Nota

  • Per rendere disponibili queste funzionalità è necessaria la versione 1.8.0 o successiva di ADOT .NET.

  • La compressione non è attualmente supportata.

  • I log non sono attualmente supportati.

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, utilizzate le seguenti variabili di ambiente prima di avviare l'applicazione (sostituitele dotnet-service-name nella variabile di OTEL_RESOURCE_ATTRIBUTES ambiente con il nome del servizio di vostra scelta):

Tracce:

  • DEVI impostare OTEL_TRACES_EXPORTER su none

  • DEVI 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 della strumentazione.NET. Questo requisito è esclusivo di .NET e non si applica ad altre lingue supportate.

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. Avviate 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 il file README per le istruzioni.