Monitorar e solucionar problemas do ATP

• Para visualizar métricas recentes de processos:

  FROM Metric SELECT *
  WHERE metricName LIKE 'process.%'
  LIMIT 100

  Copiar

• Para contar tipos únicos de métricas de processo:

  FROM Metric SELECT uniqueCount(metricName)
  WHERE metricName LIKE 'process.%'

  Copiar

• Para visualizar métricas recentes de processo do seu cluster:

  FROM Metric SELECT *
  WHERE k8s.cluster.name='your-cluster-name'
  AND metricName LIKE 'process.%'
  LIMIT 100

  Copiar

• Para contar tipos únicos de métricas de processo para o seu cluster:

  FROM Metric SELECT uniqueCount(metricName)
  WHERE k8s.cluster.name='your-cluster-name'
  AND metricName LIKE 'process.%'

  Copiar

Problema: Todas as métricas de processo estão sendo enviadas, não filtradas.

Problema: A memória do Coletor aumenta ao longo do tempo

Solução: Ajuste as configurações de retenção:

processors:
  adaptivetelemetry:
    retention_minutes: 15  # Reduce from default 30

Problema: Processos esperados estão ausentes da telemetria

Solução: Deve-se usar o caminho completo para adicionar processos à lista de inclusão. Entradas sem separadores de caminho não corresponderão a nenhum processo. Por exemplo:

processors:
  adaptivetelemetry:
    include_process_list:
      - "/usr/bin/myapp"  # Always captured regardless of thresholds

Problema: Anteriormente, os dados de ATP eram exibidos, mas agora não são. Isso pode ser devido ao atingimento dos limites de cardinalidade. O ATP filtra muitos processos para reduzir o volume de telemetria, mas, se você tiver um número muito alto de processos únicos, ainda poderá atingir os limites. Você pode monitorar o uso de cardinalidade para acompanhar isso.

Solução:

Para solucionar problemas, verifique se você atingiu os limites de cardinalidade acessando a página de gerenciamento de cardinalidade no New Relic. Se você excedeu os limites, você pode aumentar seu limite de cardinalidade.

processors:
  adaptivetelemetry:
    metric_thresholds:
      process.cpu.utilization: 0.10  # Increase from 0.05 to 0.10 (10% CPU)
      process.memory.utilization: 0.10  # Filter out more processes

Problema: os logs do ATP mostram erros ou avisos relacionados a armazenamento sobre a impossibilidade de criar diretórios de armazenamento.

Solução:

O ATP seleciona e cria automaticamente diretórios de armazenamento com base no seu método de instalação. Se o armazenamento falhar, verifique o seguinte:

1. Para instalações do systemd: certifique-se de que o serviço esteja em execução como o usuário nrdot-collector e que o arquivo de serviço do systemd inclua a diretiva StateDirectory:

   bash

   Copiar

   $
   sudo systemctl cat nrdot-collector.service | grep StateDirectory

   Resultado esperado: StateDirectory=nrdot-collector

2. Para instalações manuais de binários: verifique se seu usuário tem permissões de gravação em ~/.local/state/:

   bash

   Copiar

   $
   mkdir -p ~/.local/state/nrdot-collector
   $
   touch ~/.local/state/nrdot-collector/test && rm ~/.local/state/nrdot-collector/test

3. Verifique os logs do coletor em busca de mensagens relacionadas a armazenamento:

   bash

   Copiar

   $
   sudo journalctl -u nrdot-collector | grep -i storage

   Importante

   Se o ATP não puder criar ou acessar o armazenamento, ele desabilita automaticamente a persistência e continua operando apenas com o estado em memória. O recurso de retenção do ATP continua funcionando normalmente durante o tempo de execução do coletor, mas o estado de rastreamento será perdido nas reinicializações do coletor, pois não é salvo em disco.

O ATP gerencia automaticamente os caminhos de armazenamento com base no seu método de instalação:

Para instalações de serviço systemd (pacotes DEB/RPM):

• O armazenamento é configurado automaticamente em /var/lib/nrdot-collector/

• O serviço systemd usa StateDirectory para criar e gerenciar o diretório

• Nenhuma configuração manual necessária

  Para instalações manuais de binários:

• O armazenamento usa ~/.local/state/nrdot-collector/ para o usuário regular

• Não são necessários privilégios de root para armazenamento

• O diretório é automaticamente criado se for gravável.

  Dica

  Se o armazenamento não puder ser criado (por exemplo, devido a problemas de permissão), o ATP desabilita automaticamente a persistência e continua operando apenas com o estado em memória. O recurso de retenção funciona normalmente durante o tempo de execução, mas o estado de rastreamento é perdido nas reinicializações do coletor. Verifique os logs do coletor se precisar verificar o status do armazenamento.

Para habilitar a coleta de dados de disk.io pelo receptor hostmetrics do OpenTelemetry, você precisa de privilégios elevados porque os dados de E/S armazenados em /proc/[PID]/io exigem acesso de usuário root. Isso não é um requisito do ATP, o ATP processa apenas dados que já foram coletados pelo OpenTelemetry.

Adicione o seguinte contexto de segurança ao seu Helm chart:

securityContext:
  allowPrivilegeEscalation: true
  privileged: true
  readOnlyRootFilesystem: false
  runAsNonRoot: false
  runAsUser: 0