Forwarding Logs to New Relic

This guide covers configuration of your App Builder application to forward logs to your New Relic deployment.

Prerequisites

A New Relic account and an Ingest license API key.
A local development setup for your App Builder application.
The latest version of AIO CLI. Check by running aio --version; update by running npm install -g @adobe/aio-cli

data-variant=info

data-slots=text

App Builder does not support creating a new New Relic license key. Before configuring log forwarding, obtain an existing INGEST - LICENSE key from your organization's New Relic account administrator.

Identify the API key and base URI

Obtain an existing INGEST - LICENSE key from your organization's New Relic account administrator and copy the key value for later use.

App Builder does not support creating a new New Relic license key. If your organization does not already have an appropriate key, contact your New Relic account administrator.
Depending on the region hosting your New Relic account, you must use the United States or Europe endpoint as a base uri.

If you don't know the region of your New Relic instance, check the browser URL of your New Relic home.
- If the URL begins with https://one.newrelic.com/, specify https://log-api.newrelic.com/log/v1 as the URI
- If it begins with https://one.eu.newrelic.com/, specify https://log-api.eu.newrelic.com/log/v1

Set up log forwarding in App Builder

From the command line, navigate to the App Builder project directory on your local machine.

Run this command, providing values from previous steps:

aio app config set log-forwarding
? select log forwarding destination: New Relic
? base URI: <base_uri>
? license key: <license_key>

The URI value must include the protocol (https://).

Verify that the configuration change has taken effect:
```
aio app config get log-forwarding
```
To generate logs, execute an action in your App Builder application workspace.
Go to New Relic Home > Logs and run your query.
If you don't see any logs in New Relic, check for log forwarding errors:
```
aio app config get log-forwarding errors
```

Next steps

If you are unable to set up log forwarding using these procedures, visit Adobe Experience League Built by Developers Community for support.

Return to Managing Application Logs.

Return to Guides Index.