feat: complete observability stack (O1-O13) (#52)
## Complete Observability Stack (O1-O13) Implements all 13 observability issues in a single PR. 119 metrics total. ### Commits (one per issue) | Issue | Title | Metrics | |-------|-------|---------| | **O10** | Prometheus metrics module + /metrics endpoint | Foundation | | **O1** | Instrument ingest handler | I1-I12 (12) | | **O2** | Instrument query handler | Q1-Q12 (12) | | **O3** | Instrument context endpoint | C1-C8 (8) | | **O4** | Relevance judge | R1-R9 (9) | | **O5** | Write volume + storage metrics | W1-W12 (12) | | **O6** | Pod resource observability | P1-P13 | | **O7** | Availability + dependency health | A1-A10 (10) | | **O8** | Ingest rate pattern tracking | IR1-IR10 (10) | | **O9** | Postgres internal observability | PG1-PG33 | | **O11** | Grafana dashboard | 12 panels | | **O12** | Prometheus alerting rules | 11 alerts | | **O13** | Relevance evaluation CronJob | K8s manifest | ### Key Changes - **metrics.rs**: Zero-dependency Prometheus metrics (Counter, Gauge, Histogram, Timer) - **GET /metrics**: Prometheus text exposition format endpoint - **Ingest/Query/Context handlers**: Instrumented with latency, errors, auth failures - **Health check**: DB dependency check with latency tracking - **Background task**: Periodic DB stats collection (entity/edge counts, pool stats) - **Relevance judge**: Threshold-based eval with precision/recall/F1 tracking - **Grafana dashboard**: 12 panels covering all metric groups - **Alert rules**: 11 PrometheusRule alerts (availability, latency, errors, quality) - **CronJob**: Periodic relevance evaluation with sample queries ### Testing - 506 tests passing (0 failures) - All metrics modules have unit tests - Relevance judge: 4 tests ### Deploy ```bash # Grafana dashboard kubectl apply -f k8s/infra/grafana-dashboard.json # Prometheus alerts kubectl apply -f k8s/infra/prometheus-alerts.yaml # Relevance eval CronJob kubectl apply -f k8s/infra/relevance-eval-cronjob.yaml ``` Closes #27 #28 #29 #30 #31 #32 #33 #34 #35 #36 #37 #38 #39 --------- Co-authored-by: rock <[email protected]> Reviewed-on: #52 Co-authored-by: poimen <[email protected]>
This commit was merged in pull request #52.
This commit is contained in:
@@ -0,0 +1,131 @@
|
||||
{
|
||||
"annotations": { "list": [] },
|
||||
"editable": true,
|
||||
"fiscalYearStartMonth": 0,
|
||||
"graphTooltip": 0,
|
||||
"id": null,
|
||||
"links": [],
|
||||
"panels": [
|
||||
{
|
||||
"title": "Ingest Rate (req/s)",
|
||||
"type": "timeseries",
|
||||
"gridPos": { "h": 8, "w": 12, "x": 0, "y": 0 },
|
||||
"targets": [
|
||||
{ "expr": "rate(memory_ingest_requests_total[5m])", "legendFormat": "ingest req/s" }
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Query Rate (req/s)",
|
||||
"type": "timeseries",
|
||||
"gridPos": { "h": 8, "w": 12, "x": 12, "y": 0 },
|
||||
"targets": [
|
||||
{ "expr": "rate(memory_query_requests_total[5m])", "legendFormat": "query req/s" }
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Ingest Latency (p50/p95/p99)",
|
||||
"type": "timeseries",
|
||||
"gridPos": { "h": 8, "w": 12, "x": 0, "y": 8 },
|
||||
"targets": [
|
||||
{ "expr": "histogram_quantile(0.5, rate(memory_ingest_duration_seconds_bucket[5m]))", "legendFormat": "p50" },
|
||||
{ "expr": "histogram_quantile(0.95, rate(memory_ingest_duration_seconds_bucket[5m]))", "legendFormat": "p95" },
|
||||
{ "expr": "histogram_quantile(0.99, rate(memory_ingest_duration_seconds_bucket[5m]))", "legendFormat": "p99" }
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Query Latency (p50/p95/p99)",
|
||||
"type": "timeseries",
|
||||
"gridPos": { "h": 8, "w": 12, "x": 12, "y": 8 },
|
||||
"targets": [
|
||||
{ "expr": "histogram_quantile(0.5, rate(memory_query_duration_seconds_bucket[5m]))", "legendFormat": "p50" },
|
||||
{ "expr": "histogram_quantile(0.95, rate(memory_query_duration_seconds_bucket[5m]))", "legendFormat": "p95" },
|
||||
{ "expr": "histogram_quantile(0.99, rate(memory_query_duration_seconds_bucket[5m]))", "legendFormat": "p99" }
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Error Rates",
|
||||
"type": "timeseries",
|
||||
"gridPos": { "h": 8, "w": 12, "x": 0, "y": 16 },
|
||||
"targets": [
|
||||
{ "expr": "rate(memory_ingest_errors_total[5m])", "legendFormat": "ingest errors" },
|
||||
{ "expr": "rate(memory_query_errors_total[5m])", "legendFormat": "query errors" },
|
||||
{ "expr": "rate(memory_query_embedding_failures_total[5m])", "legendFormat": "embedding failures" }
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Embedding Latency",
|
||||
"type": "timeseries",
|
||||
"gridPos": { "h": 8, "w": 12, "x": 12, "y": 16 },
|
||||
"targets": [
|
||||
{ "expr": "histogram_quantile(0.5, rate(memory_query_embedding_duration_seconds_bucket[5m]))", "legendFormat": "p50" },
|
||||
{ "expr": "histogram_quantile(0.95, rate(memory_query_embedding_duration_seconds_bucket[5m]))", "legendFormat": "p95" }
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "DB Row Counts",
|
||||
"type": "stat",
|
||||
"gridPos": { "h": 4, "w": 12, "x": 0, "y": 24 },
|
||||
"targets": [
|
||||
{ "expr": "memory_db_table_entity_rows", "legendFormat": "entities" },
|
||||
{ "expr": "memory_db_table_edge_rows", "legendFormat": "edges" },
|
||||
{ "expr": "memory_db_table_chunk_rows", "legendFormat": "chunks" }
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Dependency Health",
|
||||
"type": "stat",
|
||||
"gridPos": { "h": 4, "w": 12, "x": 12, "y": 24 },
|
||||
"targets": [
|
||||
{ "expr": "memory_dependency_db_up", "legendFormat": "DB" },
|
||||
{ "expr": "memory_dependency_embedding_up", "legendFormat": "Embedding" },
|
||||
{ "expr": "memory_dependency_opensearch_up", "legendFormat": "OpenSearch" },
|
||||
{ "expr": "memory_dependency_llm_up", "legendFormat": "LLM" }
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "DB Pool Stats",
|
||||
"type": "timeseries",
|
||||
"gridPos": { "h": 8, "w": 12, "x": 0, "y": 28 },
|
||||
"targets": [
|
||||
{ "expr": "memory_db_pool_size", "legendFormat": "pool size" },
|
||||
{ "expr": "memory_db_pool_idle", "legendFormat": "idle" },
|
||||
{ "expr": "memory_db_pool_active", "legendFormat": "active" }
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Relevance Metrics",
|
||||
"type": "timeseries",
|
||||
"gridPos": { "h": 8, "w": 12, "x": 12, "y": 28 },
|
||||
"targets": [
|
||||
{ "expr": "memory_relevance_precision", "legendFormat": "precision" },
|
||||
{ "expr": "memory_relevance_recall", "legendFormat": "recall" },
|
||||
{ "expr": "memory_relevance_f1_score", "legendFormat": "F1" }
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "In-Flight Operations",
|
||||
"type": "timeseries",
|
||||
"gridPos": { "h": 8, "w": 12, "x": 0, "y": 36 },
|
||||
"targets": [
|
||||
{ "expr": "memory_ingest_in_flight", "legendFormat": "ingest" },
|
||||
{ "expr": "memory_query_in_flight", "legendFormat": "query" }
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Write Volume",
|
||||
"type": "timeseries",
|
||||
"gridPos": { "h": 8, "w": 12, "x": 12, "y": 36 },
|
||||
"targets": [
|
||||
{ "expr": "rate(memory_write_entities_total[5m])", "legendFormat": "entities/s" },
|
||||
{ "expr": "rate(memory_write_edges_total[5m])", "legendFormat": "edges/s" },
|
||||
{ "expr": "rate(memory_write_chunks_total[5m])", "legendFormat": "chunks/s" }
|
||||
]
|
||||
}
|
||||
],
|
||||
"schemaVersion": 39,
|
||||
"tags": ["poimen", "memory", "observability"],
|
||||
"templating": { "list": [] },
|
||||
"time": { "from": "now-1h", "to": "now" },
|
||||
"title": "Poimen Memory Observability",
|
||||
"uid": "poimen-memory-obs"
|
||||
}
|
||||
Reference in New Issue
Block a user