View a markdown version of this page

Ativar o Container Insights - AWS Batch

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Ativar o Container Insights

Conclua as etapas a seguir para ativar o Container Insights para ambientes AWS Batch computacionais.

Console de gerenciamento da AWS

  1. Abra o console do AWS Batch.

  2. Escolha Environments (Ambientes).

  3. Escolha o ambiente de computação que deseja.

  4. Na aba Insights de contêiner, ative Insights de contêiner para o ambiente computacional.

    dica

    Você pode selecionar um intervalo padrão para agregar as métricas ou criar um intervalo personalizado.

AWS CLI

Ative o Container Insights ao criar um ambiente computacional

Use o --ecs-settings parâmetro with create-compute-environment para ativar o Container Insights em um novo ambiente computacional.

$ aws batch create-compute-environment \
    --compute-environment-name my-compute-env \
    --type MANAGED \
    --state ENABLED \
    --ecs-settings containerInsights=ENHANCED \
    --compute-resources type=FARGATE,maxvCpus=256,subnets=subnet-a123456b,securityGroupIds=sg-a12b3456

Os valores válidos para containerInsights são ENABLED, ENHANCED e DISABLED.

Habilite o Container Insights em um ambiente computacional existente

Use update-compute-environment para ativar ou alterar o Container Insights em um ambiente computacional existente.

$ aws batch update-compute-environment \
    --compute-environment my-compute-env \
    --ecs-settings containerInsights=ENHANCED

Verifique a configuração do Container Insights

Use describe-compute-environments para verificar a configuração atual.

$ aws batch describe-compute-environments \
    --compute-environments my-compute-env \
    --query "computeEnvironments[0].ecsSettings"

O seguinte mostra a saída quando o Container Insights está ativado.

{
    "containerInsights": "ENHANCED"
}
nota

Se o Container Insights nunca tiver sido definido no ambiente computacional, o ecsSettings campo estará ausente da resposta.

API

Use o ecsSettings parâmetro em sua CreateComputeEnvironment UpdateComputeEnvironment solicitação.

Crie um ambiente computacional com o Container Insights

Inclua ecsSettings no corpo da solicitação:

{
    "computeEnvironmentName": "my-compute-env",
    "type": "MANAGED",
    "state": "ENABLED",
    "ecsSettings": {
        "containerInsights": "ENHANCED"
    },
    "computeResources": {
        "type": "FARGATE",
        "maxvCpus": 256,
        "subnets": ["subnet-a123456b"],
        "securityGroupIds": ["sg-a12b3456"]
    }
}

Atualize o Container Insights em um ambiente computacional existente 

{
    "computeEnvironment": "my-compute-env",
    "ecsSettings": {
        "containerInsights": "ENHANCED"
    }
}

Para obter mais informações, consulte CreateComputeEnvironment e UpdateComputeEnvironment na Referência da API do AWS Batch .

Importante

Depois de definir um valor do Container Insights em um ambiente computacional, você não pode reverter para o comportamento padrão (não definido), no qual a configuração do Container Insights é gerenciada fora do. AWS Batch Para alterar o modo Container Insights, você deve chamar UpdateComputeEnvironment com o novo valor.

Isso também significa que, se você definir essa propriedade em um CloudFormation modelo, uma reversão de pilha não poderá reverter a configuração para seu estado anterior não definido.