Go agent release notesRSS

3.21.0

Added

• New errors inbox features:
  • User tracking: You can now see the number of users impacted by an error group. Identify the end user with the setUser method.
  • Error fingerprint: Are your error occurrences grouped poorly? Set your own error fingerprint via a callback function.
• Ability to disable reporting parameterized query in nrpgx-5

Fixed

• Improved test coverage for gRPC integration, nrgrpc

Support statement

We use the latest version of the Go language. At minimum, you should be using no version of Go older than what is supported by the Go team themselves.

See the Go agent EOL Policy for details about supported versions of the Go agent and third-party components.

3.20.4

Fixed

• nrmssql driver updated to use version maintained by Microsoft
• Bug where error messages were not truncated to the maximum size, and would get dropped if they were too large
• Bug #643 where number of span events was hard coded to 1000, and config setting was being ignored
• Unencrypted hash vulnerability in v1.15.0 of github.com/aws/aws-sdk-go patched by bumping to v1.33.0

Added

• Improved performance of ignore error code checks in agent
• HTTP error codes can be set as expected by adding them to ErrorCollector.ExpectStatusCodes in the config

Support Statement

We also using the latest version of the Go language. At minimum, you should at least be using no version of Go older than what is supported by the Go team themselves.

See the Go Agent EOL Policy for details about supported versions of the Go Agent and third-party components.

3.20.3

Fixed

• Performance Improvements for compression
• nrsnowflake updated to golang 1.17 versions of packages

Support Statement

We also using the latest version of the Go language. At minimum, you should at least be using no version of Go older than what is supported by the Go team themselves.

See the Go Agent EOL Policy for details about supported versions of the Go Agent and third-party components.

3.20.2

Added

• New NoticeExpectedError() method allows you to capture errors that you are expecting to handle, without triggering alerts

  Fixed

• More defensive harvest cycle code that will avoid crashing even in the event of a panic

• Update nats-server version to avoid known zip-slip exploit

• Update labstack/echo version to mitigate known open redirect exploit

3.20.1

Added

• New integration nrpgx5 v1.0.0 to instrument github.com/jackc/pgx/v5.

Changed

• Changed the following TraceOption function to be consistent with their usage and other related identifier names. The old names remain for backward compatibility, but new code should use the new names.
  • WithIgnoredPrefix -> WithIgnoredPrefixes
  • WithPathPrefix -> WithPathPrefixes
• Implemented better handling of Code Level Metrics reporting when the data (e.g., function names) are excessively long, so that those attributes are suppressed rather than being reported with truncated names. Specifically:
  • Attributes with values longer than 255 characters are dropped.
  • No CLM attributes at all will be attached to a trace if the code.function attribute is empty or is longer than 255 characters.
  • No CLM attributes at all will be attached to a trace if both code.namespace and code.filepath are longer than 255 characters.

3.20.0

이 변경 사항을 반드시 읽어보시고, 애플리케이션이 의도한 대로 작동하도록 구성 설정을 확인해 주십시오. 이번 릴리스에서는 Go 에이전트의 일부 기본 동작이 변경되었습니다.

추가됨

• 모듈 종속성 메트릭 기능이 추가되었습니다. 이는 애플리케이션으로 가져온 모듈 목록을 수집하여 애플리케이션 종속성 관리를 돕고, 취약점 탐지 및 대응 등을 더 쉽게 할 수 있도록 합니다.

  • 이 기능은 기본적으로 활성화되어 있지만, 애플리케이션에 ConfigModuleDependencyMetricsEnable(false)을(를) 명시적으로 포함하거나 동등한 환경 변수 또는 Config 필드를 직접 설정하여 비활성화할 수 있습니다.
  • ConfigModuleDependencyMetricsIgnoredPrefixes 옵션을 통해 보고서에서 모듈을 명시적으로 제외할 수 있습니다.
  • 제외된 모듈 이름은 ConfigModuleDependencyMetricsRedactIgnoredPrefixes 옵션을 통해 삭제될 수 있습니다. 이것은 기본적으로 활성화되어 있습니다.

• 이제 Application Log Forwarding [애플리케이션 로그 전달]이 기본적으로 활성화됩니다.

  • 자동 애플리케이션 로그 포워딩이 이제 기본적으로 활성화됩니다. 이는 logcontext-v2 통합 중 하나로 래핑된 로깅 프레임워크가 이 버전의 에이전트를 사용하여 보강된 애플리케이션 로그를 뉴렐릭으로 자동 전송함을 의미합니다. 이 기능에 대한 자세한 내용은 문맥적 APM 로그 문서를 참조하십시오. 추가 설정 옵션에 대해서는 문맥적 Go 로그 문서를 참조하십시오. 계정별로 로그 수집을 켜거나 끄는 방법에 대해 알아보려면 UI 또는 API를 통해 자동 로깅을 비활성화 하는 문서를 참조하십시오.
  • logcontext-v2 확장을 사용 중이지만 에이전트가 로그를 자동으로 전달하지 않도록 하려면 애플리케이션에서 ConfigAppLogForwardingEnabled(false)을(를) 구성하십시오.
  • 모든 애플리케이션 로깅 구성 옵션에 환경 변수가 추가되었습니다:
    • NEW_RELIC_APPLICATION_LOGGING_ENABLED
  • NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED
  • NEW_RELIC_APPLICATION_LOGGING_FORWARDING_MAX_SAMPLES_STORED
  • NEW_RELIC_APPLICATION_LOGGING_METRICS_ENABLED
  • NEW_RELIC_APPLICATION_LOGGING_LOCAL_DECORATING_ENABLED

• 커스텀 대시보드 한도 증가

  • 이 버전은 커스텀 대시보드의 DEFAULT 제한을 분당 10,000 이벤트에서 분당 30,000 이벤트로 증가시킵니다. 커스텀 대시보드가 제한되는 시나리오에서, 이 변경 사항을 통해 더 많은 커스텀 대시보드를 뉴렐릭으로 전송할 수 있습니다. 또한 분당 100,000 이벤트라는 구성 가능한 새로운 MAXIMUM 제한이 있습니다. 제한을 변경하려면 애플리케이션에서 원하는 제한으로 ConfigCustomInsightsEventsMaxSamplesStored(limit)을(를) 설정하십시오. 변경 사항 및 커스텀 대시보드가 누락되고 있는지 확인하는 방법에 대해 자세히 알아보려면 Explorers Hub 게시물을 참조하십시오.
  • 새로운 구성 옵션 ConfigCustomInsightsEventsEnabled(false)을(를) 사용하여 애플리케이션에서 커스텀 대시보드 수집을 비활성화할 수 있습니다.

변경됨

• 다음 이름을 사용법 및 기타 관련 식별자 이름과 일치하도록 변경했습니다. 이전 이름은 이전 버전과의 호환성을 위해 유지되지만, 새 코드는 새 이름을 사용해야 합니다.

  • ConfigCodeLevelMetricsIgnoredPrefix -> ConfigCodeLevelMetricsIgnoredPrefixes
  • ConfigCodeLevelMetricsPathPrefix -> ConfigCodeLevelMetricsPathPrefixes
  • NEW_RELIC_CODE_LEVEL_METRICS_PATH_PREFIX -> NEW_RELIC_CODE_LEVEL_METRICS_PATH_PREFIXES
  • NEW_RELIC_CODE_LEVEL_METRICS_IGNORED_PREFIX -> NEW_RELIC_CODE_LEVEL_METRICS_IGNORED_PREFIXES

• IgnoredPrefixes 또는 PathPrefixes 설정 필드를 통해 CodeLevelMetrics에서 보고된 정보를 제외할 때(예: ConfigCodeLevelMetricsIgnoredPrefixes 또는 ConfigCodeLevelMetricsPathPrefixes 지정), 무시된 접두사 및 설정된 경로 접두사의 이름이 이제 뉴렐릭으로 전송되는 에이전트 설정 정보에서 삭제될 수 있습니다.

  • 이 교정은 기본적으로 활성화되어 있지만, ConfigCodeLevelMetricsRedactPathPrefixes 또는 ConfigCodeLevelMetricsRedactIgnoredPrefixes에 false 값을 제공하거나 해당 Config 필드 또는 환경 변수를 false(으)로 설정하여 비활성화할 수 있습니다.

결정된

• #583: 로그 메시지의 쉼표로 구분된 필드가 JSON 파서에 혼동을 주어 패닉을 일으킬 수 있는 zerologWriter의 버그를 수정했습니다.

지원 성명

뉴렐릭은 최신 기능과 성능 이점을 얻을 수 있도록 에이전트를 정기적으로 업그레이드할 것을 권장합니다. 또한, 이전 릴리스는 수명 주기가 종료되면 더 이상 지원되지 않습니다.

또한 최신 버전의 Go 언어를 사용하는 것을 권장합니다. 최소한 Go 팀 자체에서 지원하는 것보다 오래된 버전의 Go를 사용해서는 안 됩니다.

지원되는 Go 에이전트 및 타사 구성 요소 버전에 대한 자세한 내용은 Go 에이전트 EOL 정책을 참조하십시오.

3.19.2

Changed

• Updated nrgin integration to more accurately report code locations when code level metrics are enabled.
• The Go Agent and all integrations now require Go version 1.17 or later.
• Updated minimum versions for third-party modules.
  • nrawssdk-v2, nrecho-v4, nrgrpc, nrmongo, nrmysql, nrnats, and nrstan now require Go Agent 3.18.2 or later
  • the Go Agent now requires protobuf 1.5.2 and grpc 1.49.0
• Internal dev process and unit test improvements.

Support Statement

New Relic recommends that you upgrade the agent regularly to ensure that you’re getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

We also recommend using the latest version of the Go language. At minimum, you should at least be using no version of Go older than what is supported by the Go team themselves.

See the Go Agent EOL Policy for details about supported versions of the Go Agent and third-party components.

3.19.1 - Hotfix Release

Changed

• Moved the v3/internal/logcontext/nrwriter module to v3/integrations/logcontext-v2/nrwriter

Support Statement

New Relic recommends that you upgrade the agent regularly to ensure that you’re getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

See the Go Agent EOL Policy for details about supported versions of the Go Agent and third-party components.