> ## Documentation Index
> Fetch the complete documentation index at: https://upstash-worktree-docs-descriptions.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Prometheus - Upstash QStash Integration

> Scrape Upstash QStash metrics into Prometheus and visualize them in Grafana to monitor message delivery and performance.

To monitor your QStash metrics in Prometheus and visualize in Grafana, follow these steps:

<Check>
  **Integration Scope**

  Upstash Prometheus Integration covers Prod Pack.
</Check>

## **Step 1: Enable Prometheus in Upstash Console**

1. Open the Upstash Console and navigate to QStash.
2. Go to Settings → Monitoring.
3. Enable Prometheus to allow scraping QStash metrics.

<img src="https://mintcdn.com/upstash-worktree-docs-descriptions/ZxFMtb5kLiuAUFsm/img/prometheus/configuration-qstash.png?fit=max&auto=format&n=ZxFMtb5kLiuAUFsm&q=85&s=c97f4180d74a7ea784dc2a39e381cf3c" alt="configuration.png" width="1956" height="680" data-path="img/prometheus/configuration-qstash.png" />

## **Step 2: Copy Monitoring Token**

1. After enabling, a monitoring token is generated and displayed.
2. Copy the token. It will be used to authenticate Prometheus requests.

<Check>
  **Header Format**

  Send the token as `Authorization: Bearer <MONITORING_TOKEN>`.
</Check>

<img src="https://mintcdn.com/upstash-worktree-docs-descriptions/ZxFMtb5kLiuAUFsm/img/prometheus/monitoring-token.png?fit=max&auto=format&n=ZxFMtb5kLiuAUFsm&q=85&s=ea3016718184f95ca61a6f877c1d810e" alt="monitoring-token.png" width="950" height="520" data-path="img/prometheus/monitoring-token.png" />

## **Step 3: Configure Prometheus (via Grafana Data Source)**

1. In Grafana, add a Prometheus data source.
2. Set the address to `https://api.upstash.com/monitoring/prometheus`.
3. In HTTP headers, add the monitoring token.

<img src="https://mintcdn.com/upstash-worktree-docs-descriptions/ZxFMtb5kLiuAUFsm/img/prometheus/datasource.png?fit=max&auto=format&n=ZxFMtb5kLiuAUFsm&q=85&s=ca8a3daa633436055ae41b64f504c543" alt="datasource.png" width="1848" height="464" data-path="img/prometheus/datasource.png" />

<img src="https://mintcdn.com/upstash-worktree-docs-descriptions/ZxFMtb5kLiuAUFsm/img/prometheus/headers.png?fit=max&auto=format&n=ZxFMtb5kLiuAUFsm&q=85&s=ae33b9759ccb88725735aa4948571557" alt="headers.png" width="1322" height="346" data-path="img/prometheus/headers.png" />

Click <b>Test and Save</b>.

<img src="https://mintcdn.com/upstash-worktree-docs-descriptions/ZxFMtb5kLiuAUFsm/img/prometheus/datasource-final.png?fit=max&auto=format&n=ZxFMtb5kLiuAUFsm&q=85&s=bdc7614542676d340d9fbe6009cce42b" alt="datasource-final.png" width="1560" height="412" data-path="img/prometheus/datasource-final.png" />

## **Step 4: Import Dashboard**

You can use the Upstash Grafana dashboard to visualize QStash metrics.

Open the import dialog and use: <a href="https://grafana.com/grafana/dashboards/24206-upstash-qstash-dashboard/">Upstash QStash Dashboard</a>

<img src="https://mintcdn.com/upstash-worktree-docs-descriptions/ZxFMtb5kLiuAUFsm/img/prometheus/grafana-qstash-dashboard.png?fit=max&auto=format&n=ZxFMtb5kLiuAUFsm&q=85&s=5412a28bf8c47cfdabfa7296d8a0a663" alt="grafana-dashboard.png" width="2978" height="1250" data-path="img/prometheus/grafana-qstash-dashboard.png" />

## **Conclusion**

You’ve integrated QStash with Prometheus. Use Grafana to explore message throughput, retries, DLQ, schedules, and Upstash Workflows.

If you encounter issues, contact support.