Complemento Fluentd para reenvío de registros

Si log Fluentd ya está monitoreando tus datos , puedes usar nuestra integración Fluentd para reenviar y enriquecer tus log datos en New Relic.

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

Proceso básico

Para habilitar las capacidades de administración de registros:

1. Asegúrate de tener:

   • Una New Relicclave de licencia
   • Fluentd 1.0 o superior

2. Instale el complemento Fluentd.

3. Configura el complemento Fluentd.

4. Si corresponde, configurar EU extremo

5. Pruebe el complemento Fluentd.

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

Instalar el complemento Fluentd

Para instalar el complemento Fluentd:

$
fluent-gem install fluent-plugin-newrelic

$
td-agent-gem install fluent-plugin-newrelic

Configurar el complemento Fluentd

Para configurar tu complemento Fluentd:

1. En su archivo fluent.conf , o td-agent.conf si usa td-agente, agregue el siguiente bloque de datos, reemplazando el texto del marcador de posición con su clave de licencia:

   #Tail one or more log files
   <source>
     @type tail
     <parse>
       @type none
     </parse>
     path /path/to/file
     tag example.service
   </source>
   
   #Add hostname and service_name to all events with "example.service" tag
   <filter example.service>
     @type record_transformer
     <record>
       service_name ${tag}
       hostname "#{Socket.gethostname}"
     </record>
   </filter>
   
   #Forward all events to New Relic
   
   <match>
     @type newrelic
     license_key YOUR_LICENSE_KEY
   </match>

   Copia

2. Reinicie el servicio Fluentd para asegurarse de que se apliquen los cambios.

Configurar el complemento Fluentd para cuentas de la UE

De forma predeterminada, el complemento Fluentd reenvía el registro a nuestro extremo de EE. UU.: https://log-api.newrelic.com/log/v1. Si su organización New Relic está en nuestro centro de datos de la UE, debe configurar manualmente la propiedad base_uri en el extremo de la UE. Por ejemplo:

#Tail one or more log files
<source>
  @type tail
  <parse>
    @type none
  </parse>
  path /path/to/file
  tag example.service
</source>

#Add hostname and service_name to all events with "example.service" tag
<filter example.service>
  @type record_transformer
  <record>
    service_name ${tag}
    hostname "#{Socket.gethostname}"
  </record>
</filter>

#Forward all events to New Relic EU Endpoint
<match>
  @type newrelic
  license_key YOUR_LICENSE_KEY
  base_uri https://log-api.eu.newrelic.com/log/v1
</match>

Prueba el complemento Fluentd

Para probar si tu complemento Fluentd recibe información de un archivo de registro:

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.

Ver datos log

Si todo está configurado correctamente y sus datos se están recopilando, debería ver iniciar sesión 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.

Optimizar log del búfer Fluentd

De forma predeterminada, el complemento envía un registro a New Relic cada cinco segundos. Si desea cambiar este tiempo, agregue un bloque <buffer> a la configuración siguiendo este ejemplo:

[...]

# Forward all events to New Relic EU Endpoint
<match>
  @type newrelic
  license_key YOUR_LICENSE_KEY

  <buffer time>
    timekey 60s
  </buffer>
</match>

Para obtener más información, consulta la documentación de Fluentd sobre la configuración del buffer.

Configurar la transformación de UTF-16LE a UTF-8

En este ejemplo de registro de errores de Microsoft SQL Server, use Fluentd para enviar el registro codificado en UTF-16LE a New Relic con la codificación UTF-8 requerida para la ingesta. También puede adoptar este ejemplo para otras codificaciones.

#Tail one or more log files
<source>
  @type tail
  <parse>
    @type none
  </parse>
  path "D:/sqlserver/error.log"
  tag example.service
  encoding UTF-8
  from_encoding UTF-16LE
</source>

#Add hostname and service_name to all events with "example.service" tag
<filter example.service>
  @type record_transformer
  <record>
    service_name ${tag}
    hostname "#{Socket.gethostname}"
    logtype MSSQL
  </record>
</filter>

#Forward all events to New Relic
<match>
  @type newrelic
  license_key YOUR_LICENSE_KEY
</match>

Configurar la transformación de Shift-JIS a UTF-8

Los archivos de log japoneses codificados en Shift-JIS (SP932) se convierten a la codificación UTF-8 requerida y son necesarios para importar y enviar datos log a New Relic.

<source>
#Tail one or more log files
  @type tail
  path C:\opt\fluent\cp932text.log  # Full path of the log file you want to collect
  tag example.service
  from_encoding CP932
  encoding UTF-8
  <parse>
    @type none
  </parse>
</source>

#Forward all events to New Relic
<match>
  @type newrelic
  license_key YOUR_LICENSE_KEY
</match>

¿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 registros, siga los procedimientos estándar en la documentación de Fluentd. No necesitas hacer nada más en New Relic.