우리의 Trace API는 분산된 추적 데이터 를 New Relic에 보내는 데 사용됩니다: 우리 고유의 일반 형식 또는 Zipkin 데이터 형식. 이 API는 일부 통합 및 내보내기의 추적 데이터가 New Relic에 보고되는 방식이기도 합니다.
Trace API를 사용해 보고 싶으십니까? 무료 New Relic 계정 을 만들었는지 확인하십시오. 신용 카드가 필요하지 않습니다.
일부 소개 콘텐츠를 건너뛰고 빠르게 시작하려면 데이터 보고 시작 으로 이동하세요.
추적 API란 무엇입니까?
Trace API는 New Relic이 분산 추적 데이터 를 수집하는 한 가지 방법입니다. 이 API( Infinite Tracing , 오픈 소스 통합 및 Telemetry SDK )를 통해 데이터를 보고하는 몇 가지 추적 도구가 있거나 API를 직접 사용하여 고유한 추적 구현을 만들 수 있습니다.
Trace API를 사용하는 이유:
- 사용자 지정 분산 추적 도구가 있고 계측을 변경하지 않고 New Relic에서 해당 데이터를 보고 싶어합니다.
- 추적 데이터를 내보내지만 추적 저장을 위한 백엔드가 필요한 도구가 있습니다.
- 설치된 솔루션 을 사용하지 않고 분산 추적 데이터를 New Relic에 보고하려고 합니다.
- Zipkin 을 사용하고 계측을 변경하지 않고 New Relic에서 해당 추적 데이터를 보고자 합니다.
추적 데이터가 다른 New Relic 데이터와 어떻게 관련되는지 이해하고 싶으십니까? 데이터 유형에 대해 읽어보세요 .
요구 사항
보낼 수 있는 데이터와 처리 방법에 대한 자세한 내용은 규칙 및 제한 을 참조하십시오.
샘플링 고려 사항
추적 API를 사용할 때 무한 추적 을 활성화하는 옵션이 있습니다. 무한 추적을 사용하는지 여부는 샘플링을 구성하는 방법에 영향을 미칩니다.
Use your own sampling (no Infinite Tracing):
Infinite Tracing을 사용하지 않는 경우, 샘플 트레이스가 우리에게 전송되기 전에 자신만의 샘플링 구현을 사용하여 샘플 트레이스를 사용하려는 것으로 가정합니다. (트레이스 데이터가 데이터 한도를 초과하는 경우 샘플링을 실시합니다.)
Use Infinite Tracing:
Infinite Tracing을 사용하려는 경우 일반적인 접근 방식은 Traces 데이터를 100% 전송하고 Infinite Tracing 샘플링을 사용하는 것입니다. (아래의 데이터 보고 시작 지침을 진행하면 무한 추적을 활성화하는 옵션이 제공됩니다.)
데이터 보고 시작
Trace API는 다음 두 가지 JSON 형식의 추적 데이터를 허용합니다.
zipkin: Zipkin JSON v2 추적 데이터 형식( Zipkin이 무엇인지 알아보기 ). Zipkin 데이터 전송을 시작하십시오 .newrelic: 우리의 일반적인 형식. Zipkin 형식의 데이터가 없으면 이것을 사용하십시오. New Relic 형식의 데이터 전송을 시작하십시오 .
보고할 데이터를 가져오는 데 문제가 있습니까? 문제 해결 을 참조하십시오.
데이터 찾기
다음 위치에서 Trace API를 통해 또는 이 API를 사용하는 통합에서 보낸 데이터를 찾을 수 있습니다.
- 분산 추적 UI 에서 .
- 쿼리를 통해: 사용자 지정 차트를 쿼리하고 만드는 방법에 대한 자세한 내용은 분산 추적 데이터 쿼리 를 참조하세요.
다음 단계
다음은 고려해야 할 몇 가지 추가 단계입니다.
- 분산 추적의 작동 방식 과 데이터 구조에 대해 자세히 알아보세요.
- 사용자 정의 속성으로 스팬 데이터를 장식 하십시오.
- GraphQL 기반 NerdGraph API를 사용하여 프로그래밍 방식으로 추적 데이터를 쿼리합니다 .