이동: 컨텍스트에서 로그 구성

대부분의 사용자에게 Go 에이전트에 내장된 자동 로그 전달을 사용하는 것이 최상의 솔루션입니다. 설정하기 쉽고 대부분의 사용 사례에 적합합니다. 자동 로그 전달을 허용하도록 에이전트를 구성하려면 다음 설정을 포함하도록 구성을 수정하십시오.

app, err := newrelic.NewApplication(
  newrelic.ConfigAppLogForwardingEnabled(true),
)

사용자 정의 로깅이 더 필요한 사용자 또는 60초 주기당 10,000개 이상의 로그 또는 5초 주기당 833개 이상의 로그를 New Relic으로 보내려는 사용자의 경우 로그 전달을 수동으로 설정하는 것이 좋습니다. 로그를 New Relic에 보내도록 구성된 로그 전달자가 있으면 Go 에이전트가 다음 설정을 포함하도록 구성을 수정하여 전달할 로그를 강화할 수 있습니다.

app, err := newrelic.NewApplication(
  newrelic.ConfigAppLogDecoratingEnabled(true),
)

logWriter 라이브러리는 최신 New Relic Logs in Context 기능을 go 표준 라이브러리 로거에 자동으로 통합하는 io.Writer 입니다. 다음 단계에 따라 애플리케이션에 설치하십시오. 이 라이브러리를 사용하려면 설치된 Go 에이전트 버전이 3.19.1 이상이어야 합니다.

1. 모듈에 logWriter 패키지를 추가하십시오.

   bash

   카피

   $
   go get github.com/newrelic/go-agent/v3/integrations/logcontext-v2/logWriter

2. 로거를 초기화하는 파일에서 logWriter 패키지를 가져옵니다.

   import (
     "log"
   
     "github.com/newrelic/go-agent/v3/integrations/logcontext-v2/logWriter"
   )

   카피

3. logWriter 개체를 만듭니다. 로그가 기록될 유효한 io.Writer와 초기화된 go-agent 애플리케이션을 전달해야 합니다. 다음 예는 표준 출력에 씁니다.

   writer := logWriter.New(os.Stdout, newRelicApp)

   카피

4. 로거의 출력 대상으로 새 logWriter 개체를 사용하여 로거 개체를 만듭니다.

   logger := log.New(&writer, "", log.Default.Flags())

   카피

   이 시점에서 생성된 로거로 작성된 모든 로그는 로깅 구성 설정에 따라 go-agent에서 처리됩니다.

   업무

   트랜잭션의 컨텍스트를 캡처하려면 새 logWriter 개체와 로거 개체를 만들어야 합니다. 트랜잭션에 대한 새 logWriter 객체를 만들려면 트랜잭션이 함수에 전달되는 방식에 따라 WithTransaction() 또는 WithContext() 함수를 사용합니다. 이러한 함수는 트랜잭션 컨텍스트가 포함된 원본 logWriter 개체의 새 복사본을 만듭니다.

   함수가 트랜잭션으로 래핑된 컨텍스트를 수신하는 경우 WithContext() 함수를 사용합니다.

   txnWriter := writer.WithContext(myWrappedContext)

   카피

   함수가 트랜잭션 포인터를 받으면 WithTransaction() 함수를 사용하십시오.

   txnWriter := writer.WithTransaction(myTransation)

   카피

   각 트랜잭션에 대해 항상 새 logWriter를 사용하여 새 로거를 생성해야 합니다. 이는 비동기 프로세스가 다른 컨텍스트 정보를 사용하여 동일한 로거 객체에 액세스할 가능성을 방지합니다.

   txnLogger := log.New(txnWriter, "", log.Default().Flags())

   카피

   문제점 해결

   logWriter 도구는 자동으로 실패하도록 설계되었습니다. 디버깅 정보를 활성화하려면 logWriter 객체에서 DebugLogging(true) 메서드를 호출하세요. logWriter에서 오류가 발생하면 편집되지 않은 로그 행이 항상 첫 번째 행에 인쇄됩니다. DebugLogging이 활성화되면 오류가 발생하면 다음 줄에 오류 메시지가 인쇄됩니다.

   writer.DebugLogging(true)

   카피

zerologWriter 라이브러리는 최신 New Relic Logs in Context 기능을 zerolog에 자동으로 통합하는 io.Writer 입니다. 다음 단계에 따라 애플리케이션에 설치하십시오. 이 라이브러리를 사용하려면 설치된 go-agent 버전이 3.19.1 이상이어야 합니다.

1. 모듈에 zerologWriter 패키지를 추가합니다.

   bash

   카피

   $
   go get github.com/newrelic/go-agent/v3/integrations/logcontext-v2/zerologWriter

2. zerolog 로거를 초기화하는 파일에서 zerologWriter 패키지를 가져옵니다.

   import (
     "log"
   
     "github.com/newrelic/go-agent/v3/integrations/logcontext-v2/zerologWriter"
   )

   카피

3. zerologWriter 개체를 만듭니다. 로그가 기록될 유효한 io.Writer와 초기화된 go-agent 애플리케이션을 전달해야 합니다. 다음 예는 표준 출력에 씁니다.

   writer := logWriter.New(os.Stdout, newRelicApp)

   카피

4. 로거의 출력 대상으로 새 zerologWriter 개체를 사용하여 로거 개체를 만듭니다.

   logger := zerolog.New(writer)

   카피

   이 시점에서 생성된 로거로 작성된 모든 로그는 로깅 구성 설정에 따라 go-agent에서 처리됩니다.

   업무

   트랜잭션의 컨텍스트를 캡처하려면 새로운 zerologWriter 개체와 로거 개체를 만들어야 합니다. 트랜잭션에 대한 새로운 zerologWriter 객체를 생성하려면 트랜잭션이 함수에 전달되는 방식에 따라 WithTransaction() 또는 WithContext() 함수를 사용합니다. 이러한 함수는 트랜잭션 컨텍스트가 포함된 원래 zerologWriter 개체의 새 복사본을 만듭니다.

   함수가 트랜잭션으로 래핑된 컨텍스트를 수신하는 경우 WithContext() 함수를 사용합니다.

   txnWriter := writer.WithContext(myWrappedContext)

   카피

   함수가 트랜잭션 포인터를 받으면 WithTransaction() 함수를 사용하십시오.

   txnWriter := writer.WithTransaction(myTransation)

   카피

   각 트랜잭션에 대해 항상 새로운 zerologWriter를 사용하여 새 로거를 생성해야 합니다. 이는 비동기 프로세스가 다른 컨텍스트 정보를 사용하여 동일한 로거 객체에 액세스할 가능성을 방지합니다.

   txnLogger := logger.Output(txnWriter)

   카피

   문제점 해결

   zerologWriter 도구는 자동으로 실패하도록 설계되었습니다. 디버깅 정보를 활성화하려면 zerologWriter 객체에서 DebugLogging(true) 메서드를 호출하세요. zerologWriter에서 오류가 발생하면 항상 첫 번째 줄에 편집되지 않은 로그 줄을 인쇄합니다. DebugLogging이 활성화되면 오류가 발생하면 다음 줄에 오류 메시지가 인쇄됩니다.

   writer.DebugLogging(true)

   카피

nrlogrus 플러그인은 logrus 로깅 프레임워크를 사용하여 컨텍스트 수집에서 자동 로그를 활성화합니다. 애플리케이션이 이를 사용하도록 구성되면 go-agent는 logrus에 작성된 모든 로그를 자동으로 수집합니다. 이를 위해서는 설치된 go-agent 버전이 3.18.0 이상이어야 합니다.

1. nrlogrus 패키지를 모듈에 추가합니다.

   bash

   카피

   $
   go get github.com/newrelic/go-agent/v3/integrations/logcontext-v2/nrlogrus

2. logrus 로거를 초기화하는 파일에서 nrlogrus 패키지를 가져옵니다.

   import (
     "github.com/newrelic/go-agent/v3/integrations/logcontext-v2/nrlogrus"
   
     "github.com/sirupsen/logrus"
   )

   카피

3. 새 nrlogrus 포맷터를 구성하고 만듭니다. 유효한 애플리케이션과 유효한 logrus 포맷터를 전달해야 합니다. 전달된 포맷터는 기록되는 로그의 모양을 결정합니다.

   nrlogrusFormatter := nrlogrus.NewFormatter(newRelicApplication, &logrus.TextFormatter{})

   카피

4. 로거의 포맷터를 새로 생성된 nrlogrus 포맷터로 설정합니다.

   log := logrus.New()
   log.SetFormatter(nrlogrusFormatter)

   카피

   이 시점에서 생성된 로거로 작성된 모든 로그는 로깅 구성 설정에 따라 go-agent에서 처리됩니다.

   업무

   트랜잭션 내부의 로그를 계측할 때 해당 트랜잭션을 logrus에 컨텍스트로 전달해야 합니다. 그러면 에이전트가 처리한 로그를 트랜잭션 및 발생한 범위에 연결하는 해당 트랜잭션에 대한 새 로거 개체가 생성됩니다.

   트랜잭션이 포함된 컨텍스트가 있는 경우:

   txnLogger := log.WithContext(yourWrappedContext)

   카피

   그렇지 않으면 컨텍스트를 만들어 logrus에 전달할 수 있습니다.

   txnLogger := log.WithContext(newrelic.NewContext(context.Background(), txn))

   카피