AWS Lambda para enviar registros de CloudWatch

Puede enviar su registro de Amazon CloudWatch a New Relic utilizando nuestra función Lambda AWS , newrelic-log-ingestion. Esto se puede implementar fácilmente desde el repositorio de aplicaciones AWS Serverless.

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

Instalar y configurar la función de registro de CloudWatch Lambda

La siguiente configuración muestra un enfoque para configurar variables de entorno. También puedes configurarlos desde la página Funciones .

Complete lo siguiente:

1. Asegúrate de tener un clave de licencia.

2. Abra el repositorio de aplicaciones AWS Serverless en su browser.

3. Busque newrelic y marque Show apps that create custom IAM roles or resource policies para encontrar newrelic-log-ingestion.

4. Abra los detalles newrelic-log-ingestion y haga clic en Deploy.

5. En el menú Configure de la función, vaya a Environment Variables y configure el reenvío de registros utilizando las siguientes variables de entorno:

   Llave	Descripción
   DEBUG_LOGGING_ENABLED	Un valor booleano para determinar si desea generar mensajes de depuración en la consola de CloudWatch. Opcional. Para activar el registro de depuración, configúrelo en true. El valor predeterminado es false.
   LICENSE_KEY	clave de licenciase utiliza para enviar datos a New Relic. Requerido.
   LOGGING_ENABLED	Determina si los registros se reenvían a New Relic. Requerido. Para activar el registro, configúrelo en true.
   NR_TAGS	Especifique la etiqueta que se agregará a todos los registros de eventos. Opcional. Cada etiqueta se compone de una clave y un valor delimitados por dos puntos. Los pares principales de valores múltiples están delimitados por punto y coma; por ejemplo, env:prod;team:myTeam.
   NR_LAMBDA_LOG_GROUP_PREFIX	Si ha configurado su grupo log de Lambda para utilizar una ruta diferente a /aws/lambda, puede especificarla con esta variable. Opcional.
   NR_VPC_LOG_GROUP_PREFIX	Si ha configurado su grupo log de VPC para utilizar una ruta diferente a /aws/vpc/flow-log, puede especificarla con esta variable. Opcional.

6. Reconozca que la aplicación crea funciones de IAM personalizadas y luego haga clic en Deploy.

Una vez que se complete el proceso, cree un desencadenador Lambda para vincular su función Lambda al registro de CloudWatch.

Crear un disparador Lambda

Asegúrese de configurar un activador, no una suscripción log , en la función de ingesta. Si se configuró una suscripción en la consola Lambda, esto podría generar una cascada de registros generados y reenviados a New Relic.

Para que su registro se transmita a New Relic, adjunte un activador a Lambda:

1. En el menú del lado izquierdo, seleccione

   Functions

   .

2. Busque y seleccione la función newrelic-log-ingestion creada anteriormente.

3. En

   Triggers

   , haga clic en

   Add Triggers

   y seleccione

   CloudWatch Logs

   en el menú desplegable.

4. Seleccione el

   Log group

   apropiado para su aplicación.

5. Ingrese un nombre para su filtro.

6. Opcional: ingrese un patrón de filtro.

7. Marque la casilla de verificación

   Enable trigger

   y luego haga clic en

   Add

   para crear el activador.

Opcional: configurar diferentes extremos de registro

Puede configurar un extremo de registro personalizado si es necesario, esto le permitirá, por ejemplo, utilizar nuestro extremo compatible con FedRAMP.

Para eso, debes desplegar la aplicación explicada anteriormente y luego:

1. Vaya a la vista Lambda recientemente desplegar función en AWS.

2. Desplácese hacia abajo y haga clic en la pestaña

   Configuration

   .

3. En el menú de la izquierda dentro de la pestaña

   Configuration

   , haga clic en

   Environment Variables

   .

4. Aquí puede ver una lista de las variables de entorno ya existentes; simplemente haga clic en

   Edit

   en la parte superior derecha de la tabla

   Environment Variables

   .

5. Actualice el NR_LOGGING_ENDPOINT con el extremo apropiado:

   • Para EE.UU: https://log-api.newrelic.com/log/v1
   • Para la UE: https://log-api.eu.newrelic.com/log/v1
   • Para FedRAMP: https://gov-log-api.newrelic.com/log/v1

6. Haga clic en

   Save

   .

Opcional: configurar reintentos

Puede configurar la cantidad de reintentos que desea realizar en caso de que la función no pueda enviar los datos en caso de problemas de comunicación. El número recomendado es tres reintentos, pero puedes cambiar el comportamiento de reintento cambiando el siguiente parámetro:

MAX_RETRIES = 3  # Defines the number of retries after lambda failure to deliver data
INITIAL_BACKOFF = 1  # Defines the initial wait seconds until next retry is executed
BACKOFF_MULTIPLIER = 2  # Time multiplier between the retries
As an example, in default above configuration, first retry will happen after 1 second, second retry after 2 seconds and third retry will happen after 4 seconds.

Recursos creados por la plantilla SAM

Cuando creas la aplicación desde el repositorio, también se crean los siguientes recursos:

• La función Lambda en sí
• Un rol utilizado para otorgar permisos de ejecución a la función Lambda basada en el registro de CloudWatch.

Todas las demás configuraciones de Lambda que no figuran en la lista se pueden dejar como predeterminadas.

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
• New Relic para ejecutar consultaNRQL . 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.

• 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 Amazon CloudWatch. No necesitas hacer nada más en New Relic.