diff --git a/src/content/docs/apm/agents/go-agent/configuration/go-agent-configuration.mdx b/src/content/docs/apm/agents/go-agent/configuration/go-agent-configuration.mdx index 4316727ba26..999b5416b7f 100644 --- a/src/content/docs/apm/agents/go-agent/configuration/go-agent-configuration.mdx +++ b/src/content/docs/apm/agents/go-agent/configuration/go-agent-configuration.mdx @@ -639,6 +639,7 @@ NEW_RELIC_APP_NAME="Your Application Name" NEW_RELIC_CODE_LEVEL_METRICS_ENABLED="true" NEW_RELIC_CODE_LEVEL_METRICS_PATH_PREFIX="myproject/src" NEW_RELIC_LABELS="Env:Dev;Label2:label2;Label3:label3;Label4:label4" +NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CUSTOM_ATTRIBUTES="key1:val1;key2:val2;key3:val3" ``` then the following code: @@ -770,6 +771,40 @@ Not all possible configuration options may be set via environment variables. The + + + `CustomInsightsEvents.CustomAttributesEnabled` + + + + `ConfigAppLogForwardingEnabled` + + (See [note 1](#table-note-one) below) + + + + `NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CUSTOM_ATTRIBUTES_ENABLED` + + + + + + `CustomInsightsEvents.CustomAttributesValues` + + + + `ConfigAppLogForwardingEnabled` + + `ConfigCustomInsightsCustomAttributesEnabled` + + (See [note 1](#table-note-one) below) + + + + `NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CUSTOM_ATTRIBUTES` + + + `ApplicationLogging.LocalDecorating.Enabled` @@ -1742,6 +1777,7 @@ Not all possible configuration options may be set via environment variables. The * `ConfigAppLogDecoratingEnabled(false)` sets `ApplicationLogging.LocalDecorating.Enabled=false` but does not affect `ApplicationLogging.Enabled`. * `ConfigAppLogMetricsEnabled(true)` sets `ApplicationLogging.Metrics.Enabled=true` but also sets `ApplicationLogging.Enabled=true`. * `ConfigAppLogMetricsEnabled(false)` sets `ApplicationLogging.Metrics.Enabled=false` but does not affect `ApplicationLogging.Enabled`. + * `ConfigAppLogForwardingEnabled(false)` sets `CustomInsightsEvents.CustomAttributesEnabled=false` but also sets `CustomInsightsEvents.CustomAttributesValues=nil`. ### Table note 2: [#table-note-two] @@ -1766,8 +1802,9 @@ This section includes Go agent configurations for setting up AI monitoring. - When enabled, AI monitoring records a streaming copy of inputs and outputs sent to and from the models you choose to monitor, including any personal information contained therein. - You're responsible for obtaining consent from your model users that their interactions may be recorded by a third party (New Relic) for the purpose of providing the AI monitoring feature. + When enabled, AI monitoring records a streaming copy of inputs and outputs sent to and from the models you choose to monitor. This includes any personal information contained within those inputs and outputs. + + You're responsible for obtaining consent from your model users, informing them that their interactions may be recorded @@ -1982,6 +2019,112 @@ You can create custom events and make them available for querying and analysis. ) ``` + + + + + + + + + + + + + + + + + + + + + + +
+ Type + + Boolean +
+ Default + + `false` +
+ [Set in](#options) + + `newrelic.Config` struct +
+ + If `true`, the agent captures custom attributes related to the log lines being sent up by your application. `ApplicationLogging.Enabled` must also be `true` for this setting to take effect. + + Configure `CustomInsightsEvents.CustomAttributesEnabled` by calling `ConfigCustomInsightsCustomAttributesEnabled()`. + + ```go + app, err := newrelic.NewApplication( + newrelic.ConfigCustomInsightsCustomAttributesEnabled(true), + ) + ``` +
+ + + + + + + + + + + + + + + + + + + + + + +
+ Type + + Map +
+ Default + + `nil` +
+ [Set in](#options) + + `newrelic.Config` struct +
+ + A map with key/value pairs to add as custom attributes to all log events forwarded to New Relic. If sending using an environment variable, the value must be formatted like: "key1:val1;key2:val2;key3:val3" + + Configure `CustomInsightsEvents.CustomAttributesValues` by calling `ConfigCustomInsightsCustomAttributesValues()`. + + ```go + app, err := newrelic.NewApplication( + newrelic.ConfigAppName("Your Application Name"), + newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")), + func(config *newrelic.Config) { + config.CustomInsightsEvents.CustomAttributesValues = map[string]string{ + "key1": "val1", + "key2": "val2", + "key3": "val3", + } + }, + ) + ``` +
## Transaction events configuration [#transaction-events-settings]