Knowledge Base Metrics

Track Knowledge Base ingestion and retrieval, including connector failures and permission sync gaps.

Metrics

MetricLabelsMeasures
rag_connector_syncs_total, rag_connector_sync_duration_secondsconnector_type, statusConnector syncs (success, failed, or partial) and their duration
rag_documents_processed_total, rag_documents_ingested_total, rag_chunks_created_totalconnector_typeDocuments read, documents added or updated, and chunks created
rag_documents_without_text_totalconnector_typeDocuments skipped because they have no extractable text
rag_ocr_pages_totalconnector_type, outcomeScanned PDF pages sent to OCR
rag_embedding_batches_total, rag_embedding_documents_totalstatusEmbedding batches and documents
rag_queries_total, rag_query_duration_seconds, rag_query_results_countsearch_typeSearches, their end-to-end duration, and results returned
rag_search_lane_timeout_totallaneSearch lanes cut by the database statement timeout
rag_quote_verification_totalresultChat-answer quotes checked against their cited source
rag_permission_syncs_totalconnector_type, statusPermission sync passes
rag_permission_sync_*connector_typePermission sync gaps: group failures, dropped principals, ACL over-approximations, unreadable containers, restriction fallbacks, and skipped identity lookups
rag_access_token_truncations_totalkindUsers whose group memberships exceeded the per-user cap at query time
rag_knowledge_query_unresolved_identity_totalSearches limited to organization-wide documents because the caller had no email