추적 관찰자 설정

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

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

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

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

뉴렐릭 APM에이전트 또는 타사 통합을 사용하는 경우 새 트레이스 관찰자를 생성하려면 다음을 수행하세요.

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

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

3. 트레이스 관찰자가 이미 존재하지 않으면 New trace observer 클릭하여 추가하고 정보를 입력한 후 Create 클릭합니다. 우리는 다음 지역을 제공합니다.

   • us-east-1 (US)

   • us-west-2 (US)

   • eu-central-1 (EU):

     EU 요청에서 데이터를 수집하고 EU 데이터센터에 보고하는 EU 기반 뉴렐릭 계정이 있는 경우 이 지역을 선택하세요.

   • eu-west-1 (US):

     EU 요청에서 데이터를 수집하고 미국 데이터센터에 보고하는 미국 기반 뉴렐릭 계정이 있는 경우 이 지역을 선택하세요.

   • ap-southeast-1 (US)

   • ap-southeast-2 (US)

   • us-east-2 (US, FedRAMP)

4. Endpoints 드롭다운 메뉴에서 For other integrations 아래의 엔드포인트 값을 복사하여 준비하세요. 이 값은 코드 예제에서 YOUR_TRACE_OBSERVER_URL 로 참조됩니다. 이는 트레이스 관찰자를 테스트하고, 텔레메트리 통합 을 구성하고, 트레이스 API 통해 데이터를 전송하는 데 사용됩니다.

5. APM 에이전트를 설정하는 경우 For language agents 아래의 엔드포인트 값도 복사하여 준비해야 합니다. 이 값은 코드 예제에서 YOUR_TRACE_OBSERVER_HOST 로 참조됩니다. 이는 Traces 관찰자에게 데이터를 보내기 위해 우리 언어 에이전트를 구성하는 데 사용됩니다.

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 integrations 엔드포인트 값으로 바꿉니다.

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

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

      • For other integrations

        엔드포인트 값을 사용했는지 확인하세요.

      • 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 추적 관찰자에게 데이터를 보내야 하는 데이터 원본(서비스, 앱 또는 엔터티)을 지정하는 추적 관찰자에서 별도의 구성을 완료합니다.

다른 유형의 서비스(예: APM에이전트)를 설정하는 동안 트레이스 관찰자를 이미 생성한 경우 트레이스 관찰자 생성 단계를 건너뛰고 브라우저, 모바일 및 Lambda에 대한 초기 트레이스 관찰자 설정 으로 바로 이동할 수 있습니다. 데이터 소스를 선택합니다.

추적 관찰자 만들기

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

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

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

3. 트레이스 관찰자가 이미 존재하지 않으면 New trace observer 클릭하여 추가하고 정보를 입력한 후 Create 클릭합니다. 우리는 다음 지역을 제공합니다.

   • us-east-1 (US)

   • us-west-2 (US)

   • eu-central-1 (EU):

     EU 요청에서 데이터를 수집하고 EU 데이터센터에 보고하는 EU 기반 뉴렐릭 계정이 있는 경우 이 지역을 선택하세요.

   • eu-west-1 (US):

     EU 요청에서 데이터를 수집하고 미국 데이터센터에 보고하는 미국 기반 뉴렐릭 계정이 있는 경우 이 지역을 선택하세요.

   • ap-southeast-1 (US)

   • ap-southeast-2 (US)

   • us-east-2 (US, FedRAMP)

4. Endpoints 드롭다운 메뉴에서 For other integrations 아래의 엔드포인트 값을 복사하여 준비하세요. 이 값은 코드 예제에서 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 integrations 엔드포인트 값으로 바꿉니다.

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

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

      • For other integrations

        엔드포인트 값을 사용했는지 확인하세요.

      • 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 capabilities > Infinite Tracing settings)으로 돌아갑니다.

2. 트레이스 관찰자의 경우 행 끝으로 이동하여 줄임표 아이콘 ... 클릭한 다음 Edit mobile, browser, lambda sources 클릭합니다.

   

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

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

   • 브라우저 앱이 여러 이름을 가진

     APM

     에이전트에 연결된 경우 이름은 하나만 선택할 수 있습니다.

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

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

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

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

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