Como Configurar o Monitoramento do Qdrant

Primeiro, configure o Prometheus para coletar métricas, depois as sondas de saúde e, por fim, os alertas. Não pule a configuração de monitoramento antes de ir para produção.

Métricas do Prometheus

Use quando: configurar a coleta de métricas pela primeira vez ou adicionar uma nova implantação.

• Métricas de nó no endpoint /metrics Documentação de Monitoramento
• Métricas de cluster em /sys_metrics (apenas Qdrant Cloud)
• Personalização de prefixo via configuração service.metrics_prefix ou variável de ambiente QDRANT__SERVICE__METRICS_PREFIX
• Exemplo de configuração auto-hospedada com Prometheus + Grafana repositório prometheus-monitoring

Coleta de Métricas Híbrida na Nuvem

Use quando: executar o Qdrant Hybrid Cloud e precisar de visibilidade em nível de cluster.

Não colete apenas métricas dos nós do Qdrant. No Hybrid Cloud, você gerencia o plano de dados do Kubernetes. Você também deve coletar métricas dos pods cluster-exporter e operator para visibilidade completa do cluster e do estado do operador.

• Tutorial de configuração do Prometheus para Hybrid Cloud Hybrid Cloud Prometheus
• Dashboards oficiais do Grafana repositório de dashboards Grafana

Sondas de Liveness e Readiness

Use quando: configurar verificações de saúde do Kubernetes.

• Use /healthz, /livez, /readyz para status básico, liveness e readiness endpoints de saúde do Kubernetes

Alertas

Use quando: configurar alertas para implantações em produção ou Hybrid Cloud.

• O Hybrid Cloud oferece aproximadamente 11 alertas Prometheus pré-configurados prontos para uso Monitoramento de cluster na nuvem
• Use AlertmanagerConfig para rotear alertas para Slack, PagerDuty ou outros destinos com base em rótulos
• No mínimo, alerte sobre: erros do otimizador, nó não pronto, fator de replicação abaixo do alvo, uso de disco >80%

Centralização de Logs e Logs de Auditoria

Use quando: conformidade empresarial exige logs centralizados ou trilhas de auditoria.

• Habilite o formato de log JSON para análise estruturada: defina logger.format para json na configuração Configuração
• Use FluentD/OpenSearch para agregação de logs
• Logs de auditoria (v1.17+) são gravados no sistema de arquivos local (/qdrant/storage/audit/), não no stdout. Monte um Volume Persistente e implante um contêiner sidecar para rastrear esses arquivos para stdout para que os DaemonSets possam capturá-los. Logs de auditoria

O Que NÃO Fazer

• Coletar métricas de /sys_metrics em implantações auto-hospedadas (disponível apenas no Qdrant Cloud)
• Coletar métricas apenas dos nós do Qdrant no Hybrid Cloud (você perderá as métricas do cluster-exporter e do operador)
• Pular a configuração de monitoramento antes de ir para produção (você vai se arrepender)
• Alertar sobre o uso de memória da cache de página (ela deve preencher a RAM disponível, comportamento normal do sistema operacional)