Agent SDK Release Notes

End of Life Notice

The APM Agent SDK is deprecated beta software. If you're using the Agent SDK, we recommend switching to the C SDK.

Agent SDK Release Notes

Friday, June 12, 2015 - 11:15 Download


  • We fixed a memory leak that occurs while communicating with New Relic

  • Calls of newrelic_segment_external_begin() no longer create duplicate external metrics

    Previously, one call would cause two external metrics to display in the breakdown table. We removed the less informative of the two metrics that appear.

  • Corrected the parameter definition for newrelic_enable_instrumentation()

    You should pass 0 to disable and 1 to enable instrumentation. The old comment had those instructions reversed. Also, the docs site example used a boolean rather than an integer, and that has been corrected.

Monday, November 10, 2014 - 17:46 Download


  • Changed the way we initialize our libraries to avoid potential crashes and/or undefined behavior due to static initialization reordering
Tuesday, November 4, 2014 - 11:11 Download


  • The Agent SDK will now work on systems that have libcurl built against an SSL library other than OpenSSL.
Wednesday, October 15, 2014 - 17:18 Download


  • This release changes the Agent SDK's SSL/TLS configuration to disable SSLv3 and always use TLS1.x if SSL is enabled for the agent
Friday, October 10, 2014 - 15:02 Download


Memory Leak

  • Fixed memory leak when obfuscating SQL or cleansing a request URL
Thursday, October 9, 2014 - 11:54 Download


This release of the Agent SDK is focused around thread-safety.



  • Modifying and ending a single transaction from different threads is now thread-safe.
  • Starting, modifying, and ending segments on different threads within the same transaction is now thread-safe.
Thursday, September 11, 2014 - 12:42 Download


This release of the Agent SDK is focused around adding support for SQL Traces and improving insight gained from Transaction Traces.

New Features

SQL Trace aka Slow SQL

The Agent SDK now generates an SQL trace for each instrumented datastore segment. Every minute the agent sends 10 of these traces up to the New Relic service. The traces selected will represent the worst performing SQL statements during that minute.

Custom SQL Obfuscation

SQL is obfuscated by default by replacing string literals and number sequences with the ? character. There is also a way for you to supply the Agent SDK with your own custom obfuscator for a datastore segment.

SQL Trace Aggregation

By default, the Agent SDK aggregates SQL Traces that have similar SQL statements using the obfuscated SQL. It also provides a way for you to decide how to aggregate these traces.

SQL Statements inside Transaction Traces

You can also see SQL statements for datastore segments that are part of a transaction trace.


Note: In High Security Mode, the Agent SDK will not send any SQL traces nor will it send SQL inside a Transaction Trace.

Wednesday, August 13, 2014 - 16:04 Download


This release of the Agent SDK adds support for New Relic's High Security Mode feature.

New Features

High Security Mode

The Agent SDK now supports High Security Mode. There is a new local configuration setting that enables high security for the agent. Once enabled, SSL will be enforced and attributes inside transaction traces and traced errors will not be collected.

Note: Server-side High Security Mode must be enabled via the New Relic web interface before turning it on locally. After local config has changed, the agent must be restarted in order to read setting changes and to create a new connection. For those running a daemon, this means restarting the daemon.

Monday, July 28, 2014 - 12:42 Download


This release of the Agent SDK focuses on providing more insight into your application's overall performance.

New Features

CPU & Memory Metrics

The Agent SDK now supports CPU and memory usage. This gives you a better picture of an application's performance and impact on the system. To get started, make an API call to newrelic_record_cpu_usage and newrelic_record_memory_usage whenever you want to see an application's CPU and memory usage at a given time. You can get an overall picture of your application's system performance by periodically making these API calls.

New Features

Bug Fixes

The Agent SDK build script now updates version header files with the latest release version number. Releases used after version 0.6 and before this version were reporting as 0.6. This did not effect user experience, but potentially could have if certain APM features were enabled for future versions of the Agent SDK.