Go agent release notes

Go agent v1.0

Mon, 08 Aug 2016 00:00:00 +0000

Notes

Removed BetaToken from the Config structure.
Breaking Datastore change: datastore package contents moved to top level newrelic package. datastore.MySQL has become newrelic.DatastoreMySQL.
Breaking Attributes change: attributes package contents moved to top level newrelic package. attributes.ResponseCode has become newrelic.AttributeResponseCode. Some attribute name constants have been shortened.
Added "runtime.NumCPU" to the environment tab. Thanks sergeylanzman for the contribution.
Prefixed the environment tab values "Compiler", "GOARCH", "GOOS", and "Version" with "runtime."

Go agent v1.1

Wed, 07 Sep 2016 00:00:00 +0000

Notes

Added support for Transaction Traces.
Stack trace filenames have been shortened: Any thing preceding the first /src/ is now removed.

Go agent v1.10

Tue, 24 Oct 2017 00:00:00 +0000

New

Added new RecordCustomMetric method to Application. This functionality can be used to track averages or counters without using custom events. See Custom Metric Documentation
Fixed import needed for logrus. The import Sirupsen/logrus had been renamed to sirupsen/logrus. Thanks to @alfred-landrum for spotting this.
Added ErrorAttributer, an optional interface that can be implemented by errors provided to Transaction.NoticeError to attach additional attributes. These attributes are subject to attribute configuration.
Added Error, a type that allows direct control of error fields.
Updated license to address scope of usage.

Go agent v1.2

Thu, 06 Oct 2016 00:00:00 +0000

Notes

Added support for instrumenting short-lived processes:
- The new Application.Shutdown method allows applications to report data to New Relic without waiting a full minute.
- The new Application.WaitForConnection method allows your process to defer instrumentation until the application is connected and ready to gather data.
- Full documentation here: application.go
- Example short-lived process: examples/short-lived-process/main.go
Error metrics are no longer created when ErrorCollector.Enabled = false.
Added support for http://wwwgithub.com/mgutz/logxi. See https://github.com/newrelic/go-agent/blob/master/_integrations/nrlogxi/v1/nrlogxi.go.
Fixed bug where Transaction Trace thresholds based upon Apdex were not being applied to background transactions.

Go agent v1.11

Wed, 29 Nov 2017 00:00:00 +0000

New Features

Added support for Cross Application Tracing (CAT). Please refer to the upgrading section of the guide for more detail on how to ensure you get the most out of the Go agent's new CAT support.
The agent now collects additional metadata when running within Amazon Web Services, Google Cloud Platform, Microsoft Azure, and Pivotal Cloud Foundry. This information is used to provide an enhanced experience when the agent is deployed on those platforms.

Go agent v1.3

Fri, 07 Oct 2016 00:00:00 +0000

Notes

Added a timeout parameter to the Application.Shutdown method.

Go agent v1.4

Wed, 12 Oct 2016 00:00:00 +0000

Notes

Added support for slow query traces. Slow datastore segments will now generate slow query traces viewable on the datastore tab. These traces include a stack trace and help you to debug slow datastore activity.
Added new DatastoreSegment fields ParameterizedQuery, QueryParameters, Host, PortPathOrID, and DatabaseName. These fields will be shown in transaction traces and in slow query traces.

Go agent v1.6

Thu, 16 Feb 2017 00:00:00 +0000

Notes

Added support for gorilla/mux in the new nrgorilla package.
- Documentation
- Example

Go agent v1.6

Thu, 09 Feb 2017 00:00:00 +0000

Notes

Added support for custom error messages and stack traces. Errors provided to Transaction.NoticeError will now be checked to see if they implement ErrorClasser and/or StackTracer. Thanks to @fgrosse for this proposal.
Added support for pkg/errors. Thanks to @fgrosse for this work.
- documentation
- example
Fixed tests for Go 1.8.

Go agent v1.9

Tue, 18 Apr 2017 00:00:00 +0000

New

Added support for github.com/gin-gonic/gin in the new nrgin package.
- Documentation

Go agent v1.8

Fri, 17 Mar 2017 00:00:00 +0000

Notes

Fixed incorrect metric rule application when the metric rule is flagged to terminate and matches but the name is unchanged.
Segment.End(), DatastoreSegment.End(), and ExternalSegment.End() methods now return an error which may be helpful in diagnosing situations where segment data is unexpectedly missing.

Go agent v2.1

Tue, 28 Aug 2018 00:00:00 +0000

2.1.0 New

Go Agent now supports distributed tracing

Distributed tracing lets you see the path that a request takes as it travels through your distributed system. By showing the distributed activity through a unified view, you can troubleshoot and understand a complex system better than ever before.

Distributed tracing is available with an APM Pro or equivalent subscription. To see a complete distributed trace, you need to enable the feature on a set of neighboring services. Enabling distributed tracing changes the behavior of some New Relic features, so carefully consult the transition guide before you enable this feature.

To enable distributed tracing, set the following fields in your config. Note that distributed tracing and cross application tracing cannot be used simultaneously.

config := newrelic.NewConfig("Your Application Name", "__YOUR_NEW_RELIC_LICENSE_KEY__")
  config.CrossApplicationTracer.Enabled = false
  config.DistributedTracer.Enabled = true

Please refer to the distributed tracing section of the guide for more detail on how to ensure you get the most out of the Go agent's distributed tracing support.

New distributed trace calls/functions

Added functions NewContext and FromContext for adding and retrieving the Transaction from a Context. Handlers instrumented by WrapHandle, WrapHandleFunc, and nrgorilla.InstrumentRoutes may use FromContext on the request's context to access the Transaction. Thanks to @caarlos0 for the contribution! Though NewContext and FromContext require Go 1.7+ (when context was added), RequestWithTransactionContext is always exported so that it can be used in all framework and library instrumentation.

Go agent v2.0

Tue, 15 May 2018 00:00:00 +0000

2.0.0 New

The End() functions defined on the Segment, DatastoreSegment, and ExternalSegment types now receive the segment as a pointer, rather than as a value. This prevents unexpected behaviour when a call to End() is deferred before one or more fields are changed on the segment.

In practice, this is likely to only affect this pattern:
```
defer newrelic.DatastoreSegment{
  // ...
}.End()
```
Instead, you will now need to separate the literal from the deferred call:
```
ds := newrelic.DatastoreSegment{
  // ...
}
defer ds.End()
```
When creating custom and external segments, we recommend using newrelic.StartSegment() and newrelic.StartExternalSegment(), respectively.
Added GoDoc badge to README. Thanks to @mrhwick for the contribution!
Config.UseTLS configuration setting has been removed to increase security. TLS will now always be used in communication with New Relic Servers.

Go agent v2.10.0

Wed, 31 Jul 2019 00:00:00 +0000

2.10.0

New Features

Added support for custom events when using nrlambda. Example Lambda handler which creates custom event:

func handler(ctx context.Context) {
    if txn := newrelic.FromContext(ctx); nil != txn {
        txn.Application().RecordCustomEvent("myEvent", map[string]interface{}{
            "zip": "zap",
        })
    }
    fmt.Println("hello world!")
}

Go agent v2.11.0

Thu, 22 Aug 2019 00:00:00 +0000

New Features

Added support for Micro monitoring with the new _integrations/nrmicro package. This package supports instrumentation for servers, clients, publishers, and subscribers.
Added support for creating static WebRequest instances manually via the NewStaticWebRequest function. This can be useful when you want to create a web transaction but don't have an http.Request object. Here's an example of creating a static WebRequest and using it to mark a transaction as a web transaction:
```
hdrs := http.Headers{}
u, _ := url.Parse("http://example.com")
webReq := newrelic.NewStaticWebRequest(hdrs, u, "GET", newrelic.TransportHTTP)
txn := app.StartTransaction("My-Transaction", nil, nil)
txn.SetWebRequest(webReq)
```

Go agent v2.13.0

Mon, 23 Sep 2019 00:00:00 +0000

2.13.0

New Features

Added support for HttpRouter in the new _integrations/nrhttprouter package. This package allows you to easily instrument inbound requests through the HttpRouter framework.
- Documentation
- Example
Added support for github.com/uber-go/zap in the new _integrations/nrzap package. This package allows you to send agent log messages to zap.

Go agent v2.12.0

Tue, 17 Sep 2019 00:00:00 +0000

New Features

Added new methods to expose Transaction details:
- Transaction.GetTraceMetadata() returns a TraceMetadata which contains distributed tracing identifiers.
- Transaction.GetLinkingMetadata() returns a LinkingMetadata which contains the fields needed to link data to a trace or entity.
Added a new plugin for the Logrus logging framework with the new _integrations/logcontext/nrlogrusplugin package. This plugin leverages the new GetTraceMetadata and GetLinkingMetadata above to decorate logs.

To enable, set your log's formatter to the nrlogrusplugin.ContextFormatter{}
```
logger := logrus.New()
logger.SetFormatter(nrlogrusplugin.ContextFormatter{})
```
The logger will now look for a newrelic.Transaction inside its context and decorate logs accordingly. Therefore, the Transaction must be added to the context and passed to the logger. For example, this logging call
```
logger.Info("Hello New Relic!")
```
must be transformed to include the context, such as:
```
ctx := newrelic.NewContext(context.Background(), txn)
logger.WithContext(ctx).Info("Hello New Relic!")
```
For full documentation see the godocs or view the example.
Added support for NATS and NATS Streaming monitoring with the new _integrations/nrnats and _integrations/nrstan packages. These packages support instrumentation of publishers and subscribers.
- NATS Example
- NATS Streaming Example
Enables ability to migrate to Configurable Security Policies (CSP) on a per agent basis for accounts already using High-security mode (HSM).
- Previously, if CSP was configured for an account, New Relic would not allow an agent to connect without the security_policies_token. This led to agents not being able to connect during the period between when CSP was enabled for an account and when each agent is configured with the correct token.
- With this change, when both HSM and CSP are enabled for an account, an agent (this version or later) can successfully connect with either high_security: true or the appropriate security_policies_token configured - allowing the agent to continue to connect after CSP is configured on the account but before the appropriate security_policies_token is configured for each agent.

Go agent v2.14.0

Mon, 14 Oct 2019 00:00:00 +0000

2.14.0

New Features

Added support for a new segment type, MessageProducerSegment, to be used to track time spent adding messages to message queuing systems like RabbitMQ or Kafka.

seg := &newrelic.MessageProducerSegment{
  StartTime:       newrelic.StartSegmentNow(txn),
  Library:         "RabbitMQ",
  DestinationType: newrelic.MessageExchange,
  DestinationName: "myExchange",
}
// add message to queue here
seg.End()

Added new attribute constants for use with message consumer transactions. These attributes can be used to add more detail to a transaction that tracks time spent consuming a message off a message queuing system like RabbitMQ or Kafka. They can be added using txn.AddAttribute.

// The routing key of the consumed message.
txn.AddAttribute(newrelic.AttributeMessageRoutingKey, "myRoutingKey")
// The name of the queue the message was consumed from.
txn.AddAttribute(newrelic.AttributeMessageQueueName, "myQueueName")
// The type of exchange used for the consumed message (direct, fanout,
// topic, or headers).
txn.AddAttribute(newrelic.AttributeMessageExchangeType, "myExchangeType")
// The callback queue used in RPC configurations.
txn.AddAttribute(newrelic.AttributeMessageReplyTo, "myReplyTo")
// The application-generated identifier used in RPC configurations.
txn.AddAttribute(newrelic.AttributeMessageCorrelationID, "myCorrelationID")

It is recommended that at most one message is consumed per transaction.

Added support for Go 1.13's Error wrapping. Transaction.NoticeError now uses Unwrap recursively to identify the error's cause (the deepest wrapped error) when generating the error's class field. This functionality will help group your errors usefully.

For example, when using Go 1.13, the following code:
```
type socketError struct{}

func (e socketError) Error() string { return "socket error" }

func gamma() error { return socketError{} }
func beta() error  { return fmt.Errorf("problem in beta: %w", gamma()) }
func alpha() error { return fmt.Errorf("problem in alpha: %w", beta()) }

func execute(txn newrelic.Transaction) {
err := alpha()
txn.NoticeError(err)
}
```
captures an error with message "problem in alpha: problem in beta: socket error" and class "main.socketError". Previously, the class was recorded as "*fmt.wrapError".
A Stack field has been added to Error, which can be assigned using the new NewStackTrace function. This allows your error stack trace to show where the error happened, rather than the location of the NoticeError call.

Transaction.NoticeError not only checks for a stack trace (using StackTracer) in the error parameter, but in the error's cause as well. This means that you can create an Error where your error occurred, wrap it multiple times to add information, notice it with NoticeError, and still have a useful stack trace. Take a look!
```
func gamma() error {
return newrelic.Error{
    Message: "something went very wrong",
    Class:   "socketError",
    Stack:   newrelic.NewStackTrace(),
}
}

func beta() error  { return fmt.Errorf("problem in beta: %w", gamma()) }
func alpha() error { return fmt.Errorf("problem in alpha: %w", beta()) }

func execute(txn newrelic.Transaction) {
err := alpha()
txn.NoticeError(err)
}
```
In this example, the topmost stack trace frame recorded is "gamma", rather than "execute".
Added support for configuring a maximum number of transaction events per minute to be sent to New Relic. It can be configured as follows:
```
config := newrelic.NewConfig("Application Name", os.Getenv("NEW_RELIC_LICENSE_KEY"))  
config.TransactionEvents.MaxSamplesStored = 100
```
- For additional configuration information, see our documentation

Miscellaneous

Updated the nrmicro package to use the new segment type MessageProducerSegment and the new attribute constants:
- nrmicro.ClientWrapper now uses newrelic.MessageProducerSegments instead of newrelic.ExternalSegments for calls to Client.Publish.
- nrmicro.SubscriberWrapper updates transaction names and adds the attribute message.routingKey.
Updated the nrnats and nrstan packages to use the new segment type MessageProducerSegment and the new attribute constants:
- nrnats.StartPublishSegment now starts and returns a newrelic.MessageProducerSegment type.
- nrnats.SubWrapper and nrstan.StreamingSubWrapper updates transaction names and adds the attributes message.routingKey, message.queueName, and message.replyTo.

Go agent v2.14.1

Tue, 15 Oct 2019 00:00:00 +0000

2.14.1

Bug Fixes

Removed the hidden "NEW_RELIC_DEBUG_LOGGING" environment variable setting which was broken in release 2.14.0.

Go agent v2.16.0

Fri, 22 Nov 2019 00:00:00 +0000

2.16.0

Upcoming

The next release of the Go Agent is expected to be a major version release to improve the API and incorporate Go modules. Details available here: https://github.com/newrelic/go-agent/issues/106 We would love your feedback!

Bug Fixes

Fixed an issue in the nrhttprouter integration where the transaction was not being added to the requests context. This resulted in an inability to access the transaction from within an httprouter.Handle function. This issue has now been fixed.

Go agent v2.15.0

Thu, 24 Oct 2019 00:00:00 +0000

2.15.0

New Features

Added support for monitoring MongoDB queries with the new _integrations/nrmongo package.
- Example application
- Full godocs Documentation
Added new method Transaction.IsSampled() that returns a boolean that indicates if the transaction is sampled. A sampled transaction records a span event for each segment. Distributed tracing must be enabled for transactions to be sampled. false is returned if the transaction has finished. This sampling flag is needed for B3 trace propagation and future support of W3C Trace Context.

Added support for adding B3 Headers to outgoing requests. This is helpful if the service you are calling uses B3 for trace state propagation (for example, it uses Zipkin instrumentation). You can use the new _integrations/nrb3 package's nrb3.NewRoundTripper like this:

// When defining the client, set the Transport to the NewRoundTripper. This
// will create ExternalSegments and add B3 headers for each request.
client := &http.Client{
  Transport: nrb3.NewRoundTripper(nil),
}

// Distributed Tracing must be enabled for this application.
// (see https://docs.newrelic.com/docs/understand-dependencies/distributed-tracing/enable-configure/enable-distributed-tracing)
txn := currentTxn()

req, err := http.NewRequest("GET", "http://example.com", nil)
if nil != err {
  log.Fatalln(err)
}

// Be sure to add the transaction to the request context.  This step is
// required.
req = newrelic.RequestWithTransactionContext(req, txn)
resp, err := client.Do(req)
if nil != err {
  log.Fatalln(err)
}

defer resp.Body.Close()
fmt.Println(resp.StatusCode)

Go agent v2.16.2

Tue, 10 Dec 2019 00:00:00 +0000

2.16.2

New Relic's Go agent v3.0 is currently available for review and beta testing. Your use of this pre-release is at your own risk. New Relic disclaims all warranties, express or implied, regarding the beta release.

If you do not manually take steps to use the new v3 folder you will not see any changes in your agent.

This is the second release of the pre-release of Go agent v3.0. It includes changes due to user feedback during the pre-release. The existing agent in "github.com/newrelic/go-agent" is unchanged. The Go agent v3.0 code in the v3 folder has the following changes:

Transaction names created by WrapHandle, WrapHandleFunc, nrecho-v3, nrecho-v4, nrgorilla, and nrgin now include the HTTP method. For example, the following code:
```
http.HandleFunc(newrelic.WrapHandleFunc(app, "/users", usersHandler))
```
now creates a metric called WebTransaction/Go/GET /users instead of WebTransaction/Go/users. As a result of this change, you may need to update your alerts and dashboards.
The ConfigFromEnvironment config option is now strict. If one of the environment variables, such as NEW_RELIC_DISTRIBUTED_TRACING_ENABLED, cannot be parsed, then Config.Error will be populated and NewApplication will return an error.
ConfigFromEnvironment now processes NEW_RELIC_ATTRIBUTES_EXCLUDE and NEW_RELIC_ATTRIBUTES_INCLUDE.

Go agent v2.16.1

Mon, 02 Dec 2019 00:00:00 +0000

2.16.1

New Relic's Go agent v3.0 is currently available for review and beta testing. Your use of this pre-release is at your own risk. New Relic disclaims all warranties, express or implied, regarding the beta release.

If you do not manually take steps to use the new v3 folder, as described below, you will not see any changes in your agent.

This 2.16.1 release includes a new v3.0 folder which contains the pre-release of Go agent v3.0; Go agent v3.0 includes breaking changes. We are seeking feedback and hope that you will look this over and test out the changes prior to the official release.

This is not an official 3.0 release, it is just a vehicle to gather feedback on proposed changes. It is not tagged as 3.0 in Github and the 3.0 release is not yet available to update in your Go mod file. In order to test out these changes, you will need to clone this repo in your Go source directory, under [go-src-dir]/src/github.com/newrelic/go-agent. Once you have the source checked out, you will need to follow the steps in the second section of v3/MIGRATION.md.

A list of changes and installation instructions is included in the v3 folder and can be found here

For this pre-release (beta) version of Go agent v3.0, please note:

The changes in the v3 folder represent what we expect to release in '~'2 weeks as our major 3.0 release. However, as we are soliciting feedback on the changes and there is the possibility of some breaking changes before the official release.
This is not an official 3.0 release; it is not tagged as 3.0 in Github and the 3.0 release is not yet available to update in your Go mod file.
If you test out these changes and encounter issues, questions, or have feedback that you would like to pass along, please open up an issue here and be sure to include the label 3.0.
- For normal (non-3.0) issues/questions we request that you report them via our support site or our community forum. Please only report questions related to the 3.0 pre-release directly via GitHub.

New Features

V3 will add support for Go Modules. The go.mod files exist in the v3 folder, but they will not be usable until we have fully tagged the 3.0 release officially. Examples of version tags we plan to use for different modules include:
- v3.0.0
- v3/integrations/nrecho-v3/v1.0.0
- v3/integrations/nrecho-v4/v1.0.0

Changes

The changes are the ones that we have requested feedback previously in this issue.
A full list of changes that are included, along with a checklist for upgrading, is available in v3/MIGRATION.md.

Go agent v2.2

Tue, 18 Dec 2018 00:00:00 +0000

2.2 Notes

The Transaction parameter to NewRoundTripper and StartExternalSegment is now optional: If it is nil, then a Transaction will be looked for in the request's context (using FromContext). Passing a nil transaction is STRONGLY recommended when using NewRoundTripper since it allows one http.Client.Transport to be used for multiple transactions. Example use:

client := &http.Client{}
client.Transport = newrelic.NewRoundTripper(nil, client.Transport)
request, _ := http.NewRequest("GET", "http://example.com", nil)
request = newrelic.RequestWithTransactionContext(request, txn)
resp, err := client.Do(request)

Introduced Transaction.SetWebRequest(WebRequest) method which marks the transaction as a web transaction. If the WebRequest parameter is non-nil, SetWebRequest will collect details on request attributes, url, and method. This method is useful if you don't have access to the request at the beginning of the transaction, or if your request is not an *http.Request (just add methods to your request that satisfy WebRequest). To use an *http.Request as the parameter, use the NewWebRequest transformation function. Example:

var request *http.Request = getInboundRequest()
txn.SetWebRequest(newrelic.NewWebRequest(request))

Fixed Debug in nrlogrus package. Previous versions of the New Relic Go Agent incorrectly logged to Info level instead of Debug. This has now been fixed. Thanks to @paddycarey for catching this.
nrgin.Transaction may now be called with either a context.Context or a *gin.Context. If you were passing a *gin.Context around your functions as a context.Context, you may access the Transaction by calling either nrgin.Transaction or FromContext. These functions now work nicely together. For example, FromContext will return the Transaction added by nrgin.Middleware. Thanks to @rodriguezgustavo for the suggestion.

Go agent v2.16.3

Wed, 11 Dec 2019 00:00:00 +0000

Notes

New Relic's Go agent v3.0 is currently available for review and beta testing. Your use of this pre-release is at your own risk. New Relic disclaims all warranties, express or implied, regarding the beta release.

If you do not manually take steps to use the new v3 folder you will not see any changes in your agent.

This is the third release of the pre-release of Go agent v3.0. It includes changes due to user feedback during the pre-release. The existing agent in`"github.com/newrelic/go-agent"` is unchanged.

Fixes

The Go agent v3.0 code in the v3 folder has the following changes:

A ConfigFromEnvironment bug has been fixed.

Go agent v2.3

Thu, 24 Jan 2019 00:00:00 +0000

2.3.0 Notes

Added support for Echo in the new nrecho package.
- Documentation
- Example
Introduced Transaction.SetWebResponse(http.ResponseWriter) method which sets the transaction's response writer. After calling this method, the Transaction may be used in place of the http.ResponseWriter to intercept the response code. This method is useful when the http.ResponseWriter is not available at the beginning of the transaction (if so, it can be given as a parameter to Application.StartTransaction). This method will return a reference to the transaction which implements the combination of http.CloseNotifier, http.Flusher, http.Hijacker, and io.ReaderFrom implemented by the ResponseWriter. Example:

func setResponseDemo(txn newrelic.Transaction) {
    recorder := httptest.NewRecorder()
    txn = txn.SetWebResponse(recorder)
    txn.WriteHeader(200)
    fmt.Println("response code recorded:", recorder.Code)
}

The Transaction's http.ResponseWriter methods may now be called safely if a http.ResponseWriter has not been set. This allows you to add a response code to the transaction without using a http.ResponseWriter. Example:

func transactionWithResponseCode(app newrelic.Application) {
       txn := app.StartTransaction("hasResponseCode", nil, nil)
       defer txn.End()
       txn.WriteHeader(200) // Safe!
}

The agent will now collect environment variables prefixed by NEW_RELIC_METADATA_ and KUBERNETES_SERVICE_HOST. These will be added to Transaction events to provide context between your Kubernetes cluster and your services. For details on the benefits (currently in beta) see this blog post
The agent now collects the fully qualified domain name of the host and local IP addresses for improved linking with our Infrastructure product.

Go agent v2.4

Thu, 31 Jan 2019 00:00:00 +0000

2.4.0 Notes

Introduced Transaction.Application method which returns the Application that started the Transaction. This method is useful since it may prevent having to pass the Application to code that already has access to the Transaction. Example use:

txn.Application().RecordCustomEvent("customerOrder", map[string]interface{}{
    "numItems":   2,
    "totalPrice": 13.75,
})

The Transaction.AddAttribute method no longer accepts nil values since our backend ignores them.

Go agent v2.5

Thu, 14 Feb 2019 00:00:00 +0000

2.5.0

Added support for New Relic Browser using the new BrowserTimingHeader method on the Transaction which returns a BrowserTimingHeader. The New Relic Browser JavaScript code measures page load timing, also known as real user monitoring. The Pro version of this feature measures AJAX requests, single-page applications, JavaScript errors, and much more! Example use:

func browser(w http.ResponseWriter, r *http.Request) {
    hdr, err := w.(newrelic.Transaction).BrowserTimingHeader()
    if nil != err {
        log.Printf("unable to create browser timing header: %v", err)
    }
    // BrowserTimingHeader() will always return a header whose methods can
    // be safely called.
    if js := hdr.WithTags(); js != nil {
        w.Write(js)
    }
    io.WriteString(w, "browser header page")
}

The Go agent now collects an attribute named request.uri on Transaction Traces, Transaction Events, Error Traces, and Error Events. request.uri will never contain user, password, query parameters, or fragment. To prevent the request's URL from being collected in any data, modify your Config like this:

cfg.Attributes.Exclude = append(cfg.Attributes.Exclude, newrelic.AttributeRequestURI)

Go agent v2.6

Tue, 12 Mar 2019 00:00:00 +0000

2.6.0

New Features

Added support for async: the ability to instrument multiple concurrent goroutines, or goroutines that access or manipulate the same Transaction.

The new Transaction.NewGoroutine() Transaction method allows transactions to create segments in multiple goroutines!

NewGoroutine returns a new reference to the Transaction. This must be called any time you are passing the Transaction to another goroutine which makes segments. Each segment-creating goroutine must have its own Transaction reference. It does not matter if you call this before or after the other goroutine has started.

All Transaction methods can be used in any Transaction reference. The Transaction will end when End() is called in any goroutine.

Example passing a new Transaction reference directly to another goroutine:
```
go func(txn newrelic.Transaction) {
    defer newrelic.StartSegment(txn, "async").End()
    time.Sleep(100 * time.Millisecond)
}(txn.NewGoroutine())
```
Example passing a new Transaction reference on a channel to another goroutine:
```
ch := make(chan newrelic.Transaction)
go func() {
    txn := <-ch
    defer newrelic.StartSegment(txn, "async").End()
    time.Sleep(100 * time.Millisecond)
}()
ch <- txn.NewGoroutine()
```
Added integration support for aws-sdk-go and aws-sdk-go-v2.

When using these SDKs, a segment will be created for each out going request. For DynamoDB calls, these will be Datastore segments and for all others they will be External segments.
- v1 Documentation
- v2 Documentation
- Added span event and transaction trace segment attribute configuration. You may control which attributes are captured in span events and transaction trace segments using the Config.SpanEvents.Attributes and Config.TransactionTracer.Segments.Attributes settings. For example, if you want to disable the collection of "db.statement" in your span events, modify your config like this:
```
cfg.SpanEvents.Attributes.Exclude = append(cfg.SpanEvents.Attributes.Exclude,
    newrelic.SpanAttributeDBStatement)
```
To disable the collection of all attributes from your transaction trace segments, modify your config like this:
```
cfg.TransactionTracer.Segments.Attributes.Enabled = false
```

Bug Fixes

Fixed a bug that would prevent External Segments from being created under certain error conditions related to Cross Application Tracing.

Miscellaneous

Improved linking between Cross Application Transaction Traces in the APM UI. When Config.CrossApplicationTracer.Enabled = true, External segments in the Transaction Traces details will now link to the downstream Transaction Trace if there is one. Additionally, the segment name will now include the name of the downstream application and the name of the downstream transaction.
Update attribute names of Datastore and External segments on Transaction Traces to be in line with attribute names on Spans. Specifically:
- "uri" => "http.url"
- "query" => "db.statement"
- "database_name" => "db.instance"
- "host" => "peer.hostname"
- "port_path_or_id" + "host" => "peer.address"

Go agent v2.7

Tue, 26 Mar 2019 00:00:00 +0000

2.7.0

New Features

Added support for server side configuration. Server side configuration allows you to set the following configuration settings in the New Relic APM UI:
- Config.TransactionTracer.Enabled
- Config.ErrorCollector.Enabled
- Config.CrossApplicationTracer.Enabled
- Config.TransactionTracer.Threshold
- Config.TransactionTracer.StackTraceThreshold
- Config.ErrorCollector.IgnoreStatusCodes
For more information see the server side configuration documentation.
Added support for AWS Lambda functions in the new nrlambda package. Please email lambda_preview@newrelic.com if you are interested in learning more or previewing New Relic Lambda monitoring. This instrumentation package requires aws-lambda-go version v1.9.0 or higher.
- Documentation
- Working example

Go agent v2.8.1

Tue, 18 Jun 2019 00:00:00 +0000

2.8.1

Bug Fixes

Removed nrmysql.NewConnector since go-sql-driver/mysql has not yet released mysql.NewConnector.

Go agent v2.8

Tue, 11 Jun 2019 00:00:00 +0000

2.8.0

New Features

Support for Real Time Streaming
- Event data is now sent to New Relic every five seconds, instead of every minute. As a result, transaction, error, and custom events will now be available in New Relic dashboards in near real time. For more information on how to view your events with a five-second refresh, see the real time streaming documentation.
- Note that the overall limits on how many events can be sent per minute have not changed. Also, span events, metrics, and trace data is unaffected, and will still be sent every minute.
Introduce support for databases using database/sql. This new functionality allows you to instrument MySQL, PostgreSQL, and SQLite calls without manually creating DatastoreSegments.

Database Library Supported

Integration Package

go-sql-driver/mysql

_integrations/nrmysql

lib/pq

_integrations/nrpq

mattn/go-sqlite3

_integrations/nrsqlite3

Using these database integration packages is easy! First replace the driver with our integration version:

import (
    // import our integration package
    _ "github.com/newrelic/go-agent/_integrations/nrmysql"
  )

  func main() {
    // open "nrmysql" in place of "mysql"
    db, err := sql.Open("nrmysql", "user@unix(/path/to/socket)/dbname")
  }

Second, use the ExecContext, QueryContext, and QueryRowContext methods of sql.DB, sql.Conn, sql.Tx, and sql.Stmt and provide a transaction-containing context. Calls to Exec, Query, and QueryRow do not get instrumented.

ctx := newrelic.NewContext(context.Background(), txn)
  row := db.QueryRowContext(ctx, "SELECT count(*) from tables")

If you are using a database/sql database not listed above, you can write your own instrumentation for it using InstrumentSQLConnector, InstrumentSQLDriver, and SQLDriverSegmentBuilder. The integration packages act as examples of how to do this.

For more information, see the Go agent documentation on instrumenting datastore segments.

Bug Fixes

The http.RoundTripper returned by NewRoundTripper no longer modifies the request. Our thanks to @jlordiales for the contribution.

Go agent v2.9.0

Wed, 10 Jul 2019 00:00:00 +0000

2.9.0

New Features

Added support for gRPC monitoring with the new _integrations/nrgrpc package. This package supports instrumentation for servers and clients.
- Server Example
- Client Example
Added new ExternalSegment fields Host, Procedure, and Library. These optional fields are automatically populated from the segment's URL or Request if unset. Use them if you don't have access to a request or URL but still want useful external metrics, transaction segment attributes, and span attributes.
- Host is used for external metrics, transaction trace segment names, and span event names. The host of segment's Request or URL is the default.
- Procedure is used for transaction breakdown metrics. If set, it should be set to the remote procedure being called. The HTTP method of the segment's Request is the default.
- Library is used for external metrics and the "component" span attribute. If set, it should be set to the framework making the call. "http" is the default.
With the addition of these new fields, external transaction breakdown metrics are changed: External/myhost.com/all will now report as External/myhost.com/http/GET (provided the HTTP method is GET).
HTTP Response codes below 100, except 0 and 5, are now recorded as errors. This is to support gRPC status codes. If you start seeing new status code errors that you would like to ignore, add them to Config.ErrorCollector.IgnoreStatusCodes or your server side configuration settings.
Improve logrus support by introducing nrlogrus.Transform, a function which allows you to turn a logrus.Logger instance into a newrelic.Logger. Example use:
```
l := logrus.New()
l.SetLevel(logrus.DebugLevel)
cfg := newrelic.NewConfig("Your Application Name", "__YOUR_NEW_RELIC_LICENSE_KEY__")
cfg.Logger = nrlogrus.Transform(l)
```
As a result of this change, the nrlogrus package requires logrus version v1.1.0 and above.

Go agent v3.12.0

Mon, 03 May 2021 00:00:00 +0000

3.12.0

Changes

Updated CHANGELOG.md release notes language, to correct typographical errors and clean up grammar. #289

Fixed

When using DAX to query a dynamodb table, the New Relic instrumentation panics with a nil dereference error. This was due to the way that the request is made internally such that there is no HTTPRequest.Header defined, but one was expected. This correction checks for the existence of that header and takes an appropriate course of action if one is not found. #287 Thanks to @odannyc for reporting the issue and providing a pull request with a suggested fix.

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.

Go agent v3.13.0

Wed, 02 Jun 2021 00:00:00 +0000

3.13.0

Fixed

Replaced the NR AWS SDK V2 integration for the v3 agent with a new version that works. See the v3/integrations/nrawssdk-v2/example/main.go file for an example of how to use it. Issues #250 and #288 are fixed by this PR. #309
Fixes issue #221: grpc errors reported in code watched by UnaryServerInterceptor() or StreamServerInterceptor() now create error events which are reported to the UI with the error message string included. #317
Fixes documentation in GUIDE.md for txn.StartExternalSegment() to reflect the v3 usage. Thanks to @abeltay for calling this to our attention and submitting PR #320.

Changes

The v3/examples/server/main.go example now uses newrelic.ConfigFromEnvironment(), rather than explicitly pulling in the license key with newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")). The team is starting to use this as a general systems integration testing script, and this facilitates testing with different settings enabled.

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.

Go agent v3.14.1

Tue, 20 Jul 2021 00:00:00 +0000

3.14.1

Fixed

A typographical error in the nrgrpc unit tests was fixed. Fixes Issue #344. This updates the nrgrpc integration to version 1.3.1.

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.

Go agent v3.14.0

Mon, 12 Jul 2021 00:00:00 +0000

3.14.0 Fixed

Integration tags and go.mod files for integrations were updated so that pkg.go.dev displays the documentation for each integration correctly.
The nrgrpc server integration was reporting all non-OK grpc statuses as errors. This has now been changed so that only selected grpc status codes will be reported as errors. Others are shown (via transaction attributes) as "warnings" or "informational" messages. There is a built-in set of defaults as to which status codes are reported at which severity levels, but this may be overridden by the caller as desired. Also supports custom grpc error handling functions supplied by the user.
- This is implemented by adding WithStatusHandler() options to the end of the UnaryServerInterceptor() and StreamServerInterceptor() calls, thus extending the capability of those functions while retaining the existing functionality and usage syntax for backward compatibility.
Added advice on the recommended usage of the app.WaitForConnection() method. Fixes [https://github.com/newrelic/go-agent/issues/296](Issue #296)

Added

Added a convenience function to build distributed trace header set from a JSON string for use with the AcceptDistributedTraceHeaders() method. Normally, you must create a valid set of HTTP headers representing the trace identification information from the other trace so the new trace will be associated with it. This needs to be in a Go http.Header type value.
- If working only in Go, this may be just fine as it is. However, if the other trace information came from another source, possibly in a different language or environment, it is often the case that the trace data is already presented to you in the form of a JSON string.
- This new function, DistributedTraceHeadersFromJSON(), creates the required http.Header value from the JSON string without requiring manual effort on your part.
- We also provide a new all-in-one method AcceptDistributedTraceHeadersFromJSON() to be used in place of AcceptDistributedTraceHeaders(). It accepts a JSON string rather than an http.Header, adding its trace info to the new transaction in one step.
- Fixes [https://github.com/newrelic/go-agent/issues/331](Issue #331)

Changed

Improved the NR AWS SDK V2 integration to use the current transaction rather than the one passed in during middleware creation, if nil is passed into nrawssdk-v2.AppendMiddlewares. Thanks to @HenriBeck for noticing and suggesting improvement, and thanks to @nc-wittj for the fantastic PR! #328

Support Statement

Go agent v3.15.1

Wed, 27 Oct 2021 00:00:00 +0000

3.15.1

Fixed

Updated support for SQL database instrumentation across the board for the Go Agent’s database integrations to more accurately extract the database table name from SQL queries. Fixes Issue #397.
Updated the go.mod file in the nrecho-v4 integration to require version 4.5.0 of the github.com/labstack/echo package. This addresses a security concern arising from downstream dependencies in older versions of the echo package, as described in the release notes for echo v4.5.0.

ARM64 Compatibility Note

The New Relic Go Agent is implemented in platform-independent Go, and supports (among the other platforms which run Go) ARM64/Graviton2 using Go 1.17+.

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.

Go agent v3.15.2

Mon, 06 Dec 2021 00:00:00 +0000

3.15.2

Added

Strings logged via the Go agent's built-in logger will have strings of the form license_key=hex-string changed to license_key=[redacted] before they are output, regardless of severity level, where hex-string means a sequence of upper- or lower-case hexadecimal digits and dots ('.'). This incorporates PR #415.

Support Statement

Go agent v3.15.0

Thu, 02 Sep 2021 00:00:00 +0000

3.15.0

Fixed

Updated mongodb driver version to 1.5.1 to fix security issue in external dependency. Fixes Issue #358 and Issue #370.
Updated the go.mod file in the nrgin integration to require version 1.7.0 of the github.com/gin-gonic/gin package. This addresses CVE-2020-28483 which documents a vulnerability in versions of github.com/gin-gonic/gin earlier than 1.7.0.

Added

New integration nrpgx added to provide the same functionality for instrumenting Postgres database queries as the existing nrpq integration, but using the pgx driver instead. This only covers (at present) the use case of the pgx driver with the standard library database/sql. Fixes Issue #142 and Issue #292

Changed

Enhanced debugging logs so that New Relic license keys are redacted from the log output. Fixes Issue #353.
Updated the advice in GUIDE.md to have correct go get commands with explicit reference to v3.

Support Statement

Go agent v3.16.0

Thu, 19 May 2022 00:00:00 +0000

3.16.0

Added

Distributed Tracing is now the default mode of operation. It may be disabled by user configuration if so desired. PR #495
- To disable DT, add newrelic.ConfigDistributedTracerEnabled(false) to your application configuration.
- To change the reservoir limit for how many span events are to be collected per harvest cycle from the default, add newrelic.ConfigDistributedTracerReservoirLimit(newlimit) to your application configuration.
- The reservoir limit's default was increased from 1000 to 2000.
- The maximum reservoir limit supported is 10,000.
Note that Cross Application Tracing is now deprecated.
Added support for gathering memory statistics via PhysicalMemoryBytes functions for OpenBSD.

Fixed

Corrected some example code to be cleaner.
Updated version of nats-streaming-server. PR #458
Correction to nrpkgerrors so that nrpkgerrors.Wrap now checks if the error it is passed has attributes, and if it does, copies them into the New Relic error it creates. This fixes issue #409 via PR #441.
- This increments the nrpkgerrors version to v1.1.0.

Support Statement

Go agent v3.16.1

Thu, 26 May 2022 00:00:00 +0000

3.16.1

Fixed

Changed dependency on gRPC from v1.27.0 to v1.39.0. This in turn changes gRPC's dependency on x/crypto to v0.0.0-20200622213623-75b288015ac9, which fixes a security vulnerability in the x/crypto standard library module. Fixes issue #451.
Incremented version number of the nrawssdk-v1 integration from v1.0.1 to v1.1.0 to resolve an incompatibility issue due to changes to underlying code. Fixes issue #499

Support Statement

Go agent v3.17.0

Wed, 29 Jun 2022 00:00:00 +0000

3.17.0

Added

Logs in context now supported for zerolog.
This is a quick way to view logs no matter where you are in the platform.
- Adds support for logging metrics which shows the rate of log messages by severity in the Logs chart in the APM Summary view. This is enabled by default in this release.
- Adds support for forwarding application logs to New Relic. This automatically sends application logs that have been enriched to power APM logs in context. This is disabled by default in this release. This will be on by default in a future release.
- To learn more about APM logs in context see the documentation here.
- Includes the RecordLog function for recording log data from a single log entry
- An integrated plugin for zerolog to automatically ingest log data with the Go Agent.
- Resolves issue 178, issue 488, issue 489, issue 490, and issue 491 .
Added integration for MS SQL Server (PR 425; thanks @ishahid91!)
- This introduces the nrmssql integration v1.0.0.
Added config function ConfigCustomInsightsEventsMaxSamplesStored for limiting the number of samples stored in a custom insights event. Fixes issue 476

Fixed

Improved speed of building distributed trace header JSON payload. Fixes issue 505.
Renamed the gRPC attribute names from GrpcStatusLevel, GrpcStatusMessage, and GrpcStatusCode to grpcStatusLevel, grpcStatusMessage, and grpcStatusCode respectively, to conform to existing naming conventions for New Relic agents. Fixes issue 492.
Updated go.mod for the nrgin integration to mitigate security issue in 3rd party dependency.
Updated go.mod for the nrawssdk-v1 integration to properly reflect its dependency on version 3.16.0 of the Go Agent.
Updated go.mod for the nrlambda integration to require aws-lambda-go version 1.20.0. (PR 356; thanks MattWhelan!)

Support Statement

Note that the oldest supported version of the Go Agent is 2.11.0.

Go agent v3.18.0

Mon, 01 Aug 2022 00:00:00 +0000

3.18.0

Added

Code-level metrics are now available for instrumented transactions. This is off by default but once enabled via ConfigCodeLevelMetricsEnabled(true) transactions will include information about the location in the source code where StartTransaction was invoked.
- Adds information about where in your source code transaction traces originated.
- See the Go agent documentation for details on configuring code-level metrics and how to instrument your code using them.
New V2 logs-in-context plugin is available for Logrus, packed with all the features you didn't know you wanted:
- Automatic log forwarding
- Log metrics
- Capture logs anywhere in your code; both inside or outside of a transaction.
- Use the Logrus formatting package of your choice
- Local log decorating is now available for the new logcontext-v2/nrlogrus plugin only. This is off by default but can be enabled with ConfigAppLogForwardingEnabled(true).

Fixed

Fixed issue with custom event limits and number of distributed tracing spans to more accurately follow configured limits.

Compatibility Notice

This release extends the API by allowing custom options to be added to calls to the Application.StartTransaction method and the WrapHandle and WrapHandleFunc functions. They are implemented as variadic functions such that the new option parameters are optional (i.e., zero or more options may be added to the end of the function calls) to be backward-compatible with pre-3.18.0 usage of those functions. This prevents the changes from breaking existing code for typical usage of the agent. However, it does mean those functions' call signatures have changed:

StartTransaction(string) -> StartTransaction(string, ...TraceOption)
WrapHandle(*Application, string, http.Handler) -> WrapHandle(*Application, string, http.Handler, ...TraceOption)
WrapHandleFunc(*Application, string, func(http.ResponseWriter, *http.Request)) -> WrapHandleFunc(*Application, string, func(http.ResponseWriter, *http.Request), ...TraceOption)

If, for example, you created your own custom interface type which includes the StartTransaction method or something that depends on these functions' exact call semantics, that code will need to be updated accordingly before using version 3.18.0 of the Go Agent.

Support Statement

Note that the oldest supported version of the Go agent is 2.11.0.

Go agent v3.18.1

Thu, 18 Aug 2022 00:00:00 +0000

3.18.1

Added

Extended the IgnoredPrefix configuration value for Code-Level Metrics so that multiple such prefixes may be given instead of a single one. This deprecates the IgnoredPrefix configuration field of Config.CodeLevelMetrics in favor of a new slice field IgnoredPrefixes. The corresponding configuration option-setting functions ConfigCodeLevelMetricsIgnoredPrefix and WithIgnoredPrefix now take any number of string parameters to set these values. Since those functions used to take a single string value, this change is backward-compatible with pre-3.18.1 code. Accordingly, the NEW_RELIC_CODE_LEVEL_METRICS_IGNORED_PREFIX environment variable is now a comma-separated list of prefixes. Fixes Issue #551.

Fixed

Corrected some small errors in documentation of package features. Fixes Issue #550

Compatibility Notice

As of release 3.18.0, the API was extended by allowing custom options to be added to calls to the Application.StartTransaction method and the WrapHandle and WrapHandleFunc functions. They are implemented as variadic functions such that the new option parameters are optional (i.e., zero or more options may be added to the end of the function calls) to be backward-compatible with pre-3.18.0 usage of those functions. This prevents the changes from breaking existing code for typical usage of the agent. However, it does mean those functions' call signatures have changed:

StartTransaction(string) -> StartTransaction(string, ...TraceOption)
WrapHandle(*Application, string, http.Handler) -> WrapHandle(*Application, string, http.Handler, ...TraceOption)
WrapHandleFunc(*Application, string, func(http.ResponseWriter, *http.Request)) -> WrapHandleFunc(*Application, string, func(http.ResponseWriter, *http.Request), ...TraceOption)

Support Statement

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

Go agent v3.18.2

Wed, 07 Sep 2022 00:00:00 +0000

3.18.2

Added

Added WithDefaultFunctionLocation trace option. This allows the caller to indicate a fall-back function to use for CLM in case no other location was found first.
Added caching versions of the code-level metrics functions ThisCodeLocation and FunctionLocation , and trace options WithThisCodeLocation and WithFunctionLocation. These improve performance by caching the result of computing the source code location, and reuse that cached result on all subsequent calls.
Added a WithCodeLevelMetrics trace option to force the collection of CLM data even if it would have been excluded as being out of the configured scope. (Note that CLM data are never collected if CLM is turned off globally or if the WithoutCodeLevelMetrics option was specified for the same transaction.)
Added an exported CodeLevelMetricsScopeLabelToValue function to convert a list of strings describing CLM scopes in the same manner as the NEW_RELIC_CODE_LEVEL_METRICS_SCOPE environment variable (but as individual string parameters), returning the CodeLevelMetricsScope value which corresponds to that set of scopes.
Added a new CodeLevelMetricsScopeLabelListToValue function which takes a comma-separated list of scope names exactly as the NEW_RELIC_CODE_LEVEL_METRICS_SCOPE environment variable does, and returns the CodeLevelMetrics value corresponding to that set of scopes.
Added text marshaling and unmarshaling for the CodeLevelMetricsScope value, allowing the CodeLevelMetrics field of the configuration struct to be converted to or from JSON or other text-based encoding representations.

Changed

The WithPathPrefix trace option now takes any number of string parameters, allowing multiple path prefixes to be recognized rather than just one.
The FunctionLocation function now accepts any number of function values instead of just a single one. The first such parameter which indicates a valid function, and for which CLM data are successfully obtained, is the one which will be reported.
The configuration struct field PathPrefix is now deprecated with the introduction of a new PathPrefixes field. This allows for multiple path prefixes to be given to the agent instead of only a single one.
The NEW_RELIC_CODE_LEVEL_METRICS_SCOPE environment variable now accepts a comma-separated list of pathnames.

Fixed

Improved the implementation of CLM internals to improve speed, robustness, and thread safety.
Corrected the implementation of the WrapHandle and WrapHandleFunc functions so that they consistently report the function being invoked by the http framework, and improved them to use the new caching functions and ensured they are thread-safe.

This release fixes issue #557.

Compatibility Notice

StartTransaction(string) -> StartTransaction(string, ...TraceOption)
WrapHandle(*Application, string, http.Handler) -> WrapHandle(*Application, string, http.Handler, ...TraceOption)
WrapHandleFunc(*Application, string, func(http.ResponseWriter, *http.Request)) -> WrapHandleFunc(*Application, string, func(http.ResponseWriter, *http.Request), ...TraceOption)

Support Statement

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

Go agent v3.19.0

Thu, 15 Sep 2022 00:00:00 +0000

3.19.0

Added

logcontext-v2/logWriter plugin: a new logs in context plugin that supports the standard library logging package.
logcontext-v2/zerologWriter plugin: a new logs in context plugin for zerolog that will replace the old logcontext-v2/zerolog plugin. This plugin is more robust, and will be able to support a richer set of features than the previous plugin.
see the updated logs in context documentation for information about configuration and installation.

Changed
the logcontext-v2/zerolog plugin will be deprecated once the 3.17.0 release EOLs.

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.

Go agent v3.19.1

Fri, 16 Sep 2022 00:00:00 +0000

3.19.1 - Hotfix Release

Changed

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

Support Statement

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

Go agent v3.19.2

Wed, 21 Sep 2022 00:00:00 +0000

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

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.

Go agent v3.20.1

Tue, 15 Nov 2022 00:00:00 +0000

3.20.1

We recommend updating to the latest agent version as soon as it’s available. If your organization has established practices that prevent you from upgrading to the latest version, ensure that your agents are regularly updated to a version at most 90 days old. Read more about keeping your agent up to date.

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.

Go agent v3.20.2

Wed, 14 Dec 2022 00:00:00 +0000

3.20.2

We recommend updating to the latest agent version as soon as it’s available. If your organization has established practices that prevent you from upgrading to the latest version, ensure that your agents are regularly updated to a version that's at most 90 days old. Read more about keeping your agent up to date.

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

Go agent v3.20.0

Wed, 02 Nov 2022 00:00:00 +0000

3.20.0

PLEASE READ these changes, and verify your config settings to ensure your application behaves how you intend it to. This release changes some default behaviors in the go agent.

Added

The Module Dependency Metrics feature was added. This collects the list of modules imported into your application, to aid in management of your application dependencies, enabling easier vulnerability detection and response, etc.
- This feature is enabled by default, but may be disabled by explicitly including ConfigModuleDependencyMetricsEnable(false) in your application, or setting the equivalent environment variable or Config field direclty.
- Modules may be explicitly excluded from the report via the ConfigModuleDependencyMetricsIgnoredPrefixes option.
- Excluded module names may be redacted via the ConfigModuleDependencyMetricsRedactIgnoredPrefixes option. This is enabled by default.
Application Log Forwarding will now be ENABLED by default
- Automatic application log forwarding is now enabled by default. This means that logging frameworks wrapped with one of the logcontext-v2 integrations will automatically send enriched application logs to New Relic with this version of the agent. To learn more about this feature, see the APM logs in context documentation. For additional configuration options, see the Go logs in context documentation. To learn about how to toggle log ingestion on or off by account, see our documentation to disable automatic logging via the UI or API.
- If you are using a logcontext-v2 extension, but don't want the agent to automatically forward logs, please configure ConfigAppLogForwardingEnabled(false) in your application.
- Environment variables have been added for all application logging config options:
  - 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
Custom Event Limit Increase
- This version increases the DEFAULT limit of custom events from 10,000 events per minute to 30,000 events per minute. In the scenario that custom events were being limited, this change will allow more custom events to be sent to New Relic. There is also a new configurable MAXIMUM limit of 100,000 events per minute. To change the limits, set ConfigCustomInsightsEventsMaxSamplesStored(limit) to the limit you want in your application. To learn more about the change and how to determine if custom events are being dropped, see our Explorers Hub post.
- New config option ConfigCustomInsightsEventsEnabled(false) can be used to disable the collection of custom events in your application.

Changed

Changed the following names 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.
- 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
When excluding information reported from CodeLevelMetrics via the IgnoredPrefixes or PathPrefixes configuration fields (e.g., by specifying ConfigCodeLevelMetricsIgnoredPrefixes or ConfigCodeLevelMetricsPathPrefixes), the names of the ignored prefixes and the configured path prefixes may now be redacted from the agent configuration information sent to New Relic.
- This redaction is enabled by default, but may be disabled by supplying a false value to ConfigCodeLevelMetricsRedactPathPrefixes or ConfigCodeLevelMetricsRedactIgnoredPrefixes, or by setting the corresponding Config fields or environment variables to false.

Fixed

#583: fixed a bug in zerologWriter where comma separated fields in log message confused the JSON parser and could cause panics.

Support Statement

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.

Go agent v3.20.3

Thu, 19 Jan 2023 00:00:00 +0000

We recommend updating to the latest agent version as soon as it's available. If your organization has established practices that prevent you from upgrading to the latest version, ensure that your agents are regularly updated to a version at most 90 days old. Read more about keeping your agent up to date.

3.20.3

Please note that the v2 go agent is no longer supported according to our EOL policy.

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.

Go agent v3.21.0

Thu, 30 Mar 2023 00:00:00 +0000

We recommend updating to the latest agent version as soon as it's available. If your organization has established practices that prevent you from upgrading to the latest version, ensure that your agents are regularly updated to a version that's at most 90 days old. Read more about keeping your agent up to date.

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.

Go agent v3.21.1

Thu, 27 Apr 2023 00:00:00 +0000

We recommend updating to the latest agent version as soon as it's available. If your organization has established practices that prevent you from upgrading to the latest version, ensure that your agents are regularly updated to a version that's at most 90 days old. Read more about keeping your agent up to date.

3.21.1

Added

nrredis-v9: automatic instrumentation for Go redis v9

Fixed

Agent now requires Go version 1.18 or higher.
Removed support for Go version 1.17. This version of Go is outside of the support window.

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.

Go agent v3.20.4

Thu, 09 Mar 2023 00:00:00 +0000

We recommend updating to the latest agent version as soon as it's available. If your organization has established practices that prevent you from upgrading to the latest version, ensure that your agents are regularly updated to a version that's at most 90 days old. Read more about keeping your agent up to date.

3.20.4

Please note that the v2 Go agent is no longer supported according to our EOL policy.

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.

Go agent v3.22.0

Thu, 01 Jun 2023 00:00:00 +0000

We recommend updating to the latest agent version as soon as it's available. If your organization has established practices that prevent you from upgrading to the latest version, ensure that your agents are regularly updated to a version that's at most 90 days old. Read more about keeping your agent up to date.

3.22.0

Added

New Apache Kafka integration nrsarama that instruments the Sarama library https://github.com/Shopify/sarama
New logs in context integration logcontext-v2/nrzap that instruments the zap logging framework https://github.com/uber-go/zap
Integration tests created for the nrlogrus and nrzapintegrations
Updated integration tests for nrlogxi

Security Fixes

Bumped sys package to v0.1.0 in the nrmssql integration
Bumped net package to v0.7.0 in the nrgrpc, nrmssql , and nrnats integrations
Bumped aws-sdk-go package to v1.34.0 in the nrawssdk-v1 integration
Bumped text package to v0.3.8 in the nrnats, and nrpgx integrations
Bumped gin package to v1.9.0 in the nrgin integration
Bumped crypto package to v0.1.0 in the nrpgx integration
Fixed integration tests in nrnats package not correctly showing code coverage

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.

Go agent v3.22.1

Fri, 02 Jun 2023 00:00:00 +0000

We recommend updating to the latest agent version as soon as it's available. If your organization has established practices that prevent you from upgrading to the latest version, ensure that your agents are regularly updated to a version that's at most 90 days old. Read more about keeping your agent up to date.

3.22.1

Fixed

Corrects an error in the release process for 3.22.1.

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.

Go agent v3.23.0

Tue, 20 Jun 2023 00:00:00 +0000

We recommend updating to the latest agent version as soon as it's available. If your organization has established practices that prevent you from upgrading to the latest version, ensure that your agents are regularly updated to a version that's at most 90 days old. Read more about keeping your agent up to date.

3.23.0

Adds the nrsecurityagent integration for performing Interactive Application Security Testing (IAST) of your application.

To learn how to use IAST, check out our documentation.

Support statement

We use the latest version of Go. 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.

Go agent v3.23.1

Wed, 28 Jun 2023 00:00:00 +0000

We recommend updating to the latest agent version as soon as it's available. If your organization has established practices that prevent you from upgrading to the latest version, ensure that your agents are regularly updated to a version that's at most 90 days old. Read more about keeping your agent up to date.

3.23.1

Added

Added newrelic.ConfigDatastoreRawQuery(true) configuration option to allow raw SQL queries to appear in new relic dashboards
Added enriched serverless debug logging for faster debugging

Fixed

Removed timeouts on two tests in trace_observer_test.go
Bumped nrnats test to go1.19
Bumped graphql-go to v1.3.0 in the nrgraphgophers integration
Added license file to nrsecurityagent integration

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 (i.e., Go versions 1.19 and later are supported).

We recommend updating to the latest agent version as soon as it's available. If you can't upgrade to the latest version, update your agents to a version no more than 90 days old. Read more about keeping agents up to date. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

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

Go agent v3.24.0

Mon, 31 Jul 2023 00:00:00 +0000

We recommend updating to the latest agent version as soon as it's available. If your organization has established practices that prevent you from upgrading to the latest version, ensure that your agents are regularly updated to a version that's at most 90 days old. Read more about keeping your agent up to date.

3.24.0

Added

Turned Code Level Metrics on by default
Added new test case to check if the nrsecurityagent is enabled in the gRPC integration
Added new test case for InfoInterceptorStatusHandler function in the gRPC integration
Added Name() method for Transaction values to get the current transaction name.

Fixed

Bumped gin from 1.9.0 to 1.9.1
Bumped gosnowflake from 1.6.16 to 1.6.19
Bumped nrsecurityagent to 1.1.0 with improved reporting of gRPC protocol versions.
Fixed a bug where expected errors weren't being properly marked as expected on new relic dashboards

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

Go agent v3.24.1

Thu, 10 Aug 2023 00:00:00 +0000

We recommend updating to the latest agent version as soon as it's available. If your organization has established practices that prevent you from upgrading to the latest version, ensure that your agents are regularly updated to a version that's at most 90 days old. Read more about keeping your agent up to date.

3.24.1

Fixed

Performance improvement around calls to the security agent. In some cases, unnecessary setup operations were being performed even if there was no security agent present to use that. These are now conditional on the security agent being present in the application (note that this will enable the setup code if the security agent is present in the application, regardless of whether it’s currently enabled to run). This affects:
- Base agent code (updated to v3.24.1)
- nrmongo integration (updated to v1.1.1)
Fixed unit tests for integrations that were failing because code-level metrics are enabled by default now:
- nrawssdk-v1 (updated to v1.1.2)
- nrawssdk-v2 (updated to v1.2.2)
- nrecho-v3 (updated to v1.0.2)
- nrecho-v4 (updated to v1.0.4)
- nrhttprouter (updated to v1.3.0)
- nrlambda (updated to v1.2.2)
- nrnats (updated to v1.1.5)
- nrredis-v8 (updated to v1.0.1)

Changed

Updated all integration go.mod files to reflect supported Go language versions.

Support statement

We use the latest version of the Go language. At a minimum, you should be using no version of Go older than what is supported by the Go team themselves (i.e., Go versions 1.19 and later are supported). We recommend updating to the latest agent version as soon as it’s available. If you can’t upgrade to the latest version, update your agents to a version no more than 90 days old. Read more about keeping agents up to date. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/) See the Go agent EOL Policy for details about supported versions of the Go agent and third-party components.

Go agent v3.25.0

Mon, 18 Sep 2023 00:00:00 +0000

This release was retracted. Use 3.25.1 instead.

Support statement

We use the latest version of the Go language. At a minimum, you should be using no version of Go older than what is supported by the Go team themselves (for exmample, Go versions 1.19 and later are supported).

We recommend updating to the latest agent version as soon as it's available. If you can't update to the latest version, update your agents to a version no more than 90 days old. Read more about keeping agents up to date.

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

Go agent v3.27.0

Thu, 19 Oct 2023 00:00:00 +0000

We recommend updating to the latest agent version as soon as it's available. If your organization has established practices that prevent you from updating to the latest version, ensure that your agents are regularly updated to a version that's at most 90 days old. Read more about keeping your agent up to date.

3.27.0

Added

Added Support for getting Container ID's from cgroup v2 docker containers
A new instrumentation package for RabbitMQ with distributed tracing support: nramqp

Fixed
Unit tests repairs and improvements
Removed deprecated V2 code from the repository. The support timeframe for this code has expired and is no longer recommended for use.
Bumped github.com/graphql-go/graphql from 0.7.9 to 0.8.1

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.

Go agent v3.25.1

Mon, 18 Sep 2023 00:00:00 +0000

3.25.1

Added

Added support for the FastHTTP package:
- Added newrelic.WrapHandleFuncFastHTTP() and newrelic.StartExternalSegmentFastHTTP() functions to instrument fasthttp context and create wrapped handlers. These functions work similarly to the existing ones for net/http.
- Added client-fasthttp and server-fasthttp examples to help get started with FastHTTP integration.

Fixed

Corrected a bug where the security agent failed to correctly parse the NEW_RELIC_SECURITY_AGENT_ENABLED environment variable.

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.

Go agent v3.26.0

Thu, 28 Sep 2023 00:00:00 +0000

3.26.0

Added

Extended implementation of the nrpgx5 integration (now v1.2.0). This instruments Postgres database operations using the jackc/pgx/v5 library, including the direct access mode of operation as opposed to requiring code to use the library compatible with the standard database/sql library.

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.

Go agent v3.28.1

Thu, 30 Nov 2023 00:00:00 +0000

We recommend updating to the latest agent version as soon as it's available. If your organization has established practices that prevent you from upgrading to the latest version, ensure that your agents are regularly updated to a version that's at most 90 days old. Read more about keeping your agent up to date.

3.28.1

Added

Added Supportability Metrics to nrfasthttp
Always Link Transaction IDs to traces regardless of if Distributed Tracing is enabled or not

Fixed

Fixed an issue where nil Request.Body could be set to non-nil request.Body with zero length when the security agent is enabled

Security

More Secure URL Redaction

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.

Go agent v3.29.0

Thu, 14 Dec 2023 00:00:00 +0000

We recommend updating to the latest agent version as soon as it's available. If your organization's practices prevent you from updating, ensure that your agents are regularly updated to a version that's at most 90 days old. Read more about keeping your agent up to date.

3.29.0

Added

Security agent integration nrsecurityagent now reports security configuraiton information along with the overall Go Agent configuration values. (Updates nrsecurityagent to v1.2.0.)
Code-Level Metrics collection efficiency enhancement allows user callback function for as-needed (and just-in-time) evaluation of custom code locations rather than up-front location overrides, via the WithCodeLocationCallback CLM option. Deprecates WithCodeLocation option (although the latter function is still supported for compatibility with existing code).
Added extended synthetics support for new X-Newrelic-Synthetics-Info HTTP headers.
Documentation fixes.
Removed deprecated ROADMAP.md file.

Support statement

We use the latest version of the Go language. At minimum, you should be using no version of Go older than what's 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.

Go agent v3.28.0

Thu, 16 Nov 2023 00:00:00 +0000

We recommend updating to the latest agent version as soon as it's available. If your organization has established practices that prevent you from upgrading to the latest version, ensure that your agents are regularly updated to a version that's at most 90 days old. Read more about keeping your agent up to date.

3.28.0

Fixed

Bumped gRPC from 1.54.0 -> 1.56.3 in the following packages /v3/integrations/nrgrpc, /v3/, /v3/integrations/nrgrpc
Bumped golang.org/x/net from 0.8.0 -> 0.17.0 in package /v3/integrations/nrgraphqlgo
Fixed issue where nrfasthttp would not properly register security agent headers
Move fasthttp instrumentation into a new integration package, nrfasthttp
Fixed issue where usage of io.ReadAll() was causing a memory leak

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.

Go agent v3.29.1

Thu, 25 Jan 2024 00:00:00 +0000

3.29.1

Added

Added Dockerized Unit Tests for Github Actions

Fixes

Updated version on security agent

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.

Go agent v3.30.0

Thu, 15 Feb 2024 00:00:00 +0000

We recommend updating to the latest agent version as soon as it becomes available. If your organization has established practices that prevent you from updating to the latest version, ensure that you regularly update your agents to a version that's at most 90 days old. Read more about keeping your agent up to date.

3.30.0

Added

Updated the depencency on nrsecurityagent to 1.0.0.
Added new integration, logcontext-v2/nrslog, which instruments logging via the new slog library.

Fixed

Redacts license keys from error reporting.

Support statement

We use the latest version of the Go language. At minimum, you should be using no version of Go older than what the Go team itself supports. See the Go agent EOL Policy for details about supported versions of the Go agent and third-party components.

Go agent v3.31.0

Wed, 27 Mar 2024 00:00:00 +0000

3.31.0

Added

Integration packages to instrument AI model invocations (see below).
- New package nrawsbedrock v1.0.0 introduced to instrument calls to
  Amazon Bedrock
  Runtime Client API InvokeModel and InvokeModelWithResponseStream calls. Also provides a simple one-step method which invokes stream invocations and harvests the response stream data for you.
- New package nropenai v1.0.0 introduced to instrument calls to OpenAI using NRCreateChatCompletion, NRCreateChatCompletionStream, and NRCreateEmbedding calls.
Dockerfile in the examples/server sample app which facilitates the easy creation of a containerized ready-to-run sample app for situations where that makes testing easier.

Fixed

.Ignore was not ignoring transaction. Fixes Issue #845.
Added nil error check in wrap function. Fixes Issue #862.
WrapBackgroundCore background logger was not sending logs to New Relic. Fixes Issue #859.
Corrected pgx5 integration example which caused a race condition. Thanks to @WillAbides! Fixes Issue #855.
Updated third-party library versions due to reported security or other supportability issues:
- github.com/jackc/pgx/v5 to 5.5.4 in nrpgx5 integration
- google.gopang.org/protobuf to 1.33.0 in nrmicro and nrgrpc integrations
- github.com/jackc/pgx/v4 to 4.18.2 in nrpgx integration

AI Monitoring Configuration

New configuration options are available specific to AI monitoring. These settings include:

AIMonitoring.Enabled, configured via ConfigAIMonitoring.Enabled(bool) [default false]
AIMonitoring.Streaming.Enabled, configured via ConfigAIMonitoringStreamingEnabled(bool) [default true]
AIMonitoring.Content.Enabled, configured via ConfigAIMonitoringContentEnabled(bool) [default true]

AI Monitoring Public API Methods

Two new AI monitoring related public API methods have been added, as methods of the newrelic.Application value returned by newrelic.NewApplication:

AI Monitoring

New Relic AI monitoring is the industry’s first APM solution that provides end-to-end visibility for AI Large Language Model (LLM) applications. It enables end-to-end visibility into the key components of an AI LLM application. With AI monitoring, users can monitor, alert, and debug AI-powered applications for reliability, latency, performance, security and cost. AI monitoring also enables AI/LLM specific insights (metrics, events, logs and traces) which can easily integrate to build advanced guardrails for enterprise security, privacy and compliance.

AI monitoring offers custom-built insights and tracing for the complete lifecycle of an LLM’s prompts and responses, from raw user input to repaired/polished responses. AI monitoring provides built-in integrations with popular LLMs and components of the AI development stack. This release provides instrumentation for OpenAI and Bedrock.

When AI monitoring is enabled with ConfigAIMonitoringEnabled(true), the agent will now capture AI LLM related data. This data will be visible under a new APM tab called AI Responses. See our AI Monitoring documentation for more details.

Support statement

Go agent v3.32.0

Thu, 04 Apr 2024 00:00:00 +0000

We recommend updating to the latest agent version as soon as it's available. If your organization has established practices that prevent you from upgrading to the latest version, ensure that your agents are regularly updated to a version that's at most 90 days old. Read more about keeping your agent up to date.

3.32.0

Added

Updates to support for the New Relic security agent to report API endpoints
- Adds new wrapper function for the nrecho, nrgin, and nrgorilla integrations
Handler to take New Relic transaction data from context automatically when using nrslog integration (thanks, @adomaskizogian!)

Fixed

Adds missing license file to the nropenai integration
Changes *bedrockruntime.Client parameters in nrawsbedrock integration to use a more general interface type, allowing the use of custom types which extend the bedrock client type
Fixes pgx5 pool example
Updated unit tests to check Transaction.Ignore
Updated nrzap unit tests to add background logger sugared test case.

Support statement

Go agent v3.33.0

Wed, 01 May 2024 00:00:00 +0000

3.33.0

Added

Support for Zap Field Attributes

Fixed

Fixed an issue where running containers on AWS would falsely flag Azure Utilization
Fixed a typo with nrecho
Changed nrslog example to use a context-driven handler

Support statement

We use the latest version of the Go language. At a 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.

Go agent v3.34.0

Thu, 01 Aug 2024 00:00:00 +0000

We recommend updating to the latest agent version as soon as it's available. If your organization has established practices that prevent you from upgrading to the latest version, ensure that your agents are regularly updated to a version that's at most 90 days old. Read more about keeping your agent up to date.

3.34.0

Added

logcontext-v2/nrlogrus can now collect user attributes
logcontext-v2/nrslog can now collect user attributes
Use slog to manage Go agent logs with the new nrslog library
Use zerolog go manage Go agent logs with the new nrzerolog library
Support for RegisterTLSConfig in nrmysql

Fixed

logcontext-v2/nrlogrus will still print user logs without issues if the Go agent has already been shut down
Switched protobuff to google.golang.org/protobuff in modfile

Support statement

We use the latest version of the Go language. At a minimum, you should use no version of Go older than what's 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.

Go agent v3.33.1

Tue, 02 Jul 2024 00:00:00 +0000

We recommend updating to the latest agent version as soon as it's available. If your organization has established practices that prevent you from upgrading to the latest version, ensure that your agents are regularly updated to a version that's at most 90 days old. Read more about keeping your agent up to date.

3.33.1

Added

Increased max span events default limit to 2,000 to align with agent specifications.
Updated support for latest New Relic security agent release.
Added support for gRPC API endpoints and HTTP status codes in the nrsecurity integration.
Added feature to detect route of an incoming request for all supported frameworks in the nrsecurity integration.

Fixed

Fixed an issue with nrzap attributes not properly being forwarded.
Improved comments on nropenai.
Fixed a minor bug relating to ExpectStatusCodes in app_run.go.

Support statement

Go agent v3.35.0

Thu, 10 Oct 2024 00:00:00 +0000

3.35.0

Added

Enhanced security features (adds support for secure cookie even reporting)
- Enables sharing of response headers with the csec-security-agent.
Now uses error.Error() value for log attributes
- Thanks to @ejsolberg for the PR
nramqp integration cloud services entity relationship changes
- Enhances url support for amqp server connections

Fixed

nrawssdk-v2 integration examples of AppendMiddlewares corrected.
- Thanks to @Meroje for the PR
Zerolog integration correction to example program import statement.
- Fixes issue #950
Zerolog integration JSON parser bug caused a runtime panic in some circumstances.
- Fixes issue #955
Fixed handling of panic(nil). This was made necessary by changes introducted to Go as of 1.21.
A race condition was possible due to code level metrics accesses to a contended memory address.
- Fixes issue #949
- Fixes issue #957
Integer size issues flagged when converting unsigned to signed values.
Workflow corrections for CI processes in github.
- Fixes issue #946
Updated to use latest grpc and protobuf versions.

Support statement

Go agent v3.35.1

Thu, 24 Oct 2024 00:00:00 +0000

3.35.1

Fixed

Security agent bug hotfix: Don't update the security agent until the Go agent has completed its connect process PR
Faster Trace ID generation
- Community member @ankon contributed this change

Support statement

Go agent v3.37.0

Wed, 26 Feb 2025 00:00:00 +0000

We recommend updating to the latest agent version as soon as it's available. If your organization has established practices that prevent you from upgrading to the latest version, ensure that your agents are regularly updated to a version that's at most 90 days old. Read more about keeping your agent up to date.

3.37.0

Added

Implemented a new approach to integrating New Relic with SLOG that is more lightweight, out of the way, and collects richer data. These changes have been constructed to be completely backwards-compatible with v1 of nrslog. Changes include:
- Wrapping slog.Handler objects with errors to allow users to handle invalid use cases
- A complete rework of log enrichment so that New Relic linking metadata does not invalidate JSON, BSON, or YAML scanners. This new approach will instead inject the linking metadata as a key-value pair.
- Complete support for With(), WithGroup(), and attributes for automatic instrumentation.
- Performance operations.
- Robust testing (close to 90% coverage).
- This updates logcontext-v2/nrslog to v1.4.0.
Now custom application tags (labels) may be added to all forwarded log events.
- Enabled if ConfigAppLogForwardingLabelsEnabled(true) or NEW_RELIC_APPLICATION_LOGGING_FORWARDING_LABELS_ENABLED=TRUE
- May exclude labels named in ConfigAppLogForwardingLabelsExclude("label1","label2",...) or NEW_RELIC_APPLICATION_LOGGING_FORWARDING_LABELS_EXCLUDE="label1,label2,..."
- Labels are defined via ConfigLabels(...) or NEW_RELIC_LABELS
Added memory allocation limit detection/response mechanism to facilitate calling custom functions to perform application-specific resource management functionality, report custom metrics or events, or take other appropriate actions, in response to rising heap memory size.

Support statement

Go agent v3.36.0

Thu, 16 Jan 2025 00:00:00 +0000

3.36.0

Enhanced

Internal improvements to securityagent integration to better support trace handling and other support for security analysis of applications under test, now v1.3.4; affects the following other integrations:
- nrecho, now v1.1.4
- nrecho-v4, now v1.1.3
- nrgin, now v1.3.3
- nrgorilla, now v1.2.3
- nrgraphqlgo, now v1.0.2
- nrhttprouter, now v1.1.3

Fixed

Added missing license files.
Fixed module dependencies in nrgrpc integration, now v1.4.5
Corrects handling of panic(nil) to no longer try to keep pre-Go-1.21 behavior but to allow newer language semantics for that condition. Fixes issue 975.

Go agent v3.38.0

Thu, 20 Mar 2025 00:00:00 +0000

3.38.0

Added

Added new integration nrgochi v1.0.0 for support for go-chi library
Added IsEnded() method for the Transaction type. Allowing for a straightforward approach to checking if a transaction has ended
- Community Member @frknikiz contributed to this solution

Fixed

Added caveat to API docs about local log decoration in zap integration

Support statement

Go agent v3.39.0

Thu, 08 May 2025 00:00:00 +0000

3.39.0

Added

Added nrfiber integration for go fiber framework
- Thank you to community member @MitulShah1 for contributing to this solution
Updated nrslog example with new API
- Thank you to community member @frankywahl for contributing to this solution
Add Optional Path Filtering Function to nrgin Middleware
- Thank you to community member @frknikiz for contributing to this solution
Added ConfigDatastoreKeysEnabled to nrreddis integration allowing for reporting the names of keys along with the datastore operations
Switched GitHub Action Testing Suite from an Emulated ARM layer to Native ARM layers
Added support for time objects for attribute values for nrslog

Fixed

Fixed linking metadata location in log messages

Support statement

Go agent v3.40.0

Wed, 16 Jul 2025 00:00:00 +0000

3.40.0

Added

Added txn.IgnoreApdex() function to ignore Apdex score for a given transaction
Added Custom Attributes via environment variables NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CUSTOM_ATTRIBUTES
Added nrconnect integration for connect library. Connect is a slim library for building browser and gRPC-compatible HTTP APIs
- Thank you to community member @castaneai for contributing to this solution
Added nrmongo-v2 integration supporting the mongodb-v2 library
Overhauled GitHub Actions Test Suite
- Added dockerized database support for mongodb and pgx5 integrations

Fixed

Enhanced query parameter representation in nrpgx5 integration
Fixed a bug where a race condition would occur in identifying container utilization.
Capture DynamoDB table name and index name in DatastoreSegment
- Thank you to community member @rittneje for contributing to this solution
Updated third-party library versions due to reported security or other supportability issues:
- github.com/gofiber/fiber/v2 to 2.52.7 in nrfiber integration
- github.com/go-chi/chi/v5 to 5.2.2 in nrgochi integration

Support statement

Go agent v3.40.1

Fri, 18 Jul 2025 00:00:00 +0000

3.40.1

Fixed

Reverted utilization.go back to v3.39.0 release due to deadlock bug
Removed awssupport_test.go tests that added direct dependencies to go module

Support statement

Go agent v3.41.0

Wed, 24 Sep 2025 00:00:00 +0000

3.41.0

Added

Added DistributedTracer.Sampler config options for controlling the sampling behavior for Inbound Requests for distributed traces
- To configure the sampler, added ConfigRemoteParentSampled(flag RemoteParentSamplingConfig) and ConfigRemoteParentNotSampled(flag RemoteParentSamplingConfig) which handles sampling behavior based on what the remote parent has flagged
- Flags added are "always_on", "always_off", and "default" which can be called using RemoteParentSamplingConfig
- Example: newrelic.ConfigRemoteParentSampled(newrelic.AlwaysOff)
Added OOM Monitoring Tests
Increased Secure Agent Test Coverage

Fixed

Updated third-party library versions due to reported security or other supportability issues:
- github.com/gofiber/fiber/v2 from 2.52.7 to 2.52.9 in nrfiber integration
- golang.org/x/net from 0.25.0 to 0.38.0 in nrconnect integration

Support statement

Go agent v3.43.0

Thu, 02 Apr 2026 00:00:00 +0000

3.43.0

Added

Added UnWrap support for replacement response writer
- Thank you to community member @ArturFortunato for contributing to this solution
Added support for Lambda function URL request and response in the nrlambda integration
- Thank you to community member @rittneje for contributing to this solution
Added additional Span attribute for Opensearch/elastic search endpoint in the nrawssdk integration
Added Support for "WITH" clauses to sqlparse

Fixed

Fixed failing httptest

Security

Updated CI/CD go version
Bumped nrgrpc version
Dependabot security bumps
- logcontext/nrlogrus
- logcontext/nrlogrusplugin
- logcontext-v2/nrlogrus
- nrfiber

Support statement

Go agent v3.42.0

Wed, 19 Nov 2025 00:00:00 +0000

3.42.0

Added

Added ConfigTransactionEventsMaxSamplesStoredand ConfigErrorCollectorMaxSamplesStored allowing full control of maximum samples stored for Transaction Events, Custom Insights Events, Error Events, and Log Events
Added support for the MultiValueHeaders property when extracting the headers from events.APIGatewayProxyResponse in nrlambda
- Thank you to community member @rittneje for contributing to this solution

Fixed

Removed unused variables and modernize by replacing interface with any in the nrpxg5 integration
Fixed a bug where error events did not correctly mark expected errors
- Thank you to community member @driimus for contributing to this solution
Bumped nrwriter integration to use v1.0.2
- Thank you to community member @hiicharm for spotting this.

Support statement

Go agent v3.43.1

Thu, 09 Apr 2026 00:00:00 +0000

3.43.1

Fixed

Fixed a bug where we were importing the incorrect version of the nrsecureagent in our nrgrpc integration

Support statement

Go agent v3.43.2

Thu, 16 Apr 2026 00:00:00 +0000

3.43.2

Fixed

Fixed a bug in replacementResponseWriter where the Unwrap function wasn't being promoted as a part of an anoynmous struct

Support statement

Go agent v3.44.0

Thu, 11 Jun 2026 00:00:00 +0000

We recommend updating to the latest agent version as soon as it's available. If your organization has established practices that prevent you from upgrading to the latest version, ensure that your agents are regularly updated to a version that's at most 90 days old. Read more about keeping your agent up to date.

3.44.0

Added

Added Support for Anthropic SDK nranthropic Added Support for GocqlX nrgocqlx

Fixed

Export Internal Test Types via integrationsupport to unblock external test consumers Thank you to community member @nitinprajwal for contributing to this solution Fixed a bug in sqlparse to support optional INTO statements in sql integrations Fixed a bug in nrnats that caused flaky testing

Security

Dependabot Security Bumps nrfiber

Support statement

Go agent v3.43.3

Tue, 28 Apr 2026 00:00:00 +0000

3.43.3

Feature

EXPERIMENTAL: Added a config option ConfigAppLogDecoratingWithinMessage to allow Local Log Decorator to appear within a message field. This can only be applied to the logcontext-v2/nrlogrus integration. The logcontext-v2/nrlogrus integration will be bumped to v1.1.4.

Security

Dependabot security bumps
- nrawsbedrock (integration will be bumped to v1.1.1)
- nrawssdk-v2 (integration will be bumped to v1.2.7)
- nrpgx5 (integration will be bumped to v1.3.4)`

Support statement

Go agent v3.44.1

Mon, 22 Jun 2026 00:00:00 +0000

We recommend updating to the latest agent version as soon as it's available. If your organization has established practices that prevent you from upgrading to the latest version, ensure that your agents are regularly updated to a version that's at most 90 days old. Read more about keeping your agent up to date.

3.44.1

Fixed

Corrected incorrect tag for previous release

Security

Dependabot security updates
- nrgochi integration updated to v5.2.4
- nrmongo integration updated to v1.17.7
- nrmongo-v2 integration updated to v2.4.2
- nrnats integration updated to v2.11.15

Support statement

We use the latest version of the Go language. At a minimum, use a version of Go that the Go team still supports. See the Go agent EOL Policy for details about supported versions of the Go agent and third-party components.

Go agent v3.44.2

Tue, 11 Aug 2026 00:00:00 +0000

We recommend updating to the latest agent version as soon as it's available. If your organization has established practices that prevent you from upgrading to the latest version, ensure that your agents are regularly updated to a version that's at most 90 days old. Read more about keeping your agent up to date.

3.44.2

Added

aws.lambda.eventSource.eventType attribute support for the nrlambda integration

Fixed

TransactionTrace fixes
- backtrace shows properly in the UI -> Fixed an issue where backtraces weren't properly displaying in NR1
- timestamp no longer null -> Fixed an issue where timestamp always showed as null
- exclusive_duration_millis no longer null -> Fixed an issue where exclusive_duration_millis always showed as null

Security

Dependabot security updates
- nrgrpc bump google.golang.org/grpc to 1.82.1
- nrconnect bump golang.org/x/net to 0.55.0

Support statement

Go agent v3.0.0

Tue, 17 Dec 2019 00:00:00 +0000

3.0.0

We are pleased to announce the release of Go Agent v3.0.0! This is a major release that includes some breaking changes that will simplify your future use of the Go Agent.

Please pay close attention to the list of Changes.

Changes

A full list of changes and a step by step checklist on how to upgrade can be found in the v3 Migration Guide.

New Features

Support for Go Modules. Our Go agent integration packages support frameworks and libraries which are changing over time. With support for Go Modules, we are now able to release instrumentation packages for multiple versions of frameworks and libraries with a single agent release; and support operation of the Go agent in Go Modules environments. This affects naming of our integration packages, as described in the v3 Migration Guide (see under "Changes" above).
Detect and set hostnames based on Heroku dyno names. When deploying an application in Heroku, the hostnames collected will now match the dyno name. This serves to greatly improve the usability of the servers list in APM since dyno names are often sporadic or fleeting in nature. The feature is controlled by two new configuration options Config.Heroku.UseDynoNames and Config.Heroku.DynoNamePrefixesToShorten.

Go agent v3.10.0

Mon, 11 Jan 2021 00:00:00 +0000

3.10.0

New Features

To keep up with the latest security protocols implemented by Amazon Web Services, the agent now uses AWS IMDSv2 to find utilization data. #249

Changes

Updated the locations of our license files so that Go docs https://pkg.go.dev will display our agent. Thanks @tydavis for your PR to fix this! #254
Added an Open Source repo linter GitHub action that runs on push. #262
Updated the README.md file to correctly show the support resources from New Relic. #255

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 2.2.0.

Go agent v3.1.0

Wed, 15 Jan 2020 00:00:00 +0000

New Features

Support for W3C Trace Context, with easy upgrade from New Relic trace context.

Distributed Tracing now supports W3C Trace Context headers for HTTP and gRPC protocols when distributed tracing is enabled. Our implementation can accept and emit both W3C trace header format and New Relic trace header format. This simplifies agent upgrades, allowing trace context to be propagated between services with older and newer releases of New Relic agents. W3C trace header format will always be accepted and emitted. New Relic trace header format will be accepted, and you can optionally disable emission of the New Relic trace header format.

When distributed tracing is enabled with Config.DistributedTracer.Enabled = true, the Go agent will now accept W3C's traceparent and tracestate headers when calling Transaction.AcceptDistributedTraceHeaders. When calling Transaction.InsertDistributedTraceHeaders, the Go agent will include the W3C headers along with the New Relic distributed tracing header, unless the New Relic trace header format is disabled using Config.DistributedTracer.ExcludeNewRelicHeader = true.

Also, see Knowns Issues and Workarounds.
Added support for elastic/go-elasticsearch in the new v3/integrations/nrelasticsearch-v7 package.

Known Issues and Workarounds

If a .NET agent is initiating distributed traces as the root service, you must update that .NET agent to version 8.24 or later before upgrading your downstream Go New Relic agents to this agent release.

Go agent v3.11.0

Thu, 18 Mar 2021 00:00:00 +0000

3.11.0

New Features

Aerospike is now included on the list of recognized datastore names. Thanks @vkartik97 for your PR! #233
Added support for version 8 of go-redis. Thanks @ilmimris for adding this instrumentation! #251

Changes

Changed logging level for messages resulting from Infinite Tracing load balancing operations. These were previously logged as errors, and now they are debugging messages. #276

Fixed

When the agent is configured with cfg.ErrorCollector.RecordPanics set to true, panics would be recorded by New Relic, but stack traces would not be logged as the Go Runtime usually does. The agent now logs stack traces from within its panic handler, providing similar functionality. #278
Added license files to some integrations packages to ensure compatibility with package.go.dev. Now the documentation for our integrations shows up again on go.docs.

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.

Go agent v3.4.0

Mon, 23 Mar 2020 00:00:00 +0000

3.4.0

New Features

Attribute http.statusCode has been added to external span events representing the status code on an http response. This attribute will be included when added to an ExternalSegment in one of these three ways:
1. Using NewRoundTripper with your http.Client
2. Including the http.Response as a field on your ExternalSegment
3. Using the new ExternalSegment.SetStatusCode API to set the status code directly
To exclude the http.statusCode attribute from span events, update your agent configuration like so, where cfg is your newrelic.Config object.
```
cfg.SpanEvents.Attributes.Exclude = append(cfg.SpanEvents.Attributes.Exclude, newrelic.SpanAttributeHTTPStatusCode)
```
Error attributes error.class and error.message are now included on the span event in which the error was noticed, or on the root span if an error occurs in a transaction with no segments (no chid spans). Only the most recent error information is added to the attributes; prior errors on the same span are overwritten.

To exclude the error.class and/or error.message attributes from span events, update your agent configuration like so, where cfg is your newrelic.Config object.
```
cfg.SpanEvents.Attributes.Exclude = append(cfg.SpanEvents.Attributes.Exclude, newrelic.newrelic.SpanAttributeErrorClass, newrelic.SpanAttributeErrorMessage)
```

Changes

Use Context.FullPath() for transaction names when using Gin version 1.5.0 or greater. Gin transactions were formerly named after the Context.HandlerName(), which uses reflection. This change improves transaction naming and reduces overhead. Please note that because your transaction names will change, you may have to update any related dashboards and alerts to match the new name.
```
// Transactions previously named
"GET main.handleGetUsers"
// will be change to something like this match the full path
"GET /user/:id"
```

Go agent v3.2.0

Mon, 27 Jan 2020 00:00:00 +0000

3.2.0

New Features

Added support for v7 of go-redis/redis in the new v3/integrations/nrredis-v7 package.
- Documentation
- Example

Changes

Updated Gorilla instrumentation to include request time spent in middlewares. Added new nrgorilla.Middleware and deprecated nrgorilla.InstrumentRoutes. Register the new middleware as your first middleware using Router.Use. See the godocs examples for more details.

r := mux.NewRouter()
// Always register the nrgorilla.Middleware first.
r.Use(nrgorilla.Middleware(app))

// All handlers and custom middlewares will be instrumented.  The
// transaction will be available in the Request's context.
r.Use(MyCustomMiddleware)
r.Handle("/", makeHandler("index"))

// The NotFoundHandler and MethodNotAllowedHandler must be instrumented
// separately using newrelic.WrapHandle.  The second argument to
// newrelic.WrapHandle is used as the transaction name; the string returned
// from newrelic.WrapHandle should be ignored.
_, r.NotFoundHandler = newrelic.WrapHandle(app, "NotFoundHandler", makeHandler("not found"))
_, r.MethodNotAllowedHandler = newrelic.WrapHandle(app, "MethodNotAllowedHandler", makeHandler("method not allowed"))

http.ListenAndServe(":8000", r)

Known Issues and Workarounds

Go agent v3.5.0

Wed, 20 May 2020 00:00:00 +0000

3.5.0

New Features

Added support for Infinite Tracing on New Relic Edge.

Infinite Tracing observes 100% of your distributed traces and provides visualizations for the most actionable data so you have the examples of errors and long-running traces so you can better diagnose and troubleshoot your systems.

You configure your agent to send traces to a trace observer in New Relic Edge. You view your distributed traces through the New Relic’s UI. There is no need to install a collector on your network.

Infinite Tracing is currently available on a sign-up basis. If you would like to participate, please contact your sales representative.

Changes

nrgin.Middleware uses Context.FullPath() for transaction names when using Gin version 1.5.0 or greater. Gin transactions were formerly named after the Context.HandlerName(), which uses reflection. This change improves transaction naming and reduces overhead. Please note that because your transaction names will change, you may have to update any related dashboards and alerts to match the new name. If you wish to continue using Context.HandlerName() for your transaction names, use nrgin.MiddlewareHandlerTxnNames instead.
```
// Transactions previously named
"GET main.handleGetUsers"
// will be change to something like this match the full path
"GET /user/:id"
```
Note: As part of agent release v3.4.0, a v2.0.0 tag was added to the nrgin package. When using go modules however, it was impossible to install this latest version of nrgin. The v2.0.0 tag has been removed and replaced with v1.1.0.

Go agent v3.6.0

Tue, 09 Jun 2020 00:00:00 +0000

3.6.0 New Features

Added support for adding custom attributes directly to spans. These attributes will be visible when looking at spans in the distributed tracing UI.

Example:

txn := newrelic.FromContext(r.Context())
sgmt := txn.StartSegment("segment1")
defer sgmt.End()
sgmt.AddAttribute("mySpanString", "hello")
sgmt.AddAttribute("mySpanInt", 123)

Custom attributes added to the transaction with txn.AddAttribute are now also added to the root span and will be visible when looking at the span in the distributed tracing UI. These custom attributes can be disabled from all destinations using Config.Attributes.Exclude or disabled from spans specifically using Config.SpanEvents.Attributes.Exclude.
Agent attributes added to the transaction are now also added to the root span event and will be visible when looking at the span in the distributed tracing UI. These attributes include the request.uri and the request.method along with all other attributes listed in the attributes section of our godocs. These agent attributes can be disabled from all destinations using Config.Attributes.Exclude or disabled from spans specifically using Config.SpanEvents.Attributes.Exclude.

Bug Fixes

Fixed an issue where it was impossible to exclude the attributes error.class and error.message from the root span. This issue has now been fixed. These attributes can now be excluded from all spans using Config.Attributes.Exclude or Config.SpanEvents.Attributes.Exclude.
Fixed an issue that caused Go's data race warnings to trigger in certain situations when using the newrelic.NewRoundTripper. There were no reports of actual data corruption, but now the warnings should be resolved. Thank you to @blixt for bringing this to our attention!

Go agent v3.3.0

Tue, 11 Feb 2020 00:00:00 +0000

3.3.0

New Features

Added support for GraphQL in two new integrations:
- graph-gophers/graphql-go with v3/integrations/nrgraphgophers.
  - Documentation
  - Example
- graphql-go/graphql with v3/integrations/nrgraphqlgo.
  - Documentation
  - Example
Added database instrumentation support for snowflakedb/gosnowflake.
- Documentation
- Example

Changes

When using newrelic.StartExternalSegment or newrelic.NewRoundTripper, if existing cross application tracing or distributed tracing headers are present on the request, they will be replaced instead of added.
The FromContext API which allows you to pull a Transaction from a context.Context will no longer panic if the provided context is nil. In this case, a nil is returned.

Known Issues and Workarounds

Go agent v3.7.0

Thu, 18 Jun 2020 00:00:00 +0000

3.7.0

Changes

When Config.Transport is nil, no longer use the http.DefaultTransport when communicating with the New Relic backend. This addresses an issue with shared transports as described in golang/go#33006.
If a timeout occurs when attempting to send data to the New Relic backend, instead of dropping the data, we save it and attempt to send it with the next harvest. Note data retention limits still apply and the agent will still start to drop data when these limits are reached. We attempt to keep the highest priority events and traces.

Go agent v3.8.0

Wed, 01 Jul 2020 00:00:00 +0000

3.8.0

Changes

When marking a transaction as a web transaction using Transaction.SetWebRequest, it is now possible to include a Host field in the WebRequest struct, which defaults to the empty string.

Bug Fixes

The Host header is now being correctly captured and recorded in the request.headers.host attribute, as described here.
Previously, the timestamps on Spans and Transactions were being written using different data types, which sometimes caused rounding errors that could cause spans to be offset incorrectly in the UI. This has been fixed.

Go agent v3.8.1

Wed, 15 Jul 2020 00:00:00 +0000

3.8.1

Bug Fixes

Fixed an issue that could cause orphaned Distributed Trace spans when using SQL instrumentation like nrmysql.

Go agent v3.9.0

Thu, 03 Sep 2020 00:00:00 +0000

3.9.0

Changes

When sending Serverless telemetry using the nrlambda integration, support an externally-managed named pipe.

The articles below provide additional instructions on support for an externally-managed named pipe in lambdas:

Go agent v3.45.0

Thu, 24 Sep 2026 00:00:00 +0000

We recommend updating to the latest agent version as soon as it's available. If your organization has established practices that prevent you from upgrading to the latest version, ensure that your agents are regularly updated to a version that's at most 90 days old. Read more about keeping your agent up to date.

3.45.0

Added

Added new integration nrecho-v5. Note that previous major versions (v3,v4) are still available under their respective folders
Added new integration nrgemini that instruments the genai package
Added support for continuous profiling * NOTE: Continuous Profiling is a new feature which is not yet generally available for use. The agent-side component code is now present in the agent but to actually use it ahead of the General Availability release, you will need to contact your New Relic sales representative to join the preview early

Fixed

Fixed a bug where LLM messages would incorrectly be truncated

Security

Dependabot security updates
- Bumped grpc from 1.82.1 to 1.83.1 in v3/integrations/nrgrpc and /v3
- Bumped amqp091-go from 1.9.0 to 1.13.0 in v3/integrations/nramqp
- Bumped echo/v4 from 4.9.0 to 4.15.3 in v3/integrations/nrecho-v4