Go 애플리케이션에 대한 분산 추적 활성화

분산 추적을 사용하면 분산 시스템 전체에서 요청의 전체 여정을 볼 수 있습니다.Go 에이전트의 경우 두 가지 유형의 분산 추적을 제공합니다(자세한 내용은 스팬 샘플링 작동 방식 참조).

• 표준(헤드 기반 샘플링): 추적이 도착하기 전에 수락하고 분석할 추적 비율을 결정합니다.이를 통해 추적이 어떻게 도움이 되는지 확인할 수 있는 확실한 출발점이 됩니다.Go 에이전트 3.16.0 이상에서는 기본적으로 켜져 있습니다.
• 무한 추적(꼬리 기반 샘플링): 당사의 클라우드 기반 서비스는 모든 추적을 수용한 다음 가장 중요한 추적을 찾기 위해 정렬합니다.표준 추적을 설정한 후에는 모든 추적을 분석하고 가장 중요한 추적을 샘플링하는 구성 옵션을 제공하므로 이 옵션을 추가하는 것이 좋습니다.

분산 추적을 시작하는 데 필요한 모든 단계는 다음과 같습니다.

• 새 Go 에이전트: 새 에이전트 설치를 위한 헤드 및 테일 기반 샘플링 단계
• 이전 Go 에이전트: 이전 Go 에이전트 가 있는 경우 추적 옵션
• 수동 계측: 추가 계측을 위한 팁

새로운 Go 에이전트

표준 분산 추적(헤드 기반 샘플링)을 시도하거나 무한 추적(테일 기반 샘플링)을 설정하려는 경우 표준 추적 설정부터 시작해야 합니다. 우리는 당신을 통해 얻을 것입니다 헤드 기반 샘플링을 진행하기 위한 에이전트 설치. 그런 다음 옵션이지만 권장되는 무한 추적을 설정할 수 있습니다.

표준 분산 추적을 사용하려면 에이전트 설치

아직 서비스에 대한 APM 에이전트를 설치하지 않았거나 추가 서비스를 계측하려는 경우 표준 분산 추적 을 설정하는 가장 좋은 방법입니다.

이 APM 에이전트로 계측된 일부 서비스가 이미 있고 이를 분산 추적에 포함하려면 각 서비스에 대해 분산 추적을 수동으로 활성화해야 합니다.이전 Go 에이전트에 대한 옵션을 참조하세요.

1단계. 서비스 식별

어떤 서비스가 요청에 영향을 미치는지 파악하여 각 서비스를 계측하여 New Relic에 추적 데이터를 보낼 수 있습니다.

2단계. APM 에이전트로 각 서비스 계측

트랜잭션과 관련된 각 서비스에 대해 에이전트 설치 루틴을 반복합니다.일부 서비스에서 다른 언어를 사용하는 경우 해당 언어에 대한 설치 단계 를 반복하기만 하면 됩니다.

설치 루틴을 시작하려면 아래 타일을 클릭하세요.각 에이전트 설치를 마치면 여기로 돌아와 추적 보기에 대한 팁을 확인하세요 .

Start installation

3단계. 추적 보기

APM 에이전트로 각 서비스를 계측한 후 일부 추적을 캡처할 수 있도록 애플리케이션에서 일부 트래픽을 생성합니다.다음은 UI에서 추적을 보는 몇 가지 방법입니다.

UI에서 추적을 찾는 데 도움이 더 필요하면:

• 분산 추적 UI 이해 및 사용
• 분산 추적 데이터 쿼리

무한 추적 설정

APM 에이전트용 표준 분산 추적( 위 )은 추적의 최대 10%를 캡처하지만 당사가 모든 데이터를 분석하고 가장 관련성이 높은 추적을 찾기를 원하는 경우 무한 추적을 설정할 수 있습니다.

시작하기 전에 먼저 요구 사항 을 충족하는지 확인하십시오.

1단계. 새 에이전트 설치 완료

무한 추적 설정은 표준 분산 추적을 위한 새 에이전트 설치 의 계측 단계를 기반으로 합니다.

2단계. 추적 관찰자 설정

추적 관찰자는 모든 추적을 수집하고 분석하는 New Relic AWS 기반 서비스입니다. 추적 관찰자 설정 의 지침을 따릅니다. 완료되면 추적 관찰자 정보와 함께 여기로 돌아와 에이전트를 구성하는 다음 단계를 계속합니다.

3단계: 무한 추적을 위한 에이전트 구성

무한 추적 구성 설정에는 표준 분산 추적과 추적 관찰자에 대한 정보가 포함됩니다.

4단계. (선택 사항) 무한 추적 사용자 지정

에이전트 구성 설정을 추가한 후 New Relic UI에서 데이터를 보기 시작해야 합니다. 데이터를 분석하는 데 시간을 보낸 후 Infinite Tracing의 일부 기능을 조정할 수 있습니다.

• 추적 관찰자 모니터링 구성
• 스팬 속성 추적 필터 구성
• 임의 추적 필터 구성

이전 Go 에이전트를 위한 옵션

이전 Go 에이전트가 있는 경우 이 섹션을 사용하여 원하는 분산 추적 기능이 지원되는지 확인하십시오.

호환성 정보 다음은 표준 분산 추적을 켜기 위한 기본 구성 설정을 보여주는 섹션입니다. 이전 에이전트가 무한 추적을 지원하고 설정하려는 경우 위 의 단계를 참조하십시오.

호환성 가이드

아래의 호환성 정보를 검토한 후 구성 설정을 따르십시오.

이전 Go 에이전트 구성

분산 추적을 사용하려면 아래 설정을 참조하세요.

추가 수동 계측

Go 에이전트 및 분산 추적의 모든 설치에는 Go 에이전트 구성 설정 에 나열된 설정을 사용하여 수동 계측이 필요합니다.그러나 설정을 최적화하기 위해 몇 가지 추가 구성을 수행해야 할 수도 있습니다.다음은 트랜잭션 및 HTTP 요청을 계측하기 위한 몇 가지 지침입니다.

http.HandleFunc("/users", usersHandler)

http.HandleFunc(newrelic.WrapHandleFunc(app, "/users", usersHandler))

func useNewRoundTripper(txn *newrelic.Transaction) (*http.Response, error) {
    client := &http.Client{}
    client.Transport = newrelic.NewRoundTripper(client.Transport)
    request, _ := http.NewRequest("GET", "http://example.com", nil)
    request = newrelic.RequestWithTransactionContext(request, txn)
    return client.Do(request)
}

func external(txn *newrelic.Transaction, req *http.Request) (*http.Response, error) { 
    s := newrelic.StartExternalSegment(txn, req) 
    response, err := http.DefaultClient.Do(req) 
    s.Response = response 
    s.End() 
    return response, err
}

func noGoodForDt(txn *newrelic.Transaction, url string) (*http.Response, error) {
    // Distributed tracing headers are not added to the outgoing request.
    // Use newrelic.NewRoundTripper or newrelicc.StartExternalSegment instead.
    defer newrelic.ExternalSegment{
        StartTime: txn.StartSegmentNow(),
        URL:       url,
    }.End()

    return http.Get(url)
}

InsertDistributedTraceHeaders(h http.Header)

AcceptDistributedTraceHeaders(h http.Header)

이를 사용하는 방법에 대한 자세한 내용은 Go 에이전트 GitHub 리포지토리 를 참조하세요.