---
title: Install monitoring components
source: https://docs.newrelic.com/docs/sap-solutions/install-and-configure/install-out-of-the-box
---

New Relic monitoring for SAP includes out-of-the-box monitoring components: dashboards, alert policies, and the IDOC Explorer.

## Before you begin

To perform these tasks, you must have New Relic Admin privileges on the account.

> #### ⚠️ IMPORTANT
>
> For the **SAP Cockpit** dashboard, you must [create a lookup table](#create-lookup-table) named `NR_LKUP_SYSTEM` before installation.

## Locate SAP monitoring components [#locate-components]

1.  Go to **[one.newrelic.com](https://one.newrelic.com)**. If you manage multiple accounts, select the sub-account that collects SAP data.
2.  Select **+ Integrations & Agents** > **Apps & Visualizations**.
3.  Search for **SAP**. Results show all available apps, alert policies, and dashboards for SAP monitoring.

## Install dashboards

### Create lookup table [#create-lookup-table]

> #### 💡 TIP
>
> Only required for the **SAP Cockpit** dashboard.

The **SAP Cockpit** dashboard uses a **lookup table** for **SAP systems** and their environments.

1.  Create the **lookup table** with two columns: `SYS_ID` and `Env`, and save it as a **CSV file**. Here is a sample of the lookup file:

    ```csv
    SYS_ID,Env
    GD1,DEV
    SD2,DEV
    AQ1,Testing
    AQ2,Testing
    SP1,Prod
    SP2,Prod
    ```

2.  Go to **Log > Lookup Tables**.

3.  Click **Add a table**.

4.  In the **Add a lookup table** sidebar, name the table **NR_LKUP_SYSTEM**, and upload the **CSV file**. See [Lookup tables](https://docs.newrelic.com/docs/logs/ui-data/lookup-tables-ui/) for more information.

5.  To verify the table content, use the **query builder** with `FROM lookup(NR_LKUP_SYSTEM) SELECT *`, then click **Run**.

### Install the dashboards [#install-dashboards]

1.  Go to **[one.newrelic.com](https://one.newrelic.com)** > **Integrations & Agents** and search for **New Relic Monitoring for SAP Solutions**. Alternatively, go to **Dashboards > Recommended Dashboards**, click **View all**, and search for SAP. See [Dashboards](https://docs.newrelic.com/docs/query-your-data/explore-query-data/dashboards/introduction-dashboards/) for more information.
2.  Select the **Dashboards** tab.
3.  Click a dashboard and select the account where you want to install it. The dashboard installs automatically.
4.  Install these dashboards:
    -   **SAP Dashboards**
    -   **SAP Cockpit**
    -   **SAP Data Collection Monitoring**
    -   **SAP Data Ingestion Estimate**

> #### 💡 TIP
>
> After you install the **SAP Cockpit** dashboard, open it and confirm that the landing page reflects the correct system status. This verifies that the `NR_LKUP_SYSTEM` lookup table maps your environments to systems correctly.

### Add dashboard filter [#add-dashboard-filter]

1.  Go to **[one.newrelic.com](https://one.newrelic.com)** > **Dashboards** and select a dashboard.
2.  Click the ellipsis (**…**) in the upper-right corner of a widget.
3.  Select **Edit** to open the edit screen.
4.  Toggle the **Filter the current dashboard** switch.

Enable facet linking for table, pie chart, and bar chart widgets to filter by **SAP system**, **instance**, **IDOC status**, **jobs**, and more.

## Install alert policies

1.  Go to **[one.newrelic.com](https://one.newrelic.com) > Alerts > Alert Policies**.

2.  Search and click **New Relic Monitoring for SAP Solutions alert policy**.

    ![A screenshot displaying the connection setup for New Relic Monitoring for SAP Solutions alert policy](https://docs.newrelic.com/images/new-relic-monitoring-for-sap-solutions-alert-policy.webp "New Relic Monitoring for SAP Solutions alert policy")

3.  In the **Alert condition** tab, select the account and toggle the **alert policy** to **Enable**. See [Manage your policies](https://docs.newrelic.com/docs/alerts/organize-alerts/create-edit-or-find-alert-policy/) for instructions on managing policies.

4.  Go back and search for **Nr4sap default alert policy**. Toggle on the **alert condition** you'd like to enable.

## Install IDOC Explorer

1.  Go to **[one.newrelic.com](https://one.newrelic.com) > Integrations & Agents**.

2.  Select **Apps & Visualizations**, and search for **IDOC Explorer**.

3.  Select **Manage access**. Choose the account for access to the app.

    ![A screenshot displaying the manage access settings for IDOC Explorer](https://docs.newrelic.com/images/idoc-explorer.webp "IDOC Explorer")

4.  Click **Update**. The **IDOC Explorer** appears when you view **IDOC entities**.