qdrant-monitoring-setup
Guides on setting up monitoring for Qdrant, including alerts and logs.
What it does
This guide helps you set up Qdrant monitoring. It covers collecting metrics with Prometheus, configuring health checks, monitoring Qdrant Hybrid Cloud, setting up alerts, and centralizing logs.
When to use it
- ✓Setting up metric collection for the first time.
- ✓Ensuring your application is healthy with probes.
- ✓Centralizing logs for auditing and compliance.
Example of what to ask your AI
“How do I set up Qdrant monitoring with Prometheus and Grafana?”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
The guide walks you through setting up Prometheus to collect metrics, then configuring health probes for status checks, and finally setting up alerts and log centralization.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add github/awesome-copilot --skill qdrant-monitoring-setupOr download just the file:
curl -L https://raw.githubusercontent.com/github/awesome-copilot/main/skills/qdrant-monitoring/setup/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
How to Set Up Qdrant Monitoring
Get Prometheus scraping working first, then health probes, then alerting. Do not skip monitoring setup before going to production.
Prometheus Metrics
Use when: setting up metric collection for the first time or adding a new deployment.
- Node metrics at
/metricsendpoint Monitoring docs - Cluster metrics at
/sys_metrics(Qdrant Cloud only) - Prefix customization via
service.metrics_prefixconfig orQDRANT__SERVICE__METRICS_PREFIXenv var - Example self-hosted setup with Prometheus + Grafana prometheus-monitoring repo
Hybrid Cloud Scraping
Use when: running Qdrant Hybrid Cloud and need cluster-level visibility.
Do not just scrape Qdrant nodes. In Hybrid Cloud, you manage the Kubernetes data plane. You must also scrape the cluster-exporter and operator pods for full cluster visibility and operator state.
- Hybrid Cloud Prometheus setup tutorial Hybrid Cloud Prometheus
- Official Grafana dashboards Grafana dashboard repo
Liveness and Readiness Probes
Use when: configuring Kubernetes health checks.
- Use
/healthz,/livez,/readyzfor basic status, liveness, and readiness Kubernetes health endpoints
Alerting
Use when: setting up alerts for production or Hybrid Cloud deployments.
- Hybrid Cloud provides ~11 pre-configured Prometheus alerts out of the box Cloud cluster monitoring
- Use AlertmanagerConfig to route alerts to Slack, PagerDuty, or other targets based on labels
- At minimum, alert on: optimizer errors, node not ready, replication factor below target, disk usage >80%
Log Centralization and Audit Logging
Use when: enterprise compliance requires centralized logs or audit trails.
- Enable JSON log format for structured analysis: set
logger.formattojsonin config Configuration - Use FluentD/OpenSearch for log aggregation
- Audit logs (v1.17+) write to local filesystem (
/qdrant/storage/audit/), not stdout. Mount a Persistent Volume and deploy a sidecar container to tail these files to stdout so DaemonSets can pick them up. Audit logging
What NOT to Do
- Scrape
/sys_metricson self-hosted (only available on Qdrant Cloud) - Scrape only Qdrant nodes in Hybrid Cloud (miss cluster-exporter and operator metrics)
- Skip monitoring setup before going to production (you will regret it)
- Alert on page cache memory usage (it's supposed to fill available RAM, normal OS behavior)
FAQ
What are 'health probes'?
These are automatic checks that tell if Qdrant is running (liveness) and ready to handle requests (readiness).
What is Qdrant Hybrid Cloud?
It's a version of Qdrant running in environments like Kubernetes, requiring broader monitoring that includes extra components.
Where are audit logs stored?
In recent versions, audit logs are saved to Qdrant's local filesystem, not directly to standard output.
Details
Original description by the author
Guides Qdrant monitoring setup including Prometheus scraping, health probes, Hybrid Cloud metrics, alerting, and log centralization. Use when someone asks 'how to set up monitoring', 'Prometheus config', 'Grafana dashboard', 'health check endpoints', 'how to scrape Hybrid Cloud', 'what alerts to set', 'how to centralize logs', or 'audit logging'.
repo: github/awesome-copilot
Popularity
- GitHub stars
- 40k
- Ranking position
- #5301
- License
- MIT
- Updated
- 10/15/2026
Comments
- …
More skills from this repository
acquire-codebase-knowledge
Helps your agent understand and document an existing code project. It's useful for onboarding new people or getting an overview of the architecture.
github/awesome-copilot
acreadiness-assess
Enables your agent to assess a project's readiness for AI and generate a report. It's useful for understanding how well a project is prepared to use AI tools.
github/awesome-copilot
acreadiness-generate-instructions
Helps your agent create instructions for AI tools based on an assessment. It's useful for improving how AI interacts with code and closing identified gaps.
github/awesome-copilot
acreadiness-policy
Enables your agent to help define or apply policies for AI project assessment. It's useful for standardizing how projects are evaluated and ensuring compliance.
github/awesome-copilot
Similar skills
clickhouse-io
Helps your agent optimize queries and schemas in ClickHouse databases. It applies best practices for high-performance analytical workloads. Use when analytical queries are too slow.
affaan-m/ECC
scientific-db-pubmed-database
Helps your agent search for scientific articles in the biomedical field. It's useful for research needing specific medical information.
affaan-m/ECC
scientific-db-uspto-database
Allows the agent to look up official US patent and trademark data. It's useful for intellectual property research.
affaan-m/ECC