Coleta de logs de contêiner com o coletor de logs do Amazon ECS - Amazon Elastic Container Service

Coleta de logs de contêiner com o coletor de logs do Amazon ECS

nota

Você não pode usar o coletor de logs do Amazon ECS nas instâncias gerenciadas do Amazon ECS.

Se você não tiver certeza de como coletar todos os vários logs nas instâncias de contêiner, poderá usar o coletor de logs do Amazon ECS. Ele está disponível no GitHub para os sistemas Linux e Windows. O script coleta logs gerais do sistema operacional geral, além dos logs do agente de contêiner do Docker e do Amazon ECS, que podem ser úteis para solucionar problemas de casos do AWS Support. Em seguida, compacta e arquiva os dados coletados em um único arquivo que pode ser facilmente compartilhado para fins de diagnóstico. Também oferece suporte à habilitação do modo de depuração do daemon do Docker e do agente de contêiner do Amazon ECS em variantes do Amazon Linux, como a AMI otimizada para Amazon ECS.

nota

Nas AMIs otimizadas para Amazon ECS, versão 20250909 e posteriores no Amazon Linux, o coletor de logs do Amazon ECS é pré-instalado em /opt/amazon/ecs/ecs-logs-collector.sh e está pronto para uso sem precisar ser baixado do GitHub. Para obter mais informações, consulte ECS Logs Collector na documentação da AMI otimizada para ECS.

No momento, o coletor de logs do Amazon ECS oferece suporte aos seguintes sistemas operacionais:

  • Amazon Linux

  • Red Hat Enterprise Linux

  • Ubuntu

  • Windows Server

Para executar o coletor de logs do Amazon ECS para Linux (AMI otimizada para o ECS)

  1. Conecte-se à sua instância de contêiner.

  2. Execute o script para coletar os logs e criar o arquivo.

    nota

    Para habilitar o modo de depuração no daemon do Docker e no agente de contêiner do Amazon ECS, adicione a opção --mode=enable-debug ao comando a seguir. Isso pode reiniciar o daemon do Docker, o que elimina todos os contêineres em execução na instância. Considere drenar a instância de contêiner e mover todas as tarefas importantes para outras instâncias de contêiner antes de ativar o modo de depuração. Para obter mais informações, consulte Drenagem de instâncias de contêiner do Amazon ECS.

    [ec2-user ~]$ sudo /opt/amazon/ecs/ecs-logs-collector.sh

Depois que tiver implementado o script, será possível examinar os logs coletados na pasta collect criada pelo script. O arquivo collect.tgz é um arquivo compactado de todos os logs, que você pode compartilhar com o AWS Support para receber ajuda no diagnóstico.

Para baixar e executar o coletor de logs do Amazon ECS para Linux

  1. Conecte-se à sua instância de contêiner.

  2. Baixe o script do coletor de logs do Amazon ECS.

    curl -O https://raw.githubusercontent.com/awslabs/ecs-logs-collector/master/ecs-logs-collector.sh

  3. Execute o script para coletar os logs e criar o arquivo.

    $ sudo bash ./ecs-logs-collector.sh
Para baixar e executar o coletor de logs do Amazon ECS para Windows

  1. Conecte-se à sua instância de contêiner. Para obter mais informações, consulte Conectar à instância do Windows usando um cliente RDP no Guia do usuário do Amazon EC2.

  2. Baixe o script do coletor de logs do Amazon ECS usando o PowerShell.

    Invoke-WebRequest -OutFile ecs-logs-collector.ps1 https://raw.githubusercontent.com/awslabs/aws-ecs-logs-collector-for-windows/master/ecs-logs-collector.ps1

  3. Execute o script para coletar os logs e criar o arquivo.

    nota

    Para habilitar o modo de depuração no daemon do Docker e no agente de contêiner do Amazon ECS, adicione a opção -RunMode debug ao comando a seguir. Isso reinicia o daemon do Docker, o que elimina todos os contêineres em execução na instância. Considere drenar a instância de contêiner e mover todas as tarefas importantes para outras instâncias de contêiner antes de ativar o modo de depuração. Para obter mais informações, consulte Drenagem de instâncias de contêiner do Amazon ECS.

    .\ecs-logs-collector.ps1

Depois que tiver implementado o script, será possível examinar os logs coletados na pasta collect criada pelo script. O arquivo collect.tgz é um arquivo compactado de todos os logs, que você pode compartilhar com a AWS Support para receber ajuda no diagnóstico.