Complemento Fluent Bit para reenvío de logs

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 log 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 log 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:

   bash

   Copia

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

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

Actualice el complemento Fluent Bit

Antes de actualizar su complemento Fluent Bit, ejecute la siguiente consulta NRQL para encontrar las versiones actuales del complemento de salida que se emplea en su sistema:

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

Para actualizar, siga las instrucciones de instalación u obtenga la última versión precompilada de nuestro repositorio de GitHub.

Instalar el complemento de salida Fluent Bit

New Relic tiene un complemento de salida Fluent Bit para reenviar su registro a New Relic la administración de logde . Este complemento también se proporciona en una imagen docker independiente que se puede instalar en un clúster de Kubernetes en forma de DaemonSet, también conocido como complemento Kubernetes .

Puede instalarlo en su clúster empleando nuestro gráfico Helm de dos maneras.

Emplee nuestra instalación guiada

Aunque el gráfico de registro de nuevas reliquias funciona de forma independiente, recomendamos instalarlo como parte del gráfico del paquete nri .

La mejor manera de instalarlo es a través de nuestro proceso de instalación guiado . Esta instalación guiada puede generar los comandos de Helm 3 necesarios para instalarlo (consulte "Helm 3").

Instalación manual

Alternativamente, puedes instalarlo manualmente usando Helm, ejecutando este comando para instalar el repositorio:

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

Para actualizar el repositorio puedes ejecutar:

$
helm repo update newrelic

Vaya aquí para obtener instrucciones de desinstalación.

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:

   bash

   Copia

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

Pruebe el complemento Fluent Bit

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

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

   bash

   Copia

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

2. Busque en nuestra UI de logs 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 logs 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 UI de logs
• 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 logs, siga nuestros procedimientos estándar de resolución de problemas de logs.

¿Que sigue?

Explore los datos de logging en su plataforma con nuestra UI de logs.

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

Desactivar reenvío de logs

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