외부 서비스 기능은 New Relic APM 에이전트 및 OpenTelemetry 에서 사용할 수 있습니다.
최대한 빨리 시작하고 실행하려면 APM 에이전트를 사용하는 것이 좋습니다.
로고를 클릭하면 에이전트 설치 및 구성 과정을 안내하는 New Relic 플랫폼으로 이동됩니다.
외부 서비스 설정
다음 지침은 외부 서비스 설정 과정을 안내합니다.
데이터 전송 시작
APM 에이전트를 사용하는지 아니면 OpenTelemetry를 사용하는지에 따라 외부 서비스 설정이 변경됩니다. 시스템에 적합한 설치 옵션 탭을 선택합니다.
외부 서비스에서 보려는 각 서비스에 대해 다음을 완료하십시오.
아직 설치하지 않았다면 적절한 New Relic APM 에이전트 를 설치하십시오.
에이전트에서 분산 추적이 켜져 있는지 확인합니다.
- 새 에이전트를 설치한 경우 표준 분산 추적이 기본적으로 켜져 있습니다. 서비스가 무한 추적을 사용하는 다른 서비스와 통신하는 경우 무한 추적에 대한 도움말은 에이전트 설명서를 참조하십시오.
- 이전 에이전트가 있는 경우 구성 단계에 따라 표준 분산 추적 또는 무한 추적을 활성화하십시오. 분산 추적을 활성화하면 이전 교차 애플리케이션 추적이 무시됩니다.
에이전트에 추가 설정 단계가 필요한지 확인하십시오.
에이전트
최소 버전
설정
가다
3.6.0
NewRoundTripper()사용에 대한 문서를 참조하세요.자바
5.13.0
Java 에이전트 API 를 사용하여 외부 호출을 계측하는 방법에 대한 설명서를 참조하십시오.
.그물
8.29.0
Azure의 .NET 에이전트와 .NET 에이전트는 외부 호출을 자동으로 계측하지만 트랜잭션에 대한 메서드는 계측하지 않습니다. 거래를 보려면 다음 조합을 사용해야 합니다.
노드.js
6.9.0
Node.js 에이전트 API 사용에 대한 문서를 참조하십시오.
PHP
9.12.0.268
PHP 에이전트 API 를 사용하여 외부 호출을 계측하는 방법에 대한 설명서를 참조하십시오.
파이썬
5.14.0.142
추가 단계가 필요하지 않습니다. 외부 호출은 자동으로 계측됩니다.
루비
6.12.0.367
Ruby 에이전트 API 를 사용하여 외부 호출을 계측하는 방법에 대한 설명서를 참조하세요.
팁
기존 외부 서비스를 이미 사용 중인 에이전트 체인에 새 서비스를 추가해야 하는 경우 외부 서비스의 클래식 버전을 계속 사용할 수 있습니다. 클래식 외부 서비스를 설치하려면 아래 단계에서 분산 추적 대신 교차 애플리케이션 추적 을 활성화합니다.
New Relic UI는 서비스에 대한 OpenTelemetry 계측 설정 단계와 다른 서비스에 대한 호출 을 완료하면 외부 서비스 세부 정보를 표시합니다. 외부 서비스 기능은 서비스 간의 호출을 각 서비스의 트랜잭션 엔드포인트별로 분류하여 표시합니다. 각 트랜잭션의 이름은 프로세스( span.kind = "server" )의 항목 범위에서 파생됩니다.
APM 서비스가 OpenTelemetry 서비스(업스트림 또는 다운스트림)에 연결된 경우 해당 OpenTelemetry 서비스는 해당 APM 서비스의 보기에 표시되지 않습니다. 이는 APM 서비스를 볼 때 이 기능이 APM 에이전트에서만 보고하는 메트릭을 사용하기 때문입니다. OpenTelemetry 서비스를 볼 때 APM 서비스가 연결로 표시됩니다.
표시되는 정보의 품질은 수집기에서 사용하는 샘플링 전략에 따라 다릅니다. 샘플링을 사용하여 UI에 표시되는 내용을 제어하는 방법에 대한 다음 섹션을 참조하세요.
팁
OpenTelemetry 데이터의 100%를 Trace API로 보내면 조직에 대한 특정 속도 제한이 없거나 기본 속도 제한을 트리거하기에 충분한 데이터를 보내지 않는 한 해당 데이터의 100%를 저장합니다.
더 많은 UI 데이터를 보려면 샘플링을 조정하세요.
APM 에이전트를 사용 중이고 지도의 초기 페이지 이상으로 드릴링을 시작할 때 데이터가 거의 또는 전혀 표시되지 않는 경우 더 많은 데이터를 샘플링하기 위해 범위 저장소를 조정해야 할 수도 있습니다. 이는 트랜잭션 수준 데이터가 샘플링된 추적 데이터로 채워지기 때문입니다.
OpenTelemetry의 경우 초기 페이지와 모든 드릴다운 페이지가 모두 샘플링된 데이터로 채워지므로 필요한 데이터를 얻으려면 샘플링을 일부 조정해야 할 수도 있습니다.
다음은 APM 에이전트의 저장소를 조정하는 다양한 루틴에 대한 정보와 OpenTelemetry의 샘플링 조정에 대한 팁입니다.
모든 APM 에이전트에는 스팬을 저장하는 저장소가 있으며 이러한 에이전트 저장소의 대부분은 구성 가능합니다. 이 저장소의 크기는 에이전트가 생성하는 모든 범위를 보낼 수 있는 가능성에 영향을 줍니다. 자세한 내용은 조각난 추적 을 참조하세요.
이 기능에 대한 데이터는 한 서비스에서 다른 서비스로 외부 호출이 이루어지는 인접 클라이언트 및 서버 범위에서 파생됩니다. 에이전트가 스팬 저장소 제한에 도달하면 이러한 호출을 나타내는 일부 스팬을 삭제할 가능성이 있습니다.
기본 에이전트 구성 값 2000은 에이전트가 분당 수집하는 최대 이벤트 수를 정의합니다. 이 수보다 더 많은 범위가 있는 경우 에이전트는 통계적 샘플링을 수집하여 기본적으로 외부 서비스 맵에서 사용되는 데이터의 양을 저하시킵니다.
UI에 원하는 유형의 세부 정보가 표시되지 않으면 저수지의 크기를 최대 10,000까지 늘릴 수 있습니다. 에이전트 저장소를 조정하려면 다음을 검토하십시오.
APM 에이전트 | 선적 서류 비치 |
|---|---|
가다 | 저수지는 현재 구성할 수 없습니다 |
자바 | |
.그물 | |
노드.js | |
PHP | 저수지는 현재 구성할 수 없습니다 |
파이썬 | Python 구성 ( |
루비 |
팁
이 섹션은 서비스가 OpenTelemetry Collector를 통해 New Relic에 데이터를 보내는 경우에만 적용됩니다. 데이터가 OpenTelemetry Collector에서 샘플링되지 않기 때문입니다.
OpenTelemetry의 경우 모든 외부 서비스 보기가 샘플링된 추적으로 채워지므로 유용한 데이터가 충분하지 않을 수 있습니다. 이 문제를 해결하기 위해 수집기에서 샘플링을 변경하여 New Relic에 더 많은 데이터를 허용할 수 있습니다.
구성에 대한 팁은 샘플링을 참조하세요.
다음은 뭐지?
- 외부 서비스를 사용하여 API 문제를 해결하는방법 알아보기
- 외부 서비스 UI 탐색 에 대해 자세히 알아보세요.
- UI를 이해하는 방법에 대한 질문이 있는 경우 도움말 을 참조하세요.