Customizando agentes de monitoramento do Linux

Por padrão, o agente de monitoramento coleta dados de várias plataformas e aplicativos. É possível editar o arquivo de configuração do agente para mudar seu comportamento padrão e incluir ou excluir dados. É possível customizar o arquivo de configuração do agente de monitoramento para incluir métricas customizadas, como JMX, StatsD e Prometheus. Também é possível filtrar métricas e contêineres.

O agente de monitoramento usa dois arquivos de configuração que especificam quais dados serão coletados automaticamente:

arquivos de configuração do agente de monitoramento
Arquivo	Descrição	Local
`dragent.default.yaml`	Arquivo de configuração principal IMPORTANTE: Não edite esse arquivo.	`/opt/draios/etc/dragent.default.yaml`
`dragent.yaml`	Arquivo de configuração que é editado para customizar o agente de monitoramento.	`/opt/draios/etc/dragent.yaml`

É possível editar o arquivo dragent.yaml para customizar os dados coletados. As mudanças entram em vigor imediatamente após o salvamento do arquivo. O agente detecta a mudança e reinicia automaticamente. É possível localizar a frequência e os arquivos que um agente de monitoramento verifica no arquivo dragent.default.yaml.

Por exemplo, um dragent.default.yaml inclui as informações a seguir:

check_frequency_s: 5
files:
- /opt/draios/etc/dragent.yaml
- /opt/draios/etc/kubernetes/config/dragent.yaml
- /opt/draios/etc/kubernetes/secrets/access-key

Editando o arquivo dragent yaml

O arquivo yaml está localizado em /opt/draios/etc/.

Conclua as etapas a seguir para editar o arquivo e aplicar as mudanças:

Acesse o * dragent.yaml * diretamente. O arquivo está localizado em /opt/draios/etc/dragent.yaml.
Edite o arquivo. Use a sintaxe YAML válida.
Reinicie o agente. Execute o comando a seguir:
```
service dragent restart
```

Bloqueando portas

Para bloquear o tráfego de rede e as métricas de portas de rede, deve-se customizar a seção blacklisted_ports no arquivo dragent.yaml. Deve-se listar as portas das quais você deseja filtrar quaisquer dados.

Nota: a porta 53 (DNS) é sempre incluída na lista de bloqueio.

Por exemplo, a amostra a seguir exibe como configurar a seção blacklisted_ports de um agente de monitoramento para excluir dados vindos das portas 6666 e 6379:

blacklisted_ports:
    - 6666
    - 6379

Incluindo e excluindo métricas

Para filtrar as métricas customizadas, deve-se customizar a seção metrics_filter no arquivo dragent.yaml. É possível especificar quais métricas incluir e quais filtrar, configurando os parâmetros de filtragem include e exclude.

Nota: a ordem da regra de filtragem é configurada como a seguir: a primeira regra que corresponder a uma métrica será aplicada.

Por exemplo, se a seção metrics_filter de um agente de monitoramento for semelhante ao seguinte:

metrics_filter:
  - include: metricA.*
  - exclude: metricA.*
  - include: metricB.*
  - include: haproxy.backend.*
  - exclude: haproxy.*
  - exclude: metricC.*

Você está configurando o agente de monitoramento para coletar todos os dados das métricas que começam com metricA, metricB e haproxy.backend.
Você está filtrando métricas iniciadas com metricC e outras métricas iniciadas com haproxy.
A entrada exclude: metricA.* é ignorada.

Mudando o nível de log

Para configurar o nível de log, deve-se customizar a seção de log no arquivo dragent.yaml.

O agente de monitoramento gera entradas de log em /opt/draios/logs/draios.log.

O arquivo de log gira ao atingir 10 MB de tamanho.
Os 10 arquivos de log mais recentes são mantidos. O registro de data anexado ao nome do arquivo é usado para determinar quais arquivos manter.
Os níveis de log válidos são: nenhum, erro, aviso, informações, depuração, rastreio
O nível de log padrão é informações, em que uma entrada é criada para cada transmissão de métricas agregadas para os servidores de backend, uma vez por segundo, além das entradas para quaisquer avisos e erros.
É possível customizar o tipo de log e as entradas que são coletadas definindo o arquivo de configuração do agente de monitoramento /opt/draios/etc/dragent.yaml. Depois de editar o arquivo, deve-se reiniciar o agente no shell com service dragent restart para ativar as mudanças.

Entradas da seção de registro
Casos de uso	Entrada de seção de log
Solucionar problemas de comportamento do agente	`file_priority: debug`
Reduza a saída de console do contêiner	`console_priority: warning`
Filtrando eventos por severidade	`event_priority: warning`
Verifique quais métricas estão incluídas ou excluídas	`metrics_excess_log: true`