Plug-in Fluent Bit para encaminhamento de logs

Se seus dados de log já estão sendo monitorados pelo Fluent Bit, você pode usar nosso plug-in de saída Fluent Bit para encaminhar e enriquecer seus dados de log no New Relic.

Encaminhar seu registro do Fluent Bit para o New Relic proporcionará gerenciamento de logsrecursos aprimorados para coletar, processar, explorar, consultar e alertar sobre seus dados log .

Processo básico

Publicamos um contêiner com o plug-in instalado. Ele serve como imagem base para ser usada pela nossa integração com Kubernetes. Recomendamos que você use esta imagem base e coloque em camadas seus próprios arquivos de configuração personalizados.

Para encaminhar seu log do Fluent Bit para o New Relic:

1. Assegure-se de ter:

   • Uma New Relic

     chave de licença

   • Fluent Bit 1.0 ou superior (recomendado), embora v0.12 ou superior seja compatível

   • As instruções de instalação do Fluent Bit Windows podem ser encontradas aqui

   • As instruções de instalação do Fluent Bit Linux podem ser encontradas aqui

2. Instale o plug-in Fluent Bit.

3. Configure o plug-in Fluent Bit.

4. Teste o plug-in Fluent Bit.

5. Gere algum tráfego e aguarde alguns minutos e, em seguida, verifique os dados da sua conta .

Instale o plug-in Fluent Bit

Para instalar o plug-in Fluent Bit:

1. Navegue até New Relic o repositório do plug-in Fluent Bit da no GitHub. 2. Na página do repositório, clone ou baixe o repositório. 3. Execute o seguinte comando para construir seu plug-in:

   cd newrelic-fluent-bit-output && make all

   Copiar

2. Armazene out_newrelic.so ou out_newrelic_winXX.dll em um local que possa ser acessado pelo daemon fluent-bit .

Configurar o plug-in Fluent Bit

O Fluent Bit precisa saber a localização do plug-in New Relic e do New Relic chave de licençapara enviar dados para o New Relic. Para configurar seu plug-in Fluent Bit:

1. Localize ou crie um arquivo plugins.conf no diretório do plug-in.

2. No arquivo plugins.conf , adicione uma referência a out_newrelic.so, adjacente ao seu arquivo fluent-bit.conf :

   [PLUGINS]
       Path /PATH/TO/newrelic-fluent-bit-output/out_newrelic.so

   Copiar

3. No arquivo fluent-bit.conf , adicione a seguinte linha no bloco service :

   [SERVICE]
   # This is the main configuration block for fluent bit.
   # Ensure the follow line exists somewhere in the SERVICE block
   Plugins_File plugins.conf

   Copiar

4. Na parte inferior do arquivo fluent-bit.conf , adicione o seguinte para configurar as seções de entrada, filtro e saída. Substitua o texto do espaço reservado pelo seu chave de licença:

   [INPUT]
       Name tail
       Tag my.tag
       Path /PATH/TO/YOUR/LOG/FILE
   # If you have multiple sources, just add another [INPUT] section like this:
   # [INPUT] 
   #     Name tail 
   #     Tag my.other.tag 
   #     Path /PATH/TO/SOME/OTHER/LOG/FILE 
   
   # Having multiple [FILTER] blocks allows you to control the flow of changes as they read top down. 
   [FILTER]
       Name modify
       # Here we only match on one tag, my.tag, defined in the [INPUT] section earlier
       Match my.tag
       # Below, we're renaming the host.cpu attribute to CPU
       Rename host.cpu CPU
   
   [FILTER]
       Name record_modifier
       # Match on all tags, *, so all logs get decorated per the Record clauses below. Record adds attributes + their values to each record.
       Match *
       # Adding a logtype attribute ensures your logs will be automatically parsed by our built-in parsing rules
       Record logtype nginx
       # Add the server's hostname to all logs generated
       Record hostname ${HOSTNAME}
   
   [OUTPUT]
       Name newrelic
       Match *
       licenseKey YOUR_LICENSE_KEY

   Copiar

5. Reinicie sua instância do Fluent Bit com o seguinte comando:

   fluent-bit -c /PATH/TO/fluent-bit.conf

   Copiar

Teste o plug-in Fluent Bit

Para testar se o plug-in do Fluent Bit está recebendo entrada de um arquivo de log:

1. Execute o seguinte comando para anexar uma mensagem de teste do log ao seu arquivo de log:

   echo "test message" >> /PATH/TO/YOUR/LOG/FILE

   Copiar

2. Pesquise test message em nossa interface de registros .

Para obter mais opções, consulte a documentação do filtro de modificação do Fluent Bit e nossa documentação para encaminhar seus logs usando o agente de infraestrutura.

Opcional: Configurar atributo do plugin

Depois de instalar e configurar o plugin Fluent Bit, você pode usar o seguinte atributo para configurar como o plugin envia dados para o New Relic:

Ver dados log

Se tudo estiver configurado corretamente e seus dados estiverem sendo coletados, você deverá ver os dados de log em ambos os locais:

• Nossa interface de registros
• Nossas ferramentas para executar a consulta NRQL. Por exemplo, você pode executar uma consulta como esta:

SELECT * FROM Log

Se nenhum dado aparecer após você ativar nossos recursos de gerenciamento de logs, siga nossos procedimentos padrão de resolução de problemas de log.

Qual é o próximo?

Explore os dados de registro em sua plataforma com nossa interface de registros.

• Obtenha visibilidade mais profunda dos dados de desempenho do seu aplicativo e da sua plataforma encaminhando seu log com nossos recursos logs contextualizados .
• Configure o alerta.
• consulte seus dados e crie dashboard.

Desativar encaminhamento de logs

Para desativar os recursos de encaminhamento de logs, siga os procedimentos padrão na documentação do Fluent Bit. Você não precisa fazer mais nada no New Relic.