Complemento Fluent Bit para reenvío de registros

Si log Fluent Bit ya está monitoreando sus datos , puede usar nuestro complemento de salida Fluent Bit para reenviar y enriquecer sus log datos en New Relic.

Reenviar su registro de Fluent Bit a New Relic le brindará administración de logscapacidades mejoradas para recopilar, procesar, explorar, consultar y alertar sobre sus datos log .

Proceso básico

Hemos publicado un contenedor con el complemento instalado. Sirve como imagen base para nuestra integración de Kubernetes. Le recomendamos que utilice esta imagen base y superponga sus propios archivos de configuración personalizados.

Para reenviar su registro de Fluent Bit a New Relic:

1. Asegúrate de tener:

   • Una New Relic

     clave de licencia

   • Fluent Bit 1.0 o superior (recomendado), aunque se admite v0.12 o superior

   • Las instrucciones de instalación de Fluent Bit Windows se pueden encontrar aquí

   • Las instrucciones de instalación de Fluent Bit Linux se pueden encontrar aquí

2. Instale el complemento Fluent Bit.

3. Configure el complemento Fluent Bit.

4. Pruebe el complemento Fluent Bit.

5. Genere algo de tráfico y espere unos minutos, luego verifique los datos de su cuenta .

Instale el complemento Fluent Bit

Para instalar el complemento Fluent Bit:

1. Navegue hasta New Relic el repositorio del complemento Fluent Bit de en GitHub. 2. Desde la página del repositorio, clone o descargue el repositorio. 3. Ejecute el siguiente comando para crear su complemento:

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

   Copia

2. Almacene out_newrelic.so o out_newrelic_winXX.dll en una ubicación a la que pueda acceder el daemon fluent-bit.

Configurar el complemento Fluent Bit

Fluent Bit necesita conocer la ubicación del complemento New Relic y New Relic clave de licenciapara enviar datos a New Relic. Para configurar su complemento Fluent Bit:

1. Localice o cree un archivo plugins.conf en su directorio de complementos.

2. En el archivo plugins.conf , agregue una referencia a out_newrelic.so, junto a su archivo fluent-bit.conf :

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

   Copia

3. En el archivo fluent-bit.conf , agregue la siguiente línea debajo del bloque 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

   Copia

4. En la parte inferior del archivo fluent-bit.conf , agregue lo siguiente para configurar las secciones de entrada, filtro y salida. Reemplace el texto del marcador de posición con su clave de licencia:

   [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

   Copia

5. Reinicie su instancia de Fluent Bit con el siguiente comando:

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

   Copia

Pruebe el complemento Fluent Bit

Para probar si su complemento Fluent Bit está recibiendo información de un archivo de registro:

1. Ejecute el siguiente comando para agregar un mensaje de registro de prueba a su archivo de registro:

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

   Copia

2. Busque en nuestra UI de registros test message.

Para obtener más opciones, consulte la documentación del filtro de modificación de Fluent Bit y nuestra documentación para reenviar sus registros utilizando el agente de infraestructura.

Opcional: configurar el atributo del complemento

Una vez que haya instalado y configurado el complemento Fluent Bit, puede usar el siguiente atributo para configurar cómo el complemento envía datos a New Relic:

Ver datos log

Si todo está configurado correctamente y se están recopilando sus datos, debería ver los datos log en ambos lugares:

• Nuestra UIusuario de registros
• Nuestras herramientas para ejecutar NRQL consulta. Por ejemplo, puedes ejecutar una consulta como esta:

SELECT * FROM Log

Si no aparecen datos después de habilitar nuestras capacidades de administración de registros, siga nuestros procedimientos estándar de resolución de problemas de registros.

¿Que sigue?

Explore los datos de registro en su plataforma con nuestra UIde registros.

• Obtenga una visibilidad más profunda de los datos de rendimiento de su aplicación y de su plataforma reenviando su registro con nuestras capacidades de logs en el contexto .
• Configurar alerta.
• Consulta tus datos y crea un panel.

Desactivar reenvío de registros

Para deshabilitar las capacidades de reenvío de registros, siga los procedimientos estándar en la documentación de Fluent Bit. No necesitas hacer nada más en New Relic.