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á recursos 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:
Assegure-se de ter:
Instale o plug-in Fluent Bit.
Configure o plug-in Fluent Bit.
Teste o plug-in Fluent Bit.
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:
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:
bash$cd newrelic-fluent-bit-output && make allArmazene
out_newrelic.so
ouout_newrelic_winXX.dll
em um local que possa ser acessado pelo daemonfluent-bit
.
Dica
Se preferir não compilar o plug-in sozinho, você pode baixar versões pré-compiladas na página de lançamentos do nosso repositório GitHub.
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 em uso em seu sistema:
FROM K8sContainerSample SELECT latest(containerImage) WHERE podName like '%newrelic-logging%' FACET clusterName
Cuidado
As versões 1.16.0 a 1.19.2 do plug-in de saída Fluent Bit são afetadas por vulnerabilidades de segurança (CVE-2024-4323). Se você estiver usando uma dessas versões, atualize para a versão 2.0.0 ou superior. Para mais informações sobre isso, consulte nosso boletim de segurança NR24-01 – Fluent Bit.
Para atualizar, siga as instruções de instalação ou obtenha a versão pré-compilada mais recente em nosso repositório GitHub.
Instale o plug-in de saída Fluent Bit
New Relic possui um plug-in de saída Fluent Bit para encaminhar seu log para New Relic o gerenciamento de log . Este plug-in também é fornecido em uma imagem docker independente que pode ser instalada em um cluster do Kubernetes na forma de um DaemonSet, também conhecido como plug-in Kubernetes .
Você pode instalá-lo em seu cluster usando nosso gráfico Helm de duas maneiras.
Use 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 é através do nosso processo de instalação guiado . Esta instalação guiada pode gerar os comandos do Helm 3 necessários para instalá-lo (consulte "Helm 3").
Instalação manual
Como alternativa, você pode instalá-lo manualmente usando o Helm, executando este comando para instalar o repositório:
$helm repo add newrelic https://helm-charts.newrelic.com
Para atualizar o repositório você pode executar:
$helm repo update newrelic
Clique aqui para obter instruções de desinstalação.
Configurar o plug-in Fluent Bit
O Fluent Bit precisa saber a localização do plug-in New Relic e do New Relic para enviar dados para o New Relic. Para configurar seu plug-in Fluent Bit:
Importante
Preste atenção aos espaços em branco ao editar seus arquivos de configuração. Certifique-se de usar quatro espaços para recuar e um espaço entre chaves e valores.
Localize ou crie um arquivo
plugins.conf
no diretório do plug-in.No arquivo
plugins.conf
, adicione uma referência aout_newrelic.so
, adjacente ao seu arquivofluent-bit.conf
:[PLUGINS]Path /PATH/TO/newrelic-fluent-bit-output/out_newrelic.soNo arquivo
fluent-bit.conf
, adicione a seguinte linha no blocoservice
:[SERVICE]# This is the main configuration block for fluent bit.# Ensure the follow line exists somewhere in the SERVICE blockPlugins_File plugins.confNa 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 :[INPUT]Name tailTag my.tagPath /PATH/TO/YOUR/LOG/FILE# If you have multiple sources, just add another [INPUT] section like this:[INPUT]Name tailTag my.other.tagPath /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 earlierMatch my.tag# Below, we're renaming the host.cpu attribute to CPURename 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 rulesRecord logtype nginx# Add the server's hostname to all logs generatedRecord hostname ${HOSTNAME}[OUTPUT]Name newrelicMatch *licenseKey YOUR_LICENSE_KEYReinicie sua instância do Fluent Bit com o seguinte comando:
bash$fluent-bit -c /PATH/TO/fluent-bit.conf
Este documento ajudou você na instalação?
Teste o plug-in Fluent Bit
Para testar se o plug-in do Fluent Bit está recebendo entrada de um arquivo de log:
Execute o seguinte comando para anexar uma mensagem de teste do log ao seu arquivo de log:
bash$echo "test message" >> /PATH/TO/YOUR/LOG/FILEPesquise
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:
Chave | Descrição |
---|---|
| O . Use |
| O tamanho máximo que a carga enviou, em bytes. Padrão: |
| O número máximo de registros a serem enviados por vez. Padrão: |
| Deprecated. Utiliza uma chave de inserção do New Relic Insights, mas é preferível usar o atributo |
| O padrão é |
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.