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 registro de Fluent Bit a le New Relic brindará administración de logscapacidades mejoradas para recopilar, procesar, explorar, consultar y alertar sobre sus log datos . Tienes estas opciones para instalar Fluent Bit:

• Instalación Kubernetes
• Usando una imagen de Docker
• Instalación en el host

Instalación Kubernetes

New Relic tiene un complemento de salida Fluent Bit para reenviar su registro a New Relic la administración de logde . Puede instalar este complemento como una imagen de Docker independiente en un clúster de Kubernetes, donde funciona como un DaemonSet, también conocido como el complemento Kubernetes .

Puedes instalarlo en tu clúster usando nuestro gráfico Helm de dos maneras:

• A través de nuestra instalación guiada
• Instalación manual

Usando nuestra instalación guiada

Aunque el gráfico newrelic-logging funciona de forma independiente, recomendamos instalarlo como parte del gráfico nri-bundle .

La mejor manera de instalarlo es a través de nuestro proceso de instalación guiada . Esta instalación guiada genera los comandos Helm necesarios para instalarla.

Instalación manual

Puedes instalarlo manualmente usando Helm, aunque esta opción no se recomienda. Ejecute este comando para instalar el repositorio:

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

Para actualizar el repositorio, ejecute este comando:

$
helm repo update newrelic

Consulta Desinstalar la integración de Kubernetes si deseas desinstalarla.

Usando una imagen de Docker

Si tiene su propia integración Kubernetes personalizada, le recomendamos emplear nuestra imagen de Docker que viene con el complemento newrelic-fluent-bit-output . O puede emplear la imagen de Docker como imagen base y agregarle sus propios archivos de configuración personalizados.

Instalación en el host

Para realizar una instalación en el host del complemento Fluent Bit, siga estos pasos:

1. Abra el New Relic repositorio de complementos Fluent Bit de en GitHub.

2. Desde la página del repositorio, clona o descarga el repositorio.

3. Ejecute este comando para crear su complemento:

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

4. Almacene out_newrelic.so o out_newrelic_winXX.dll en una ubicación donde daemon fluent-bit pueda acceder a ellos.

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 está empleando en su sistema:

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

Para actualizar, siga las instrucciones de instalación o descargue la última versión precompilada desde nuestro repositorio de GitHub.

Configurar el complemento Fluent Bit

Fluent Bit necesita saber la ubicación del complemento New Relic y New Relic clave de licenciapara enviar datos a New Relic.

Para configurar su complemento Fluent Bit, siga estos pasos:

1. Localice o cree el 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

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

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. Resetear su instancia de Fluent Bit. Ejecute este 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 este comando para agregar un mensaje de log prueba a su archivo de log:

   bash

   Copia

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

2. Busque test message en nuestra UIde registro .

Para obtener más opciones, consulte el filtro modify en la documentación de Fluent Bit. Consulte también nuestra documentación para reenviar su registro empleando el agente de infraestructura.

Opcional: configurar el atributo del complemento

Una vez que instaló 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 configuraste todo correctamente y New Relic recopila tus datos, deberías ver datos log en estos dos lugares:

• Nuestra UI de logs

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

SELECT * 
FROM Log

Si no obtiene ningún dato luego de habilitar nuestras capacidades de administración de log , siga nuestros procedimientos estándar log de resolución de problemas.

¿Que sigue?

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

• 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 alertas.

• Consulta tus datos y crea un panel.

Desactivar reenvío de logs

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