New Relic ofrece una integración para informar sus datos de AWS X-Ray. Este documento explica cómo activar esta integración y describe los datos que se pueden reportar.
Activar la integración
Para habilitar la integración de AWS X-Ray, siga los procedimientos estándar para conectar los servicios de AWS a la infraestructura.
Cuando haya conectado correctamente su cuenta de AWS con New Relic:
Vaya a
one.newrelic.com > All capabilities > Infrastructure
y luego haga clic en
AWS
.
Haga clic en
Manage Services
para seleccionar la integración de AWS que desea activar.
Marque la casilla de verificación junto a
AWS X-Ray
.
Haga clic en
Save
.
Configuración y sondeo
Puede cambiar la frecuencia de sondeo y filtrar sus datos usando las opciones de configuración.
Aquí está la información de sondeo predeterminada para la integración de AWS X-Ray:
- New Relic intervalo de sondeo: 5 minutos
Sugerencia
Espere hasta 20 minutos para que aparezca su primera traza. Dado que las trazas se recopilan una vez completadas, y solo una vez por intervalo de sondeo, los datos de las trazas de rayos X se retrasan considerablemente con el tiempo real y no deben usarse para alertar.
Importante
Un intervalo de sondeo superior a 5 minutos puede provocar la pérdida de la traza. New Relic arroja datos de traza de más de 20 minutos. De manera similar, es probable que las trazas de larga duración estén incompletas. El monitoreo de rayos X recopila únicamente trazas completas y se eliminan los intervalos dentro de una traza de más de 20 minutos.
Buscar y utilizar datos
New Relic informa los segmentos de rayos X como datosSpan
. Una vez que haya activado esta integración, debería ver aparecer la traza de AWS X-Ray en rastreo distribuido.
Para filtrar sus intervalos, puede utilizar el atributo newRelic.ingestPoint
. Este atributo está establecido en xray.polling
para todos los intervalos de rayos X.
A continuación se muestra un ejemplo de consulta NRQL para verificar la ingesta de rayos X:
SELECT count(*) FROM Span WHERE newRelic.ingestPoint = 'xray.polling' TIMESERIES
A continuación se muestra un ejemplo de consulta NRQL para correlacionar datos de X-Ray con el rendimiento de API específico:
SELECT average(duration.ms) FROM Span WHERE newRelic.ingestPoint = 'xray.polling' AND http.url LIKE 'https://yourdomanin.com/api/v1/endpoint%' since 1 month ago LIMIT MAX TIMESERIES 1 day
Uso de políticas de IAM personalizadas
Si utiliza una política de IAM personalizada al conectar su cuenta de AWS con el agente de infraestructura, su política personalizada necesitará los siguientes permisos para que funcione la integración de AWS X-Ray:
xray:BatchGet*
xray:Get*
Rayos X y función Lambda
La función Lambda requiere alguna configuración para usar X-Ray. Consulte la sección Uso de AWS X-Ray en la Guía para desarrolladores de AWS Lambda.
En particular, tenga en cuenta que la función de ejecución de su función Lambda necesitará permisos adicionales para registrar datos en X-Ray.
Funciones de rayos X y escalones
Las máquinas de estado AWS Step Function son aplicaciones distribuidas y se pueden monitorear con rayos X. El seguimiento de rayos X debe estar habilitado explícitamente para que X-Ray capture datos para las máquinas de estado de funciones de pasos.
Asegúrese de habilitar el seguimiento de rayos X para cualquier función Lambda en su máquina de estado, así como para la máquina de estado en general.