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 Relic

     clave 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 <DoNotTranslate>**>
     @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 **</DoNotTranslate>>
  @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 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.

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

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 <DoNotTranslate>**>
  @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 **</DoNotTranslate>>
  @type newrelic
  license_key YOUR_LICENSE_KEY
</match>

¿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 Fluentd. No necesitas hacer nada más en New Relic.