Gerar log para resolução de problemas do agente de infraestrutura

Problema

Quando a resolução de problemas for do seu agente de infraestrutura, gere debug log por alguns minutos para localizar e investigar erros. Isso pode ser útil para sua própria resolução de problemas ou ao trabalhar com o suporte New Relic .

Importante

O registro detalhado gera muitos dados muito rapidamente. Ao terminar de gerar o log, certifique-se de definir level: info (ou menos) para reduzir o consumo de espaço em disco e a ingestão de dados ao encaminhar o log para o New Relic.

Você pode automatizar esse processo usando o comando newrelic-infra-ctl . Para obter mais informações, consulte a documentação binária sobre resolução de problemas.

Solução

A geração do arquivo de log debug requer a edição do arquivo de configuração. Para obter um arquivo de configuração de amostra que inclui todas as configurações aplicáveis, consulte o modelo de exemplo. Para gerar log detalhado:

Etapa	Procedimentos
	Edite seu arquivo `newrelic-infra.yml` com configurações de registro: `log: level: debug file: /path/to/logfile.log` Ative a geração de registros de depuração: `level: debug`. (Se você usar um agente de infraestrutura em contêiner no CoreOS, consulte as notas específicas do sistema.) Defina `file` para um local conveniente do arquivo de log. Reinicie o agente para que ele perceba as novas configurações.
	Deixe seu host funcionar com carga normal por cerca de três minutos para gerar dados de registro suficientes.
	Retorne suas configurações ao padrão: Desative o registro detalhado configurando `level: info` em `newrelic-infra.yml`. Opcional: desative a criação de log em um arquivo customizado removendo a linha `file` da seção `log` em `newrelic-infra.yml`. Reinicie o agente para que ele perceba as novas configurações.
	Examine o arquivo de log em busca de erros. Se você precisar enviar seu arquivo de log para o suporte da New Relic: Inclua a linha no seu arquivo de log que contém a versão do agente: `New Relic infrastructure agent version X.YY.ZZZ` Anexe o arquivo de log ao seu ticket de suporte, junto com seu `newrelic-infra.yml`.

Modo detalhado inteligente

Às vezes, os erros só ocorrem depois de algum tempo. Isso dificulta a depuração, porque normalmente o log detalhado só é ativado por um curto período; caso contrário, haverá muitos logs de depuração. Por exemplo, se um erro ocorrer uma hora após o agente de infraestrutura ter sido iniciado, obter o log de depuração próximo ao horário do erro pode ser complicado ou impraticável.

A partir do agente de infraestrutura v1.9.0 ou superior, você pode usar o modo detalhado inteligente para log. O modo detalhado inteligente registra apenas as mensagens de depuração mais recentes após o registro de um erro. Isso permite que você deixe o modo detalhado inteligente em execução até que ocorra um erro, sem registrar muitas mensagens de depuração irrelevantes e registrando apenas as mensagens de depuração mais recentes. (O número de mensagens é determinado pela sua configuração.)

Para obter mais informações sobre o modo detalhado inteligente, consulte os documentos de comportamento de registro em log do agente de infraestrutura e use a documentação de definições de configuração da infraestrutura para obter detalhes sobre como habilitar o modo detalhado inteligente.

Encaminhe o log do agente para o New Relic

O agente de infraestrutura pode ser configurado para enviar seu próprio log para o New Relic. Isso pode ser útil para resolução de problemas com encaminhamento de logs, agente de infraestrutura ou ao entrar em contato com o suporte.

Para obter detalhes sobre como habilitar o encaminhamento de logs para o agente de infraestrutura, consulte Solucionar problemas de encaminhamento de logs.

Notas para sistemas específicos

Estas são algumas notas e requisitos adicionais para sistemas específicos, usados para complementar as instruções gerais de registro:

Se você estiver usando um agente de infraestrutura em contêiner:

Escolha uma destas opções para alterar o nível de log para detalhado:
- Recomendado: defina a variável de ambiente NRIA_LOG_LEVEL como debug. Executar isso na linha de comando seria semelhante a:
  bash
```
$-e NRIA_LOG_LEVEL=debug
```
  OU
- Edite o arquivo de configuração para definir level: debug na seção log . (Editar o arquivo de configuração em um contêiner não é recomendado, pois requer a reconstrução da imagem duas vezes: uma para adicionar o registro detalhado e outra para removê-lo.)

Use journalctl para coletar o registro:

bash

$journalctl -u newrelic-infra > newrelic-infra.log

Defina o nível de registro novamente para info ou warn após coletar o registro por alguns minutos.

Esta tradução de máquina é fornecida para sua comodidade.

Gerar log para resolução de problemas do agente de infraestrutura

Problema

Importante

Solução

Modo detalhado inteligente

Encaminhe o log do agente para o New Relic

Notas para sistemas específicos

Agente conteinerizado

Esta tradução de máquina é fornecida para sua comodidade.

Gerar log para resolução de problemas do agente de infraestrutura

Problema.css-21sua1{background:none;border:none;width:0;padding:0;}

Importante

Solução

Modo detalhado inteligente

Encaminhe o log do agente para o New Relic

Notas para sistemas específicos

Problema