@senad-d/observme 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.env.example +57 -0
- package/CHANGELOG.md +52 -0
- package/LICENSE +21 -0
- package/ObservMe-Production-Docs/00-README.md +79 -0
- package/ObservMe-Production-Docs/01-requirements-and-scope.md +207 -0
- package/ObservMe-Production-Docs/02-reference-architecture.md +306 -0
- package/ObservMe-Production-Docs/03-pi-event-and-session-model.md +266 -0
- package/ObservMe-Production-Docs/04-telemetry-semantic-conventions.md +722 -0
- package/ObservMe-Production-Docs/05-otel-pipeline-and-collector.md +355 -0
- package/ObservMe-Production-Docs/06-security-privacy-redaction.md +294 -0
- package/ObservMe-Production-Docs/07-extension-implementation-blueprint.md +447 -0
- package/ObservMe-Production-Docs/08-query-grafana-integration.md +276 -0
- package/ObservMe-Production-Docs/09-dashboards-alerts-slos.md +640 -0
- package/ObservMe-Production-Docs/10-testing-release-operations.md +319 -0
- package/ObservMe-Production-Docs/11-deployment-runbooks.md +203 -0
- package/ObservMe-Production-Docs/12-configuration-reference.md +337 -0
- package/ObservMe-Production-Docs/13-source-notes.md +33 -0
- package/ObservMe-Production-Docs/pi-session-format.md +427 -0
- package/README.md +356 -0
- package/SECURITY.md +45 -0
- package/dashboards/observme-agent-node-graphs.json +250 -0
- package/dashboards/observme-agents.json +1880 -0
- package/dashboards/observme-alerts.yaml +113 -0
- package/dashboards/observme-branches-compactions.json +1042 -0
- package/dashboards/observme-cost.json +1254 -0
- package/dashboards/observme-errors.json +1659 -0
- package/dashboards/observme-export-health.json +1802 -0
- package/dashboards/observme-latency.json +1494 -0
- package/dashboards/observme-llm-conversations.json +730 -0
- package/dashboards/observme-logs-llm.json +644 -0
- package/dashboards/observme-models.json +933 -0
- package/dashboards/observme-overview.json +2129 -0
- package/dashboards/observme-slo-health.json +737 -0
- package/dashboards/observme-slos.yaml +56 -0
- package/dashboards/observme-tools.json +902 -0
- package/dashboards/observme-trace-journey.json +1793 -0
- package/docs/STRUCTURE.md +49 -0
- package/docs/agent-subagent-observability-requirements.md +997 -0
- package/docs/compatibility-matrix.md +39 -0
- package/docs/configuration-tui-design-standard.md +767 -0
- package/docs/configuration.md +38 -0
- package/docs/review-validation.md +115 -0
- package/docs/validation-flow.md +117 -0
- package/examples/collector.yaml +123 -0
- package/examples/observme.yaml +131 -0
- package/img/demo.gif +0 -0
- package/img/icon.svg +47 -0
- package/package.json +103 -0
- package/src/commands/obs-agents-runtime.ts +150 -0
- package/src/commands/obs-agents.ts +491 -0
- package/src/commands/obs-args.ts +63 -0
- package/src/commands/obs-backfill.ts +1334 -0
- package/src/commands/obs-command-support.ts +43 -0
- package/src/commands/obs-cost.ts +228 -0
- package/src/commands/obs-diagnostics.ts +22 -0
- package/src/commands/obs-errors.ts +156 -0
- package/src/commands/obs-health.ts +301 -0
- package/src/commands/obs-link.ts +90 -0
- package/src/commands/obs-logs.ts +194 -0
- package/src/commands/obs-loki-summary.ts +184 -0
- package/src/commands/obs-session.ts +259 -0
- package/src/commands/obs-status.ts +359 -0
- package/src/commands/obs-tools.ts +274 -0
- package/src/commands/obs-trace.ts +411 -0
- package/src/commands/obs.ts +211 -0
- package/src/config/bootstrap-project-config.ts +300 -0
- package/src/config/defaults.ts +143 -0
- package/src/config/load-config.ts +631 -0
- package/src/config/project-paths.ts +61 -0
- package/src/config/schema.ts +405 -0
- package/src/config/validate.ts +456 -0
- package/src/constants.ts +4 -0
- package/src/diagnostics/sanitize.ts +6 -0
- package/src/extension.ts +38 -0
- package/src/otel/logs.ts +160 -0
- package/src/otel/metrics.ts +165 -0
- package/src/otel/otlp-endpoint.ts +10 -0
- package/src/otel/sdk.ts +114 -0
- package/src/otel/shutdown.ts +102 -0
- package/src/otel/traces.ts +166 -0
- package/src/pi/agent-lineage.ts +378 -0
- package/src/pi/agent-tree-tracker.ts +258 -0
- package/src/pi/event-handlers/agent-turn.ts +155 -0
- package/src/pi/event-handlers/lifecycle.ts +642 -0
- package/src/pi/event-handlers/llm.ts +115 -0
- package/src/pi/event-handlers/session-events.ts +159 -0
- package/src/pi/event-handlers/tool-bash.ts +275 -0
- package/src/pi/handler-internals.ts +2154 -0
- package/src/pi/handler-runtime.ts +633 -0
- package/src/pi/handler-types.ts +261 -0
- package/src/pi/handlers.ts +75 -0
- package/src/pi/subagent-spawn.ts +975 -0
- package/src/pi/subagent-types.ts +29 -0
- package/src/privacy/content-capture.ts +104 -0
- package/src/privacy/hash.ts +93 -0
- package/src/privacy/redact.ts +619 -0
- package/src/privacy/secret-patterns.ts +185 -0
- package/src/privacy/truncate.ts +69 -0
- package/src/query/grafana-readiness.ts +164 -0
- package/src/query/grafana-transport.ts +481 -0
- package/src/query/grafana.ts +371 -0
- package/src/query/loki.ts +332 -0
- package/src/query/prometheus.ts +388 -0
- package/src/query/tempo.ts +332 -0
- package/src/safety/sensitive-input.ts +208 -0
- package/src/semconv/attributes.ts +279 -0
- package/src/semconv/metrics.ts +146 -0
- package/src/semconv/spans.ts +19 -0
- package/src/semconv/values.ts +13 -0
- package/src/util/bounded-map.ts +97 -0
- package/tsconfig.json +15 -0
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
groups:
|
|
2
|
+
- name: observme.alerts
|
|
3
|
+
rules:
|
|
4
|
+
- alert: ObservMeHighLlmErrorRate
|
|
5
|
+
expr: >-
|
|
6
|
+
sum(rate(observme_llm_errors_total[10m])) / clamp_min(sum(rate(observme_llm_requests_total[10m])), 1e-9) > 0.05
|
|
7
|
+
for: 10m
|
|
8
|
+
labels:
|
|
9
|
+
severity: warning
|
|
10
|
+
annotations:
|
|
11
|
+
summary: High LLM error rate
|
|
12
|
+
description: More than 5% of ObservMe LLM requests are failing over 10 minutes.
|
|
13
|
+
runbook: "Severity guidance from production docs: warning."
|
|
14
|
+
- alert: ObservMeHighToolFailureRate
|
|
15
|
+
expr: >-
|
|
16
|
+
sum(rate(observme_tool_failures_total[10m])) by (tool_name) / clamp_min(sum(rate(observme_tool_calls_total[10m])) by (tool_name), 1e-9) > 0.10
|
|
17
|
+
for: 10m
|
|
18
|
+
labels:
|
|
19
|
+
severity: warning
|
|
20
|
+
annotations:
|
|
21
|
+
summary: High tool failure rate
|
|
22
|
+
description: More than 10% of ObservMe tool calls are failing for one tool_name over 10 minutes.
|
|
23
|
+
runbook: "Severity guidance from production docs: warning."
|
|
24
|
+
- alert: ObservMeSubagentSpawnFailures
|
|
25
|
+
expr: >-
|
|
26
|
+
sum(rate(observme_subagent_spawn_failures_total[10m])) > 0
|
|
27
|
+
for: 10m
|
|
28
|
+
labels:
|
|
29
|
+
severity: warning
|
|
30
|
+
annotations:
|
|
31
|
+
summary: Subagent spawn failures detected
|
|
32
|
+
description: At least one ObservMe subagent spawn failure occurred in the last 10 minutes.
|
|
33
|
+
runbook: "Severity guidance from production docs: warning."
|
|
34
|
+
- alert: ObservMeExportDropsDetected
|
|
35
|
+
expr: >-
|
|
36
|
+
sum(rate(observme_telemetry_dropped_total[5m])) > 0
|
|
37
|
+
for: 5m
|
|
38
|
+
labels:
|
|
39
|
+
severity: warning
|
|
40
|
+
annotations:
|
|
41
|
+
summary: Export drops detected
|
|
42
|
+
description: ObservMe is locally dropping telemetry before export.
|
|
43
|
+
runbook: "Severity guidance from production docs: warning."
|
|
44
|
+
- alert: ObservMeCostSpike
|
|
45
|
+
expr: >-
|
|
46
|
+
sum(increase(observme_llm_cost_usd_total[1h])) > 50
|
|
47
|
+
for: 15m
|
|
48
|
+
labels:
|
|
49
|
+
severity: budget-dependent
|
|
50
|
+
annotations:
|
|
51
|
+
summary: LLM cost spike
|
|
52
|
+
description: ObservMe LLM spend increased by more than 50 USD in one hour.
|
|
53
|
+
runbook: "Severity guidance from production docs: depends on organization budget."
|
|
54
|
+
- alert: ObservMeRedactionFailures
|
|
55
|
+
expr: >-
|
|
56
|
+
sum(rate(observme_redaction_failures_total[5m])) > 0
|
|
57
|
+
for: 5m
|
|
58
|
+
labels:
|
|
59
|
+
severity: critical
|
|
60
|
+
annotations:
|
|
61
|
+
summary: Redaction failures detected
|
|
62
|
+
description: ObservMe redaction failures occurred; treat as critical when content capture is enabled.
|
|
63
|
+
runbook: "Severity guidance from production docs: critical if content capture is enabled."
|
|
64
|
+
- alert: ObservMeRunawayAgentFanOut
|
|
65
|
+
expr: >-
|
|
66
|
+
histogram_quantile(0.95, sum(rate(observme_agent_fanout_count_bucket[10m])) by (le)) > 20
|
|
67
|
+
for: 10m
|
|
68
|
+
labels:
|
|
69
|
+
severity: warning
|
|
70
|
+
annotations:
|
|
71
|
+
summary: Runaway agent fan-out
|
|
72
|
+
description: p95 ObservMe agent fan-out exceeded 20 over 10 minutes.
|
|
73
|
+
runbook: "Severity guidance from production docs: warning; tune the threshold to the organization's normal orchestrator workload."
|
|
74
|
+
- alert: ObservMeExcessiveAgentTreeDepth
|
|
75
|
+
expr: >-
|
|
76
|
+
histogram_quantile(0.95, sum(rate(observme_agent_tree_depth_bucket[10m])) by (le)) > 5
|
|
77
|
+
for: 10m
|
|
78
|
+
labels:
|
|
79
|
+
severity: warning
|
|
80
|
+
annotations:
|
|
81
|
+
summary: Excessive agent tree depth
|
|
82
|
+
description: p95 ObservMe agent tree depth exceeded 5 over 10 minutes.
|
|
83
|
+
runbook: "Severity guidance from production docs: warning; tune the threshold to expected maximum delegation depth."
|
|
84
|
+
- alert: ObservMeOrphanAgentsDetected
|
|
85
|
+
expr: >-
|
|
86
|
+
sum(rate(observme_orphan_agents_total[10m])) > 0
|
|
87
|
+
for: 10m
|
|
88
|
+
labels:
|
|
89
|
+
severity: warning
|
|
90
|
+
annotations:
|
|
91
|
+
summary: Orphan agents detected
|
|
92
|
+
description: ObservMe detected agent runtimes without usable parent lineage.
|
|
93
|
+
runbook: "Severity guidance from production docs: warning."
|
|
94
|
+
- alert: ObservMeTraceContextPropagationFailures
|
|
95
|
+
expr: >-
|
|
96
|
+
sum(rate(observme_trace_context_propagation_failures_total[10m])) > 0
|
|
97
|
+
for: 10m
|
|
98
|
+
labels:
|
|
99
|
+
severity: warning
|
|
100
|
+
annotations:
|
|
101
|
+
summary: Trace-context propagation failures
|
|
102
|
+
description: ObservMe failed to propagate or recover trace context for subagent work.
|
|
103
|
+
runbook: "Severity guidance from production docs: warning."
|
|
104
|
+
- alert: ObservMeActiveAgentsStuckHigh
|
|
105
|
+
expr: >-
|
|
106
|
+
sum(observme_active_agents) > 100
|
|
107
|
+
for: 30m
|
|
108
|
+
labels:
|
|
109
|
+
severity: deployment-dependent
|
|
110
|
+
annotations:
|
|
111
|
+
summary: Active agents stuck high
|
|
112
|
+
description: ObservMe active-agent gauge remains above 100.
|
|
113
|
+
runbook: "Severity guidance from production docs: depends on normal fleet size; tune per deployment."
|