> ## Documentation Index
> Fetch the complete documentation index at: https://artie.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrations

> Send Artie pipeline metrics to Datadog or Grafana Cloud.

Artie can send pipeline metrics to Datadog or Grafana Cloud so you can monitor throughput, lag, flush behavior, and replication health alongside your existing telemetry.

## Datadog

<Note>For Datadog setup instructions and the available metrics, see the [Artie integration in Datadog](https://docs.datadoghq.com/integrations/artie/).</Note>

## Grafana Cloud Metrics

Connect Grafana Cloud Metrics to send the same pipeline metrics available in Artie to your Grafana Cloud account. Artie sends metrics with Prometheus remote write; you do not need to run Prometheus, Grafana Alloy, or a collector.

### What you'll need

* A Grafana Cloud stack with a Metrics instance.
* A Grafana Cloud access-policy token with permission to write metrics.
* Company admin access in Artie.

### Create Grafana Cloud credentials

1. In Grafana Cloud, open your stack and select the **Prometheus** or **Metrics** card.
2. Select **Details** and copy the Metrics remote-write URL and Metrics instance ID.
3. Create an access-policy token that can write metrics, then copy the token.

The remote-write URL ends in `/api/prom/push`.

<img src="https://mintcdn.com/artie/8LlUF13QfSK6wJF9/assets/grafana-cloud-metrics-credentials.png?fit=max&auto=format&n=8LlUF13QfSK6wJF9&q=85&s=8b4a606fb98f99174aeb2da10a5fc7ac" alt="Grafana Cloud Metrics details showing the remote-write endpoint, Metrics instance ID, and API token controls" width="1015" height="616" data-path="assets/grafana-cloud-metrics-credentials.png" />

### Connect Grafana Cloud in Artie

<Steps>
  <Step title="Open integrations">
    In Artie, open **Settings** and select **Integrations**.
  </Step>

  <Step title="Enter Grafana Cloud credentials">
    Under **Grafana Cloud Metrics**, enter the remote-write URL, Metrics instance ID, and access-policy token.
  </Step>

  <Step title="Connect">
    Select **Connect**. Artie stores the access-policy token encrypted at rest and does not display it after connection.
  </Step>
</Steps>

After the next export run, query the `artie_*` metrics in Grafana Cloud. Artie sends the existing pipeline metrics and dimensions, including pipeline, source, destination, data plane, table, operation, flush reason, and replication-slot labels when available.

### Import the Artie dashboard

Artie's [Datadog integration dashboard](https://github.com/DataDog/integrations-extras/tree/master/artie) organizes rows processed, performance, and database-health metrics. The Grafana dashboard uses the same six exported Artie metrics.

1. Download [the Artie Grafana dashboard JSON](/docs/assets/grafana-artie-overview.json).
2. In Grafana, open **Dashboards** and select **New** > **Import**.
3. Upload the JSON file, select the Grafana Cloud Metrics data source that receives Artie metrics for **Prometheus**, and select **Import**.
4. Open the imported **Artie Overview** dashboard. It includes rows processed, ingestion lag, row lag, flush time, flush count, and replication slot size panels.

The dashboard queries only the exported metric names and groups series using labels Artie adds when they are available: `pipeline`, `table`, `operation`, `reason`, and `slotname`. It includes no credentials, data-source URL, or customer identifiers.

<img src="https://mintcdn.com/artie/8LlUF13QfSK6wJF9/assets/grafana-artie-overview.png?fit=max&auto=format&n=8LlUF13QfSK6wJF9&q=85&s=9e8fd91d0c00020f1fc6a3deb6a92f24" alt="Artie Overview Grafana dashboard showing rows processed, lag, flush, and replication slot metrics" width="1712" height="1084" data-path="assets/grafana-artie-overview.png" />

### Disconnect Grafana Cloud

In **Settings** > **Integrations**, select **Disconnect Grafana**. Artie stops future exports after the integration is disconnected. You can also revoke the access-policy token in Grafana Cloud.

### Limits

This integration supports Grafana Cloud Metrics only. It does not send logs or traces, and it does not support self-hosted Grafana or custom Prometheus-compatible endpoints.

| Metric                | Grafana Cloud name               |
| --------------------- | -------------------------------- |
| Rows processed        | `artie_rows_processed`           |
| Ingestion lag         | `artie_ingestion_lag_ms`         |
| Row lag               | `artie_row_lag`                  |
| Flush time            | `artie_flush_time_ms`            |
| Flush count           | `artie_flush_count`              |
| Replication slot size | `artie_replication_slot_size_mb` |

<Accordion title="Table-level metric labels and Grafana Cloud costs">
  Artie preserves table-level dimensions from the Datadog integration. Each table can create additional active time series in Grafana Cloud. Review your Grafana Cloud plan and usage when connecting pipelines with many tables.
</Accordion>

### Troubleshooting

* Confirm that the remote-write URL uses HTTPS, ends in `/api/prom/push`, and belongs to your Grafana Cloud Metrics instance.
* Confirm that the Metrics instance ID and access-policy token are copied from the same Grafana Cloud stack.
* If metrics do not appear, disconnect and reconnect with a newly created write token.

For Grafana Cloud's credential and remote-write setup, see [Send metrics data from Prometheus](https://grafana.com/docs/grafana-cloud/observe-and-act/send-data/metrics/metrics-prometheus/).