Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

docs(observability): document server.observability.dump_body from #2052 (#2063)

Evodebf5f2b5279
diff --git a/docs/en/guides/05-observability.md b/docs/en/guides/05-observability.md
index a4561f120..7710b2eb1 100644
--- a/docs/en/guides/05-observability.md
+++ b/docs/en/guides/05-observability.md
@@ -277,6 +277,7 @@ OpenViking groups signal-level observability configuration under `server.observa
- `server.observability.metrics`: metrics subsystem and exporters
- `server.observability.traces`: trace export configuration
- `server.observability.logs`: log export configuration
+- `server.observability.dump_body`: attaches HTTP request/response bodies (filtered by content-type, truncated by bytes) as attributes on the active trace span so they can be inspected in trace UIs. Off by default — bodies may contain secrets and high-cardinality content
Example:
@@ -322,6 +323,10 @@ Example:
"endpoint": "otel-collector:4317",
"service_name": "openviking-server",
"headers": {}
+ },
+ "dump_body": {
+ "enabled": false,
+ "max_bytes": 4096
}
}
}
diff --git a/docs/zh/guides/05-observability.md b/docs/zh/guides/05-observability.md
index e4af50275..04670a0a6 100644
--- a/docs/zh/guides/05-observability.md
+++ b/docs/zh/guides/05-observability.md
@@ -276,6 +276,7 @@ OpenViking 将信号级别的可观测性配置统一放在 `server.observabilit
- `server.observability.metrics`:metrics 子系统与 exporter 配置
- `server.observability.traces`:trace 导出配置
- `server.observability.logs`:log 导出配置
+- `server.observability.dump_body`:把 HTTP 请求/响应 body(按 content-type 过滤、按字节截断)作为属性挂到当前 trace span 上,便于在 trace UI 中调试。默认关闭,因为 body 可能含密钥/高基数内容
示例:
@@ -321,6 +322,10 @@ OpenViking 将信号级别的可观测性配置统一放在 `server.observabilit
"endpoint": "otel-collector:4317",
"service_name": "openviking-server",
"headers": {}
+ },
+ "dump_body": {
+ "enabled": false,
+ "max_bytes": 4096
}
}
}