Skip to main content
To monitor your QStash metrics in Prometheus and visualize in Grafana, follow these steps:
Integration ScopeUpstash Prometheus Integration covers Prod Pack.

​
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.
configuration.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.
Header FormatSend the token as Authorization: Bearer <MONITORING_TOKEN>.
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.
datasource.png headers.png Click Test and Save. datasource-final.png

​
Step 4: Import Dashboard

You can use the Upstash Grafana dashboard to visualize QStash metrics. Open the import dialog and use: Upstash QStash Dashboard grafana-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.