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

LEA estos cambios y verifique los ajustes de configuración para asegurarse de que la aplicación se comporte como desea. Esta versión cambia algunos comportamientos predeterminados en el agente de Go.

Agregado

• Se agregó la característica de métricas de dependencia de módulos. Esto recopila la lista de módulos importados en la aplicación, para ayudar en la gestión de las dependencias de la aplicación, lo que permite una detección y respuesta a vulnerabilidades más sencilla, etc.

  • Esta característica está habilitada de forma predeterminada, pero puede deshabilitarse incluyendo explícitamente ConfigModuleDependencyMetricsEnable(false) en la aplicación, o configurando la variable de entorno equivalente o el campo Config directamente.
  • Los módulos pueden excluirse explícitamente del informe mediante la opción ConfigModuleDependencyMetricsIgnoredPrefixes.
  • Los nombres de los módulos excluidos pueden redactarse mediante la opción ConfigModuleDependencyMetricsRedactIgnoredPrefixes. Está habilitado de forma predeterminada.

• Application Log Forwarding ahora estará HABILITADO por defecto

  • El reenvío automático de logs de aplicación ahora está habilitado de forma predeterminada. Esto significa que los frameworks de registro envueltos con una de las integraciones de logcontext-v2 enviarán automáticamente logs de aplicación enriquecidos a New Relic con esta versión del agente. Para obtener más información sobre esta característica, consulte la documentación de logs en el contexto de APM. Para opciones de configuración adicionales, consulte la documentación de logs en el contexto de Go. Para obtener información sobre cómo activar o desactivar la ingesta de logs por cuenta, consulte nuestra documentación para deshabilitar el registro automático a través de la UI o la API.
  • Si utiliza una extensión logcontext-v2, pero no desea que el agente reenvíe los logs automáticamente, configure ConfigAppLogForwardingEnabled(false) en su aplicación.
  • Se han agregado variables de entorno para todas las opciones de configuración de logging de la aplicación:
    • 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

• Aumento del límite de eventos personalizados

  • Esta versión aumenta el límite PREDETERMINADO de eventos personalizados de 10 000 eventos por minuto a 30 000 eventos por minuto. En el caso de que se estuvieran limitando los eventos personalizados, este cambio permitirá enviar más eventos personalizados a New Relic. También hay un nuevo límite MÁXIMO configurable de 100 000 eventos por minuto. Para cambiar los límites, establezca ConfigCustomInsightsEventsMaxSamplesStored(limit) en el límite que desee en su aplicación. Para obtener más información sobre el cambio y cómo determinar si se están descartando eventos personalizados, consulte nuestra publicación en el Explorers Hub.
  • La nueva opción de configuración ConfigCustomInsightsEventsEnabled(false) se puede usar para deshabilitar la recopilación de eventos personalizados en la aplicación.

Cambió

• Se cambiaron los siguientes nombres para que sean coherentes con su uso y otros nombres de identificadores relacionados. Los nombres antiguos se mantienen por compatibilidad con versiones anteriores, pero el código nuevo debe usar los nombres nuevos.

  • 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

• Al excluir la información reportada por CodeLevelMetrics mediante los campos de configuración IgnoredPrefixes o PathPrefixes (por ejemplo, al especificar ConfigCodeLevelMetricsIgnoredPrefixes o ConfigCodeLevelMetricsPathPrefixes), los nombres de los prefijos ignorados y los prefijos de ruta configurados ahora pueden ocultarse de la información de configuración del agente enviada a New Relic.

  • Esta ocultación está habilitada de forma predeterminada, pero se puede deshabilitar proporcionando un valor false a ConfigCodeLevelMetricsRedactPathPrefixes o ConfigCodeLevelMetricsRedactIgnoredPrefixes, o estableciendo los campos Config o las variables de entorno correspondientes en false.

Fijado

• #583: se corrigió un error en zerologWriter donde los campos separados por comas en el mensaje de log confundían al analizador JSON y podían causar pánicos.

Declaración de apoyo

New Relic recomienda actualizar el agente regularmente para asegurarse de obtener las últimas características y beneficios de rendimiento. Además, las versiones anteriores dejarán de tener soporte cuando lleguen al fin de su vida útil.

También recomendamos usar la última versión del lenguaje Go. Como mínimo, no debería usar ninguna versión de Go anterior a la que admite el propio equipo de Go.

Consulte la Política de fin de vida útil (EOL) del agente de Go para obtener detalles sobre las versiones compatibles del agente de Go y los componentes de terceros.

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.