docker compose stats

O comando docker compose stats é utilizado para monitorar em tempo real o uso de recursos dos contêineres associados aos serviços definidos em um arquivo docker-compose.yml. Este comando fornece métricas como uso de CPU, memória, I/O de rede, e I/O de disco para ajudar na análise de desempenho e na identificação de gargalos ou problemas.

Sintaxe

docker compose stats [OPÇÕES] [SERVIÇOS...]

Parâmetros

• SERVIÇOS: (Opcional) Lista dos serviços que você deseja monitorar. Se nenhum serviço for especificado, o docker compose stats exibirá as estatísticas de todos os serviços definidos no arquivo docker-compose.yml que estão em execução.

Opções

• --no-stream: Mostra as estatísticas em um único instantâneo, sem atualização contínua. Por padrão, o comando continua atualizando as estatísticas em intervalos regulares.

Exemplo de Uso

1. Monitorar Todos os Serviços: Para monitorar o uso de recursos de todos os serviços em execução:

   docker compose stats

2. Monitorar um Serviço Específico: Para monitorar apenas o serviço web:

   docker compose stats web

3. Monitorar Vários Serviços: Para monitorar os serviços web e db:

   docker compose stats web db

4. Exibir Estatísticas em um Instantâneo Único: Para exibir as estatísticas uma única vez, sem atualização contínua:

   docker compose stats --no-stream

Exemplo de Saída

A saída do comando docker compose stats pode parecer com o seguinte:

NAME                CPU %   MEM USAGE / LIMIT   MEM %   NET I/O        BLOCK I/O       PIDS
web_1               0.10%   50MiB / 1GiB        5.00%   100kB / 50kB   10MB / 5MB      5
db_1                0.20%   150MiB / 2GiB       7.50%   150kB / 75kB   15MB / 10MB     10

Nesta saída:

• NAME: O nome do contêiner, gerado a partir do nome do serviço definido no docker-compose.yml e do número de réplica.

• CPU %: Percentual de uso da CPU pelo contêiner.

• MEM USAGE / LIMIT: Quantidade de memória sendo utilizada pelo contêiner em relação ao limite máximo configurado.

• MEM %: Percentual de uso da memória pelo contêiner.

• NET I/O: Quantidade de dados enviados e recebidos pela rede pelo contêiner.

• BLOCK I/O: Quantidade de dados lidos e escritos em disco pelo contêiner.

• PIDS: Número de processos em execução dentro do contêiner.

Considerações

• Análise de Desempenho: O docker compose stats é uma ferramenta essencial para monitorar a saúde e o desempenho dos seus serviços. Com essas métricas, você pode identificar se um serviço está utilizando recursos em excesso ou se há algum gargalo.

• Uso em Produção: Em ambientes de produção, o monitoramento contínuo dos recursos é crucial para garantir que os serviços estejam funcionando de maneira eficiente. O docker compose stats pode ser utilizado em conjunto com outras ferramentas de monitoramento para obter uma visão mais abrangente.

• Comparação com docker stats: O docker compose stats é semelhante ao comando docker stats, mas é específico para contêineres gerenciados por um arquivo docker-compose.yml, facilitando o monitoramento de aplicações compostas por múltiplos serviços.

• Integração com Scripts: Para integrar o monitoramento em scripts ou sistemas de alerta, você pode usar a opção --no-stream em conjunto com outras ferramentas para capturar instantâneos de uso de recursos e reagir a eles conforme necessário.

O docker compose stats é uma ferramenta poderosa e de fácil uso para gerenciar e otimizar os recursos alocados para seus serviços Docker, ajudando a manter a aplicação eficiente e estável.