> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/internal-developer-portal/use-idp/plugins/available-plugins/new-relic.md).

# New Relic

| Plugin details |                                                                                                         |
| -------------- | ------------------------------------------------------------------------------------------------------- |
| **Created by** | [timwheelercom](https://github.com/timwheelercom)                                                       |
| **Category**   | Monitoring                                                                                              |
| **Source**     | [GitHub](https://github.com/backstage/community-plugins/tree/main/workspaces/newrelic/plugins/newrelic) |
| **Type**       | Open-source plugin                                                                                      |

### Configuration <a href="#configuration" id="configuration"></a>

#### Application configuration YAML <a href="#application-configuration-yaml" id="application-configuration-yaml"></a>

This plugin requires a backend proxy configuration to make calls to Opsgenie with authentication.

* Under the **Plugins** tab in **Configure**, go to `app-config.yaml` and **Edit YAML** to configure your NewRelic instance in the **target** field and add your **domain** in the format as shown below.

```yaml
# app-config.yaml <a href="#app-configyaml" id="app-configyaml"></a>
proxy:
  endpoints:
    '/newrelic/apm/api':
      target: https://api.newrelic.com/v2
      pathRewrite:
        api/proxy/newrelic/apm/api?: /
      headers:
        X-Api-Key: ${NEW_RELIC_REST_API_KEY}
      allowedHeaders:
        - link
```

#### Secrets <a href="#secrets" id="secrets"></a>

* There are some types of API key on new relic, to this use must be `User` type of key. Read more about how to find or generate this key in [New Relic's Documentation](https://docs.newrelic.com/docs/apis/get-started/intro-apis/types-new-relic-api-keys#rest-api-key).
* **Create secret in Harness** to store API token, click on “New Secret Text” and enter values as shown below.

![](/files/5xlv8py0pkDk9uMOK8Kd)

### Layout <a href="#layout" id="layout"></a>

*No action required*

* This plugin exports a page that you can use as a **New Relic** page on the **Sidenav** to view New Relic Application Performance Monitoring (APM) data such as:
  1. Application Name
  2. Response Time (ms)
  3. Throughput (rpm)
  4. Error Rate
  5. Instance Count
  6. Apdex Score
* Since the plugin shows all the data in a single view and is not related to any one particular service, a Sidenav is more appropriate and is added by default than a tab.
* The following configuration is set by default in **Layout** under **Sidenav Layout** and you do not need to change anything:

```yaml
- name: SidebarItem
  props:
    to: NewRelicPage
    text: NewRelic
```

![](/files/yWzhDXovxDwzolp3SVm8)

### Annotations <a href="#annotations" id="annotations"></a>

*Not-Required*

### Support <a href="#support" id="support"></a>

The plugin is owned by Backstage Community and managed in this [repository](https://github.com/backstage/community-plugins/tree/main/workspaces/newrelic/plugins/newrelic) as an open-source project. Create a GitHub issue to report bugs or suggest new features for the plugin.