A New Relic oferece uma integração para relatar seus dados do AWS X-Ray. Este documento explica como ativar esta integração e descreve os dados que podem ser reportados.
Ative a integração
Para habilitar a integração do AWS X-Ray, siga os procedimentos padrão para conectar os serviços da AWS à infraestrutura.
Depois de conectar com êxito sua conta da AWS ao New Relic:
Vá para
one.newrelic.com > All capabilities > Infrastructure
e clique em
AWS
.
Clique em
Manage Services
para selecionar a integração AWS que você deseja ativar.
Marque a caixa de seleção ao lado de
AWS X-Ray
.
Clique em
Save
.
Configuração e polling
Você pode alterar a frequência de pesquisa e filtrar seus dados usando opções de configuração.
Aqui estão as informações de pesquisa padrão para a integração do AWS X-Ray:
- Intervalo de sondagem New Relic : 5 minutos
Dica
Aguarde até 20 minutos para que seu primeiro rastreamento apareça. Como os rastreamentos são coletados após serem concluídos, e apenas uma vez por intervalo de sondagem, os dados trace do Raio-X atrasam consideravelmente o tempo real e não devem ser usados para alertas.
Importante
Intervalos de sondagem superiores a 5 minutos podem resultar na perda do rastreio. New Relic descarta dados trace com mais de 20 minutos. Da mesma forma, o rastreamento de longa duração provavelmente estará incompleto. O monitoramento do X-Ray coleta apenas o rastreamento concluído e os intervalos dentro de um trace com mais de 20 minutos são descartados.
Encontre e use dados
O New Relic relata segmentos do X-Ray como Span
dados. Depois de ativar esta integração, você verá o rastreamento do AWS X-Ray aparecendo no distributed tracing.
Para filtrar seus períodos, você pode usar o atributo newRelic.ingestPoint
. Este atributo é definido como xray.polling
para todos os períodos do X-Ray.
Aqui está um exemplo de consulta NRQL para verificar a ingestão do X-Ray:
SELECT count(*) FROM Span WHERE newRelic.ingestPoint = 'xray.polling' TIMESERIES
Aqui está um exemplo de consulta NRQL para correlacionar dados do X-Ray com desempenho específico da API:
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
Usando políticas personalizadas do IAM
Se você estiver usando uma política personalizada do IAM ao conectar sua conta da AWS ao agente de infraestrutura, sua política personalizada precisará das seguintes permissões para que a integração do AWS X-Ray funcione:
xray:BatchGet*
xray:Get*
Raio-X e função do Lambda
A função do Lambda requer alguma configuração para usar o X-Ray. Consulte a seção Usar o AWS X-Ray no Guia para desenvolvedores AWS Lambda .
Em particular, observe que a função de execução da sua função do Lambda precisará de permissões adicionais para registrar dados no X-Ray.
Funções de Raio-X e Step
As máquinas de estado AWS Step Function são aplicativos distribuídos e podem ser monitoradas com o X-Ray. O rastreamento do X-Ray precisa ser explicitamente habilitado para que o X-Ray capture dados para máquinas de estado de função de etapa.
Certifique-se de habilitar o rastreamento do X-Ray para qualquer função do Lambda em sua máquina de estado, bem como para a máquina de estado em geral.