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 log do Fluent Bit para New Relic lhe dará gerenciamento de logsrecursos aprimorados para coletar, processar, explorar, consultar e alertar sobre seus log dados . Você tem estas opções para instalar o Fluent Bit:

• Instalação Kubernetes
• Usando uma imagem Docker
• Instalação no host

Instalação Kubernetes

New Relic tem um plug-in de saída Fluent Bit para encaminhar seu log para New Relic o gerenciamento de log . Você pode instalar este plug-in como uma imagem docker autônoma em um cluster do Kubernetes, onde ele funciona como um DaemonSet, também conhecido como plug-in Kubernetes .

Você pode instalá-lo em seu cluster usando nosso gráfico Helm de duas maneiras:

• Por meio de nossa instalação guiada
• Instalação manual

Usando nossa instalação guiada

Embora o gráfico newrelic-logging funcione de forma independente, recomendamos instalá-lo como parte do gráfico nri-bundle .

A melhor maneira de instalar isso é por meio do nosso processo de instalação guiada . Esta instalação guiada gera os comandos Helm necessários para instalá-lo.

Instalação manual

Você pode instalá-lo manualmente usando o Helm, embora essa opção não seja recomendada. Execute este comando para instalar o repositório:

$
helm repo add newrelic https://helm-charts.newrelic.com

Para atualizar o repositório, execute este comando:

$
helm repo update newrelic

Consulte Desinstalar a integração do Kubernetes se quiser desinstalá-la.

Usando uma imagem Docker

Se você tiver sua própria integração personalizada Kubernetes , recomendamos usar nossa imagem docker que vem com o plug-in newrelic-fluent-bit-output . Ou você pode usar a imagem do docker como imagem base e sobrepor seus próprios arquivos de configuração personalizados.

Instalação no host

Para uma instalação no host do plug-in Fluent Bit, siga estas etapas:

1. Abra New Relic o repositório de plug-ins Fluent Bit do no GitHub.

2. Na página do repositório, clone ou baixe o repositório.

3. Execute este comando para construir seu plug-in:

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

4. Armazene out_newrelic.so ou out_newrelic_winXX.dll em um local onde o daemon fluent-bit possa acessá-los.

Atualize o plug-in Fluent Bit

Antes de atualizar seu plug-in Fluent Bit, execute a seguinte consulta NRQL para encontrar as versões atuais do plug-in de saída que você está usando em seu sistema:

FROM K8sContainerSample 
SELECT latest(containerImage) 
WHERE podName like '%newrelic-logging%' 
FACET clusterName

Para atualizar, siga as instruções de instalação ou obtenha a versão pré-compilada mais recente do nosso repositório GitHub.

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, siga estas etapas:

1. Localize ou crie o arquivo plugins.conf no diretório do seu 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

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

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. Execute este comando:

   bash

   Copiar

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

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 este comando para anexar uma mensagem de teste do log ao seu arquivo de log:

   bash

   Copiar

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

2. Pesquise por test message em nossa interface de logs .

Para mais opções, consulte o filtro modify na documentação do Fluent Bit. Veja também nossa documentação para encaminhar seu log utilizando o agente de infraestrutura.

Opcional: Configurar atributo do plugin

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

Ver dados log

Se você configurou tudo corretamente e o New Relic coleta seus dados, você deverá ver dados de log em ambos os lugares:

• Nossa interface de registros

• Nossas ferramentas para executar a consultaNRQL . Por exemplo, você pode executar uma consulta como esta:

SELECT * 
FROM Log

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

Qual é o próximo?

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

• Obtenha visibilidade mais profunda dos dados de desempenho do seu aplicativo e da sua plataforma encaminhando seu log com nossos recursos logs contextualizados .

• Configurar alertas.

• consulte seus dados e crie dashboard.

Desativar encaminhamento de logs

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