악기 바둑 부문

New Relic for Go를 사용하면 Go 애플리케이션에서 트랜잭션 의 특정 세그먼트를 모니터링하여 특정 기능 또는 코드 블록에 대한 자세한 정보를 얻을 수 있습니다.

기능 및 코드 블록의 시간 측정

Segments 애플리케이션 트랜잭션 의 특정 부분입니다. 로그된 세그먼트를 통해 외부 호출, 데이터스토어 호출, 대기열에 메시지 추가, 백그라운드 작업 등의 함수 및 코드 블록에 소요된 시간을 측정할 수 있습니다.

Example: 배송 정보와 신용 카드 정보를 모두 처리하는 결제 프로세스와 연결된 프로세서가 있습니다. 귀하는 해당 프로세서를 배송용 세그먼트 하나와 지불용 세그먼트 하나, 이렇게 두 부분으로 나누도록 강제할 수 있습니다.

코드 블록 세그먼트

트랜잭션을 계측하면 해당 트랜잭션 에서 하나 이상의 세그먼트를 계측할 준비가 된 것입니다.

임의의 코드 블록을 세그먼트로 계측하려면 다음 패턴을 사용하고 트랜잭션에 대해 설정된 변수 이름으로 txn 을 포함합니다.

segment := newrelic.Segment{}
segment.Name = "mySegmentName"
segment.StartTime = txn.StartSegmentNow()
// ... code you want to time here ...
segment.End()

StartSegment 편리한 도우미입니다. 세그먼트를 만들고 시작합니다.

segment := txn.StartSegment("mySegmentName")
// ... code you want to time here ...
segment.End()

기능 세그먼트

함수를 세그먼트로 계측하는 것은 본질적으로 임의의 코드 블록을 세그먼트로 계측하는 것과 동일합니다. 주요 차이점은 함수에 불연속적인 끝이 있기 때문에 Go의 defer 문 을 사용할 수 있다는 것입니다.

함수를 세그먼트로 계측하려면 함수 시작 부분에 다음 코드를 추가하고 트랜잭션에 대해 설정된 변수 이름으로 txn 을 포함합니다.

defer txn.StartSegment("mySegmentName").End()

네스트 세그먼트

세그먼트는 중첩될 수 있습니다. 종료되는 세그먼트는 가장 최근에 시작된 세그먼트여야 합니다.

다음은 다른 세그먼트 내에서 시작하고 끝나는 세그먼트의 예입니다.

s1 := txn.StartSegment("outerSegment")
s2 := txn.StartSegment("innerSegment")
// s2 must end before s1
s2.End()
s1.End()

값이 0인 세그먼트는 안전하게 종료될 수 있습니다. 따라서 다음 코드는 조건문이 실패하더라도 안전합니다.

var s newrelic.Segment
if recordSegment {
    s.StartTime = txn.StartSegmentNow()
}
// ... code you wish to time here ...
s.End()

데이터 저장소 세그먼트

로그를 남기고 데이터 스토어를 호출할 수 있습니다. 데이터스토어 세그먼트는 뉴렐릭에 있는 APM Transactions breakdown Databases Transactions 페이지 의 테이블과 탭에 나타납니다.

MySQL, PostgreSQL 또는 SQLite 데이터베이스 드라이버를 사용하는 경우 Datastore 세그먼트를 추가하는 가장 쉬운 방법은 사전 구축된 통합 패키지를 사용하는 것입니다. 그렇지 않으면 각 데이터베이스 호출에 대해 Datastore 세그먼트를 수동으로 만들 수 있습니다.

지원하는 각 데이터베이스 드라이버에 대한 통합 패키지가 있습니다.

데이터베이스 라이브러리 지원	통합 패키지
go-sql-드라이버/mysql	v3/통합/nrmysql
라이브러리/pq	v3/통합/nrpq
mattn/go-sqlite3	v3/통합/nrsqlite3

이러한 통합 중 하나를 사용하려면 먼저 드라이버를 통합 버전으로 교체하십시오.

import (
    // import our integration package in place of "github.com/go-sql-driver/mysql"
    _ "github.com/newrelic/go-agent/v3/integrations/nrmysql"
)

func main() {
    // open "nrmysql" in place of "mysql"
    db, err := sql.Open("nrmysql", "user@unix(/path/to/socket)/dbname")
}

둘째, sql.DB , sql.Conn , sql.Tx 및 sql.Stmt 의 ExecContext , QueryContext 및 QueryRowContext 메서드를 사용하고 트랜잭션이 포함된 컨텍스트를 제공합니다. Exec , Query 및 QueryRow 에 대한 호출은 계측되지 않습니다.

ctx := newrelic.NewContext(context.Background(), txn)
row := db.QueryRowContext(ctx, "SELECT count(*) from tables")

위에 나열되지 않은 데이터베이스/sql 데이터베이스를 사용하는 경우 InstrumentConnector , InstrumentDriver 및 DriverSegmentBuilder 를 사용하여 자체 계측을 작성할 수 있습니다. 통합 패키지는 이를 수행하는 방법의 예 역할을 합니다.

중요

MySQL, PostgreSQL 및 SQLite용 데이터 저장소 통합 패키지가 Go 에이전트 v2.8.0에 추가되었으며 Go v1.10 이상이 필요합니다.

기본 세그먼트와 마찬가지로 데이터 저장소 세그먼트는 StartTime 필드가 채워질 때 시작되고 End 메서드가 호출될 때 끝납니다. 데이터스토어 세그먼트를 계측하려면 모니터링하려는 함수의 시작 부분에 다음을 배치합니다.

s := newrelic.DatastoreSegment{
    Product: newrelic.DatastoreMySQL,
    Collection: "users",
    Operation: "INSERT",
    ParameterizedQuery: "INSERT INTO users (name, age) VALUES ($1, $2)",
    QueryParameters: map[string]interface{}{
        "name": "Dracula",
        "age": 439,
    },
    Host: "mysql-server-1",
    PortPathOrID: "3306",
    DatabaseName: "my_database",
}
s.StartTime = txn.StartSegmentNow()
// ... make the datastore call
s.End()

다음에 대한 자세한 정보:

Collection , Operation , DatabaseName 및 기타 매개변수 값 할당: GoDoc의 New Relic 데이터 저장소 세그먼트 문서를 참조하십시오.
Product 에 사용 가능한 값: GitHub의 New Relic 문서를 참조하세요.

전체 함수 호출에 걸쳐 있는 데이터 저장소 호출을 계측할 때 defer 문을 사용하여 계측을 단순화할 수 있습니다.

s := newrelic.DatastoreSegment{
    StartTime: txn.StartSegmentNow(),
    Product: newrelic.DatastoreMySQL,
    Collection: "users",
    Operation: "INSERT",
    ParameterizedQuery: "INSERT INTO users (name, age) VALUES ($1, $2)",
    QueryParameters: map[string]interface{}{
        "name": "Dracula",
        "age": 439,
    },
    Host: "mysql-server-1",
    PortPathOrID: "3306",
    DatabaseName: "my_database",
}
defer s.End()

외부 세그먼트

웹 서비스, 클라우드의 리소스 및 기타 네트워크 호출과 같은 외부 서비스에 대한 호출을 추가할 수 있습니다. 외부 세그먼트는 뉴렐릭의 Transactions breakdown 테이블과 External services 페이지 에 표시됩니다.

외부 세그먼트를 계측하는 두 가지 방법이 있습니다.

권장사항: 뉴렐릭이 을 사용하여 추적 작업 간의 트레이스 활동에 사용하므로 StartExternalSegment 도우미를 사용하세요.

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
}

NewRoundTripper http.Client 의 Transport 필드를 수정하여 StartExternalSegment 를 호출하지 않고 외부 호출을 계측할 수 있는 http.RoundTripper 를 반환합니다. 반환된 RoundTripper 은 FromContext 를 사용하여 요청 컨텍스트에서 Transaction 를 찾습니다.

다음은 NewRoundTripper 계측의 예입니다.

client := &http.Client{}
client.Transport = newrelic.NewRoundTripper(client.Transport)

request, _ := http.NewRequest("GET", "http://example.com", nil)
request = newrelic.RequestWithTransactionContext(request, txn)

response, err := client.Do(request)

메시지 생산자 세그먼트

RabbitMQ 및 Kafka와 같은 대기열 시스템에 메시지를 추가하는 Go 기능을 호출할 수 있습니다. 메시지 생성자 세그먼트는 뉴렐릭의 APM Transactions breakdown 에 나타납니다.

메시지 생성자 세그먼트를 계측하는 방법은 한 가지뿐입니다.

기본 세그먼트와 마찬가지로 메시지 생성자 세그먼트는 StartTime 필드가 채워질 때 시작되고 End 메서드가 호출될 때 끝납니다. 메시지 생성자 세그먼트를 계측하려면 모니터링하려는 기능의 시작 부분에 다음을 배치합니다.

s := newrelic.MessageProducerSegment{
    Library:              "RabbitMQ",
    DestinationType:      newrelic.MessageExchange,
    DestinationName:      "myExchange",
    DestinationTemporary: false,
}
s.StartTime = txn.StartSegmentNow()
// ... add message to queue
s.End()

Library , DestinationType , DestinationName 또는 DestinationTemporary 필드 할당에 대한 자세한 내용은 GoDoc의 New Relic 메시지 생성자 세그먼트 문서를 참조하세요 .

전체 함수 호출에 걸쳐 있는 메시지 생성자 호출을 계측할 때 defer 문을 사용하여 계측을 단순화할 수 있습니다.

s := newrelic.MessageProducerSegment{
    StartTime:            txn.StartSegmentNow(),
    Library:              "RabbitMQ",
    DestinationType:      newrelic.MessageExchange,
    DestinationName:      "myExchange",
    DestinationTemporary: false,
}
defer s.End()
// ... add message to queue

중요

메시지 생산자 세그먼트는 Go 에이전트 버전 2.14.0에 추가되었습니다.

사용자의 편의를 위해 제공되는 기계 번역입니다.

기능 및 코드 블록의 시간 측정

코드 블록 세그먼트

기능 세그먼트

네스트 세그먼트

데이터 저장소 세그먼트

계측 패키지 사용

중요

사용 `DatastoreSegment`

외부 세그먼트

사용 `StartExternalSegment()`

사용 `NewRoundTripper()`

메시지 생산자 세그먼트

사용 `MessageProducerSegment`

중요

사용자의 편의를 위해 제공되는 기계 번역입니다.

악기 바둑 부문

기능 및 코드 블록의 시간 측정 .css-21sua1{background:none;border:none;width:0;padding:0;}

코드 블록 세그먼트

기능 세그먼트

네스트 세그먼트

데이터 저장소 세그먼트

사용 DatastoreSegment

외부 세그먼트

사용 StartExternalSegment()

사용 NewRoundTripper()

메시지 생산자 세그먼트

사용 MessageProducerSegment

기능 및 코드 블록의 시간 측정

사용 `DatastoreSegment`

사용 `StartExternalSegment()`

사용 `NewRoundTripper()`

사용 `MessageProducerSegment`