Monitor de Podman

Um monitor de Podman acompanha os contêineres de um host Podman e avisa você quando um contêiner esquenta demais, fica sem memória ou não para de reiniciar. Ele lê as métricas que o agente Podman do Status200 envia do host, então nada é sondado de fora: instale o agente e depois crie o monitor a partir de um modelo ou da sua própria consulta.

Como funciona#

O agente Podman do Status200 é executado como contêiner no host. A cada 30 segundos, ele lê as estatísticas dos contêineres pelo socket de API compatível com Docker do Podman, acompanha os arquivos de log dos contêineres e envia os dois para o Status200 via OTLP. Os primeiros dados de um host o registram no Status200.

Um monitor de Podman está vinculado a um host. A cada minuto, ele executa sua consulta sobre as métricas dos contêineres desse host e compara o resultado com seus critérios.

Antes de começar#

• Instale o agente Podman no host. O guia do agente Podman cobre a instalação, a atualização e a verificação. O agente precisa do socket de API do Podman em /run/podman/podman.sock.
• Verifique se o host está registrado. Ele aparece em Produtos → Infraestrutura → Podman → Todos os hosts, com o nome do PODMAN_HOST_NAME do agente, assim que chegam os primeiros dados.
• Para os logs dos contêineres, execute os contêineres com o driver de log k8s-file. Consulte Requisito do driver de log.

Criar um monitor de Podman#

1. Começar um monitor novo#

   Acesse Monitores e clique em Criar monitor.

2. Escolher Podman Container#

   Em Tipo de monitor, clique em Mais tipos de monitor e escolha Podman Container em Infraestrutura, ou digite podman na caixa de busca. Informe um Nome – ele é usado nos títulos de incidentes e alertas – e clique em Próximo.

3. Escolher o host#

   Em Podman Monitor Configuration, escolha o host em Podman Host. Todo host que enviou dados está na lista.

4. Escolher o que monitorar#

   Escolha uma das três abas:

   • Quick Setup – clique em um modelo. Ele define a métrica, a agregação, o intervalo de tempo e os limites, e substitui os critérios abaixo pelos dele. Você ainda pode mudar o Intervalo de tempo.
   • Custom Metric – escolha uma métrica em Podman Metric e depois defina Agregação e Intervalo de tempo. Nome do contêiner e Imagem do contêiner a restringem a alguns contêineres.
   • Avançado – monte você mesmo consultas e fórmulas em Selecionar Métricas. Use Group by resource.container.name para avaliar cada contêiner separadamente.

5. Revisar os critérios#

   Abra cada critério em Critérios do monitor e confira sua Métrica, Agregação, Condição e Threshold. Um modelo os preenche. Com Custom Metric ou Avançado, o monitor começa com os critérios padrão, que só percebem uma métrica caindo para zero, então defina o seu próprio limite.

6. Criar o monitor#

   Clique em Criar monitor. O Status200 abre a página do monitor e o avalia a cada minuto. Os incidentes e alertas que ele gera também aparecem nas páginas Incidentes e Alertas do host.

Configurações do monitor#

Modelos de alerta prontos#

Quick Setup oferece cinco modelos. Cada um monta um monitor completo: uma consulta agrupada por resource.container.name, um critério que dispara e outro que se recupera. Cada contêiner é avaliado separadamente e recebe seu próprio incidente e seu próprio alerta. Os limites são pontos de partida que você pode editar.

Um critério só dispara quando a condição vale em todos os minutos da sua janela, e se recupera 10% além do limite para que um valor oscilando na linha não fique mudando de estado.

Gravidade é o rótulo que o seletor mostra. O incidente e o alerta que um modelo cria começam com a gravidade de incidente e de alerta mais alta do seu projeto; altere-as nos critérios.

Os dois modelos de porcentagem usam Média: as métricas deles já são porcentagens por contêiner, então a média de um minuto é a leitura sustentada. A contagem de reinícios e a contagem de processos usam Máximo, em que uma única amostra acima do limite já é o sinal.

Não há modelo de limitação de CPU. As métricas de limitação que o agente coleta só crescem, e um alerta de "limitado alguma vez" dispararia uma vez e nunca se resolveria. As duas continuam sendo coletadas, então você pode mostrá-las em gráficos.

Métricas coletadas#

O agente usa o receptor docker_stats do OpenTelemetry apontado para o socket compatível com Docker do Podman, /run/podman/podman.sock, a cada 30 segundos. As métricas de cada contêiner trazem sua identidade como atributos de recurso: resource.container.name, resource.container.image.name, resource.container.id, resource.container.runtime (podman) e resource.host.name.

CPU#

Memória#

Rede#

E/S de bloco#

Contêiner#

A lista Podman Metric também oferece container.cpu.usage.percpu, container.memory.rss, container.memory.cache e os contadores de pacotes de rede. A configuração do agente distribuída não os ativa, então confira a página Métricas do host antes de depender deles. container.cpu.throttling_data.throttled_periods não está na lista; consulte-a em Avançado.

Critérios de monitoramento#

Um critério compara uma das consultas ou fórmulas do monitor com um limite. Os critérios de um monitor de Podman não têm Tipo de filtro: cada regra verifica o valor da métrica, com estes campos.

As condições de anomalia comparam cada valor com a mesma hora da semana na linha de base. Elas ficam em um estado "Learning", e não geram nada, até a janela de linha de base ter histórico suficiente.

Cada critério também diz o que fazer quando corresponde: mudar o status do monitor, criar um alerta ou declarar um incidente. Os critérios são verificados de cima para baixo, e o primeiro que corresponde decide.

Critérios padrão#

Um monitor que você não cria a partir de um modelo começa com dois critérios:

Logs coletados#

O agente também acompanha o arquivo ctr.log de cada contêiner e envia cada linha como um registro de log do OpenTelemetry com:

Os logs aparecem na página Registros do host e na página de cada contêiner.

Requisito do driver de log#

O agente lê os arquivos que o driver de log k8s-file do Podman grava, em /var/lib/containers/storage/overlay-containers/*/userdata/ctr.log. O Podman com root usa journald por padrão, que grava no journal do systemd, então não há arquivo para ler:

As métricas não dependem do driver de log: um host cujos contêineres usam journald continua informando métricas; só a página Registros dele fica vazia.

Verifique o driver de um contêiner e o padrão do Podman:

podman inspect <container> --format '{{.HostConfig.LogConfig.Type}}'
podman info --format '{{.Host.LogDriver}}'

Mude para k8s-file. O Podman define o driver de log de um contêiner quando o contêiner é criado, então recrie cada contêiner depois da mudança – um reinício mantém o driver antigo.

podman run --log-driver k8s-file ... <image>

podman rm -f <container>
podman run --log-driver k8s-file ... <image>

services:
  my-app:
    image: my-app:latest
    logging:
      driver: "k8s-file"
      options:
        max-size: "100m"

podman compose up -d --force-recreate <service>

[containers]
log_driver = "k8s-file"

Solução de problemas#

Próximos passos#