# Configure Monitoring with New Relic

You can monitor your SingleStore Helios workspaces using New Relic via the [OpenTelemetry Collector](https://opentelemetry.io/docs/collector/). To visualize the SingleStore Prometheus metrics, use the [Prometheus receiver](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/prometheusreceiver) and send metrics data to New Relic.

## Prerequisites

* A Kubernetes cluster and the `kubectl` command-line tool.
* A New Relic account and a [license key](https://docs.newrelic.com/docs/apis/intro-apis/new-relic-api-keys/#license-key) used for data ingest.
* An active SingleStore Helios deployment.
* A SingleStore [API key](https://docs.singlestore.com/cloud/reference/management-api/#section-idm4495199953840032756423936306.md).

## Configure OpenTelemetry and New Relic

To ingest the SingleStore Prometheus metrics into New Relic using OpenTelemetry,

1. Clone the [New Relic OpenTelemetry Examples](https://github.com/newrelic/newrelic-opentelemetry-examples) GitHub repository.

2. Change directory to the `newrelic-opentelemetry-examples/other-examples/collector/singlestore/k8s/` directory.

3. Update the New Relic API (license) key and SingleStore API key values in the `secrets.yaml` file.
   ```
   stringData:
     NEW_RELIC_API_KEY: <New_Relic_api_key>
     SINGLESTORE_API_KEY: <SingleStore_api_key>
   ```

4. Update the SingleStore organization ID and workspace group ID in the `collector.yaml` file. To find these IDs, navigate to your SingleStore workspace group on the [Cloud Portal](https://portal.singlestore.com). In the URL,

   * The alphanumeric values next to `/organizations/` is the organization ID.
   * The alphanumeric values next to `/workspaces/` is the workspace group ID.
   ```
   - name: SINGLESTORE_ORG_ID
     value: <SingleStore_organization_ID>
   - name: SINGLESTORE_WORKSPACE_GROUP_ID
     value: <SingleStore_workspace_group_ID>
   ```

5. Run the application using the following command:
   ```shell
   kubectl apply -f k8s/
   ```

To reset the configuration or clean resources, run the following command:

```shell
kubectl delete -f k8s/
```

## View the Metrics

To view the SingleStore metrics, query the New Relic data:

```
FROM Metric SELECT uniques(metricName) WHERE otel.library.name = 'otelcol/prometheusreceiver' AND metricName LIKE 'singlestore%'
```

Refer to [How to query your New Relic data](https://docs.newrelic.com/docs/query-your-data/explore-query-data/get-started/introduction-querying-new-relic-data/) for more information.

To view the SingleStore dashboard,

1. Go to [one.newrelic.com](http://one.newrelic.com), and select **Integrations & Agents** on the left navigation pane.

2. On the **Integrations & Agents** page, search **SingleStore**, and select **SingleStore OpenTelemetry**.

3. On the **Installation plan** dialog,

   1. Select an account.

   2. [Configure OpenTelemetry and New Relic](https://docs.singlestore.com/#section-idm234728425434249.md) and select **Done**. Skip this step if the integration is already configured.

   3. Select **See your data**.

The SingleStore dashboard opens.

## References

* [Monitoring SingleStore with OpenTelemetry Collector](https://github.com/newrelic/newrelic-opentelemetry-examples/tree/main/other-examples/collector/singlestore)
* [How to query your New Relic data](https://docs.newrelic.com/docs/query-your-data/explore-query-data/get-started/introduction-querying-new-relic-data/)
* [OpenTelemetry Collector](https://opentelemetry.io/docs/collector/)
* [SingleStore OpenTelemetry](https://newrelic.com/instant-observability/singlestore)

***

Modified at: January 9, 2025

Source: [/cloud/user-and-workspace-administration/workspace-health-and-performance/configure-monitoring-with-new-relic/](https://docs.singlestore.com/cloud/user-and-workspace-administration/workspace-health-and-performance/configure-monitoring-with-new-relic/)

(An index of the documentation is available at /llms.txt)