Instrument Go 거래

HTTP 응답 또는 백그라운드 작업과 같은 특정 앱 서버 활동과 관련된 트랜잭션 을 생성하여 New Relic for Go 애플리케이션 또는 마이크로서비스를 모니터링합니다. 그런 다음 APM 트랜잭션 페이지 를 포함하여 New Relic에서 앱의 성능을 볼 수 있습니다.

웹 및 비웹 트랜잭션 식별

다른 많은 언어와 달리 Go 애플리케이션은 컴파일된 기본 바이너리 파일에서 실행됩니다. 즉, Golang 앱에 New Relic을 설정하려면 소스 코드에 New Relic 메서드를 수동으로 추가해야 합니다.

APM에서 트랜잭션은 웹 트랜잭션 또는 웹이 아닌 트랜잭션으로 식별됩니다.

• HTTP 요청 및 응답 작성자가 있는 트랜잭션을 계측하거나 래핑할 때 New Relic은 이를 웹 트랜잭션으로 처리합니다.
• HTTP 데이터가 없는 트랜잭션을 계측하거나 래핑할 때 New Relic은 이를 웹이 아닌 트랜잭션으로 처리합니다.

세그먼트는 트랜잭션을 구성하는 기능 및 호출입니다. New Relic for Go를 사용 하여 트랜잭션에 세그먼트 수준 세부 정보를 추가 할 수도 있습니다.

트랜잭션 모니터링

트랜잭션을 모니터링하려면 다음 코드를 모니터링하려는 기능의 시작 직후에 배치합니다. 예를 들어:

txn := app.StartTransaction("transaction_name")
defer txn.End()

이 코드 예제에서:

• app New Relic 구성 프로세스 중에 할당된 변수를 나타냅니다. 자세한 내용은 Go 에이전트 설치 절차 를 참조하십시오.
• defer 문은 함수가 닫힐 때까지 세그먼트 종료를 연기합니다.

웹 트랜잭션을 모니터링하려면 Transaction.SetWebRequest 및 선택적으로 Transaction.SetWebResponse API를 호출합니다.

txn := app.StartTransaction("transaction_name")
defer txn.End()

// req is a *http.Request, this marks the transaction as a web transaction
txn.SetWebRequestHTTP(req)

// writer is a http.ResponseWriter, use the returned writer in place of the original
writer = txn.SetWebResponse(writer)
writer.WriteHeader(500)

func checkout() {
    // function code here
}

func checkout() {
    txn := app.StartTransaction("checkout_transaction")
    defer txn.End()
    // function code here
}

여러 고루틴으로 트랜잭션 모니터링

여러 고루틴에서 트랜잭션을 모니터링하려면 Transaction.NewGoroutine() 을 사용합니다. NewGoroutine 메서드는 각 세그먼트 생성 고루틴에 필요한 트랜잭션에 대한 새 참조를 반환합니다. 다른 고루틴이 시작되기 전이나 후에 NewGoroutine 를 호출하는지 여부는 중요하지 않습니다.

모든 Transaction 메서드는 모든 Transaction 참조에서 사용할 수 있습니다. Transaction 는 End() 이 고루틴에서 호출될 때 종료됩니다.

go func(txn *newrelic.Transaction) {
    defer txn.StartSegment("async").End()
    time.Sleep(100 * time.Millisecond)
}(txn.NewGoroutine())

ch := make(chan *newrelic.Transaction)
go func() {
    txn := <-ch
    defer txn.StartSegment("async").End()
    time.Sleep(100 * time.Millisecond)
}()
ch <- txn.NewGoroutine()

HTTP 핸들러를 래핑하여 트랜잭션 모니터링

표준 HTTP 라이브러리 패키지를 사용 하는 경우 함수 코드를 계측 하는 대신 HTTP 요청을 래핑하여 트랜잭션을 생성할 수 있습니다.

다음은 랩핑되는 HTTP 핸들러의 전후 예입니다.

전에:

http.HandleFunc("/users", usersHandler)

후에:

이렇게 하면 요청 및 응답 작성자와의 트랜잭션이 자동으로 시작되고 종료됩니다.

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

핸들러의 트랜잭션에 액세스하려면 newrelic.FromContext API를 사용하세요. 이것은 Go 버전 1.7 이상에서만 작동합니다. 예를 들어:

func myHandler(w http.ResponseWriter, r *http.Request) {
    txn := newrelic.FromContext(r.Context())
    txn.NoticeError(errors.New("my error message"))
}

오류 모니터링

New Relic for Go는 세 가지 방법으로 오류를 캡처합니다.

APM 및 인프라 데이터에 대한 로그 보기

또한 로그와 애플리케이션의 데이터를 함께 가져와 더 쉽고 빠르게 문제를 해결할 수 있습니다. 컨텍스트의 로그를 사용하면 앱의 UI에서 직접 오류 및 추적과 관련된 로그 메시지를 볼 수 있습니다.

1. 오류 페이지에서 추적을 클릭하면 오류 세부정보 페이지 로 이동합니다.
2. 오류 세부정보 페이지에서 로그 보기 를 클릭합니다.
3. 개별 로그 메시지와 관련된 세부 정보를 보려면 메시지를 직접 클릭하십시오.

Kubernetes 클러스터와 같은 인프라 데이터 컨텍스트에서 로그를 볼 수도 있습니다. 다른 UI로 전환할 필요가 없습니다.

추가 거래 방법

Transaction 객체에는 NoticeError , AddAttribute 및 Ignore 와 같이 트랜잭션 동작을 제어하는 데 사용할 수 있는 몇 가지 선택적 메서드가 있습니다. 트랜잭션 방법 목록은 Godoc의 New Relic for Go 트랜잭션 방법을 참조하십시오.