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インテグレーションのいずれかでラップされたロギングフレームワークは、このバージョンのエージェントを使用して、エンリッチされたアプリケーションログをNew Relicに自動的に送信するようになります。この機能の詳細については、コンテキストの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

• カスタムイベントの制限引き上げ

  • このバージョンでは、カスタムイベントのデフォルトの制限が、1分あたり10,000イベントから1分あたり30,000イベントに引き上げられています。カスタムイベントが制限されていたシナリオでは、この変更により、より多くのカスタムイベントをNew Relicに送信できるようになります。また、1分あたり100,000イベントという、設定可能な新しい最大制限もあります。制限を変更するには、アプリケーションで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を指定するなど）、無視されたプレフィックスの名前と設定されたパスプレフィックスが、New Relicに送信されるエージェント設定情報からマスキングされるようになりました。

  • この秘匿化はデフォルトで有効になっていますが、ConfigCodeLevelMetricsRedactPathPrefixesまたはConfigCodeLevelMetricsRedactIgnoredPrefixesにfalseの値を指定するか、対応するConfigフィールドまたは環境変数をfalseに設定することで無効にできます。

修理済み

• #583：ログメッセージ内のカンマ区切りのフィールドがJSONパーサーを混乱させ、パニックを引き起こす可能性があったzerologWriterのバグを修正しました。

サポートステートメント

最新の機能とパフォーマンスの利点を確実に得られるように、New Relicでは、エージェントを定期的にアップグレードすることを推奨します。さらに、古いリリースはサポート終了を迎えるとサポートされなくなります。

また、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.