Introspezione dei container Amazon ECS - Amazon Elastic Container Service

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à.

Introspezione dei container Amazon ECS

L'agente del container di Amazon ECS fornisce un'operazione API per raccogliere i dettagli sull'istanza di container su cui è in esecuzione l'agente e sui processi associati in esecuzione su tale istanza. Puoi utilizzare il comando curl dall'interno dell'istanza di container per interrogare l'agente del container di Amazon ECS (porta 51678) e restituire metadati dell'istanza di container o informazioni sulle attività.

Importante

L'istanza di container deve disporre di un ruolo IAM che consenta l'accesso ad Amazon ECS per recuperare i metadati. Per ulteriori informazioni, consulta Ruolo IAM delle istanze di container Amazon ECS.

Per visualizzare i metadati dell'istanza di container, accedi alla tua istanza di container tramite SSH ed esegui il comando seguente. I metadati includono l'ID dell'istanza di container, il cluster Amazon ECS in cui è registrata l'istanza di container e le informazioni sulla versione dell'agente del container di Amazon ECS.

curl -s http://localhost:51678/v1/metadata | python3 -mjson.tool

Output:

{
    "Cluster": "cluster_name",
    "ContainerInstanceArn": "arn:aws:ecs:region:aws_account_id:container-instance/cluster_name/container_instance_id",
    "Version": "Amazon ECS Agent - v1.30.0 (02ff320c)"
}

Per visualizzare le informazioni su tutte le attività in esecuzione in un'istanza di container, accedi alla tua istanza di container tramite SSH ed esegui il comando seguente:

curl http://localhost:51678/v1/tasks

Output:

{
    "Tasks": [
        {
            "Arn": "arn:aws:ecs:us-west-2:012345678910:task/default/example5-58ff-46c9-ae05-543f8example",
            "DesiredStatus": "RUNNING",
            "KnownStatus": "RUNNING",
            "Family": "hello_world",
            "Version": "8",
            "Containers": [
                {
          "DockerId": "9581a69a761a557fbfce1d0f6745e4af5b9dbfb86b6b2c5c4df156f1a5932ff1",
          "DockerName": "ecs-hello_world-8-mysql-fcae8ac8f9f1d89d8301",
          "Name": "mysql",
          "CreatedAt": "2023-10-08T20:09:11.44527186Z",
          "StartedAt": "2023-10-08T20:09:11.44527186Z",
          "ImageID": "sha256:2ae34abc2ed0a22e280d17e13f9c01aaf725688b09b7a1525d1a2750e2c0d1de"
        },
        {
          "DockerId": "bf25c5c5b2d4dba68846c7236e75b6915e1e778d31611e3c6a06831e39814a15",
          "DockerName": "ecs-hello_world-8-wordpress-e8bfddf9b488dff36c00",
          "Name": "wordpress"
        }
    ]
}
    ]
}

Puoi visualizzare le informazioni per una determinata attività in esecuzione in un'istanza di container. Per specificare una determinata attività o uno specifico container, aggiungi uno dei seguenti elementi alla richiesta:

  • L'ARN dell'attività (?taskarn=task_arn)

  • L'ID Docker per un container (?dockerid=docker_id)

Per ottenere informazioni sulle attività con un ID Docker del container, accedi alla tua istanza di container tramite SSH ed esegui il comando seguente.

Nota

Gli agenti container Amazon ECS precedenti alla versione 1.14.2 richiedono un contenitore Docker completo IDs per l'API di introspezione, non la versione breve mostrata con. docker ps Puoi ottenere l'ID Docker completo per un container eseguendo il comando docker ps --no-trunc nell'istanza di container.

curl http://localhost:51678/v1/tasks?dockerid=79c796ed2a7f

Output:

{
    "Arn": "arn:aws:ecs:us-west-2:012345678910:task/default/e01d58a8-151b-40e8-bc01-22647b9ecfec",
    "Containers": [
        {
            "DockerId": "79c796ed2a7f864f485c76f83f3165488097279d296a7c05bd5201a1c69b2920",
            "DockerName": "ecs-nginx-efs-2-nginx-9ac0808dd0afa495f001",
            "Name": "nginx",
            "CreatedAt": "2023-10-08T20:09:11.44527186Z",
            "StartedAt": "2023-10-08T20:09:11.44527186Z",
            "ImageID": "sha256:2ae34abc2ed0a22e280d17e13f9c01aaf725688b09b7a1525d1a2750e2c0d1de"
        }
    ],
    "DesiredStatus": "RUNNING",
    "Family": "nginx-efs",
    "KnownStatus": "RUNNING",
    "Version": "2"
}