Merge pull request #840 from newrelic/develop

Release 3.29.0

Author: nr-swilloughby

CHANGELOG.md

@@ -1,3 +1,15 @@
+## 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 is supported by the Go team themselves.
+See the [Go agent EOL Policy](/docs/apm/agents/go-agent/get-started/go-agent-eol-policy) for details about supported versions of the Go agent and third-party components.
+
 ## 3.28.1
 ### Added
 Added Supportability Metrics to `nrfasthttp` (brings `nrfasthttp` version to v1.0.1).
@@ -1128,7 +1140,7 @@ feedback that you would like to pass along, please open up an issue
 [here](https://github.com/newrelic/go-agent/issues/new) 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](http://support.newrelic.com/) or our
+   our [support site](https://support.newrelic.com/) or our
    [community forum](https://discuss.newrelic.com). Please only report
    questions related to the 3.0 pre-release directly via GitHub.
 
@@ -1162,7 +1174,7 @@ include:
 ### Bug Fixes
 
 * Fixed an issue in the
-  [`nrhttprouter`](http://godoc.org/github.com/newrelic/go-agent/_integrations/nrhttprouter)
+  [`nrhttprouter`](https://godoc.org/github.com/newrelic/go-agent/_integrations/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
@@ -1208,7 +1220,7 @@ package.
   // (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)
+  req, err := http.NewRequest("GET", "https://example.com", nil)
   if nil != err {
       log.Fatalln(err)
   }
@@ -1384,9 +1396,9 @@ It can be configured as follows:
 ### New Features
 
 * Added support for [HttpRouter](https://github.com/julienschmidt/httprouter) in
-  the new [_integrations/nrhttprouter](http://godoc.org/github.com/newrelic/go-agent/_integrations/nrhttprouter) package.  This package allows you to easily instrument inbound requests through the HttpRouter framework.
+  the new [_integrations/nrhttprouter](https://godoc.org/github.com/newrelic/go-agent/_integrations/nrhttprouter) package.  This package allows you to easily instrument inbound requests through the HttpRouter framework.
 
-  * [Documentation](http://godoc.org/github.com/newrelic/go-agent/_integrations/nrhttprouter)
+  * [Documentation](https://godoc.org/github.com/newrelic/go-agent/_integrations/nrhttprouter)
   * [Example](_integrations/nrhttprouter/example/main.go)
 
 * Added support for [github.com/uber-go/zap](https://github.com/uber-go/zap) in
@@ -1469,7 +1481,7 @@ package.  This package supports instrumentation for servers, clients, publishers
 * 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:
   ```go
   hdrs := http.Headers{}
-  u, _ := url.Parse("http://example.com")
+  u, _ := url.Parse("https://example.com")
   webReq := newrelic.NewStaticWebRequest(hdrs, u, "GET", newrelic.TransportHTTP)
   txn := app.StartTransaction("My-Transaction", nil, nil)
   txn.SetWebRequest(webReq)
@@ -1701,8 +1713,8 @@ package.  This package supports instrumentation for servers and clients.
   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](http://godoc.org/github.com/newrelic/go-agent/_integrations/nrawssdk/v1)
-  * [v2 Documentation](http://godoc.org/github.com/newrelic/go-agent/_integrations/nrawssdk/v2)
+  * [v1 Documentation](https://godoc.org/github.com/newrelic/go-agent/_integrations/nrawssdk/v1)
+  * [v2 Documentation](https://godoc.org/github.com/newrelic/go-agent/_integrations/nrawssdk/v2)
 
 * Added span event and transaction trace segment attribute configuration.  You
   may control which attributes are captured in span events and transaction trace
@@ -1801,7 +1813,7 @@ txn.Application().RecordCustomEvent("customerOrder", map[string]interface{}{
 
 * Added support for [Echo](https://echo.labstack.com) in the new `nrecho`
   package.
-  * [Documentation](http://godoc.org/github.com/newrelic/go-agent/_integrations/nrecho)
+  * [Documentation](https://godoc.org/github.com/newrelic/go-agent/_integrations/nrecho)
   * [Example](_integrations/nrecho/example/main.go)
 
 * Introduced `Transaction.SetWebResponse(http.ResponseWriter)` method which sets
@@ -1864,7 +1876,7 @@ transactions.  Example use:
 ```go
 client := &http.Client{}
 client.Transport = newrelic.NewRoundTripper(nil, client.Transport)
-request, _ := http.NewRequest("GET", "http://example.com", nil)
+request, _ := http.NewRequest("GET", "https://example.com", nil)
 request = newrelic.RequestWithTransactionContext(request, txn)
 resp, err := client.Do(request)
 ```
@@ -2027,7 +2039,7 @@ txn.NoticeError(newrelic.Error{
 
 * Added support for [github.com/gin-gonic/gin](https://github.com/gin-gonic/gin)
   in the new `nrgin` package.
-  * [Documentation](http://godoc.org/github.com/newrelic/go-agent/_integrations/nrgin/v1)
+  * [Documentation](https://godoc.org/github.com/newrelic/go-agent/_integrations/nrgin/v1)
   * [Example](examples/_gin/main.go)
 
 ## 1.8.0
@@ -2040,9 +2052,9 @@ txn.NoticeError(newrelic.Error{
 
 ## 1.7.0
 
-* Added support for [gorilla/mux](http://github.com/gorilla/mux) in the new `nrgorilla`
+* Added support for [gorilla/mux](https://github.com/gorilla/mux) in the new `nrgorilla`
   package.
-  * [Documentation](http://godoc.org/github.com/newrelic/go-agent/_integrations/nrgorilla/v1)
+  * [Documentation](https://godoc.org/github.com/newrelic/go-agent/_integrations/nrgorilla/v1)
   * [Example](examples/_gorilla/main.go)
 
 ## 1.6.0

GUIDE.md

@@ -127,7 +127,7 @@ app, err := newrelic.NewApplication(
 To log at info level to a file, set:
 
 ```go
-w, err := os.OpenFile("my_log_file", os.O_CREATE|os.O_APPEND|os.O_WRONLY, 0644)
+w, err := os.OpenFile("my_log_file", os.O_CREATE|os.O_APPEND|os.O_WRONLY, 0600)
 if nil == err {
     app, _ := newrelic.NewApplication(
         newrelic.ConfigAppName("Your Application Name"),
@@ -400,7 +400,7 @@ ways to use this functionality:
     ```go
     client := &http.Client{}
     client.Transport = newrelic.NewRoundTripper(client.Transport)
-    request, _ := http.NewRequest("GET", "http://example.com", nil)
+    request, _ := http.NewRequest("GET", "https://example.com", nil)
     // Put transaction in the request's context:
     request = newrelic.RequestWithTransactionContext(request, txn)
     resp, err := client.Do(request)

MIGRATION.md

@@ -455,7 +455,7 @@ var _ newrelic.ErrorAttributer = MyErrorType{}
   ```go
   client := &http.Client{}
   client.Transport = newrelic.NewRoundTripper(txn, client.Transport)
-  req, _ := http.NewRequest("GET", "http://example.com", nil)
+  req, _ := http.NewRequest("GET", "https://example.com", nil)
   client.Do(req)
   ```
 

ROADMAP.md

@@ -159,7 +159,7 @@ func message(w http.ResponseWriter, r *http.Request) {
 
 func external(w http.ResponseWriter, r *http.Request) {
 	txn := newrelic.FromContext(r.Context())
-	req, _ := http.NewRequest("GET", "http://example.com", nil)
+	req, _ := http.NewRequest("GET", "https://example.com", nil)
 
 	// Using StartExternalSegment is recommended because it does distributed
 	// tracing header setup, but if you don't have an *http.Request and
@@ -193,7 +193,7 @@ func roundtripper(w http.ResponseWriter, r *http.Request) {
 	client := &http.Client{}
 	client.Transport = newrelic.NewRoundTripper(client.Transport)
 
-	request, _ := http.NewRequest("GET", "http://example.com", nil)
+	request, _ := http.NewRequest("GET", "https://example.com", nil)
 	// Since the transaction is already added to the inbound request's
 	// context by WrapHandleFunc, we just need to copy the context from the
 	// inbound request to the external request.

v3/examples/server/main.go

@@ -3,7 +3,7 @@ module github.com/newrelic/go-agent/v3/integrations/logcontext-v2/logWriter
 go 1.19
 
 require (
-	github.com/newrelic/go-agent/v3 v3.28.1
+	github.com/newrelic/go-agent/v3 v3.29.0
 	github.com/newrelic/go-agent/v3/integrations/logcontext-v2/nrwriter v1.0.0
 )
 

v3/integrations/logcontext-v2/logWriter/go.mod

@@ -3,7 +3,7 @@ module github.com/newrelic/go-agent/v3/integrations/logcontext-v2/nrlogrus
 go 1.19
 
 require (
-	github.com/newrelic/go-agent/v3 v3.28.1
+	github.com/newrelic/go-agent/v3 v3.29.0
 	github.com/sirupsen/logrus v1.8.1
 )
 

v3/integrations/logcontext-v2/nrlogrus/go.mod

@@ -2,7 +2,7 @@ module github.com/newrelic/go-agent/v3/integrations/logcontext-v2/nrwriter
 
 go 1.19
 
-require github.com/newrelic/go-agent/v3 v3.28.1
+require github.com/newrelic/go-agent/v3 v3.29.0
 
 
 replace github.com/newrelic/go-agent/v3 => ../../..

v3/integrations/logcontext-v2/nrwriter/go.mod

@@ -3,7 +3,7 @@ module github.com/newrelic/go-agent/v3/integrations/logcontext-v2/nrzap
 go 1.19
 
 require (
-	github.com/newrelic/go-agent/v3 v3.28.1
+	github.com/newrelic/go-agent/v3 v3.29.0
 	go.uber.org/zap v1.24.0
 )
 

v3/integrations/logcontext-v2/nrzap/go.mod

@@ -3,7 +3,7 @@ module github.com/newrelic/go-agent/v3/integrations/logcontext-v2/nrzerolog
 go 1.19
 
 require (
-	github.com/newrelic/go-agent/v3 v3.28.1
+	github.com/newrelic/go-agent/v3 v3.29.0
 	github.com/rs/zerolog v1.26.1
 )
 

v3/integrations/logcontext-v2/nrzerolog/go.mod

@@ -3,7 +3,7 @@ module github.com/newrelic/go-agent/v3/integrations/logcontext-v2/zerologWriter
 go 1.19
 
 require (
-	github.com/newrelic/go-agent/v3 v3.28.1
+	github.com/newrelic/go-agent/v3 v3.29.0
 	github.com/newrelic/go-agent/v3/integrations/logcontext-v2/nrwriter v1.0.0
 	github.com/rs/zerolog v1.27.0
 )

v3/integrations/logcontext-v2/zerologWriter/go.mod

@@ -5,7 +5,7 @@ module github.com/newrelic/go-agent/v3/integrations/logcontext/nrlogrusplugin
 go 1.19
 
 require (
-	github.com/newrelic/go-agent/v3 v3.28.1
+	github.com/newrelic/go-agent/v3 v3.29.0
 	// v1.4.0 is required for for the log.WithContext.
 	github.com/sirupsen/logrus v1.4.0
 )

v3/integrations/logcontext/nrlogrusplugin/go.mod

@@ -3,7 +3,7 @@ module github.com/newrelic/go-agent/v3/integrations/nramqp
 go 1.19
 
 require (
-	github.com/newrelic/go-agent/v3 v3.28.1
+	github.com/newrelic/go-agent/v3 v3.29.0
 	github.com/rabbitmq/amqp091-go v1.9.0
 )
 replace github.com/newrelic/go-agent/v3 => ../..

v3/integrations/nramqp/go.mod

@@ -8,7 +8,7 @@ go 1.19
 require (
 	// v1.15.0 is the first aws-sdk-go version with module support.
 	github.com/aws/aws-sdk-go v1.34.0
-	github.com/newrelic/go-agent/v3 v3.28.1
+	github.com/newrelic/go-agent/v3 v3.29.0
 )
 
 

v3/integrations/nrawssdk-v1/go.mod

@@ -11,7 +11,7 @@ require (
 	github.com/aws/aws-sdk-go-v2/service/lambda v1.24.5
 	github.com/aws/aws-sdk-go-v2/service/s3 v1.27.10
 	github.com/aws/smithy-go v1.13.3
-	github.com/newrelic/go-agent/v3 v3.28.1
+	github.com/newrelic/go-agent/v3 v3.29.0
 )
 
 

v3/integrations/nrawssdk-v2/go.mod

@@ -2,7 +2,7 @@ module github.com/newrelic/go-agent/v3/integrations/nrb3
 
 go 1.19
 
-require github.com/newrelic/go-agent/v3 v3.28.1
+require github.com/newrelic/go-agent/v3 v3.29.0
 
 
 replace github.com/newrelic/go-agent/v3 => ../..

v3/integrations/nrb3/go.mod

@@ -8,7 +8,7 @@ require (
 	// v3.1.0 is the earliest v3 version of Echo that works with modules due
 	// to the github.com/rsc/letsencrypt import of v3.0.0.
 	github.com/labstack/echo v3.1.0+incompatible
-	github.com/newrelic/go-agent/v3 v3.28.1
+	github.com/newrelic/go-agent/v3 v3.29.0
 )
 
 

v3/integrations/nrecho-v3/go.mod

@@ -6,7 +6,7 @@ go 1.19
 
 require (
 	github.com/labstack/echo/v4 v4.9.0
-	github.com/newrelic/go-agent/v3 v3.28.1
+	github.com/newrelic/go-agent/v3 v3.29.0
 )
 
 

v3/integrations/nrecho-v4/go.mod

@@ -6,7 +6,7 @@ go 1.19
 
 require (
 	github.com/elastic/go-elasticsearch/v7 v7.17.0
-	github.com/newrelic/go-agent/v3 v3.28.1
+	github.com/newrelic/go-agent/v3 v3.29.0
 )
 
 

v3/integrations/nrelasticsearch-v7/go.mod

@@ -3,7 +3,7 @@ module client-example
 go 1.19
 
 require (
-	github.com/newrelic/go-agent/v3 v3.28.1
+	github.com/newrelic/go-agent/v3 v3.29.0
 	github.com/newrelic/go-agent/v3/integrations/nrfasthttp v1.0.0
 	github.com/valyala/fasthttp v1.49.0
 )

v3/integrations/nrfasthttp/examples/client-fasthttp/go.mod

@@ -3,7 +3,7 @@ module server-example
 go 1.19
 
 require (
-	github.com/newrelic/go-agent/v3 v3.28.1
+	github.com/newrelic/go-agent/v3 v3.29.0
 	github.com/newrelic/go-agent/v3/integrations/nrfasthttp v1.0.0
 	github.com/valyala/fasthttp v1.49.0
 )

v3/integrations/nrfasthttp/examples/server-fasthttp/go.mod

@@ -3,6 +3,7 @@ module github.com/newrelic/go-agent/v3/integrations/nrfasthttp
 go 1.19
 
 require (
-	github.com/newrelic/go-agent/v3 v3.28.1
+	github.com/newrelic/go-agent/v3 v3.29.0
 	github.com/valyala/fasthttp v1.49.0
 )
+replace github.com/newrelic/go-agent/v3 => ../..

v3/integrations/nrfasthttp/go.mod

@@ -6,7 +6,7 @@ go 1.19
 
 require (
 	github.com/gin-gonic/gin v1.9.1
-	github.com/newrelic/go-agent/v3 v3.28.1
+	github.com/newrelic/go-agent/v3 v3.29.0
 )
 
 

v3/integrations/nrgin/go.mod

@@ -7,7 +7,7 @@ go 1.19
 require (
 	// v1.7.0 is the earliest version of Gorilla using modules.
 	github.com/gorilla/mux v1.7.0
-	github.com/newrelic/go-agent/v3 v3.28.1
+	github.com/newrelic/go-agent/v3 v3.29.0
 )
 
 

v3/integrations/nrgorilla/go.mod

@@ -7,7 +7,7 @@ go 1.19
 require (
 	// graphql-go has no tagged releases as of Jan 2020.
 	github.com/graph-gophers/graphql-go v1.3.0
-	github.com/newrelic/go-agent/v3 v3.28.1
+	github.com/newrelic/go-agent/v3 v3.29.0
 )
 
 

v3/integrations/nrgraphgophers/go.mod

@@ -5,7 +5,7 @@ go 1.19
 require (
 	github.com/graphql-go/graphql v0.8.1
 	github.com/graphql-go/graphql-go-handler v0.2.3
-	github.com/newrelic/go-agent/v3 v3.28.1
+	github.com/newrelic/go-agent/v3 v3.29.0
 	github.com/newrelic/go-agent/v3/integrations/nrgraphqlgo v1.0.0
 )
 

v3/integrations/nrgraphqlgo/example/go.mod

@@ -4,7 +4,7 @@ go 1.19
 
 require (
 	github.com/graphql-go/graphql v0.8.1
-	github.com/newrelic/go-agent/v3 v3.28.1
+	github.com/newrelic/go-agent/v3 v3.29.0
 )