추적 관찰자 설정

분산 추적을 설정하는 단계를 따르고 무한 추적이라는 고급 옵션에 대한 단계를 계속하는 경우 추적 관찰자를 설정해야 합니다. 추적 관찰자는 원격 측정 데이터를 New Relic으로 보낼 수 있는 짧은 대기 시간과 저렴한 방법을 제공하는 Infinite Tracing용 AWS 기반 서비스입니다. 추적 데이터를 수신하면 추적 관찰자는 꼬리 기반 샘플링 을 사용하여 유지하고 New Relic으로 보낼 항목을 결정합니다.

데이터 원본 유형(서비스, 앱 또는 엔터티)에 맞는 추적 관찰자 설정을 완료합니다. 다양한 유형이 있는 경우 두 개 이상의 섹션에서 단계를 수행해야 할 수 있습니다.

• APM 에이전트 및 타사 원격 측정 도구로 계측된 서비스
• New Relic 브라우저, 모바일 및 Lambda로 계측된 서비스
• (선택 사항) 모든 서비스 유형에 대한 추가 구성

APM 에이전트 및 타사 원격 측정 도구로 계측된 서비스

New Relic을 사용하는 경우 새 트레이스 옵저버를 생성하려면 에이전트 또는 타사 통합:

1. one.newrelic.com > All capabilties > Infinite Tracing settings 으로 이동합니다.

2. 왼쪽 상단 드롭다운에서 계정을 선택합니다. 여러 계정에 대한 액세스 권한이 있는 경우 무한 추적을 활성화하려는 계정에 있는지 확인하십시오. 관찰자를 추가할 수 없다면 계정 패밀리당 지역당 한 명의 관찰자 만 허용하기 때문일 수 있습니다.

3. 추적 관찰자가 이미 있는 경우 새 추적 관찰자 를 클릭하여 하나를 추가하고 정보를 입력한 다음 만들기 를 클릭합니다. 다음 지역을 제공합니다.

   • us-east-1(미국)
   • us-west-2(미국)
   • eu-central-1(EU): EU 요청에서 데이터를 수집하고 EU 데이터 센터에서 보고하는 EU 기반 New Relic 계정이 있는 경우 이 지역을 선택하십시오.
   • eu-west-1(US): EU 요청에서 데이터를 수집 중이고 미국 데이터 센터에서 보고하는 미국 기반 New Relic 계정이 있는 경우 이 지역을 선택하십시오.
   • ap-southeast-1(미국)
   • ap-southeast-2(미국)
   • us-east-2(미국, FedRAMP)

4. 끝점 드롭다운에서 다른 통합 의 경우 끝점 값을 복사하여 준비합니다. 이 값은 코드 예에서 YOUR_TRACE_OBSERVER_URL 으로 참조됩니다. 이것은 추적 관찰자 를 테스트하고 원격 측정 통합 을 구성하고 Trace API 를 통해 데이터를 보내는 데 사용됩니다.

5. APM 에이전트를 설정하는 경우 언어 에이전트 의 경우 끝점 값도 복사하여 준비해야 합니다. 이 값은 코드 예에서 YOUR_TRACE_OBSERVER_HOST 으로 참조됩니다. 이것은 추적 관찰자에게 데이터를 보내도록 언어 에이전트를 구성 하는 데 사용됩니다.

6. (선택 사항) 추적 관찰자가 작동하는지 확인하려면 샘플 추적 페이로드를 보내는 것이 좋습니다. Trace API를 직접 사용하는 경우 API 작동 방식을 배우는 데 도움이 됩니다.

   샘플 페이로드 보내기

   중요

   Zipkin 형식 데이터를 사용하는 경우 Zipkin 페이로드 보내기 를 참조하세요.

   이 테스트는 Test Service A 이라는 서비스에서 하나의 추적과 두 개의 스팬이 있는 샘플 추적 페이로드를 보냅니다.

   이 샘플 요청을 보내려면:

   1. 가져오기 계정 라이선스 키데이터를 보고할 계정에 대해 준비하십시오.

   2. 다음 curl 요청을 텍스트 편집기에 복사합니다.

      bash

      복사

      $
      curl -i -H 'Content-Type: application/json' \
      >
          -H 'Api-Key: YOUR_LICENSE_KEY' \
      >
          -H 'Data-Format: newrelic' \
      >
          -H 'Data-Format-Version: 1' \
      >
          -X POST \
      >
          -d '[
      $
              {
      $
                  "common": {
      $
                      "attributes": {
      $
                          "environment": "staging"
      $
                      }
      $
                  },
      $
                  "spans": [
      $
                      {
      $
                          "trace.id": "123456",
      $
                          "id": "ABC",
      $
                          "attributes": {
      $
                              "duration.ms": 12.53,
      $
                              "host": "host123.example.com",
      $
                              "name": "/home",
      $
                              "service.name": "Test Service A"
      $
                          }
      $
                      },
      $
                      {
      $
                          "trace.id": "123456",
      $
                          "id": "DEF",
      $
                          "attributes": {
      $
                              "error.message": "Invalid credentials",
      $
                              "service.name": "Test Service B",
      $
                              "host": "host456.example.com",
      $
                              "duration.ms": 2.97,
      $
                              "name": "/auth",
      $
                              "parent.id": "ABC"
      $
                          }
      $
                      }
      $
                  ]
      $
              }
      $
          ]' 'YOUR_TRACE_OBSERVER_URL'

   3. curl 요청에 고유한 값을 삽입합니다.

      값	설명
      YOUR_LICENSE_KEY	이것을 수집으로 교체하십시오. 계정 라이선스 키.
      YOUR_TRACE_OBSERVER_URL	이것을 이전 단계에서 복사한 For other integration endpoint 값으로 바꿉니다.

   4. curl 요청을 터미널에 복사하고 실행합니다.

   5. 테스트는 성공을 나타내는 HTTP/1.1 202 Accepted 을 반환해야 합니다. 그렇지 않은 경우 다음과 같은 일반적인 문제를 확인하십시오.

      • 다른 통합 용 엔드포인트 값을 사용했는지 확인하십시오.
      • YOUR_TRACE_OBSERVER_URL 주위에 작은따옴표를 사용하고 있는지 확인합니다.
      • 올바른 API 키를 사용하고 있는지 확인하세요.

   6. 테스트에서 HTTP/1.1 202 Accepted 이 반환된 경우 New Relic UI로 이동하여 스팬 속성 service.name = Test Service A 을 사용하는 샘플 페이로드 데이터의 쿼리를 확인하십시오(해당 쿼리에 대한 링크는 여기 ). 샘플 페이로드에는 오류 속성이 포함되어 있기 때문에 오류 샘플러는 이를 유지하도록 표시합니다. 오류 속성을 제거하기 위해 페이로드를 수정하면 임의 샘플러가 이 특정 추적을 유지하도록 선택하지 않을 수 있습니다.

      팁

      추적이 UI에 표시되는 데 최대 1분이 소요될 수 있습니다.

7. Infinite Tracing을 실험한 후 해당 구성으로 돌아갈 수 있도록 아래의 선택적 구성 을 책갈피로 지정하십시오.

8. 에이전트 또는 타사 원격 측정 도구에 대한 원래 분산 추적 설정 지침으로 돌아가서 각 서비스의 구성에 새 끝점 값을 삽입합니다.

9. New Relic 브라우저, 모바일 및 Lambda로 계측된 서비스 가 있는 경우 해당 섹션의 단계에 따라 추적 관찰기에서 데이터 원본(서비스, 앱 또는 엔터티)을 선택합니다.

New Relic 브라우저, 모바일 및 Lambda로 계측된 서비스

New Relic 브라우저, 모바일 또는 Lambda를 사용하는 경우 새 추적 관찰자를 생성하려면 APM 에이전트 및 타사 통합과 유사한 단계를 따릅니다. 이 설정이 다른 점은 각 서비스의 구성에 새 추적 관찰자 끝점을 삽입할 필요가 없다는 것입니다. 대신, Infinite Tracing 추적 관찰자에게 데이터를 보내야 하는 데이터 원본(서비스, 앱 또는 엔터티)을 지정하는 추적 관찰자에서 별도의 구성을 완료합니다.

다른 유형의 서비스(예: 에이전트), 추적 관찰자 생성 단계를 건너뛰고 브라우저, 모바일 및 Lambda에 대한 초기 추적 관찰자 구성 으로 바로 이동하여 데이터 원본을 선택할 수 있습니다.

추적 관찰자 만들기

아직 추적 관찰자를 설정하지 않은 경우 다음을 완료하십시오.

1. one.newrelic.com > All capabilties > Infinite Tracing settings 으로 이동합니다.

2. 왼쪽 상단 드롭다운에서 계정을 선택합니다. 여러 계정에 대한 액세스 권한이 있는 경우 무한 추적을 활성화하려는 계정에 있는지 확인하십시오. 관찰자를 추가할 수 없다면 계정 패밀리당 지역당 한 명의 관찰자 만 허용하기 때문일 수 있습니다.

3. 추적 관찰자가 이미 있는 경우 새 추적 관찰자 를 클릭하여 하나를 추가하고 정보를 입력한 다음 만들기 를 클릭합니다. 다음 지역을 제공합니다.

   • us-east-1(미국)
   • us-west-2(미국)
   • eu-central-1(EU): EU 요청에서 데이터를 수집하고 EU 데이터 센터에서 보고하는 EU 기반 New Relic 계정이 있는 경우 이 지역을 선택하십시오.
   • eu-west-1(US): EU 요청에서 데이터를 수집 중이고 미국 데이터 센터에서 보고하는 미국 기반 New Relic 계정이 있는 경우 이 지역을 선택하십시오.
   • ap-southeast-1(미국)
   • ap-southeast-2(미국)
   • us-east-2(미국, FedRAMP)

4. 엔드포인트 드롭다운에서 기타 통합 의 경우 엔드포인트 값을 복사하고 준비합니다. 이 값은 코드 예제에서 YOUR_TRACE_OBSERVER_URL로 참조됩니다. 추적 관찰자 를 테스트하는 데 사용됩니다.

5. (선택 사항) 추적 관찰자가 작동하는지 확인하려면 샘플 추적 페이로드를 보내는 것이 좋습니다.

   샘플 페이로드 보내기

   중요

   Zipkin 형식 데이터를 사용하는 경우 Zipkin 페이로드 보내기 를 참조하세요.

   이 테스트는 Test Service A 이라는 서비스에서 하나의 추적과 두 개의 스팬이 있는 샘플 추적 페이로드를 보냅니다.

   이 샘플 요청을 보내려면:

   1. 가져오기 계정 라이선스 키데이터를 보고할 계정에 대해 준비하십시오.

   2. 다음 curl 요청을 텍스트 편집기에 복사합니다.

      bash

      복사

      $
      curl -i -H 'Content-Type: application/json' \
      >
          -H 'Api-Key: YOUR_LICENSE_KEY' \
      >
          -H 'Data-Format: newrelic' \
      >
          -H 'Data-Format-Version: 1' \
      >
          -X POST \
      >
          -d '[
      $
              {
      $
                  "common": {
      $
                      "attributes": {
      $
                          "environment": "staging"
      $
                      }
      $
                  },
      $
                  "spans": [
      $
                      {
      $
                          "trace.id": "123456",
      $
                          "id": "ABC",
      $
                          "attributes": {
      $
                              "duration.ms": 12.53,
      $
                              "host": "host123.example.com",
      $
                              "name": "/home",
      $
                              "service.name": "Test Service A"
      $
                          }
      $
                      },
      $
                      {
      $
                          "trace.id": "123456",
      $
                          "id": "DEF",
      $
                          "attributes": {
      $
                              "error.message": "Invalid credentials",
      $
                              "service.name": "Test Service B",
      $
                              "host": "host456.example.com",
      $
                              "duration.ms": 2.97,
      $
                              "name": "/auth",
      $
                              "parent.id": "ABC"
      $
                          }
      $
                      }
      $
                  ]
      $
              }
      $
          ]' 'YOUR_TRACE_OBSERVER_URL'

   3. curl 요청에 고유한 값을 삽입합니다.

      값	설명
      YOUR_LICENSE_KEY	이것을 당신의 계정 라이선스 키.
      YOUR_TRACE_OBSERVER_URL	이것을 이전 단계에서 복사한 For other integration endpoint 값으로 바꿉니다.

   4. curl 요청을 터미널에 복사하고 실행합니다.

   5. 테스트는 성공을 나타내는 HTTP/1.1 202 Accepted 을 반환해야 합니다. 그렇지 않은 경우 다음과 같은 일반적인 문제를 확인하십시오.

      • 다른 통합 용 엔드포인트 값을 사용했는지 확인하십시오.
      • YOUR_TRACE_OBSERVER_URL 주위에 작은따옴표를 사용하고 있는지 확인합니다.
      • 올바른 API 키를 사용하고 있는지 확인하세요.

   6. 테스트에서 HTTP/1.1 202 Accepted 이 반환된 경우 New Relic UI로 이동하여 스팬 속성 service.name = Test Service A 을 사용하는 샘플 페이로드 데이터의 쿼리를 확인하십시오(해당 쿼리에 대한 링크는 여기 ). 샘플 페이로드에는 오류 속성이 포함되어 있기 때문에 오류 샘플러는 이를 유지하도록 표시합니다. 오류 속성을 제거하기 위해 페이로드를 수정하면 임의 샘플러가 이 특정 추적을 유지하도록 선택하지 않을 수 있습니다.

      팁

      추적이 UI에 표시되는 데 최대 1분이 소요될 수 있습니다.

브라우저, 모바일 및 Lambda에 대한 초기 추적 관찰자 구성

추적 관찰자가 있으면 Infinite Tracing 추적 관찰자에게 데이터를 보내야 하는 데이터 원본(서비스, 앱 또는 엔터티)을 지정해야 합니다. 데이터 소스를 선택하기 전에 다음 사항을 숙지하십시오.

아래 절차는 New Relic UI를 사용하기 위한 것이지만 프로그래밍 방식을 선호하는 경우 GraphQL을 사용하여 데이터 소스를 지정할 수 있습니다. GraphQL을 사용하는 경우 이 절차로 돌아가 아래의 4단계(선택적 구성)를 계속하십시오.

UI에서 브라우저, 모바일 및 Lambda에 대한 구성을 완료하려면:

1. 추적 관찰자 앱(one.newrelic.com > All capabilties > Infinite Tracing settings)으로 돌아갑니다.

2. 추적 관찰자의 경우 행 끝으로 이동하여 세 개의 점을 클릭한 다음 모바일, 브라우저, 람다 소스 수정 을 클릭합니다.

   

3. 다음 사항을 염두에 두고 포함할 데이터 소스를 선택하십시오.

   • 필터를 사용하여 옵션을 좁힐 수 있습니다.

   • 브라우저 앱이

     이름이 여러 개인 에이전트는 하나의 이름만 선택할 수 있습니다.

   • 항목이 회색이면 다른 추적 관찰자가 이미 사용 중입니다.

4. Infinite Tracing을 실험한 후 해당 구성으로 돌아갈 수 있도록 아래의 선택적 구성 을 책갈피로 지정하십시오.
5. New Relic 분산 추적 UI 에서 Infinite Tracing 데이터를 봅니다.
6. APM 에이전트 또는 타사 원격 측정 도구로 계측된 서비스 가 있는 경우 해당 섹션의 단계에 따라 해당 데이터가 New Relic에 보고되도록 하십시오.

(선택 사항) 모든 서비스 유형에 대한 추가 구성

다양한 구성으로 추적 관찰자의 동작을 제어할 수 있습니다. 다음은 구성할 수 있는 몇 가지 기능입니다.

• 추적 관찰자 모니터링 구성 : 보고 유지된 추적의 양을 볼 수 있습니다.
• 스팬 속성 추적 필터 구성 : 스팬에 대한 사용자 정의 필터 규칙을 만듭니다.
• 무한 추적: 임의 추적 필터 구성: 임의 추적 필터 에서 사용하는 백분율을 조정합니다.