Docs release notesRSS

New docs

• PHP agent overhead reduction tips lists configuration settings you can change to reduce the agent's overhead on your system.

Major changes

• We've released our new Advanced Compute add-on and updated various pricing, billing, user, and product license docs to reflect this.
• We've revamped our Docs site search to give you a separate search results page. Check it out and let us know what you think!
• Updated our Kubernetes agent operator doc to include information on Kubernetes APM auto-attach.

Minor changes

• When testing the Python agent to troubleshoot collector issues, updated outdated hostname lookup IP addresses.
• In instrument your non-containerized Lambda function, added example code for a basic CDK app that deploys a Node.js Lambda function.
• In KTranslate Docker container health monitoring, added KTranslate log severity levels.
• Updated logs docs to give examples of what empty or blank output messages look like.
• In Node.js agent configuration, updated NEW_RELIC_STRIP_EXCEPTION_MESSAGES_ENABLEDdefault value from true to false.

Release notes

Check out our What's New posts to learn about new features and releases:

• What's New post for Forward logs from Kong Gateway to New Relic

Stay up-to-date on our most recent releases:

• Browser agent v1.270.0
  • Removes the supportsSendBeacon runtime property from our agent's code
• Browser agent v1.270.1
  • Removes outdated reference to agentRuntime variable in the Trace feature released in v1.270.0
• Capacitor agent v1.5.2
• Capacitor agent v1.5.3
  • Updates native Android agent to version 7.6.1
  • Updates native iOS agent to version 7.5.2
• Cordova agent v7.0.3
  • Updates native Android agent to version 7.6.1
  • Updates native iOS agent to version 7.5.2
• Flutter agent v1.1.5
  • Updates native Android agent to version 7.6.1
• .NET MAUI agent v1.1.3
  • Fixes iOS binding information property list issue
• .NET MAUI agent v1.1.4
  • Updates native Android agent to version 7.6.1
  • Updates native iOS agent to version 7.5.2
  • Adds support for handling iOS crash exceptions
• Node.js agent v12.5.2
• PHP agent v11.3.0.16
  • Supports Memcached instance metrics with host name
  • Dockerized Daemon supports Arm64
  • Various bug fixes
• React Native agent v1.4.5
  • Updates native Android agent to version 7.6.1
  • Updates native iOS agent to version 7.5.2
• Unity agent v1.4.2
  • Updates native Android agent to version 7.6.1
• Xamarin agent v1.0.1
  • Updates native Android agent to version 7.6.1
  • Updates native iOS agent to version 7.5.2

New docs

• Forward Kong Gateway logs describes how to install and use this new log forwarding plugin via the Kubernetes integration.
• Azure App Service monitoring describes how to integrate this Azure service with New Relic and links out to instructions on how to set this up for our Java, .NET, Node.js, and Python APM agents.
• Introduction to the data explorer describes how to use our new data explorer UI to query your data and gain deeper insights into how the New Relic platform can support you and solve your problems.
• Monitor Amazon ECS environments with APM language agents helps you install our APM agents on your AMazaon ECS environment.
• Migrate to NRQL describes how to migrate your REST API v2 queries to NRQL queries.

Major changes

• We've migrated content from our open source site to our docs site.
• Clarified how to manage secrets with the Kubernetes agent operator.

Minor changes

• In OpenTelemetry metrics in New Relic, we've clarified that OpenTelemetry summary metrics aren't supported.
• Updated a screenshot in recommended alert policies and dashboards to clarify where to find the Kubernetes and Google Kubernetes Engine tiles.
• Deleted Stackato and WebFaction docs related to the Python APM agent, because they're no longer relevant.
• Added a new browser monitoring endpoint to our Networks doc.
• Cleaned up minor issues across our browser monitoring troubleshooting docs.
• In troubleshoot runtime upgrade errors described how to solve issues when using older Node runtimes with $http objects.
• In .NET agent API, we've added NewRelic.Api.Agent.NewRelic to the ITransaction API call and added the new RecordDatastoreSegment API call.

Release notes

Stay up-to-date on our most recent releases:

• Android agent v7.6.1
  • Adds support for the Android Gradle plugin 8.7
  • Fixes ProGuard/DexGuard mapping files not being correctly uploaded
  • Other bug fixes
• Browser agent v1.269.0
  • Allows the MicroAgent loader on NPM to use logging APIs to manually capture log data
  • Adds instrumentation metadata to logging payloads
  • Fixes bugs related to session traces and session replay security policy errors
• Go agent v3.35.0
  • Adds support for secure cookie event reporting
  • Uses error.Error() value for log attributes
  • Enhances URL support for AMQP server connections
  • Various bug fixes
• Lambda-Extension v2.3.14
  • Adds a feature to ignore extension startup checks
  • Updates README with information on how to use the NR_TAGS environment variable
  • Adds support for the NEW_RELIC_ENABLED Boolean environment variable
• .NET agent v10.32.0
  • Deprecates enviroment variables prefixed NEWRELIC_
  • Implements a consistent naming scheme for all environment variables
  • Updates CosmosDB instrumentation to support the latest version
• Ping Runtime v1.47.0
  • Fixes an issue related to user permissions for the ping-runtime control script for non-root users
• Python agent v10.2.0
  • Adds Azure init container operator flag to support that option for monitoring Azure Container apps

New docs

• No crash data appears in release build (Android) tells you what to do if you don't see data related to an application crash on the New Relic UI.
• How can I use WSL and CodeStream? provides step-by-step instructions on using Windows Subsystem for Linux (WSL) with CodeStream.
• UserAction is a new event type in browser monitoring that helps you understand user behavior with your web application.
• WithLlmCustomAttributes (Python agent API) describes the new context manager API, including its requirements, parameters, return values, and an example usage.

Minor changes

• Added US and EU data center endpoints for the APM agent in New Relic telemetry endpoints.
• Updated instructions on how to find CodeStream client-side logs when using Visual Studio.
• Reworded Notification options for muting rules for better clarity.
• Updated the compatibility information for the following packages in instrumented modules:
  • @aws-sdk/client-bedrock-runtime
  • @aws-sdk/client-dynamodb
  • @aws-sdk/client-sns
  • @aws-sdk/client-sqs
  • @aws-sdk/lib-dynamodb
  • @grpc/grpc-js
  • @langchain/core
  • @smithy/smithy-client
  • next
  • openai
• Corrected the second EU data center endpoint to 212.32.0.0/20 in data ingest IP blocks.
• Specified that New Relic's alerts service is executed in the United States whether your data is stored in New Relic's EU or US data center.
• Modified information about how to set a custom attribute. Also, updated the examples.
• Updated the steps to unacknowledge and close an issue.
• Added information on acknowleding and closing multiple issues.
• Expanded the chart refresh rates introduction to call out that the refresh rate is configurable only if you're on the New Relic compute consumption pricing plan.
• Corrected the required Transport Layer Security (TLS) version information in TLS encryption.
• Updated Step 6 in the Kubernetes integration installation procedure to match the current New Relic UI.
• Noted the importance of the non-billable event, InternalK8sCompositeSample, in Query Kubernetes data, after the table.
• Rewrote the instructions to view and manage API keys for accuracy and clarity.
• Updated instructions on how to use the API explorer in Use the API Explorer and List application ID, host ID, instance ID to match the current API explorer.
• Added back the example for correlating infrastructure with OpenTelementry APM.
• Noted how to avoid duplicate metric names when migrating to the Azure monitor integration.

Release notes

Check out our What's New posts to learn about new features and releases:

• New Relic Pathpoint connects telemetry to business KPIs

Stay up-to-date on our most recent releases:

• Errors inbox for Android v5.25.1
  • Lets you iterate through errors, inspect profiled attribute, and a lot more
• Flutter agent v1.1.4
  • Updates the iOS agent to 7.5.2
• Kubernetes integration v3.29.6
  • Updates Go to v1.23.2
  • Updates the common library for Prometheus to v0.60.0
• Python agent v10.1.0
  • Supports Python 3.13
  • Provides a new context manager API
  • Supports reporting of Amazon ECS Fargate Docker IDs
  • Includes instrumentation for SQLiteVec
• Unity agent v1.4.1
  • Updates native Android and iOS agents
  • Contains bug fixes

New docs

• Cardinality management gives you administrative tools for managing and reviewing your organization's cardinality usage.

Major changes

• Improved instructions on tracking impacted users with errors inbox with a new screenshot and a table describing the various implementation methods.
• Updated Link OpenTelemetry-instrumented applications to Kubernetes and Explore your Kubernetes cluster with current OpenTelemetry setup and configuration information.
• Rewrote Muting rules: Suppress notifications to describe how to create, manage, suppress, and review your muting rules and muted incidents and issues.
• Reorganized our Kubernetes troubleshooting docs for improved navigation and findability.
• Revised our OpenTelemetry docs for clarity and completeness.
• Added instructions to configure the Composer runtime API for vulnerability management package detection in PHP agent configuration.

Minor changes

• Updated a couple of docs to let you know that billboard charts won't render correctly when shared via links, exported images, and PDFs.
• Fixed several docs where we were mixing Linux commands in with our Windows shell commands.
• Removed some legacy docs, then added redirects to their current versions.
• Brought Alert conditions up-to-date with the current UI.
• Added new PageViewTiming attributes to our data dictionary.
• Updated network performance monitoring docs related to the Meraki polling API and the default settings for using ICMP with KTranslate.
• Added NewRelic.Labels to .NET configuration settings.
• In Track users impacted with errors inbox, added the PHP newrelic_set_user_id API call.
• Added new prohibited event type values to Data requirements and limits for custom event data: EntityRelationship, RelationshipUpdate, and Relationship[0-9] string prefixes.
• In Getting started with New Relic and Terraform, described how to use CodeStream with Terraform.

Release notes

Check out our What's New posts to learn about new features and releases:

• Metric cardinality management made easy

Stay up-to-date on our most recent releases:

• Browser agent v1.267.0
  • Upgrades to web-vitals v4
  • For session replay, improves notification of stylesheet status
  • Adds limited preview soft navigations to the Browser-Agent loader
  • Updates agent's TimeKeeper to support custom timestamps
  • Fixes various bugs
• Java agent v8.15.0
  • Adds AWS Lambda SDK instrumentation
  • Reports Flyway migration events
  • Supports using environment variables for config file location
  • Supports AWS Kinesis v1 and v2 SDKs
  • Adds a kafka-clients-node-metrics-3.7.0 instrumentation module
  • Adds instrumentation for the glassfish-jul-extension logging library
  • Supports Java v23
  • Supports reporting ECS Fargate Docker isolated
  • Fixes various bugs
• Kubernetes integration v3.29.5 updates the following dependencies:
  • golang.org/x/crypto to v0.27.0
  • Go to v1.23.1
  • Kubernetes packages to v0.31.1
  • github.com/prometheus/common to v0.59.1
  • Alpine to v3.20.3
• Mobile app for iOS v6.8.0
  • Updates APM errors with triaged and grouped errors
• .NET agent v10.31.0
  • Adds support for the EnyimMemcachedCore client
  • Allows container linking for AWS ECS apps
  • Parses Azure Function HttpTrigger parameters
  • When instrumenting .NET Framework apps, prevents FileNotFoundException when handling connection issues
• .NET MAUI agent v1.1.2
  • Resolves an iOS bindings namespace issue
• PHP agent v11.2.0.15
  • Adds support for Composer runtime API to collect information about vulnerable packages
  • Verifies support for Symfony v6 and v7
  • Upgrades Daemon Golang to v1.23.1
  • Fixes newrelic_notice_error() API for PHP v8+ when using the 4 parameter API variant
• Python agent v10.0.0
  • Drops support for Python v2.7
  • Adds Kafka server metric
  • Adds memcached host and port attributes
  • Supports uvicorn_worker
  • Adds an environment variable for garbage collector runtime metrics
  • Adds automatic detection for LangChain function signatures
  • Updates support for OpenAI's chat class and LangChain request and response parsing
  • Fixes various bugs
• Ruby agent v9.14.0
  • Adds Apache Kafka instrumentation for the rdkafka and ruby-kafka gems
  • Adds configuration to permit automatic definition of custom method tracers
  • Limits ActionDispatch 7.0+ requests to only collecting the MIME types
  • Fixes various bugs

New docs

• Our new DataBricks integration describes how to collect telemetry from Spark deployments running on Databricks or elsewhere.

Major changes

• In syntheric monitoring troubleshoot runtime upgrade errors, added several new common error scenarios and how to resolve them.
• Rewrote introduction to AWS integrations to help you find the specific AWS service you're looking for and where to go to get started with that.
• In data privacy with New Relic, we've added a new section with actionable information on how to audit user activity on our platform.
• In MySQL monitoring integration, added new code examples and a new section on Microsoft Group Managed Service Account (gMSA).

Minor changes

• In the mobile SDK guide, added Android logs-related automatically instrumented methods.
• In New Relic OTLP endpoint, added a clarification on the differences in how OpenTelemetry and OTLP handle attribute types.

Release notes

Stay up-to-date on our most recent releases:

• Capacitor agent v1.5.1
  • Fixes an issue related to getHttpHeaderforTracking
  • Updated native Android agent to version 7.6.0
• Cordova agent v7.0.1
  • Fixes an issue related to getHttpHeaderforTracking
  • Updates native Android agent updated to version 7.6.0
• Flutter agent v1.1.3
  • Added null check for debugPrint message to prevent potential crashes
  • Fixes record metrics incorrectly sending a cout of 0
  • Updates native Android agent to version 7.6.0
• Infrastructure agent v1.57.2
  • Fixes an issue with enable_process_metrics
• iOS agent v7.5.2
  • Fixes a few hanging and crashing issues
• Node.js agent v12.5.1
  • Fixes handling of Pino merging object
  • Updates @newrelic/security-agent to v2.0.0
  • Adds Azure site extension publish job workflow fun trigger
• React Native agent v1.4.5
  • Updates native Android agent to version 7.6.0

New docs

• IAST configuration explains how to configure and schedule IAST scans.
• OCSF integration describes how to use this new integration to monitor your Open Cybersecurity Schema Framework data.

Minor changes

• Updated the requirements and compatibility information for vSphere monitoring integration. If your environment consists of more than 800 virtual machines, we've highlighted a workaround so you can report all of your data.
• Updated the code snippet required to forward Envoy logs to New Relic.
• Updated the code snippets required to configure NRI-Flex for Nextcloud and to forward Nextcloud logs to New Relic.
• Updated .NET agent compatibility and requirements for the most up to date versioning (as of these release notes):
  • StackExchange.Redis (both minimum supported version and latest verified compatible version)
  • AWS Bedrock (latest verified compatible version)
  • Confluent.Kafka (latest verified compatible version)
  • AWSSDK.SQS (both minimum supported version and latest verified compatible version)
• Updated the Node.js agent compatibility information for @aws-sdk/client-bedrock-runtime, @aws-sdk/client-dynamodb, @aws-sdk/client-sns, @aws-sdk/client-sqs, @aws-sdk/lib-dynamodb, @aws-sdk/smithy-client, @langchain/core, @smithy/smithy-client, express, fastify, mysql2, next, and openai.
• Updated the instructions on how to see your control plane data in configure control plane monitoring.

Release notes and What's New posts

Check out our What's New posts to learn about new features and releases:

• Customizing chart refresh rates
• Improving notification workflows with new Slack integration features
• See logs in context in Kubernetes deployment views
• Browser agent v1.266.0
  • Removes reporting of long tasks
• Infrastructure agent v1.57.1
  • Supports SUSE Linux Enterprise Server (SLES) version 15.6
  • Uses Go 1.22
  • Updates newrelic/nri-flex, newrelic/nri-prometheus, newrelic/nri-docker, and newrelic/nri-winservices
• Logs v240912
  • Enables logging for New Relic by default
• Logs v240911
  • Supports logs integration on Amazon Linux 2023 (AArch64)
• .NET agent v10.30.0
  • Supports instrumentation of the Oracle.ManagedDataAccess and Oracle.ManagedDataAccess.Core libraries
  • Provides preview support for instrumentation of isolated model Azure Functions (Check it out!)
  • Fixes the issue where the custom query name is lost for invalid or malformed queries
• Node.js agent v12.5.0
  • Enhances monitoring capabilities for Amazon ECS

New docs

• AWS Application Migration Service integration describes how to keep track of services you've migrated to AWS.
• Browser SPA monitoring 2.0 is an update that addresses several known issues and provide an improved monitoring experience for single-page applications.

Major changes

• Added a new section describing how to set up AWS cross-account access with New Relic.
• Added information about how to link your applications to Kubernetes, using either New Relic's or OpenTelemetry's instrumentation.
• On template variables: dynamically filter dashboards, added information on how to include and exclude variables in order to focus your dashboard visualizations on the data you're most concerned about.
• Updated several screenshots and added information about default and custom chart refresh rates.

Minor changes

• Added the BYPASS_HEAD_REQUEST description to NerdGraph tutorial: Manage your synthetic monitors.
• Clarified how to use the UI installation for Flutter application monitoring and addressed some minor inconsistencies.
• Added a note to stream logs using Kinesis Data Firehose to let you know that this AWS logs integration is not FedRAMP authorized.
• Scripted monitor proxy usage is supported and requires Firefox version 3.0.7 or higher.
• Updated logging best practices to provide some new guidance around data partitions.
• Added instructions on how to cancel your account.
• Added and updated screenshots on Kubernetes summary page.
• We support the Java Regex syntax in our logs parsing UI.
• Added a note that we've deprecated the browser monitoring createTracer SPA API method and the BrowserTiming custom event.
• The .NET agent supports Oracle versions 23.4.0 to 23.5.1 (the latest verified compatible version).
• Based on customer feedback, we've clarified how to use newrelic_notice_error (PHP agent API).

Release notes and What's New posts

• What's New post for filter dashboards faster with template variable toggle
• Android agent v7.6.0
  • Upgrade JDK support to JAVA22
  • Upgrade AGP support to version 8.6
  • Add event persistence feature flag
• Browser agent v1.265.1
• Disable websocket wrapping to fix problems with third-party libraries related to sockets
• Cordova agent v7.0.1
  • A new flag disables console log instrumentation
  • Native Android and iOS agents updated to version 7.5.1
• Job Manager v403
  • Internal improvements
• Job Manager v404
  • Fix a private location bug related to disrupted communications with New Relic
• Mobile app for Android v5.24.2
  • Improve cross-account support
  • Improve retry logic for failed HTTP calls
• Node API runtime v1.2.86
  • Update build image to address CVEs related to linux-libc-dev
• Node API runtime v1.2.88
  • Update packages to address CVE-2024-39338
• Node API runtime v1.2.94
  • Update packages to address CVE-2024-29415
• Node browser runtime v3.0.4
  • Add proxy support for Firefox monitors
  • Update packages to address CVE-2024-39338
• Node browser runtime v3.0.7
  • Update packages to address CVE-2023-42282
• Node.js agent v12.4.0
  • Add support for express@5
  • Disable instrumentation of 3rd-party packages via config.instrumentation.<library>.enabled
• Ping runtime v1.46.0
  • Update packages to address CVE-2024-25638

New docs

• Optimize your data ingest is the third installment in a four-part series on achieviing observability maturity and maximizing the benefits of an observability platform.
• OpenTelemetry for Kubernetes outlines the process to monitor a Kubernetes cluster with OpenTelemetry. This feature is still under development.

Major changes

• Consolidated .NET Core and Framework compatibility docs into a single place in .NET agent: compatibility and requirements.
• Updated understand and query high cardinality metrics to indicate how to adjust cardinality limits.
• Updated the guidelines to size and organize a partition in data partitions.
• In the New Relic Flutter agent installation procedure, updated the instructions to configure an Android app.
• In the New Relic Ionic Capacitor agent installation procedure, updated the instructions to configure a native Android app.
• In the New Relic Unity agent installation procedure, updated the instructions to configure an Android app.
• In the New Relic React Native agent installation procedure, updated the instructions to configure an Android app.
• Added an entry for a new hostname variable called exclude_matching-metrics. Use the variable to prevent unwanted data from being sent to New Relic.

Minor changes

• Added back the guides to migrate the .NET agent from 8.x to 9.x and from 9.x to 10.x.
• Updated the restrictions table in log event data to call out that instrumentation.name, instrumentation.provider, and instrumentation.version are reserved for internal use in mobile and browser integrations. Do not use these attributes in your application code.
• Fixed the GraphQL query to retrieve browser application configuration.
• Updated the private minion dashboard JSON under prerequisites in monitor private locations.
• Simplified the steps to install and use Go instrumentation tool.
• Added the Amazon S3 network endpoints for US and EU under user-facing domains in New Relic network traffic. Ensure that your network doesn't block these endpoints. Otherwise, the Synthetics UI may malfunction.
• Corrected the supported Joomla version for the PHP agent in compatibility and requirements.
• Changed the default values of backgroundReportingEnabled and newEventSystemEnabled in the code to configure a Flutter project and to configure a React Native app.
• Fixed some minor inaccuracies and technical issues in Elasticsearch monitoring integration.

Release notes and What's New posts

• What's New post for a new type of alert condition threshold
• Infrastructure agent v1.57.0
  • Enables new local health status checks for valid credentials
  • Enables exclusion lists for process monitoring
• Node.js agent v12.3.1
  • Fixes REST API type payload detection in AWS Lambda
• React Native agent v1.4.4
  • Fixes an issue caused by a mismatch between the Android agent and the NDK agent

New docs

• Go easy instrumentation is an experimental tool that makes it easy to instrument your application with the New Relic Go agent, saving you time and effort. Try it now!
• Segmentation faults provides guidance on how to identify and fix segmentation faults when using the New Relic PHP agent.

Major changes

• Updated the instructions to manually install the Android agent.
• Starting August 26, 2024, only the new runtime is available for creating synthetic monitors. But you can downgrade the runtime of an existing monitor from the new version to the legacy version until October 22, 2024 EOL.

Minor changes

• In addToTrace, we've corrected the description and code example of the JavaScript object parameter.
• In Downgrade or cancel New Relic, added guidance on preparing for org deletion when using multiple authentication domains.

Release notes and What's New posts

• Node.js agent v12.3.0
  • Allows custom attributes to be assigned to LLM events in a function
  • Improves AWS Lambda event detection
• PHP agent v11.1.0.14
  • Supports Drupal 11
  • Fixes an issue where newrelic.so could not earlier use the strlcpy function on Linux