SuperAPI AI 工具集

qdrant-monitoring-setup

部署与运维

查看项目

更新于 10-16 08:48

技能介绍

用途:为 Qdrant 搭建完整监控,建议顺序为先用 Prometheus 抓取,再配置健康探针,最后设置告警,生产上线前不要跳过监控。

主要能力: 一、Prometheus 指标。节点指标在 /metrics 端点;集群指标在 /sys_metrics(仅 Qdrant Cloud 可用)。可通过 service.metrics_prefix 配置或 QDRANT__SERVICE__METRICS_PREFIX 环境变量自定义前缀。自托管可参考 Prometheus + Grafana 示例仓库。 二、混合云抓取。混合云中用户管理 Kubernetes 数据平面,除了抓取 Qdrant 节点,还必须抓取 cluster-exporter 和 operator pod,才能获得集群级可见性与 operator 状态。有官方 Grafana 仪表盘可参考。 三、存活与就绪探针。Kubernetes 健康检查使用 /healthz、/livez、/readyz 分别对应基础状态、存活和就绪。 四、告警。混合云开箱提供约 11 条预配置 Prometheus 告警;可用 AlertmanagerConfig 按标签路由到 Slack、PagerDuty 等目标。至少应告警:优化器错误、节点未就绪、副本因子低于目标、磁盘使用率超过 80%。 五、日志集中化与审计日志。将 logger.format 设为 json 以启用结构化日志分析;可用 FluentD/OpenSearch 聚合日志。审计日志(v1.17+)写入本地文件系统 /qdrant/storage/audit/ 而非 stdout,需挂载持久卷并部署 sidecar 容器将文件 tail 到 stdout,以便 DaemonSet 采集。

限制与注意事项:自托管不要抓取 /sys_metrics(仅 Qdrant Cloud 提供);混合云中不要只抓 Qdrant 节点,会漏掉 cluster-exporter 和 operator 指标;不要对 page cache 内存使用量告警,其填满可用内存属正常系统行为。