이동 에이전트 구성

서버 측 설정은 Go 에이전트 버전 2.7.0 이상 에서 사용할 수 있습니다. 이를 통해 UI에서 특정 설정을 구성할 수 있습니다. 이렇게 하면 여러 호스트에서 실행되는 경우에도 모든 에이전트에 변경 사항이 자동으로 적용됩니다. 가능한 경우 이 문서에는 개별 구성 옵션의 서버 측 구성에 대한 UI 레이블이 Server-side label 로 포함됩니다.

진행 중인 구성에 설명된 단계에 따라 신청 프로세스에서 newrelic.NewApplication() 를 계속 호출해야 합니다. 서버 측 구성 옵션 세트는 로컬로 설정된 옵션을 덮어씁니다. 서버 측에서 모든 구성 옵션을 사용할 수 있는 것은 아니므로 newrelic.Config 구조체를 계속 업데이트할 수 있습니다.

로컬 프로세스 newrelic.Config 구조에서 Go 에이전트를 구성합니다. 이 구조체는 newrelic.NewApplication() 을 호출할 때 액세스할 수 있습니다.

1. main 함수 또는 init 블록에 다음을 추가합니다.

   app, err := newrelic.NewApplication(
       newrelic.ConfigAppName("Your Application Name"),
       newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
   )

   카피

   os.Getenv 를 사용하여 newrelic.ConfigLicense 에 전달된 문자열 리터럴 값으로 하드 코딩하지 않고 환경에서 라이센스 키를 읽습니다. 라이선스 키 또는 기타 민감한 정보를 소스 코드에 넣지 않는 것이 좋습니다. 그럴 경우 SCM 리포지토리에 저장되고 승인되지 않은 당사자에게 공개될 수 있습니다.

2. newrelic.Config 구조체의 값을 업데이트하여 newrelic.ConfigOption 을 사용하여 애플리케이션을 구성합니다. 이들은 newrelic.Config 구조체에 대한 포인터를 허용하는 함수입니다. 애플리케이션을 추가로 구성하려면 newrelic.ConfigOption 을 추가하세요. 예를 들어 사전 정의된 옵션 중 하나를 사용하여 공통 구성을 수행할 수 있습니다.

   app, err := newrelic.NewApplication(
       newrelic.ConfigAppName("Your Application Name"),
       newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
       // add debug level logging to stdout
       newrelic.ConfigDebugLogger(os.Stdout),
   )

   카피

3. 또는 더 복잡한 구성을 수행하기 위해 고유한 newrelic.ConfigOption 를 만들 수 있습니다.

   app, err := newrelic.NewApplication(
       newrelic.ConfigAppName("Your Application Name"),
       newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
       newrelic.ConfigDebugLogger(os.Stdout),
       func(config *newrelic.Config) {
       // add more specific configuration of the agent within a custom ConfigOption
       config.HighSecurity = true
           config.CrossApplicationTracer.Enabled = false
       },
   )

   카피

앱의 메트릭을 New Relic 계정과 연결하는 데 사용되는 New Relic 라이선스 키를지정합니다. 라이센스와 앱 이름은 모두 New Relic 설치 프로세스의 일부로 설정됩니다.

New Relic UI에서 데이터를 집계하는 데 사용되는 애플리케이션 이름 입니다. New Relic 설치 프로세스의 일부로 라이선스와 앱 이름을 모두 설정합니다.

동시에 여러 앱에 데이터를 보고하려면 세미콜론으로 구분된 이름 목록을 지정합니다. 세미콜론 자체 앞에 공백을 두지 마십시오. 예를 들어:

app, err := newrelic.NewApplication(
    newrelic.ConfigAppName("YOUR_APP_NAME;APP_GROUP_1;ALL_APPS"),
    newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
)

true 일 때 에이전트는 앱의 데이터를 뉴렐릭 수집기 로 보냅니다.

New Relic 모니터링을 끄려면 이것을 false 으로 설정하십시오.

예를 들어:

app, err := newrelic.NewApplication(
    newrelic.ConfigAppName("Your Application Name"),
    newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
    func(config *newrelic.Config) {
        config.Enabled = false
    },
)

이 작업을 더 쉽게 하기 위해 ConfigEnabled 옵션을 사용할 수 있습니다.

app, err: = newrelic.NewApplication(
    newrelic.ConfigAppName("Your Application Name"),
    newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
    newrelic.ConfigEnabled(false),
)

이것은 개발 환경에 New Relic을 설치하거나 문제 해결을 위해 유용할 수 있습니다. Enabled 이 false 로 설정된 경우:

• New Relic Go 에이전트는 New Relic 수집기와 통신하지 않습니다.
• 에이전트는 고루틴을 생성하지 않습니다.
• 라이센스 키는 설치 중에 필요하지 않습니다.

태그를추가합니다.

app, err := newrelic.NewApplication(
    newrelic.ConfigAppName("Your Application Name"),
    newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
    func(config *newrelic.Config) {
        config.Labels = map[string]string{
            "Env":    "Dev",
            "Label2": "label2",
            "Label3": "label3",
            "Label4": "label4",
        }
    },
)

Logger 인터페이스를 사용하여 특정 위치 또는 로깅 시스템에 Go 로그 파일을 작성할 수 있습니다.

높은 보안 모드는 특정 보안 설정을 적용하고 해당 설정이 재정의되는 것을 방지하므로 에이전트가 민감한 데이터를 보내지 않습니다. 높은 보안 모드는 다음을 수행합니다.

• SSL 켜기

• 오류 메시지 문자열 보고 끄기

• 맞춤 이벤트 보고 끄기

  이 설정은 UI의 해당 계정 설정과 일치해야 합니다. 예를 들어:

  app, err := newrelic.NewApplication(
      newrelic.ConfigAppName("Your Application Name"),
      newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
      func(config *newrelic.Config) {
          config.HighSecurity = true
      },
  )

  카피

  에이전트는 기본적으로 HTTPS를 통해 New Relic과 통신하며 New Relic은 APM 및 REST API에 대한 모든 트래픽에 대해 HTTPS가 필요합니다 .

HTTPS 또는 HTTP를 사용하여 New Relic에 데이터를 보낼지 여부를 제어합니다. 에이전트는 기본적으로 HTTPS(TLS 프로토콜 사용)를 통해 New Relic과 통신하고 New Relic은 APM 및 New Relic REST API에 대한 모든 트래픽에 대해 HTTPS가 필요합니다 .

APM UI에 표시되는 호스트 이름을설정합니다. 이는 선택적 구성입니다.

이는 New Relic 수집기와 http.Client 통신을 사용자 지정합니다. 이를 사용하여 프록시를 구성할 수 있습니다.

true 이면 에이전트가 런타임 통계를 캡처합니다.

다음은 테이블 사용 방법에 대한 몇 가지 팁입니다.

• 테이블에 환경 변수가 나열되어 있으면 명명된 환경 변수를 설정하여 해당 옵션을 설정할 수 있습니다. 에이전트가 모든 NEW_RELIC_* 환경 변수를 수락하도록 하는 ConfigFromEnvironment() 함수도 포함해야 합니다.

• 구성 기능이 나열되어 있으면 ConfigFromEnvironment() 대신 해당 기능을 사용하여 해당 옵션을 설정할 수 있습니다. ConfigFromEnvironment() 를 포함하여 프로그램에 나열된 구성 기능은 코드에 나타나는 순서대로 해결된다는 점을 명심하십시오. 즉, 환경 변수를 만들고 ConfigFromEnvironment() 함수를 호출하면 이전에 특정 함수를 사용하여 설정했을 수 있는 해당 구성을 덮어씁니다. ConfigFromEnvironment() 이후의 후속 구성 옵션은 이전 구성 기능 및 환경 변수를 재정의합니다.

• 각 기능을 사용하는 방법에 대한 자세한 내용은 여기 및 Go 설명서 사이트 에서 설명서를 참조하세요.

  구성 필드	구성 기능	환경 변수
  AppName	ConfigAppName	NEW_RELIC_APP_NAME
  ApplicationLogging.Enabled	ConfigAppLogForwardingEnabled ConfigAppLogEnabled (아래 참고 1 참조)	NEW_RELIC_APPLICATION_LOGGING_ENABLED
  ApplicationLogging.Forwarding.Enabled	ConfigAppLogForwardingEnabled ConfigAppLogDecoratingEnabled ConfigAppLogMetricsEnabled (아래 참고 1 참조)	NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED
  ApplicationLogging.Forwarding.MaxSamplesStored	ConfigAppLogForwardingEnabled ConfigAppLogForwardingMaxSamplesStored (아래 참고 1 참조)	NEW_RELIC_APPLICATION_LOGGING_FORWARDING_MAX_SAMPLES_STORED
  ApplicationLogging.LocalDecorating.Enabled	ConfigAppLogDecoratingEnabled	NEW_RELIC_APPLICATION_LOGGING_LOCAL_DECORATING_ENABLED
  ApplicationLogging.Metrics.Enabled	ConfigAppLogMetricsEnabled	NEW_RELIC_APPLICATION_LOGGING_METRICS_ENABLED
  Attributes.Enabled
  Attributes.Exclude		NEW_RELIC_ATTRIBUTES_EXCLUDE
  Attributes.Include		NEW_RELIC_ATTRIBUTES_INCLUDE
  BrowserMonitoring.Attributes.Enabled
  BrowserMonitoring.Attributes.Exclude
  BrowserMonitoring.Attributes.Include
  BrowserMonitoring.Enabled
  CodeLevelMetrics.Enabled	ConfigCodeLevelMetricsEnabled	NEW_RELIC_CODE_LEVEL_METRICS_ENABLED
  CodeLevelMetrics.IgnoredPrefixes	ConfigCodeLevelMetricsIngoredPrefixes	NEW_RELIC_CODE_LEVEL_METRICS_IGNORED_PREFIXES
  CodeLevelMetrics.PathPrefixes	ConfigCodeLevelMetricsPathPrefixes	NEW_RELIC_CODE_LEVEL_METRICS_PATH_PREFIXES
  CodeLevelMetrics.RedactIgnoredPrefixes	ConfigCodeLevelMetricsRedactIgnoredPrefixes	NEW_RELIC_CODE_LEVEL_METRICS_REDACT_IGNORED_PREFIXES
  CodeLevelMetrics.RedactPathPrefixes	ConfigCodeLevelMetricsRedactPathPrefixes	NEW_RELIC_CODE_LEVEL_METRICS_REDACT_PATH_PREFIXES
  CodeLevelMetrics.Scope	ConfigCodeLevelMetricsScope	NEW_RELIC_CODE_LEVEL_METRICS_SCOPE
  CrossApplicationTracer.Enabled
  CustomInsightsEvents.Enabled	ConfigCustomInsightsEventsEnabled
  CustomInsightsEvents.MaxSamplesStored	ConfigCustomInsightsEventsMaxSamplesStored
  DatastoreTracer.DatabaseNameReporting.Enabled
  DatastoreTracer.InstanceReporting.Enabled
  DatastoreTracer.QueryParameters.Enabled
  DatastoreTracer.SlowQuery.Enabled
  DatastoreTracer.SlowQuery.Threshold
  DistributedTracer.Enabled	ConfigDistributedTracerEnabled	NEW_RELIC_DISTRIBUTED_TRACING_ENABLED
  DistributedTracer.ExcludeNewRelicHeader
  DistributedTracer.ReservoirLimit	ConfigDistributedTracerReservoirLimit
  Enabled	ConfigEnabled	NEW_RELIC_ENABLED
  ErrorCollector.Attributes.Enabled
  ErrorCollector.Attributes.Exclude
  ErrorCollector.Attributes.Include
  ErrorCollector.CaptureEvents
  ErrorCollector.Enabled
  ErrorCollector.IgnoreStatusCodes
  ErrorCollector.RecordPanics
  Error
  Heroku.DynoNamePrefixesToShorten
  Heroku.UseDynoNames
  HighSecurity		NEW_RELIC_HIGH_SECURITY
  HostDisplayName		NEW_RELIC_PROCESS_HOST_DISPLAY_NAME
  Host		NEW_RELIC_HOST
  InfiniteTracing.SpanEvents.QueueSize		NEW_RELIC_INFINITE_TRACING_SPAN_EVENTS_QUEUE_SIZE
  InfiniteTracing.TraceObserver.Host		NEW_RELIC_INFINITE_TRACING_TRACE_OBSERVER_HOST
  InfiniteTracing.TraceObserver.Port		NEW_RELIC_INFINITE_TRACING_TRACE_OBSERVER_PORT
  Labels		NEW_RELIC_LABELS
  License	ConfigLicense	NEW_RELIC_LICENSE_KEY
  Logger	ConfigLogger ConfigInfoLogger ConfigDebugLogger (아래 참고 2 참조)	NEW_RELIC_LOG NEW_RELIC_LOG_LEVEL
  ModuleDependencyMetrics.Enabled	ConfigModuleDependencyMetricsEnabled	NEW_RELIC_MODULE_DEPENDENCY_METRICS_ENABLED
  ModuleDependencyMetrics.IgnoredPrefixes	ConfigModuleDependencyMetricsIgnoredPrefixes	NEW_RELIC_MODULE_DEPENDENCY_METRICS_IGNORED_PREFIXES
  ModuleDependencyMetrics.RedaceIgnoredPrefixes	ConfigModuleDependencyMetricsRedactIgnoredPrefixes	NEW_RELIC_MODULE_DEPENDENCY_METRICS_REDACT_IGNORED_PREFIXES
  RuntimeSampler.Enabled
  SecurityPoliciesToken		NEW_RELIC_SECURITY_POLICIES_TOKEN
  Segments.Attributes.Enabled
  Segments.Attributes.Exclude
  Segments.Attributes.Include
  Segments.StackTraceThreshold
  Segments.Threshold
  ServerlessMode.AccountID
  ServerlessMode.ApdexThreshold
  ServerlessMode.Enabled
  ServerlessMode.PrimaryAppID
  ServerlessMode.TrustedAccountKey
  SpanEvents.Attributes.Enabled
  SpanEvents.Attributes.Exclude
  SpanEvents.Attributes.Include
  SpanEvents.Enabled
  TransactionEvents.Attributes.Enabled
  TransactionEvents.Attributes.Exclude
  TransactionEvents.Attributes.Include
  TransactionEvents.Enabled
  TransactionEvents.MaxSamplesStored
  TransactionTracer.Attributes.Enabled
  TransactionTracer.Attributes.Exclude
  TransactionTracer.Attributes.Include
  TransactionTracer.Enabled
  TransactionTracer.Threshold.Duration
  TransactionTracer.Threshold.IsApdexFailing
  Transport
  Utilization.BillingHostname		NEW_RELIC_UTILIZATION_BILLING_HOSTNAME
  Utilization.DetectAWS
  Utilization.DetectAzure
  Utilization.DetectDocker
  Utilization.DetectGCP
  Utilization.DetectKubernetes
  Utilization.DetectPCF
  Utilization.LocalRAMMIB		NEW_RELIC_UTILIZATION_TOTAL_RAM_MIB
  Utilization.LogicalProcessors		NEW_RELIC_UTILIZATION_LOGICAL_PROCESSORS

  표 참고 1:

  하위 기능을 활성화하기 위해 나열된 함수 중 하나를 호출하면 기본 기능도 활성화되고/하거나 다른 구성 값을 설정합니다.

  • ConfigAppLogForwardingEnabled(true) ApplicationLogging.Forwarding.Enabled=true 를 설정하지만 ApplicationLogging.Enabled=true 도 설정합니다.

  • ConfigAppLogForwardingEnabled(false) ApplicationLogging.Forwarding.Enabled=false 를 설정하지만 ApplicationLogging.Forwarding.MaxSamplesStored=0 도 설정합니다.

  • ConfigAppLogDecoratingEnabled(true) ApplicationLogging.LocalDecorating.Enabled=true 를 설정하지만 ApplicationLogging.Enabled=true 도 설정합니다.

  • ConfigAppLogDecoratingEnabled(false) ApplicationLogging.LocalDecorating.Enabled=false 을(를) 설정하지만 ApplicationLogging.Enabled 에는 영향을 미치지 않습니다.

  • ConfigAppLogMetricsEnabled(true) ApplicationLogging.Metrics.Enabled=true 를 설정하지만 ApplicationLogging.Enabled=true 도 설정합니다.

  • ConfigAppLogMetricsEnabled(false) ApplicationLogging.Metrics.Enabled=false 을(를) 설정하지만 ApplicationLogging.Enabled 에는 영향을 미치지 않습니다.

    표 참고 2:

    NEW_RELIC_LOG 환경 변수를 통해 Logger 를 설정할 때 사용되는 로거 유형은 NEW_RELIC_LOG_LEVEL 값에 따라 다릅니다. 후자의 변수가 정의되고 값이 debug , Debug , DEBUG , d 또는 D 인 경우 표준 로거 대신 디버그 수준 로거가 사용됩니다. NEW_RELIC_LOG 은 stdout , Stdout , STDOUT , stderr , Stderr 또는 STDERR 값을 가질 수 있습니다.

  팁

  환경 변수는 newrelic.ConfigFromEnvironment 에서 읽을 수 있도록 비어 있지 않은 값을 가져야 합니다.

true 으로 설정하면 AI 모니터링이 활성화됩니다.

true 로 설정하면 에이전트가 스트리밍된 응답을 캡처할 수 있습니다. false 로 설정하면 에이전트는 스트리밍된 응답에 대한 이벤트 데이터를 캡처하지 않지만 에이전트는 여전히 메트릭과 스팬을 캡처할 수 있습니다. LLM 함수 호출이 종료되면 스팬 기간이 종료됩니다. true 로 설정하면 스트림에서 최종 결과를 읽을 때 스팬 기간이 종료됩니다.

false로 설정하면 에이전트는 LLM 이벤트에서 캡처된 입력 및 출력 콘텐츠(예: 프롬프트 및 응답의 텍스트 문자열)를 생략합니다. LLM과 송수신되는 민감한 데이터를 기록하지 않으려는 경우 선택할 수 있는 보안 설정입니다.

true 일 때 에이전트는 사용자 정의 이벤트를 New Relic 으로 보냅니다. 이 설정은 맞춤 이벤트를 비활성화하는 HighSecurity에 의해 재정의됩니다.

사용자 지정 이벤트를 비활성화하려면 New Relic 구성 이 시작된 후 Go 앱에 다음을 배치하세요.

app, err := newrelic.NewApplication(
    newrelic.ConfigAppName("Your Application Name"),
    newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
    func(config *newrelic.Config) {
        config.CustomInsightsEvents.Enabled = false
    },
)

true 일 때 에이전트는 트랜잭션 이벤트를 수집합니다.

TransactionEvents.Attributes 세 개의 필드가 있는 구조체입니다.

Enabled bool
Include []string
Exclude []string

TransactionEvents.Attributes.Enabled 을 사용하여 트랜잭션 이벤트에 대한 속성 수집을 켜거나 끕니다. Include 및 Exclude 를 사용하여 특정 속성을 포함하거나 제외합니다.

트랜잭션 이벤트에서 이름이 allAgentAttributeNames 인 속성 조각을 제외하는 예:

app, err := newrelic.NewApplication(
    newrelic.ConfigAppName("Your Application Name"),
    newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
    func(config *newrelic.Config) {
        config.TransactionEvents.Attributes.Exclude = allAgentAttributeNames
    },
)

New Relic으로 보낼 분당 최대 트랜잭션 이벤트 수를 정의하며 최대 기본 최대 트랜잭션 이벤트 수는 10,000개입니다.

false 일 때 에이전트는 오류나 오류 추적을 수집하지 않습니다.

true 일 때 에이전트는 오류 분석 이벤트를 수집합니다.

nil이 아닌 경우 에이전트는 수집 시간에 발견된 모든 오류에 사용자 정의 콜백 함수를 적용하고 오류 그룹을 적용합니다.

이것은 어떤 HTTP 응답 코드가 오류로 무시되는지를 제어합니다.

100보다 크거나 같고 400보다 작은 응답 코드는 기본적으로 무시되며 이 함수를 호출할 때 지정할 필요가 없습니다. 응답 코드 0, 5, 404는 기본적으로 목록에 포함되지만 무시 목록에 추가할 때 지정해야 합니다.

이 함수의 기본 형식은 다음과 같습니다.

config.ErrorCollector.IgnoreStatusCodes = []int{
    0,                   // gRPC OK
    5,                   // gRPC NOT_FOUND
    http.StatusNotFound, // 404
}

위의 http.StatusNotFound 과 같이 응답 코드를 HTTP로 추가할 수도 있습니다.

app, err := newrelic.NewApplication(
    newrelic.ConfigAppName("Your Application Name"),
    newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
    func(config *newrelic.Config) {
        config.ErrorCollector.IgnoreStatusCodes = []int{0, 5, 404, 418}
    },
)

오류로 예상되는 HTTP 응답 코드를 제어합니다.

예상되는 응답 코드는 애플리케이션의 apdex 또는 오류 경고에 영향을 미치지 않지만 여전히 기록됩니다.

이 함수의 기본 형식은 다음과 같습니다.

config.ErrorCollector.ExpectStatusCodes = []int{
    100,
    http.StatusAccepted,
}

위에서 설명한 http.StatusAccepted 와 같은 HTTP로 응답 코드를 추가할 수도 있습니다.

app, err := newrelic.NewApplication(
    newrelic.ConfigAppName("Your Application Name"),
    newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
    func(config *newrelic.Config) {
        config.ErrorCollector.ExpectStatusCodes = []int{418, 502}
    },
)

ErrorCollector.Attributes 세 개의 필드가 있는 구조체입니다.

Enabled bool
Include []string
Exclude []string

ErrorCollector.Attributes.Enabled 을 사용하여 오류에 대한 속성 수집을 켜거나 끕니다. Include 및 Exclude 를 사용하여 특정 속성을 포함하거나 제외합니다.

오류에서 이름이 allAgentAttributeNames 인 속성 슬라이스를 제외하는 예:

app, err := newrelic.NewApplication(
    newrelic.ConfigAppName("Your Application Name"),
    newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
    func(config *newrelic.Config) {
        config.ErrorCollector.Attributes.Exclude = allAgentAttributeNames
    },
)

true 일 때 에이전트는 트랜잭션 추적 (느린 트랜잭션에 대한 세부 정보)을 수집합니다.

트랜잭션 추적 임계값이 Apdex를 기반으로 하는지 여부를 제어합니다.

• true 인 경우 추적 임계값은 Apdex 임계값 의 4배입니다.
• false 인 경우 에이전트는 Threshold.Duration 을 트랜잭션 추적 임계값으로 사용합니다.

Threshold.IsApdexFailing 이 false 로 설정되면 에이전트는 이 기간을 트랜잭션 추적 임계값으로 사용합니다.

세그먼트가 추적에 추가되는 임계값입니다.

TransactionTracer.Segments.Attributes 세 개의 필드가 있는 구조체입니다.

Enabled bool
Include []string
Exclude []string

TransactionTracer.Segments.Attributes.Enabled 을 사용하여 트랜잭션 추적 세그먼트에 대한 속성 수집을 켜거나 끕니다. Include 및 Exclude 를 사용하여 특정 속성을 포함하거나 제외합니다.

추적에서 이름이 allSegmentAttributeNames 인 속성 슬라이스를 제외하는 예:

app, err := newrelic.NewApplication(
    newrelic.ConfigAppName("Your Application Name"),
    newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
    func(config *newrelic.Config) {
        config.TransactionTracer.Segments.Attributes.Exclude = allSegmentAttributeNames
    },
)

이것은 트랜잭션 추적에서 세그먼트에 스택 추적이 제공되는 임계값입니다.

TransactionTracer.Attributes 세 개의 필드가 있는 구조체입니다.

Enabled bool
Include []string
Exclude []string

TransactionTracer.Attributes.Enabled 을 사용하여 트랜잭션 추적에 대한 속성 수집을 켜거나 끕니다. Include 및 Exclude 를 사용하여 특정 속성을 포함하거나 제외합니다.

추적에서 이름이 allAgentAttributeNames 인 속성 슬라이스를 제외하는 예:

app, err := newrelic.NewApplication(
    newrelic.ConfigAppName("Your Application Name"),
    newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
    func(config *newrelic.Config) {
        config.TransactionTracer.Attributes.Exclude = allAgentAttributeNames
    },
)

이를 통해 일부 데이터베이스 드라이버에 대한 데이터 저장소 인스턴스 메트릭(예: 호스트 및 포트)을 수집할 수 있습니다. 이는 트랜잭션 추적 및 느린 쿼리 데이터 의 일부로 보고됩니다.

느린 쿼리 추적 및 트랜잭션 추적에서 데이터베이스 이름 수집을 활성화하려면 이것을 사용하십시오. 활성화된 속성의 기본값은 true 입니다.

true 일 때 에이전트는 데이터 저장소 호출 쿼리 매개변수를 수집합니다.

느린 쿼리 가 캡처되는지 여부를 제어합니다.

에이전트는 이보다 느린 쿼리에 대해 느린 쿼리 데이터 를 캡처합니다.

true 일 때 에이전트는 아웃바운드 요청에 교차 애플리케이션 추적 헤더를 추가하고 교차 애플리케이션 추적 헤더에 대해 수신 요청을 스캔합니다.

분산 추적 및 교차 애플리케이션 추적은 동시에 사용할 수 없습니다. Go 에이전트의 기본 구성은 분산 추적을 비활성화하고 애플리케이션 간 추적을 활성화합니다.

표준 추적은 Go 에이전트 버전 3.16.0 이상에서 기본적으로 켜져 있습니다.즉, 에이전트는 아웃바운드 요청에 분산 추적 헤더를 자동으로 추가하고 분산 추적 헤더에 대해 수신 요청을 검색합니다.분산 추적을 비활성화하려면 값을 false 으로 설정합니다.

분산 추적 설정에 대한 자세한 내용은 Go 애플리케이션에 분산 추적 사용 을 참조하십시오.

아웃바운드 요청에 첨부된 New Relic 헤더를 제외하고 대신 분산 추적을 위해 W3C 추적 컨텍스트 헤더에만 의존하려면 이것을 true 으로 설정합니다. 이것이 false 이면 두 가지 유형의 헤더가 모두 사용됩니다.

true 일 때 에이전트는 스팬 이벤트를 수집합니다.

SpanEvents.Attributes 세 개의 필드가 있는 구조체입니다.

Enabled bool
Include []string
Exclude []string

SpanEvents.Attributes.Enabled 을 사용하여 스팬 이벤트에 대한 속성 수집을 활성화하거나 비활성화합니다. Include 및 Exclude 를 사용하여 특정 속성을 포함하거나 제외합니다.

추적에서 이름이 allSpanAttributeNames 인 속성 슬라이스를 제외하는 예:

app, err := newrelic.NewApplication(
    newrelic.ConfigAppName("Your Application Name"),
    newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
    func(config *newrelic.Config) {
        config.TransactionTracer.Segments.Attributes.Exclude = allSpanAttributeNames
    },
)

유효한 무한 추적 추적 관찰자 호스트 항목을 가져오는 데 도움이 필요 하면 추적 관찰자 끝점 찾기 또는 만들기 를 참조하세요.

true 인 경우 이러한 하위 기능 구성도 활성화된 경우 로그 이벤트 및 로깅 측정항목 수집을 활성화합니다.false 이면 로깅 계측 기능이 활성화되지 않습니다.

ConfigAppLogEnabled() 를 호출하여 ApplicationLogging을 구성합니다.

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

true 인 경우 에이전트는 애플리케이션에서 내보낸 로그 레코드를 캡처하여 New Relic에 전달합니다. 이 설정을 적용하려면 ApplicationLogging.Enabled 도 true 여야 합니다.

ConfigAppLogForwardingEnabled() 를 호출하여 로그 전달을 활성화합니다.

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

New Relic에 분당 보낼 로그 레코드 수입니다. 이 설정은 로그 전달 기능을 사용할 때 전체 메모리 소비를 제어합니다.

ConfigAppLogForwardingMaxSamplesStored()을(를) 호출하여 ApplicationLogging.Forwarding.MaxSamplesStored 를 구성합니다.

app, err := newrelic.NewApplication(
    newrelic.ConfigAppLogForwardingMaxSamplesStored(1000),
)

전송되는 로그 라인의 양을 줄이려면 이 값을 더 낮게 설정하십시오(로그 샘플링이 발생할 수 있음). 더 많은 로그 라인을 보내려면 이 값을 더 높게 설정하십시오.

각 로그는 연결된 트랜잭션과 동일한 우선 순위를 받습니다. 트랜잭션 외부에서 발생하는 로그는 임의의 우선 순위를 받습니다. 일부 로그는 MaxSamplesStored 에 의해 제한되기 때문에 포함되지 않을 수 있습니다. 예를 들어, 로깅 MaxSamplesStored 이 10,000으로 설정되고 트랜잭션 1에 10,000개의 로그 항목이 있는 경우 트랜잭션 1에 대한 로그 항목만 기록됩니다. 트랜잭션 1의 로그가 10,000개 미만이면 트랜잭션 1에 대한 모든 로그를 받습니다. 여전히 공간이 있으면 트랜잭션 2에 대한 모든 로그를 받는 식입니다.

샘플링된 트랜잭션에 대한 모든 로그가 기록된 후 MaxSamplesStored 의 한도에 도달하지 않은 경우 샘플링에 없는 트랜잭션에 대한 로그 메시지가 전송됩니다. 남아있는 경우 트랜잭션 외부의 로그 메시지가 기록됩니다.

true 인 경우 에이전트는 애플리케이션에서 전송 중인 로그 라인과 관련된 측정항목을 캡처합니다. 이 설정을 적용하려면 ApplicationLogging.Enabled 도 true 여야 합니다.

ConfigAppLogMetricsEnabled() 를 호출하여 ApplicationLogging.Metrics.Enabled를 구성합니다.

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

true 인 경우 모듈 종속성 데이터 수집을 활성화합니다. false 이면 모듈 종속성 정보가 수집되지 않습니다.

ConfigModuleDependencyMetricsEnabled 를 호출하여 ModuleDependencyMetrics를 구성합니다.

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

NewApplication 에 대한 호출에 ConfigFromEnvironment() 를 삽입하여 환경 변수를 통해 Go 에이전트 옵션 설정을 활성화할 수 있습니다. 이 작업을 수행한 경우 환경 변수를 설정하여 모듈 종속성 메트릭 수집을 활성화하거나 비활성화할 수 있습니다.

NEW_RELIC_MODULE_DEPENDENCY_METRICS_ENABLED=true

이 모듈 경로 접두사 목록은 에이전트가 보고한 종속성 정보에서 일부 모듈을 제외하도록 지정합니다. import 경로가 나열된 접두사 문자열로 시작하는 모든 모듈은 제외됩니다. 기본값은 발견된 모든 모듈을 보고하는 것을 의미하는 빈 목록입니다.

ConfigModuleDependencyMetricsIgnoredPrefixes 을 호출하여 제외할 경로 접두사 문자열 목록을 지정합니다.

app, err := newrelic.NewApplication(
    newrelic.ConfigModuleDependencyMetricsIgnoredPrefixes("example.com/packageAlpha", "example.com/packageBeta"),
)

NewApplication 호출에 ConfigFromEnvironment() 을 삽입하여 환경 변수를 통해 Go 에이전트 옵션 설정을 활성화한 경우 환경 변수를 설정하여 경로 접두사를 나열할 수 있습니다.

NEW_RELIC_MODULE_DEPENDENCY_METRICS_IGNORED_PREFIXES="example.com/packageAlpha,example.com/packageBeta"

일반적으로 에이전트 구성의 일부로 설정한 모든 옵션이 보고되고 New Relic UI에 표시됩니다. ConfigModuleDependencyIgnoredPrefixes 옵션을 통해 보고되는 일부 모듈을 제외하도록 선택한 경우 구성 데이터에서도 수정할 수 있습니다. 예를 들어, 기밀을 이유로 모듈이 제외된 경우.

ConfigModuleDependencyMetricsRedactIgnoredPrefixes 를 호출하여 제외된 경로의 수정을 활성화하거나 비활성화합니다. true 인 경우 제외된 모듈 접두사 목록이 보고되지 않습니다. false 이면 보고됩니다.

app, err := newrelic.NewApplication(
    newrelic.ConfigModuleDependencyMetricsRedactIgnoredPrefixes(false),
)

NewApplication 호출에 ConfigFromEnvironment() 을 삽입하여 환경 변수를 통해 Go 에이전트 옵션 설정을 활성화한 경우 환경 변수를 설정하여 경로 접두사를 나열할 수 있습니다.

NEW_RELIC_MODULE_DEPENDENCY_METRICS_REDACT_IGNORED_PREFIXES=false

ConfigSecurityFromEnvironment는 nrsecurityagent가 환경 변수에서 설정된 모든 정보를 얻도록 지시합니다.

err: = nrsecurityagent.InitSecurityAgent(
     app,
     ConfigSecurityFromEnvironment(),
 )

ConfigSecurityFromYaml은 nrsecurityagent가 외부 YAML 형식의 파일을 읽어 설정 값을 가져오도록 지시합니다. 이 파일의 경로는 환경 변수 NEW_RELIC_SECURITY_CONFIG_PATH를 설정하여 제공해야 합니다.

err: = nrsecurityagent.InitSecurityAgent(
    app,
    ConfigSecurityFromYaml(),
)

기본 YAML 파일은 다음과 같습니다.

enabled: true

# NR security provides two modes IAST and RASP
# Default is IAST
mode: IAST

# New Relic’s SaaS connection URLs
validator_service_url: wss://csec.nr-data.net

# Following category of security events
# can be disabled from generating.
detection:
  rxss:
    enabled: true
request:
  body_limit: 300

func(cfg *SecurityConfig) {
    cfg.Security.Agent.Enabled = true
}

모든 보안 기능을 완전히 비활성화하려면 이 플래그를 false로 설정하세요. Go에서 보안 에이전트를 가져오고 초기화하면 해당 에이전트를 사용할 의도가 있다고 가정하므로 이 값은 기본적으로 true 으로 설정됩니다. 이는 자동으로 힘을 받은 에이전트의 반대 동작입니다. 이 속성은 애플리케이션 시작 시 한 번만 읽힙니다.

보안 데이터를 뉴렐릭으로 보낼지 여부를 결정합니다. 이 항목이 비활성화되고 agent.enabled가 true이면 보안 모듈이 실행되지만 데이터는 전송되지 않습니다. 기본값은 false입니다.

뉴렐릭 보안 제공 모드: IAST. 기본값은 IAST입니다. IAST 스캐닝의 침습적인 특성이 있으므로 프로덕션 환경 또는 프로덕션 데이터가 처리되는 환경에서 이 모드를 활성화하면 안됩니다.

뉴렐릭 보안의 SaaS 연결 URL입니다. 보안 에이전트가 데이터를 보내는 엔드포인트이며, APM Java 에이전트를 위해 설정한 환경과 일치해야 합니다.

미국 프로덕션: wss\://csec.nr-data.net

RXSS 보안 이벤트 감지를 활성화합니다. 기본값은 true입니다.

보안 요청 본문 제한은 요청 본문을 읽을 때 소비할 수 있는 메모리 양을 KB 단위로 제한합니다. 기본적으로 이 값은 "300"입니다.