Fase 1: abilitazione di Application Signals nel tuo account Fase 2: creazione dei ruoli IAM Fase 3: Preparare la configurazione CloudWatch dell'agente Fase 4: Strumentate la vostra candidatura con l' CloudWatch agente Fase 5: distribuzione dell'applicazione (Facoltativo) Fase 6: Monitora lo stato dell'applicazione

Implementa utilizzando la strategia sidecar

Fase 1: abilitazione di Application Signals nel tuo account

Devi prima abilitare Application Signals nel tuo account. Se non l'hai fatto, vediAbilita Application Signals nel tuo account.

Fase 2: creazione dei ruoli IAM

È necessario creare un ruolo IAM. Se hai già creato questo ruolo, potrebbe essere necessario aggiungervi delle autorizzazioni.

Ruolo dell'attività ECS: i container utilizzano questo ruolo per l'esecuzione. Inoltre, le autorizzazioni dovrebbero corrispondere a ciò di cui hanno bisogno le applicazioni. CloudWatchAgentServerPolicy

Per ulteriori informazioni sulla creazione dei ruoli IAM, consulta Creazione di ruoli IAM.

Fase 3: Preparare la configurazione CloudWatch dell'agente

Innanzitutto, prepara la configurazione dell'agente con Application Signals abilitato. A tale scopo, crea un file locale denominato /tmp/ecs-cwagent.json.


{
  "traces": {
    "traces_collected": {
      "application_signals": {}
    }
  },
  "logs": {
    "metrics_collected": {
      "application_signals": {}
    }
  }
}

Quindi carica questa configurazione nell'archivio parametri SSM. A questo scopo, immetti il comando seguente. Nel file, sostituiscilo $REGION con il nome effettivo della regione.


aws ssm put-parameter \
--name "ecs-cwagent" \
--type "String" \
--value "`cat /tmp/ecs-cwagent.json`" \
--region "$REGION"

Fase 4: Strumentate la vostra candidatura con l' CloudWatch agente

Il passo successivo è quello di strumentare la vostra CloudWatch applicazione per Application Signals.

Java

Per strumentare la tua applicazione su Amazon ECS con l'agente CloudWatch

Innanzitutto, specifica un montaggio vincolato. Il volume verrà utilizzato per condividere file tra container nei passaggi successivi. Dovrai utilizzare questo montaggio vincolato più avanti in questa procedura.
```
"volumes": [
  {
    "name": "opentelemetry-auto-instrumentation"
  }
]
```
Aggiungi una definizione collaterale CloudWatch dell'agente. A tale scopo, aggiungi un nuovo container chiamato ecs-cwagent alla definizione dell'attività dell'applicazione. $REGIONSostituiscila con il nome effettivo della tua regione. Sostituisci $IMAGE con il percorso dell'immagine del CloudWatch contenitore più recente su Amazon Elastic Container Registry. Per maggiori informazioni sull'utilizzo di CloudTrail con Amazon ECR, consulta cloudwatch-agent.

Se desideri invece abilitare l' CloudWatch agente con una strategia daemon, consulta le istruzioni su. Esegui la distribuzione utilizzando la strategia daemon
```
{
  "name": "ecs-cwagent",
  "image": "$IMAGE",
  "essential": true,
  "secrets": [
    {
      "name": "CW_CONFIG_CONTENT",
      "valueFrom": "ecs-cwagent"
    }
  ],
  "logConfiguration": {
    "logDriver": "awslogs",
    "options": {
      "awslogs-create-group": "true",
      "awslogs-group": "/ecs/ecs-cwagent",
      "awslogs-region": "$REGION",
      "awslogs-stream-prefix": "ecs"
    }
  }
}
```

Aggiungi un nuovo container init alla definizione dell'attività dell'applicazione. Sostituisci $IMAGE con l'immagine più recente dall'archivio di immagini AWS Distro for OpenTelemetry Amazon ECR.


{
  "name": "init",
  "image": "$IMAGE",
  "essential": false,
  "command": [
    "cp",
    "/javaagent.jar",
    "/otel-auto-instrumentation/javaagent.jar"
  ],
  "mountPoints": [
    {
      "sourceVolume": "opentelemetry-auto-instrumentation",
      "containerPath": "/otel-auto-instrumentation",
      "readOnly": false
    }
  ]
}

Aggiungi una dipendenza dal init contenitore per assicurarti che questo contenitore finisca prima dell'avvio del contenitore dell'applicazione.
```
"dependsOn": [
  {
    "containerName": "init",
    "condition": "SUCCESS"
  }
]
```

Aggiungi le seguenti variabili di ambiente al container dell'applicazione. È necessario utilizzare la versione 1.32.2 o successiva dell'agente AWS Distro for OpenTelemetry auto-instrumentation for Java.

Variabile di ambiente	Impostazione per abilitare Application Signals
`OTEL_RESOURCE_ATTRIBUTES`	Specificate le seguenti informazioni come coppie chiave-valore: `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`. `deployment.environment` imposta l'ambiente in cui viene eseguita l'applicazione. Questo verrà visualizzato come ambiente ospitato dell'applicazione nei pannelli di controllo di Application Signals. Se non lo specificate, `generic:default` viene utilizzato il valore predefinito di. Questa chiave di attributo viene utilizzata solo da Application Signals e viene convertita in annotazioni di tracce a raggi X e CloudWatch dimensioni metriche. (Facoltativo) Per abilitare la correlazione dei log per Application Signals, impostate una variabile `aws.log.group.names` di ambiente aggiuntiva come nome del gruppo di log per il log dell'applicazione. In questo modo, le tracce e le metriche dell'applicazione possono essere correlate con le voci di registro pertinenti del gruppo 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 Abilita la correlazione tra metrica e log. Per abilitare la correlazione tra traccia e registro, dovrai anche modificare la configurazione di registrazione nell'applicazione. Per ulteriori informazioni, consulta Abilita la correlazione tra traccia e registro.
`OTEL_AWS_APPLICATION_SIGNALS_ENABLED`	Imposta per `true` fare in modo che il contenitore inizi a inviare tracce e CloudWatch metriche X-Ray ad Application Signals.
`OTEL_METRICS_EXPORTER`	Imposta su `none` per disabilitare gli esportatori di altri parametri.
`OTEL_LOGS_EXPORTER`	Impostato per `none` disabilitare altri esportatori di log.
`OTEL_EXPORTER_OTLP_PROTOCOL`	Imposta su `http/protobuf` per inviare metriche e tracce ad Application Signals tramite HTTP.
`OTEL_AWS_APPLICATION_SIGNALS_EXPORTER_ENDPOINT`	Imposta su `http://localhost:4316/v1/metrics` per inviare le metriche al sidecar. CloudWatch
`OTEL_EXPORTER_OTLP_TRACES_ENDPOINT`	Imposta su `http://localhost:4316/v1/traces` per inviare tracce al sidecar. CloudWatch
`OTEL_TRACES_SAMPLER`	Impostalo su per `xray` impostare X-Ray come campionatore di tracce.
`OTEL_PROPAGATORS`	Imposta `xray` come uno dei propagatori.
`JAVA_TOOL_OPTIONS`	Imposta su `" -javaagent:$AWS_ADOT_JAVA_INSTRUMENTATION_PATH"` Sostituisci `AWS_ADOT_JAVA_INSTRUMENTATION_PATH` con il percorso in cui è archiviato l'agente di strumentazione automatica AWS Distro for OpenTelemetry Java. Ad esempio, `/otel-auto-instrumentation/javaagent.jar`

Monta il volume opentelemetry-auto-instrumentation definito nella fase 1 di questa procedura. Se non è necessario abilitare la correlazione dei log con metriche e tracce, utilizzate il seguente esempio per un'applicazione Java. Se desideri abilitare la correlazione dei log, consulta invece il passaggio successivo.


{
  "name": "my-app",
   ...
  "environment": [
    {
      "name": "OTEL_RESOURCE_ATTRIBUTES",
      "value": "service.name=$SVC_NAME"
    },
    {
      "name": "OTEL_LOGS_EXPORTER",
      "value": "none"
    },
    {
      "name": "OTEL_METRICS_EXPORTER",
      "value": "none"
    },
    {
      "name": "OTEL_EXPORTER_OTLP_PROTOCOL",
      "value": "http/protobuf"
    },
    {
      "name": "OTEL_AWS_APPLICATION_SIGNALS_ENABLED",
      "value": "true"
    },
    {
      "name": "JAVA_TOOL_OPTIONS",
      "value": " -javaagent:/otel-auto-instrumentation/javaagent.jar"
    },
    {
      "name": "OTEL_AWS_APPLICATION_SIGNALS_EXPORTER_ENDPOINT",
      "value": "http://localhost:4316/v1/metrics"
    },
    {
      "name": "OTEL_EXPORTER_OTLP_TRACES_ENDPOINT",
      "value": "http://localhost:4316/v1/traces"
    },
    {
      "name": "OTEL_TRACES_SAMPLER",
      "value": "xray"
    },
    {
      "name": "OTEL_PROPAGATORS",
      "value": "tracecontext,baggage,b3,xray"
    }
  ],
  "dependsOn": [
    {
      "containerName": "init",
      "condition": "SUCCESS"
    }
  ],
  "mountPoints": [
    {
      "sourceVolume": "opentelemetry-auto-instrumentation",
      "containerPath": "/otel-auto-instrumentation",
      "readOnly": false
    }
  ]
}

Python

Prima di abilitare Application Signals per le tue applicazioni Python, tieni presente le seguenti considerazioni.

In alcune applicazioni containerizzate, una variabile di PYTHONPATH ambiente mancante a volte può impedire l'avvio dell'applicazione. Per risolvere questo problema, assicuratevi di impostare la variabile di PYTHONPATH ambiente sulla posizione della directory di lavoro dell'applicazione. Ciò è dovuto a un problema noto con la OpenTelemetry strumentazione automatica. Per ulteriori informazioni su questo problema, vedere L'impostazione della strumentazione automatica in Python di PYTHONPATH non è conforme.
Per le applicazioni Django, ci sono configurazioni aggiuntive richieste, che sono descritte nella documentazione di Python OpenTelemetry .
- Usa il --noreload flag per impedire il ricaricamento automatico.
- Imposta la variabile di DJANGO_SETTINGS_MODULE ambiente sulla posizione del file dell'settings.pyapplicazione Django. Ciò garantisce che OpenTelemetry possa accedere e integrarsi correttamente con le impostazioni di Django.
Se stai usando un server WSGI per la tua applicazione Python, oltre ai seguenti passaggi in questa sezione, Nessun dato di Application Signals per l'applicazione Python che utilizza un server WSGI consulta per informazioni su come far funzionare Application Signals.

Per strumentare la tua applicazione Python su Amazon ECS con l'agente CloudWatch

Innanzitutto, specifica un montaggio vincolato. Il volume verrà utilizzato per condividere file tra container nei passaggi successivi. Dovrai utilizzare questo montaggio vincolato più avanti in questa procedura.
```
"volumes": [
  {
    "name": "opentelemetry-auto-instrumentation-python"
  }
]
```
Aggiungi una definizione collaterale CloudWatch dell'agente. A tale scopo, aggiungi un nuovo container chiamato ecs-cwagent alla definizione dell'attività dell'applicazione. $REGIONSostituiscila con il nome effettivo della tua regione. Sostituisci $IMAGE con il percorso dell'immagine del CloudWatch contenitore più recente su Amazon Elastic Container Registry. Per maggiori informazioni sull'utilizzo di CloudTrail con Amazon ECR, consulta cloudwatch-agent.

Se desideri invece abilitare l' CloudWatch agente con una strategia daemon, consulta le istruzioni su. Esegui la distribuzione utilizzando la strategia daemon
```
{
  "name": "ecs-cwagent",
  "image": "$IMAGE",
  "essential": true,
  "secrets": [
    {
      "name": "CW_CONFIG_CONTENT",
      "valueFrom": "ecs-cwagent"
    }
  ],
  "logConfiguration": {
    "logDriver": "awslogs",
    "options": {
      "awslogs-create-group": "true",
      "awslogs-group": "/ecs/ecs-cwagent",
      "awslogs-region": "$REGION",
      "awslogs-stream-prefix": "ecs"
    }
  }
}
```


{
    "name": "init",
    "image": "$IMAGE",
    "essential": false,
    "command": [
        "cp",
        "-a",
        "/autoinstrumentation/.",
        "/otel-auto-instrumentation-python"
    ],
    "mountPoints": [
        {
            "sourceVolume": "opentelemetry-auto-instrumentation-python",
            "containerPath": "/otel-auto-instrumentation-python",
            "readOnly": false
        }
    ]
}

Aggiungi una dipendenza dal init contenitore per assicurarti che questo contenitore finisca prima dell'avvio del contenitore dell'applicazione.
```
"dependsOn": [
  {
    "containerName": "init",
    "condition": "SUCCESS"
  }
]
```

Aggiungi le seguenti variabili di ambiente al container dell'applicazione.

Variabile di ambiente	Impostazione per abilitare Application Signals
`OTEL_RESOURCE_ATTRIBUTES`	Specificate le seguenti informazioni come coppie chiave-valore: `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`. `deployment.environment` imposta l'ambiente in cui viene eseguita l'applicazione. Questo verrà visualizzato come ambiente ospitato dell'applicazione nei pannelli di controllo di Application Signals. Se non lo specificate, `generic:default` viene utilizzato il valore predefinito di. Questa chiave di attributo viene utilizzata solo da Application Signals e viene convertita in annotazioni di tracce a raggi X e CloudWatch dimensioni metriche. (Facoltativo) Per abilitare la correlazione dei log per Application Signals, impostate una variabile `aws.log.group.names` di ambiente aggiuntiva come nome del gruppo di log per il log dell'applicazione. In questo modo, le tracce e le metriche dell'applicazione possono essere correlate con le voci di registro pertinenti del gruppo 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 Abilita la correlazione tra metrica e log. Per abilitare la correlazione tra traccia e registro, dovrai anche modificare la configurazione di registrazione nell'applicazione. Per ulteriori informazioni, consulta Abilita la correlazione tra traccia e registro.
`OTEL_AWS_APPLICATION_SIGNALS_ENABLED`	Imposta per `true` fare in modo che il contenitore inizi a inviare tracce e CloudWatch metriche X-Ray ad Application Signals.
`OTEL_METRICS_EXPORTER`	Imposta su `none` per disabilitare gli esportatori di altri parametri.
`OTEL_EXPORTER_OTLP_PROTOCOL`	Imposta per `http/protobuf` inviare metriche e tracce all' CloudWatch utilizzo di HTTP.
`OTEL_AWS_APPLICATION_SIGNALS_EXPORTER_ENDPOINT`	Imposta per `http://127.0.0.1:4316/v1/metrics` inviare le metriche al sidecar. CloudWatch
`OTEL_EXPORTER_OTLP_TRACES_ENDPOINT`	Imposta su `http://127.0.0.1:4316/v1/traces` per inviare tracce al sidecar. CloudWatch
`OTEL_TRACES_SAMPLER`	Impostalo su per `xray` impostare X-Ray come campionatore di tracce.
`OTEL_PROPAGATORS`	Aggiungi `xray` come uno dei propagatori.
`OTEL_PYTHON_DISTRO`	Impostato per `aws_distro` utilizzare la strumentazione ADOT Python.
`OTEL_PYTHON_CONFIGURATOR`	Impostato `aws_configurator` per utilizzare la configurazione ADOT Python.
`PYTHONPATH`	Sostituisci `$APP_PATH` con la posizione della directory di lavoro dell'applicazione all'interno del contenitore. Questo è necessario affinché l'interprete Python trovi i moduli dell'applicazione.
`DJANGO_SETTINGS_MODULE`	Richiesto solo per le applicazioni Django. Impostalo sulla posizione del file dell'applicazione Django. `settings.py` Sostituisci`$PATH_TO_SETTINGS`.

Monta il volume opentelemetry-auto-instrumentation-python definito nella fase 1 di questa procedura. Se non è necessario abilitare la correlazione dei log con metriche e tracce, utilizzate il seguente esempio per un'applicazione Python. Se desideri abilitare la correlazione dei log, consulta invece il passaggio successivo.


{
  "name": "my-app",
  ...
  "environment": [
    {
      "name": "PYTHONPATH",
      "value": "/otel-auto-instrumentation-python/opentelemetry/instrumentation/auto_instrumentation:$APP_PATH:/otel-auto-instrumentation-python"
    },
    {
      "name": "OTEL_EXPORTER_OTLP_PROTOCOL",
      "value": "http/protobuf"
    },
    {
      "name": "OTEL_TRACES_SAMPLER",
      "value": "xray"
    },
    {
      "name": "OTEL_TRACES_SAMPLER_ARG",
      "value": "endpoint=http://localhost:2000"
    },
    {
      "name": "OTEL_LOGS_EXPORTER",
      "value": "none"
    },
    {
      "name": "OTEL_PYTHON_DISTRO",
      "value": "aws_distro"
    },
    {
      "name": "OTEL_PYTHON_CONFIGURATOR",
      "value": "aws_configurator"
    },
    {
      "name": "OTEL_EXPORTER_OTLP_TRACES_ENDPOINT",
      "value": "http://localhost:4316/v1/traces"
    },
    {
      "name": "OTEL_AWS_APPLICATION_SIGNALS_EXPORTER_ENDPOINT",
      "value": "http://localhost:4316/v1/metrics"
    },
    {
      "name": "OTEL_METRICS_EXPORTER",
      "value": "none"
    },
    {
      "name": "OTEL_AWS_APPLICATION_SIGNALS_ENABLED",
      "value": "true"
    },
    {
      "name": "OTEL_RESOURCE_ATTRIBUTES",
      "value": "service.name=$SVC_NAME"
    },
    {
      "name": "DJANGO_SETTINGS_MODULE",
      "value": "$PATH_TO_SETTINGS.settings"
    }
  ],
  "mountPoints": [
    {
      "sourceVolume": "opentelemetry-auto-instrumentation-python",
      "containerPath": "/otel-auto-instrumentation-python",
      "readOnly": false
    }
  ]
}

(Facoltativo) Per abilitare la correlazione dei log, effettuate le seguenti operazioni prima di montare il volume. InOTEL_RESOURCE_ATTRIBUTES, impostate 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 con le 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 Abilita la correlazione tra metrica e log. Per abilitare la correlazione tra traccia e registro, dovrai anche modificare la configurazione di registrazione nell'applicazione. Per ulteriori informazioni, consulta Abilita la correlazione tra traccia e registro.

Di seguito è riportato un esempio. Per abilitare la correlazione dei log, utilizzate questo esempio quando montate il volume opentelemetry-auto-instrumentation-python definito nel passaggio 1 di questa procedura.


{
  "name": "my-app",
  ...
  "environment": [
    {
      "name": "PYTHONPATH",
      "value": "/otel-auto-instrumentation-python/opentelemetry/instrumentation/auto_instrumentation:$APP_PATH:/otel-auto-instrumentation-python"
    },
    {
      "name": "OTEL_EXPORTER_OTLP_PROTOCOL",
      "value": "http/protobuf"
    },
    {
      "name": "OTEL_TRACES_SAMPLER",
      "value": "xray"
    },
    {
      "name": "OTEL_TRACES_SAMPLER_ARG",
      "value": "endpoint=http://localhost:2000"
    },
    {
      "name": "OTEL_LOGS_EXPORTER",
      "value": "none"
    },
    {
      "name": "OTEL_PYTHON_DISTRO",
      "value": "aws_distro"
    },
    {
      "name": "OTEL_PYTHON_CONFIGURATOR",
      "value": "aws_configurator"
    },
    {
      "name": "OTEL_EXPORTER_OTLP_TRACES_ENDPOINT",
      "value": "http://localhost:4316/v1/traces"
    },
    {
      "name": "OTEL_AWS_APPLICATION_SIGNALS_EXPORTER_ENDPOINT",
      "value": "http://localhost:4316/v1/metrics"
    },
    {
      "name": "OTEL_METRICS_EXPORTER",
      "value": "none"
    },
    {
      "name": "OTEL_AWS_APPLICATION_SIGNALS_ENABLED",
      "value": "true"
    },
    {
      "name": "OTEL_RESOURCE_ATTRIBUTES",
      "value": "aws.log.group.names=$YOUR_APPLICATION_LOG_GROUP,service.name=$SVC_NAME"
    },
    {
      "name": "DJANGO_SETTINGS_MODULE",
      "value": "$PATH_TO_SETTINGS.settings"
    }
  ],
  "mountPoints": [
    {
      "sourceVolume": "opentelemetry-auto-instrumentation-python",
      "containerPath": "/otel-auto-instrumentation-python",
      "readOnly": false
    }
  ]
}

.NET

Per strumentare la tua applicazione su Amazon ECS con l'agente CloudWatch

Innanzitutto, specifica un montaggio vincolato. Il volume verrà utilizzato per condividere file tra container nei passaggi successivi. Dovrai utilizzare questo montaggio vincolato più avanti in questa procedura.
```
"volumes": [
  {
    "name": "opentelemetry-auto-instrumentation"
  }
]
```
Aggiungi una definizione collaterale CloudWatch dell'agente. A tale scopo, aggiungi un nuovo container chiamato ecs-cwagent alla definizione dell'attività dell'applicazione. $REGIONSostituiscila con il nome effettivo della tua regione. Sostituisci $IMAGE con il percorso dell'immagine del CloudWatch contenitore più recente su Amazon Elastic Container Registry. Per maggiori informazioni sull'utilizzo di CloudTrail con Amazon ECR, consulta cloudwatch-agent.

Se desideri invece abilitare l' CloudWatch agente con una strategia daemon, consulta le istruzioni su. Esegui la distribuzione utilizzando la strategia daemon
```
{
  "name": "ecs-cwagent",
  "image": "$IMAGE",
  "essential": true,
  "secrets": [
    {
      "name": "CW_CONFIG_CONTENT",
      "valueFrom": "ecs-cwagent"
    }
  ],
  "logConfiguration": {
    "logDriver": "awslogs",
    "options": {
      "awslogs-create-group": "true",
      "awslogs-group": "/ecs/ecs-cwagent",
      "awslogs-region": "$REGION",
      "awslogs-stream-prefix": "ecs"
    }
  }
}
```

Per un'istanza di contenitore Linux, usa quanto segue.


{
  "name": "init",
  "image": "$IMAGE",
  "essential": false,
  "command": [
      "cp",
      "-a",
      "autoinstrumentation/.",
      "/otel-auto-instrumentation"
  ],
  "mountPoints": [
      {
          "sourceVolume": "opentelemetry-auto-instrumentation",
          "containerPath": "/otel-auto-instrumentation",
          "readOnly": false
      }
  ]
}

Per un'istanza del contenitore Windows Server, usa quanto segue.


{
  "name": "init",
  "image": "$IMAGE",
  "essential": false,
  "command": [
      "CMD",
      "/c",
      "xcopy",
      "/e",
      "C:\\autoinstrumentation\\*",
      "C:\\otel-auto-instrumentation",
      "&&",
      "icacls",
      "C:\\otel-auto-instrumentation",
      "/grant",
      "*S-1-1-0:R",
      "/T"
  ],
  "mountPoints": [
      {
          "sourceVolume": "opentelemetry-auto-instrumentation",
          "containerPath": "C:\\otel-auto-instrumentation",
          "readOnly": false
      }
  ]
}

Aggiungi una dipendenza dal init contenitore per assicurarti che questo contenitore finisca prima dell'avvio del contenitore dell'applicazione.
```
"dependsOn": [
    {
        "containerName": "init",
        "condition": "SUCCESS"
    }
]
```

Aggiungi le seguenti variabili di ambiente al container dell'applicazione. È necessario utilizzare la versione 1.1.0 o successiva dell'agente AWS Distro for OpenTelemetry auto-instrumentation per.NET.

Variabile di ambiente	Impostazione per abilitare Application Signals
`OTEL_RESOURCE_ATTRIBUTES`	Specificate le seguenti informazioni come coppie chiave-valore: `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`. `deployment.environment` imposta l'ambiente in cui viene eseguita l'applicazione. Questo verrà visualizzato come ambiente ospitato dell'applicazione nei pannelli di controllo di Application Signals. Se non lo specificate, `generic:default` viene utilizzato il valore predefinito di. Questa chiave di attributo viene utilizzata solo da Application Signals e viene convertita in annotazioni di tracce a raggi X e CloudWatch dimensioni metriche.
`OTEL_AWS_APPLICATION_SIGNALS_ENABLED`	Imposta per `true` fare in modo che il contenitore inizi a inviare tracce e CloudWatch metriche X-Ray ad Application Signals.
`OTEL_METRICS_EXPORTER`	Imposta su `none` per disabilitare gli esportatori di altri parametri.
`OTEL_LOGS_EXPORTER`	Impostato per `none` disabilitare altri esportatori di log.
`OTEL_EXPORTER_OTLP_PROTOCOL`	Imposta su `http/protobuf` per inviare metriche e tracce ad Application Signals tramite HTTP.
`OTEL_AWS_APPLICATION_SIGNALS_EXPORTER_ENDPOINT`	Imposta su `http://localhost:4316/v1/metrics` per inviare le metriche al sidecar. CloudWatch
`OTEL_EXPORTER_OTLP_ENDPOINT`	Imposta su `http://localhost:4316/` per inviare tracce al sidecar. CloudWatch
`OTEL_EXPORTER_OTLP_TRACES_ENDPOINT`	Imposta su `http://localhost:4316/v1/traces` per inviare tracce al CloudWatch sidecar.
`OTEL_DOTNET_AUTO_HOME`	Impostato sulla posizione di installazione della strumentazione automatica ADOT .NET.
`OTEL_DOTNET_AUTO_PLUGINS`	Impostato per `AWS.Distro.OpenTelemetry.AutoInstrumentation.Plugin, AWS.Distro.OpenTelemetry.AutoInstrumentation` abilitare il plug-in Application Signals.
`CORECLR_ENABLE_PROFILING`	Impostare `1` per abilitare il profiler.
`CORECLR_PROFILER`	Imposta su `{918728DD-259F-4A6A-AC2B-B85E1B658318}` come CLSID del profiler.
`CORECLR_PROFILER_PATH`	Imposta questo valore sul percorso del profiler. Su Linux, impostalo su `${OTEL_DOTNET_AUTO_HOME}/linux-x64/OpenTelemetry.AutoInstrumentation.Native.so` In Windows Server, impostalo su `${OTEL_DOTNET_AUTO_HOME}/win-x64/OpenTelemetry.AutoInstrumentation.Native.dll`
`DOTNET_ADDITIONAL_DEPS`	Imposta questo valore sul percorso della cartella di`${OTEL_DOTNET_AUTO_HOME}/AdditionalDeps`.
`DOTNET_SHARED_STORE`	Imposta questo valore sul percorso della cartella di`${OTEL_DOTNET_AUTO_HOME}/store`.
`DOTNET_STARTUP_HOOKS`	Imposta questo valore sul percorso dell'assieme gestito `${OTEL_DOTNET_AUTO_HOME}/net/OpenTelemetry.AutoInstrumentation.StartupHook.dll` da eseguire prima del punto di ingresso dell'applicazione principale.

Monta il volume opentelemetry-auto-instrumentation definito nella fase 1 di questa procedura. Per Linux, utilizzate quanto segue.


{
    "name": "my-app",
   ...
    "environment": [
        {
           "name": "OTEL_RESOURCE_ATTRIBUTES",
           "value": "service.name=$SVC_NAME" 
       },
        {
            "name": "CORECLR_ENABLE_PROFILING",
            "value": "1"
        },
        {
            "name": "CORECLR_PROFILER",
            "value": "{918728DD-259F-4A6A-AC2B-B85E1B658318}"
        },
        {
            "name": "CORECLR_PROFILER_PATH",
            "value": "/otel-auto-instrumentation/linux-x64/OpenTelemetry.AutoInstrumentation.Native.so"
        },
        {
            "name": "DOTNET_ADDITIONAL_DEPS",
            "value": "/otel-auto-instrumentation/AdditionalDeps"
        },
        {
            "name": "DOTNET_SHARED_STORE",
            "value": "/otel-auto-instrumentation/store"
        },
        {
            "name": "DOTNET_STARTUP_HOOKS",
            "value": "/otel-auto-instrumentation/net/OpenTelemetry.AutoInstrumentation.StartupHook.dll"
        },
        {
            "name": "OTEL_DOTNET_AUTO_HOME",
            "value": "/otel-auto-instrumentation"
        },
        {
            "name": "OTEL_DOTNET_AUTO_PLUGINS",
            "value": "AWS.Distro.OpenTelemetry.AutoInstrumentation.Plugin, AWS.Distro.OpenTelemetry.AutoInstrumentation"
        },
        {
            "name": "OTEL_RESOURCE_ATTRIBUTES",
            "value": "aws.log.group.names=$YOUR_APPLICATION_LOG_GROUP,service.name=aws-dotnet-service-name"
        },
        {
            "name": "OTEL_LOGS_EXPORTER",
            "value": "none"
        },
        {
            "name": "OTEL_METRICS_EXPORTER",
            "value": "none"
        },
        {
            "name": "OTEL_EXPORTER_OTLP_PROTOCOL",
            "value": "http/protobuf"
        },
        {
            "name": "OTEL_AWS_APPLICATION_SIGNALS_ENABLED",
            "value": "true"
        },
        {
            "name": "OTEL_AWS_APPLICATION_SIGNALS_EXPORTER_ENDPOINT",
            "value": "http://localhost:4316/v1/metrics"
        },
        {
            "name": "OTEL_EXPORTER_OTLP_TRACES_ENDPOINT",
            "value": "http://localhost:4316/v1/traces"
        },
        {
            "name": "OTEL_EXPORTER_OTLP_ENDPOINT",
            "value": "http://localhost:4316"
        },
        {
           "name": "OTEL_TRACES_SAMPLER",
           "value": "xray"
       },
       {
           "name": "OTEL_TRACES_SAMPLER_ARG",
           "value": "endpoint=http://localhost:2000"
       },
        {
            "name": "OTEL_PROPAGATORS",
            "value": "tracecontext,baggage,b3,xray"
        }
    ],
    "dependsOn": [
    {
      "containerName": "init",
      "condition": "SUCCESS"
    }
  ],
    "mountPoints": [
        {
            "sourceVolume": "opentelemetry-auto-instrumentation",
            "containerPath": "/otel-auto-instrumentation",
            "readOnly": false
        }
    ]
}

Per Windows Server, utilizzare quanto segue.


{
    "name": "my-app",
   ...
    "environment": [
       {
           "name": "OTEL_RESOURCE_ATTRIBUTES",
           "value": "service.name=$SVC_NAME" 
       },
        {
            "name": "CORECLR_ENABLE_PROFILING",
            "value": "1"
        },
        {
            "name": "CORECLR_PROFILER",
            "value": "{918728DD-259F-4A6A-AC2B-B85E1B658318}"
        },
        {
            "name": "CORECLR_PROFILER_PATH",
            "value": "C:\\otel-auto-instrumentation\\win-x64\\OpenTelemetry.AutoInstrumentation.Native.dll"
        },
        {
            "name": "DOTNET_ADDITIONAL_DEPS",
            "value": "C:\\otel-auto-instrumentation\\AdditionalDeps"
        },
        {
            "name": "DOTNET_SHARED_STORE",
            "value": "C:\\otel-auto-instrumentation\\store"
        },
        {
            "name": "DOTNET_STARTUP_HOOKS",
            "value": "C:\\otel-auto-instrumentation\\net\\OpenTelemetry.AutoInstrumentation.StartupHook.dll"
        },
        {
            "name": "OTEL_DOTNET_AUTO_HOME",
            "value": "C:\\otel-auto-instrumentation"
        },
        {
            "name": "OTEL_DOTNET_AUTO_PLUGINS",
            "value": "AWS.Distro.OpenTelemetry.AutoInstrumentation.Plugin, AWS.Distro.OpenTelemetry.AutoInstrumentation"
        },
        {
            "name": "OTEL_RESOURCE_ATTRIBUTES",
            "value": "aws.log.group.names=$YOUR_APPLICATION_LOG_GROUP,service.name=dotnet-service-name"
        },
        {
            "name": "OTEL_LOGS_EXPORTER",
            "value": "none"
        },
        {
            "name": "OTEL_METRICS_EXPORTER",
            "value": "none"
        },
        {
            "name": "OTEL_EXPORTER_OTLP_PROTOCOL",
            "value": "http/protobuf"
        },
        {
            "name": "OTEL_AWS_APPLICATION_SIGNALS_ENABLED",
            "value": "true"
        },
        {
            "name": "OTEL_AWS_APPLICATION_SIGNALS_EXPORTER_ENDPOINT",
            "value": "http://localhost:4316/v1/metrics"
        },
        {
            "name": "OTEL_EXPORTER_OTLP_TRACES_ENDPOINT",
            "value": "http://localhost:4316/v1/traces"
        },
        {
            "name": "OTEL_EXPORTER_OTLP_ENDPOINT",
            "value": "http://localhost:4316"
        },
        {
           "name": "OTEL_TRACES_SAMPLER",
           "value": "xray"
       },
       {
           "name": "OTEL_TRACES_SAMPLER_ARG",
           "value": "endpoint=http://localhost:2000"
       },
        {
            "name": "OTEL_PROPAGATORS",
            "value": "tracecontext,baggage,b3,xray"
        }
    ],
    "mountPoints": [
        {
            "sourceVolume": "opentelemetry-auto-instrumentation",
            "containerPath": "C:\\otel-auto-instrumentation",
            "readOnly": false
        }
    ],
    "dependsOn": [
        {
            "containerName": "init",
            "condition": "SUCCESS"
        }
   ]
}

Node.js

Nota

Se state abilitando Application Signals per un'applicazione Node.js con ESM, consultate Setting up a Node.js application with the ESM module format prima di iniziare questi passaggi.

Per strumentare la tua applicazione su Amazon ECS con l'agente CloudWatch

Innanzitutto, specifica un montaggio vincolato. Il volume verrà utilizzato per condividere file tra container nei passaggi successivi. Dovrai utilizzare questo montaggio vincolato più avanti in questa procedura.
```
"volumes": [
  {
    "name": "opentelemetry-auto-instrumentation-node"
  }
]
```
Aggiungi una definizione collaterale CloudWatch dell'agente. A tale scopo, aggiungi un nuovo container chiamato ecs-cwagent alla definizione dell'attività dell'applicazione. $REGIONSostituiscila con il nome effettivo della tua regione. Sostituisci $IMAGE con il percorso dell'immagine del CloudWatch contenitore più recente su Amazon Elastic Container Registry. Per maggiori informazioni sull'utilizzo di CloudTrail con Amazon ECR, consulta cloudwatch-agent.

Se desideri invece abilitare l' CloudWatch agente con una strategia daemon, consulta le istruzioni su. Esegui la distribuzione utilizzando la strategia daemon
```
{
  "name": "ecs-cwagent",
  "image": "$IMAGE",
  "essential": true,
  "secrets": [
    {
      "name": "CW_CONFIG_CONTENT",
      "valueFrom": "ecs-cwagent"
    }
  ],
  "logConfiguration": {
    "logDriver": "awslogs",
    "options": {
      "awslogs-create-group": "true",
      "awslogs-group": "/ecs/ecs-cwagent",
      "awslogs-region": "$REGION",
      "awslogs-stream-prefix": "ecs"
    }
  }
}
```


{
  "name": "init",
  "image": "$IMAGE",
  "essential": false,
  "command": [
    "cp",
    "-a",
    "/autoinstrumentation/.",
    "/otel-auto-instrumentation-node"
  ],
  "mountPoints": [
    {
      "sourceVolume": "opentelemetry-auto-instrumentation-node",
      "containerPath": "/otel-auto-instrumentation-node",
      "readOnly": false
    }
  ],
}

Aggiungi una dipendenza dal init contenitore per assicurarti che questo contenitore finisca prima dell'avvio del contenitore dell'applicazione.
```
"dependsOn": [
  {
    "containerName": "init",
    "condition": "SUCCESS"
  }
]
```

Aggiungi le seguenti variabili di ambiente al container dell'applicazione.

Variabile di ambiente	Impostazione per abilitare Application Signals
`OTEL_RESOURCE_ATTRIBUTES`	Specificate le seguenti informazioni come coppie chiave-valore: `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`. `deployment.environment` imposta l'ambiente in cui viene eseguita l'applicazione. Questo verrà visualizzato come ambiente ospitato dell'applicazione nei pannelli di controllo di Application Signals. Se non lo specificate, `generic:default` viene utilizzato il valore predefinito di. Questa chiave di attributo viene utilizzata solo da Application Signals e viene convertita in annotazioni di tracce a raggi X e CloudWatch dimensioni metriche. (Facoltativo) Per abilitare la correlazione dei log per Application Signals, impostate una variabile `aws.log.group.names` di ambiente aggiuntiva come nome del gruppo di log per il log dell'applicazione. In questo modo, le tracce e le metriche dell'applicazione possono essere correlate con le voci di registro pertinenti del gruppo 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 Abilita la correlazione tra metrica e log. Per abilitare la correlazione tra traccia e registro, dovrai anche modificare la configurazione di registrazione nell'applicazione. Per ulteriori informazioni, consulta Abilita la correlazione tra traccia e registro.
`OTEL_AWS_APPLICATION_SIGNALS_ENABLED`	Imposta per `true` fare in modo che il contenitore inizi a inviare tracce e CloudWatch metriche X-Ray ad Application Signals.
`OTEL_METRICS_EXPORTER`	Imposta su `none` per disabilitare gli esportatori di altri parametri.
`OTEL_LOGS_EXPORTER`	Impostato per `none` disabilitare altri esportatori di log.
`OTEL_EXPORTER_OTLP_PROTOCOL`	Imposta su per `http/protobuf` inviare metriche e tracce a Application Signals utilizzando OTLP/HTTP e protobuf.
`OTEL_AWS_APPLICATION_SIGNALS_EXPORTER_ENDPOINT`	Imposta su per inviare le metriche `http://localhost:4316/v1/metrics` al sidecar. CloudWatch
`OTEL_EXPORTER_OTLP_TRACES_ENDPOINT`	Imposta su `http://localhost:4316/v1/traces` per inviare tracce al sidecar. CloudWatch
`OTEL_TRACES_SAMPLER`	Impostalo su per `xray` impostare X-Ray come campionatore di tracce.
`OTEL_PROPAGATORS`	Imposta `xray` come uno dei propagatori.
`NODE_OPTIONS`	Imposta su `--require AWS_ADOT_NODE_INSTRUMENTATION_PATH`. Sostituire `AWS_ADOT_NODE_INSTRUMENTATION_PATH` con il percorso in cui è memorizzata la strumentazione automatica AWS Distro for OpenTelemetry Node.js. Ad esempio, `/otel-auto-instrumentation-node/autoinstrumentation.js`

Monta il volume opentelemetry-auto-instrumentation definito nella fase 1 di questa procedura. Se non è necessario abilitare la correlazione dei log con metriche e tracce, utilizzate il seguente esempio per un'applicazione Node.js. Se desideri abilitare la correlazione dei log, consulta invece il passaggio successivo.

Per il tuo Application Container, aggiungi una dipendenza dal init contenitore per assicurarti che il contenitore finisca prima dell'avvio del contenitore dell'applicazione.


{
  "name": "my-app",
   ...
  "environment": [
    {
      "name": "OTEL_RESOURCE_ATTRIBUTES",
      "value": "service.name=$SVC_NAME"
    },
    {
      "name": "OTEL_LOGS_EXPORTER",
      "value": "none"
    },
    {
      "name": "OTEL_METRICS_EXPORTER",
      "value": "none"
    },
    {
      "name": "OTEL_EXPORTER_OTLP_PROTOCOL",
      "value": "http/protobuf"
    },
    {
      "name": "OTEL_AWS_APPLICATION_SIGNALS_ENABLED",
      "value": "true"
    },
    {
      "name": "OTEL_AWS_APPLICATION_SIGNALS_EXPORTER_ENDPOINT",
      "value": "http://localhost:4316/v1/metrics"
    },
    {
      "name": "OTEL_EXPORTER_OTLP_TRACES_ENDPOINT",
      "value": "http://localhost:4316/v1/traces"
    },
    {
      "name": "OTEL_TRACES_SAMPLER",
      "value": "xray"
    },
    {
      "name": "OTEL_TRACES_SAMPLER_ARG",
      "value": "endpoint=http://localhost:2000"
    },
    {
      "name": "NODE_OPTIONS",
      "value": "--require /otel-auto-instrumentation-node/autoinstrumentation.js"
    }
    ],
  "mountPoints": [
    {
      "sourceVolume": "opentelemetry-auto-instrumentation-node",
      "containerPath": "/otel-auto-instrumentation-node",
      "readOnly": false
    }
  ],
  "dependsOn": [
    {
      "containerName": "init",
      "condition": "SUCCESS"
    }
  ]
}

Di seguito è riportato un esempio. Utilizzate questo esempio per abilitare la correlazione dei log quando montate il volume definito nel passaggio 1 di opentelemetry-auto-instrumentation questa procedura.


{
  "name": "my-app",
   ...
  "environment": [
    {
      "name": "OTEL_RESOURCE_ATTRIBUTES",
      "value": "aws.log.group.names=$YOUR_APPLICATION_LOG_GROUP,service.name=$SVC_NAME"
    },
    {
      "name": "OTEL_LOGS_EXPORTER",
      "value": "none"
    },
    {
      "name": "OTEL_METRICS_EXPORTER",
      "value": "none"
    },
    {
      "name": "OTEL_EXPORTER_OTLP_PROTOCOL",
      "value": "http/protobuf"
    },
    {
      "name": "OTEL_AWS_APPLICATION_SIGNALS_ENABLED",
      "value": "true"
    },
    {
      "name": "OTEL_AWS_APPLICATION_SIGNALS_EXPORTER_ENDPOINT",
      "value": "http://localhost:4316/v1/metrics"
    },
    {
      "name": "OTEL_EXPORTER_OTLP_TRACES_ENDPOINT",
      "value": "http://localhost:4316/v1/traces"
    },
    {
      "name": "OTEL_TRACES_SAMPLER",
      "value": "xray"
    },
    {
      "name": "OTEL_TRACES_SAMPLER_ARG",
      "value": "endpoint=http://localhost:2000"
    },
    {
      "name": "NODE_OPTIONS",
      "value": "--require /otel-auto-instrumentation-node/autoinstrumentation.js"
    }
    ],
  "mountPoints": [
    {
      "sourceVolume": "opentelemetry-auto-instrumentation-node",
      "containerPath": "/otel-auto-instrumentation-node",
      "readOnly": false
    }
  ],
  "dependsOn": [
    {
      "containerName": "init",
      "condition": "SUCCESS"
    }
  ]
}

Configurazione di un'applicazione Node.js con il formato del modulo ESM

Forniamo un supporto limitato per le applicazioni Node.js con il formato del modulo ESM. Per informazioni dettagliate, consultare Limitazioni note relative a Node.js con ESM.

Per il formato del modulo ESM, l'utilizzo del init contenitore per iniettare l'SDK di strumentazione Node.js non è applicabile. Per abilitare Application Signals for Node.js con ESM, salta i passaggi 1 e 3 della procedura precedente e procedi invece come segue.

Per abilitare Application Signals per un'applicazione Node.js con ESM

Installa le dipendenze pertinenti nell'applicazione Node.js per l'autostrumentazione:


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

Nei passaggi 5 e 6 della procedura precedente, rimuovete il montaggio del volume: opentelemetry-auto-instrumentation-node


 "mountPoints": [ 
    {
        "sourceVolume": "opentelemetry-auto-instrumentation-node", 
        "containerPath": "/otel-auto-instrumentation-node", 
        "readOnly": false 
    }
 ]

Sostituite le opzioni del nodo con le seguenti.


{
    "name": "NODE_OPTIONS", 
    "value": "--import @aws/aws-distro-opentelemetry-node-autoinstrumentation/register --experimental-loader=@opentelemetry/instrumentation/hook.mjs" 
}

Fase 5: distribuzione dell'applicazione

Crea una nuova revisione della definizione dell'attività e distribuiscila nel tuo cluster di applicazioni. Dovresti vedere tre container nell'attività appena creata:

init— Un contenitore necessario per l'inizializzazione dei segnali di applicazione.
ecs-cwagent— Un contenitore su cui è in esecuzione l'agente CloudWatch
my-app— Questo è il contenitore di applicazioni di esempio nella nostra documentazione. Nei carichi di lavoro effettivi, questo contenitore specifico potrebbe non esistere o potrebbe essere sostituito con contenitori di servizi personalizzati.

(Facoltativo) Fase 6: Monitora lo stato dell'applicazione

Dopo aver abilitato le applicazioni su Amazon ECS, puoi monitorare lo stato delle applicazioni. Per ulteriori informazioni, consulta Monitoraggio dell'integrità operativa delle applicazioni con Application Signals.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Abilita le tue applicazioni su Amazon ECS

Esegui la distribuzione utilizzando la strategia daemon