Complemento AWS FireLens para reenvío de registros

Si sus datos log ya están siendo monitoreados por AWS FireLens, puede utilizar nuestra integración FireLens para reenviar y enriquecer sus datos log en New Relic. Esta integración se basa en nuestro complemento de salida Fluent Bit.

Reenviar su registro de FireLens a New Relic le brindará capacidades mejoradas para recopilar, procesar, explorar, consultar y alertar sobre sus datos log .

Proceso básico

Para habilitar las capacidades de administración de registros:

Asegúrate de tener:
- A
- Clúster de servicios de contenedor (ECS) Amazon EC2
Configure el contenedor del enrutador log FireLens para que se ejecute como un sidecar. (Un sidecar es una forma de trasladar parte de la responsabilidad principal de un servicio a un módulo en contenedores que se implementa junto con la aplicación principal).
Configurar el contenedor de la aplicación.
Genere algo de tráfico y espere unos minutos, luego verifique los datos de su cuenta .

Configurar el contenedor del enrutador log FireLens

New Relic utiliza una imagen de Fluent Bit para configurar el contenedor del enrutador log FireLens. Este contenedor maneja todo el enrutamiento log desde el complemento de la aplicación.

Para reenviar su registro de FireLens a New Relic:

Agregue un contenedor complementario a su definición de tarea ECS preexistente que actuará como enrutador log de Firelens. Para obtener ayuda para configurar el enrutamiento log de ECS, consulte la documentación de Amazon ECS para el enrutamiento log personalizado.
Sustituya las imágenes recomendadas por la imagen del complemento de salida New Relic Fluent Bit para su región AWS .

Establezca el atributomemoryReservation para este contenedor.

Región de AWS	Nombre completo de la imagen
ap-northeast-1	`533243300146.dkr.ecr.ap-northeast-1.amazonaws.com/newrelic/logging-firelens-fluentbit`
ap-northeast-2	`533243300146.dkr.ecr.ap-northeast-2.amazonaws.com/newrelic/logging-firelens-fluentbit`
ap-northeast-3	`533243300146.dkr.ecr.ap-northeast-3.amazonaws.com/newrelic/logging-firelens-fluentbit`
ap-south-1	`533243300146.dkr.ecr.ap-south-1.amazonaws.com/newrelic/logging-firelens-fluentbit`
ap-southeast-1	`533243300146.dkr.ecr.ap-southeast-1.amazonaws.com/newrelic/logging-firelens-fluentbit`
ap-southeast-2	`533243300146.dkr.ecr.ap-southeast-2.amazonaws.com/newrelic/logging-firelens-fluentbit`
ca-central-1	`533243300146.dkr.ecr.ca-central-1.amazonaws.com/newrelic/logging-firelens-fluentbit`
eu-central-1	`533243300146.dkr.ecr.eu-central-1.amazonaws.com/newrelic/logging-firelens-fluentbit`
eu-north-1	`533243300146.dkr.ecr.eu-north-1.amazonaws.com/newrelic/logging-firelens-fluentbit`
eu-west-1	`533243300146.dkr.ecr.eu-west-1.amazonaws.com/newrelic/logging-firelens-fluentbit`
eu-west-2	`533243300146.dkr.ecr.eu-west-2.amazonaws.com/newrelic/logging-firelens-fluentbit`
eu-west-3	`533243300146.dkr.ecr.eu-west-3.amazonaws.com/newrelic/logging-firelens-fluentbit`
sa-east-1	`533243300146.dkr.ecr.sa-east-1.amazonaws.com/newrelic/logging-firelens-fluentbit`
us-east-1	`533243300146.dkr.ecr.us-east-1.amazonaws.com/newrelic/logging-firelens-fluentbit`
us-east-2	`533243300146.dkr.ecr.us-east-2.amazonaws.com/newrelic/logging-firelens-fluentbit`
us-west-1	`533243300146.dkr.ecr.us-west-1.amazonaws.com/newrelic/logging-firelens-fluentbit`
us-west-2	`533243300146.dkr.ecr.us-west-2.amazonaws.com/newrelic/logging-firelens-fluentbit`

callout.Recommendation

Le recomendamos fijar nuestra etiqueta de imagen cuando despliegue una de nuestras imágenes de Firelens como parte de sus definiciones de tareas. Esto permite actualizaciones más controladas de la versión de la imagen. La etiqueta de imagen disponible en nuestro repositorio ECR newrelic/logging-firelens-fluentbit se puede enumerar con el siguiente comando (requiere tener la AWS CLI correctamente instalada y configurada):

bash

$aws ecr describe-images --registry-id 533243300146 --repository-name newrelic/logging-firelens-fluentbit --filter '{"tagStatus": "TAGGED"}' --query 'reverse(sort_by(imageDetails, & imagePushedAt))[*].imageTags' --region us-east-1 --output text

El siguiente ejemplo fijará la versión 1.17.1 para que la definición de la tarea sea siempre desplegar con esa versión de la imagen:

{
  "essential": true,
  // Image below is New Relic's Fluent Bit output plugin available on ECR
  "image": "533243300146.dkr.ecr.us-east-2.amazonaws.com/newrelic/logging-firelens-fluentbit:1.17.1",
  "name": "log_router",
  "firelensConfiguration": {
    "type": "fluentbit",
    "options": {
      "enable-ecs-log-metadata": "true"
    }
  }
}

Configurar el contenedor de la aplicación

Administrador de secretos de AWS (recomendado)

Para evitar exponer su New Relic en su definición de tarea, le recomendamos encarecidamente utilizar el servicio AWS Secrets Manager .

Al agregar el secreto, utilice la pestaña Plaintext . Una vez que haya agregado el secreto a Secrets Manager, puede hacer referencia a él utilizando el bloque logConfiguration y reemplazando SECRET_NAME con el nombre de su secreto de AWS. Por ejemplo:

"logConfiguration": {
  "logDriver":"awsfirelens",
  "options": {
    "Name": "newrelic"
  },
  "secretOptions": [{
    "name": "apiKey",
    "valueFrom": "arn:aws:secretsmanager:region:aws_account_id:secret:SECRET_NAME"
  }]
}

Configuración de clave de texto sin formato

Usa el bloque logConfiguration, reemplazando INSERT_API_KEY con tu New Relic . Para obtener detalles de configuración, consulte las definiciones de tareas de FireLens en GitHub.

"logConfiguration": {
  "logDriver":"awsfirelens",
  "options": {
    "Name": "newrelic",
    "apiKey": "NEW_RELIC_LICENSE_KEY"
  }

Configuración de ejemplo

Ejemplo de definición de tarea para un servidor NGINX básico:

{
  "family": "newrelic-firelens",
  "networkMode": "awsvpc",
  "requiresCompatibilities": ["FARGATE"],
  "containerDefinitions": [
    // FireLens log router container
    {
      "essential": true,
      // Image below is New Relic's Fluent Bit output plugin available on ECR
      "image": "533243300146.dkr.ecr.us-east-2.amazonaws.com/newrelic/logging-firelens-fluentbit",
      "name": "log_router",
      "firelensConfiguration": {
        "type": "fluentbit",
        "options": {
          "enable-ecs-log-metadata": "true"
        }
      }
    },
    // Application container
    {
      "essential": true,
      "name": "webserver",
      // Application image goes here
      "image": "nginx",
      "cpu": 512,
      "memoryReservation": 1024,
      "portMappings": [
        {
          "containerPort": 5000
        }
      ],
      "environment": [
        {
          "name": "VERSION",
          "value": "V1"
        }
      ],
      // New Relic Fluent Bit output configuration
      "logConfiguration": {
        "logDriver": "awsfirelens",
        "options": {
          "Name": "newrelic"
        },
        "secretOptions": [
          {
            "name": "apiKey",
            "valueFrom": "arn:aws:secretsmanager:region:aws_account_id:secret:secret_name-AbCdEf"
          }
        ]
      }
    }
  ],
  // Use your own role here
  "executionRoleArn": "arn:aws:iam::XXXXXXXXXXXX:role/ecsTaskExecutionRole",
  "taskRoleArn": "arn:aws:iam::XXXXXXXXXXXX:role/ecsTaskExecutionRole",
  "cpu": "1 vcpu",
  "memory": "2 gb"
}

Ejemplo de definición de tarea para un servidor NGINX básico:

{
  "family": "newrelic-firelens",
  "networkMode": "bridge",
  "requiresCompatibilities": ["EC2"],
  "containerDefinitions": [
    // FireLens log router container
    {
      "essential": true,
      // Image below is New Relic's Fluent Bit output plugin available on ECR
      "image": "533243300146.dkr.ecr.us-east-2.amazonaws.com/newrelic/logging-firelens-fluentbit",
      "name": "log_router",
      "memoryReservation": 50,
      "firelensConfiguration": {
        "type": "fluentbit",
        "options": {
          "enable-ecs-log-metadata": "true"
        }
      }
    },
    // Application container
    {
      "essential": true,
      "name": "webserver",
      // Application image goes here
      "image": "nginx",
      "cpu": 512,
      "memoryReservation": 1024,
      "portMappings": [
        {
          "containerPort": 5000
        }
      ],
      "environment": [
        {
          "name": "VERSION",
          "value": "V1"
        }
      ],
      // New Relic Fluent Bit output configuration
      "logConfiguration": {
        "logDriver": "awsfirelens",
        "options": {
          "Name": "newrelic"
        },
        "secretOptions": [
          {
            "name": "apiKey",
            "valueFrom": "arn:aws:secretsmanager:region:aws_account_id:secret:secret_name-AbCdEf"
          }
        ]
      }
    }
  ],
  // Use your own role here
  "executionRoleArn": "arn:aws:iam::XXXXXXXXXXXX:role/ecsTaskExecutionRole",
  "taskRoleArn": "arn:aws:iam::XXXXXXXXXXXX:role/ecsTaskExecutionRole",
  "cpu": "1 vcpu",
  "memory": "2 gb"
}

¿Te ha ayudado este documento con la instalación?

Reenviar registro a la cuenta New Relic EU

Para reenviar el registro de Firelens a una cuenta New Relic EU, agregue una propiedad adicional al campo options del objeto logConfiguration en el contenedor de su aplicación.

"endpoint": "https://log-api.eu.newrelic.com/log/v1"

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

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

Te ofrecemos esta traducción automática para facilitar la lectura.

Complemento AWS FireLens para reenvío de registros

Proceso básico

Configurar el contenedor del enrutador log FireLens

callout.Recommendation

Configurar el contenedor de la aplicación

Administrador de secretos de AWS (recomendado)

Configuración de clave de texto sin formato

Configuración de ejemplo

Configuración de definición de tarea de ejemplo de Fargate

Configuración de definición de tarea de ejemplo de EC2

¿Te ha ayudado este documento con la instalación?

Reenviar registro a la cuenta New Relic EU

Ver datos log

¿Que sigue?

Desactivar reenvío de registros

Te ofrecemos esta traducción automática para facilitar la lectura.

Complemento AWS FireLens para reenvío de registros

Proceso básico .css-21sua1{background:none;border:none;width:0;padding:0;}

Configurar el contenedor del enrutador log FireLens

callout.Recommendation

Configurar el contenedor de la aplicación

Administrador de secretos de AWS (recomendado)

Configuración de clave de texto sin formato

Configuración de ejemplo

Configuración de definición de tarea de ejemplo de EC2

¿Te ha ayudado este documento con la instalación?

Reenviar registro a la cuenta New Relic EU

Ver datos log

¿Que sigue?

Desactivar reenvío de registros

Proceso básico