# Custom observability & analytics

If your team has an in-house analytics framework, or would otherwise like to compute metrics on your own servers and push them as needed to Runway, you can connect a custom Observability & analytics integration to accomplish this. Once connected, a unique integration identifier will be generated that you can use to construct an endpoint URL for Runway's public API that can be used to stream data points to your app's integration in Runway.

## Set up

### Navigate to the Integration settings view

1. Select an app in the top left corner from the Switcher
2. Navigate to **App Settings** by clicking the gear icon (⚙️) at the top of the Timeline sidebar
3. Click on **Integrations** in the sidebar

### Connect a new integration

1. Find the **Custom Analytics** integration module under the **Observability & analytics** section.
2. Click the **Connect** button.
3. You'll be prompted to choose a **Display Name** for your custom integration. This can be helpful if you intend to connect multiple custom analytics integrations from different data sources.
4. Click **Submit**.

A custom integration will be connected, and its unique integration identifier will be surfaced in the integration details table. You'll need this identifier to construct the public API endpoint that you'll use to send the integration data. 

<figure><img src="https://727226624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjFmyReUsbJqDjHEAlW%2Fuploads%2Fzh0JXjGphwfUejqgukeI%2Fimage.png?alt=media&#x26;token=11e8b947-f84b-4182-abc5-9ea6071b7a86" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
As events are sent to Runway and processed, they'll be shown in the "Events detected" list in the integration details table, along with the date and time of the last received event.&#x20;
{% endhint %}

Once events are received and processed by Runway, they'll be visible in the [Health Metrics page](https://docs.runway.team/using-runway/app-settings/health-metrics-settings) and available for the configuration of Observability & Analytics health metrics for your app.&#x20;

{% hint style="info" %}
Health metrics must be set up in order for custom analytics event data to be visible on the Rollouts page for releases in Runway.
{% endhint %}

### Sending data to the custom integration

Once the custom integration is set up and configured, data points can be sent to it using Runway's public API.&#x20;

For more details on how to send data to your custom Observability & analytics integration, visit our [public API documentation](https://api-docs.runway.team/#tag/app/operation/ingestCustomOBAAEvents).