用途:指导 Qdrant 监控体系的搭建,建议顺序为先让 Prometheus 抓取生效,再配置健康探针,最后设置告警;上生产前不应跳过监控配置。
主要能力与用法: Prometheus 指标:节点指标位于 /metrics 端点;集群指标位于 /sys_metrics(仅 Qdrant Cloud 可用)。可通过 service.metrics_prefix 配置项或 QDRANT__SERVICE__METRICS_PREFIX 环境变量自定义前缀。自托管可参考 Prometheus + Grafana 的 prometheus-monitoring 仓库示例。 Hybrid Cloud 抓取:不能只抓取 Qdrant 节点。在 Hybrid Cloud 中用户管理 Kubernetes 数据平面,还需抓取 cluster-exporter 与 operator pod,以获得完整集群可见性与 operator 状态。可参考 Hybrid Cloud Prometheus 教程与官方 Grafana 仪表盘仓库。 健康探针:Kubernetes 健康检查使用 /healthz、/livez、/readyz,分别对应基本状态、存活与就绪。 告警:Qdrant Cloud 为 11 类集群问题提供预配置邮件告警;需要自定义告警或路由到其他目标时使用抓取的指标。可用 AlertmanagerConfig 按标签将告警路由到 Slack、PagerDuty 等。至少应对以下情况告警:optimizer 错误、节点未就绪、复制因子低于目标、磁盘使用率超过 80%。 日志集中化与审计日志:在配置中将 logger.format 设为 json 以启用结构化日志分析;使用 FluentD/OpenSearch 做日志聚合。审计日志(v1.17+)写入本地文件系统 /qdrant/storage/audit/,而非 stdout;需挂载 Persistent Volume 并部署 sidecar 容器将这些文件 tail 到 stdout,以便 DaemonSet 采集。
限制与注意事项:不要在自托管环境抓取 /sys_metrics(仅 Qdrant Cloud 提供);Hybrid Cloud 中不要只抓取 Qdrant 节点而遗漏 cluster-exporter 与 operator 指标;不要对 page cache 内存使用告警(其填满可用 RAM 属正常 OS 行为)。