New Relic은 AWS X-Ray 데이터 보고를 위한 통합을 제공합니다. 이 문서에서는 이 통합을 활성화하는 방법과 보고할 수 있는 데이터에 대해 설명합니다.
통합 활성화
AWS X-Ray 통합을 활성화하려면 표준 절차에 따라 AWS 서비스를 인프라에 연결 하십시오.
AWS 계정을 New Relic과 성공적으로 연결했으면:
- one.newrelic.com > All capabilities > Infrastructure 로 이동한 다음 AWS를 클릭하십시오.
- 서비스 관리 를 클릭하여 활성화하려는 AWS 통합을 선택합니다.
- AWS X-Ray 옆의 확인란을 선택합니다.
- 저장 을 클릭합니다.
구성 및 폴링
구성 옵션 을 사용하여 폴링 빈도를 변경하고 데이터를 필터링할 수 있습니다.
다음은 AWS X-Ray 통합에 대한 기본 폴링 정보입니다.
- New Relic 폴링 간격: 5분
팁
첫 번째 추적이 나타날 때까지 최대 20분이 소요됩니다. 추적은 완료된 후 수집되고 폴링 간격당 한 번만 수집되기 때문에 X-Ray 추적 데이터는 실시간으로 상당히 지연되며 경고에 사용해서는 안 됩니다.
중요
폴링 간격이 5분보다 길면 추적이 손실될 수 있습니다. New Relic은 20분 이상 지난 추적 데이터를 삭제합니다. 마찬가지로 장기 실행 추적은 불완전할 수 있습니다. X-Ray 모니터링은 완료된 추적만 수집하고 20분보다 오래된 추적 내의 스팬은 삭제됩니다.
데이터 찾기 및 사용
New Relic은 X-Ray 세그먼트를 Span 데이터 로 보고합니다. 이 통합을 활성화하면 분산 추적 에 AWS X-Ray 추적이 표시되어야 합니다.
스팬을 필터링하려면 newRelic.ingestPoint 속성을 사용할 수 있습니다. 이 속성은 모든 X-Ray 범위에 대해 xray.polling 로 설정됩니다.
다음은 X-Ray 수집을 확인하기 위한 NRQL 쿼리의 예입니다.
SELECT count(*) FROM Span WHERE newRelic.ingestPoint = 'xray.polling' TIMESERIES다음은 X-Ray 데이터를 특정 API 성능과 상관시키는 NRQL 쿼리의 예입니다.
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사용자 지정 IAM 정책 사용
AWS 계정을 인프라 에이전트와 연결할 때 사용자 지정 IAM 정책을 사용하는 경우 AWS X-Ray 통합이 작동하려면 사용자 지정 정책에 다음 권한이 필요합니다.
xray:BatchGet*xray:Get*
X-Ray 및 Lambda 함수
Lambda 함수는 X-Ray를 사용하기 위해 몇 가지 구성이 필요합니다. AWS Lambda 개발자 안내서의 AWS X-Ray 사용 섹션을 참조하십시오.
특히 Lambda 함수의 실행 역할에는 X-Ray에 데이터를 기록하기 위한추가 권한 이 필요합니다.
X선 및 계단 함수
AWS Step Function 상태 머신은 분산 애플리케이션이며 X-Ray로 모니터링할 수 있습니다. X-Ray가 단계 기능 상태 머신에 대한 데이터를 캡처하려면 X-Ray 추적을 명시적으로 활성화 해야 합니다.
상태 머신의 모든 람다 기능 과 상태 머신 전체에 대해 X-Ray 추적을 활성화해야 합니다.