Mensagens de evento de serviço

Se você estiver solucionando um problema em um serviço, o primeiro lugar em que você deverá procurar informações de diagnóstico é o log de eventos do serviço. Você pode visualizar eventos de serviço usando a API DescribeServices, a AWS CLI a opção AWS Management Console.

Ao visualizar mensagens de evento de serviço usando a API do Amazon ECS, somente os eventos do programador de serviço são retornados. Esses eventos incluem o posicionamento de tarefas e eventos de integridade da instância mais recentes. No entanto, o console do Amazon ECS exibe eventos de serviço das fontes a seguir.

• Posicionamento de tarefas e eventos de integridade da instância do programador de serviço do Amazon ECS. Esses eventos terão o prefixo serviço (service-name). Para garantir que a visualização desse evento seja útil, mostramos somente os 100 eventos mais recentes e as mensagens de evento duplicadas são omitidas até que a causa seja resolvida ou decorram seis horas. Se a causa não for resolvida em até seis horas, você receberá outra mensagem de evento de serviço para essa causa.

• Eventos de Auto Scaling do serviço. Esses eventos terão o prefixo Mensagem. Os 10 eventos de escalabilidade mais recentes são mostrados. Esses eventos só ocorrem quando um serviço é configurado com uma política de escalabilidade do Application Auto Scaling.

Use as etapas a seguir para visualizar as mensagens de evento de serviço atuais.

Console

1. Abra o console em https://console.aws.amazon.com/ecs/v2.

2. No painel de navegação, escolha Clusters.

3. Na página Clusters, escolha o cluster.

4. Escolha o serviço a ser inspecionado.

5. Escolha Deployments and events (Implantações e eventos), em Events (Eventos), visualize as mensagens.

AWS CLI

Use o comando describe-serviços para visualizar as mensagens de evento de serviço para um serviço especificado.

O exemplo de AWS CLI a seguir descreve o serviço service-name no cluster padrão, que fornece as mensagens de evento de serviço mais recentes.

aws ecs describe-services \
    --cluster default \
    --services service-name \
    --region us-west-2

Mensagens de evento de serviço

Veja a seguir exemplos de mensagens de eventos de serviço que você pode ver no console do Amazon ECS.

O serviço (service-name) não consegue iniciar tarefas com êxito de maneira consistente.

Esse serviço contém tarefas que deixaram de ser iniciadas após tentativas consecutivas. Nesse ponto, o programador de serviço começa a aumentar incrementalmente o tempo entre as novas tentativas. Você deve solucionar o motivo pelo qual suas tarefas falham ao iniciar. Para obter mais informações, consulte Lógica de controle de utilização de serviço.

Depois que o serviço estiver atualizado, por exemplo, com uma definição de tarefa atualizada, o programador de serviços retomará o comportamento normal.

As operações do serviço (service-name) estão tendo a utilização controlada. Tentará novamente mais tarde.

Este serviço não consegue iniciar mais tarefas devido aos limites do controle de utilização da API. Como o programador de serviço é capaz de iniciar mais tarefas, ele é retomado.

Para solicitar um aumento na cota de limite da taxa de API, abra a página AWS Support Center, faça login, se necessário, e escolha Create case (Criar caso). Escolha Service limit increase (Aumento de limite do serviço). Preencha e envie o formulário.

O serviço (service-name) não conseguiu interromper ou iniciar tarefas durante uma implantação devido à configuração de implantação do serviço. Atualize o valor minimumHealthyPercent ou MaximumPercent e tente novamente.

Esse serviço não conseguiu interromper ou iniciar tarefas durante uma implantação de serviço devido à configuração da implantação. A configuração de implantação consiste nos valores minimumHealthyPercent e maximumPercent, que são definidos quando o serviço é criado, mas também podem ser atualizados em um serviço existente.

O minimumHealthyPercent representa o limite inferior do número de tarefas que devem estar sendo executadas para um serviço durante uma implantação ou quando uma instância de contêiner está sendo drenada, como uma porcentagem do número desejado de tarefas para o serviço. Esse valor é arredondado para cima. Por exemplo, se a porcentagem mínima de integridade é 50 e a contagem de tarefas desejadas é quatro, o programador pode interromper duas tarefas existentes antes de iniciar duas novas tarefas. Da mesma forma, se a porcentagem mínima de integridade é 75% e a contagem de tarefas desejada é dois, o programador não pode parar quaisquer tarefas porque o valor resultante também é dois.

O maximumPercent representa o limite superior do número de tarefas que devem estar sendo executadas para um serviço durante uma implantação ou quando uma instância de contêiner está sendo drenada, como uma porcentagem do número desejado de tarefas para o serviço. Esse valor é arredondado para baixo. Por exemplo, se a porcentagem máxima de integridade for 200 e a contagem de tarefas desejadas for quatro, o programador poderá iniciar quatro novas tarefas antes de interromper quatro tarefas existentes. Da mesma forma, se a porcentagem máxima de integridade é 125 e a contagem de tarefas desejada é três, o programador não pode iniciar quaisquer tarefas porque o valor resultante também é três.

Ao definir um percentual mínimo de integridade ou um percentual máximo, você deve garantir que o programador possa interromper ou iniciar pelo menos uma tarefa quando uma implantação é acionada.

O serviço (service-name) não conseguiu posicionar uma tarefa. Motivo: você atingiu o limite do número de tarefas que podem ser executadas simultaneamente

Você pode solicitar um aumento de cota para o recurso que causou o erro. Para obter mais informações, consulte Cotas de serviço do Amazon ECS. Para solicitar o aumento da cota, consulte Requesting a Quota Increase (Solicitar um aumento de cota) no Guia do usuário do Service Quotas.

O serviço (service-name) não conseguiu posicionar uma tarefa. Motivo: erro interno.

A seguir estão os possíveis motivos desse erro:

• O serviço não consegue iniciar uma tarefa devido a uma sub-rede estar em uma zona de disponibilidade sem suporte.

  Para obter mais informações sobre as regiões do Fargate e zonas de disponibilidade com suporte, consulte Regiões com suporte para Amazon ECS no AWS Fargate.

  Para obter informações sobre como visualizar a zona de disponibilidade de sub-rede, consulte Visualizar sua sub-rede no Guia do usuário da Amazon VPC.

• Você está tentando executar uma definição de tarefa que usa a arquitetura ARM no Fargate Spot.

O serviço (service-name) não conseguiu posicionar uma tarefa. Motivo: a configuração de CPU solicitada está acima do limite.

Você pode solicitar um aumento de cota para o recurso que causou o erro. Para obter mais informações, consulte Cotas de serviço do Amazon ECS. Para solicitar o aumento da cota, consulte Requesting a Quota Increase (Solicitar um aumento de cota) no Guia do usuário do Service Quotas.

O serviço (service-name) não conseguiu posicionar uma tarefa. Motivo: A configuração MEMORY solicitada está acima do limite.

Você pode solicitar um aumento de cota para o recurso que causou o erro. Para obter mais informações, consulte Cotas de serviço do Amazon ECS. Para solicitar o aumento da cota, consulte Requesting a Quota Increase (Solicitar um aumento de cota) no Guia do usuário do Service Quotas.

O serviço (service-name) não conseguiu posicionar uma tarefa. Motivo: você atingiu o limite do número de vCPUs que pode executar simultaneamente

O AWS Fargate está fazendo a transição de cotas baseadas em contagem de tarefas para cotas baseadas em vCPU.

Você pode solicitar um aumento de cota para a cota baseada em vCPU do Fargate. Para obter mais informações, consulte Cotas de serviço do Amazon ECS. Para solicitar o aumento da cota do Fargate, consulte Requesting a Quota Increase (Solicitar um aumento de cota) no Guia do usuário do Service Quotas.

O serviço (service-name) não conseguiu atingir o estado estacionário porque o conjunto de tarefas (taskSet-ID) não conseguiu reduzir a escala horizontalmente. Motivo: o número de tarefas protegidas é maior do que a contagem desejada de tarefas.

O serviço tem mais tarefas protegidas do que a contagem desejada de tarefas. Você pode executar uma das seguintes ações:

• Aguarde até que a proteção das tarefas atuais expire, permitindo que elas sejam encerradas.

• Determine quais tarefas podem ser interrompidas. Em seguida, use a API UpdateTaskProtection com a opção protectionEnabled definida como false para cancelar a proteção dessas tarefas.

• Aumente a contagem de tarefas desejada do serviço para mais do que o número de tarefas protegidas.

O serviço (service-name) não conseguiu posicionar uma tarefa. Motivo: A capacidade não está disponível no momento. Tente novamente mais tarde ou em uma zona de disponibilidade diferente.

No momento, não há capacidade disponível para executar seu serviço.

Você pode executar uma das seguintes ações:

• Espere até que a capacidade do Fargate ou as instâncias de contêiner do EC2 estejam disponíveis.

• Reinicie o serviço e especifique sub-redes adicionais.