How do I install the Qdrant Setup skill?

Run npx skillmds@latest add pyfagorass/qdrant-setup in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Qdrant Setup safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Qdrant Setup?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Qdrant Setup free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Qdrant Setup?

pyfagorass (@pyfagorass) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Qdrant Setup by pyfagorass — Agent Skill

Name: Qdrant Setup
Author: pyfagorass

Qdrant Setup

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'.

pyfagorass 3a7b069 3.3 KB Updated Sep 17, 2026

File contents

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 /metrics endpoint Monitoring docs
Cluster metrics at /sys_metrics (Qdrant Cloud only)
Prefix customization via service.metrics_prefix config or QDRANT__SERVICE__METRICS_PREFIX env 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, /readyz for 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.format to json in 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_metrics on 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)

---name: qdrant-setupdescription: 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'.---# How to Set Up Qdrant MonitoringGet Prometheus scraping working first, then health probes, then alerting. Do not skip monitoring setup before going to production.## Prometheus MetricsUse when: setting up metric collection for the first time or adding a new deployment.- Node metrics at `/metrics` endpoint [Monitoring docs](https://skills.qdrant.tech/md/documentation/ops-monitoring/monitoring/)- Cluster metrics at `/sys_metrics` (Qdrant Cloud only)- Prefix customization via `service.metrics_prefix` config or `QDRANT__SERVICE__METRICS_PREFIX` env var- Example self-hosted setup with Prometheus + Grafana [prometheus-monitoring repo](https://github.com/qdrant/prometheus-monitoring)## Hybrid Cloud ScrapingUse 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](https://skills.qdrant.tech/md/documentation/ops-monitoring/hybrid-cloud-prometheus/)- Official Grafana dashboards [Grafana dashboard repo](https://github.com/qdrant/qdrant-cloud-grafana-dashboard)## Liveness and Readiness ProbesUse when: configuring Kubernetes health checks.- Use `/healthz`, `/livez`, `/readyz` for basic status, liveness, and readiness [Kubernetes health endpoints](https://skills.qdrant.tech/md/documentation/ops-monitoring/monitoring/?s=kubernetes-health-endpoints)## AlertingUse 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](https://skills.qdrant.tech/md/documentation/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 LoggingUse when: enterprise compliance requires centralized logs or audit trails.- Enable JSON log format for structured analysis: set `logger.format` to `json` in config [Configuration](https://skills.qdrant.tech/md/documentation/ops-configuration/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](https://skills.qdrant.tech/md/documentation/security/?s=audit-logging)## What NOT to Do- Scrape `/sys_metrics` on 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)

Frequently asked questions