Skip to content

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

docs(observability): document server.observability.usage_audit in config hierarchy (#2473)

Evo7c20c2834450
diff --git a/docs/en/guides/05-observability.md b/docs/en/guides/05-observability.md
index 9b3e5e70c..bc20ed32e 100644
--- a/docs/en/guides/05-observability.md
+++ b/docs/en/guides/05-observability.md
@@ -262,6 +262,7 @@ OpenViking groups signal-level observability configuration under `server.observa
- `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
+- `server.observability.usage_audit`: per-request usage/cost audit log, stored in SQLite. `sqlite_path` overrides the database location (use a per-instance local path for multi-instance deployments); `timezone` controls timestamp localization. Enabled by default
Example:
@@ -311,6 +312,11 @@ Example:
"dump_body": {
"enabled": false,
"max_bytes": 4096
+ },
+ "usage_audit": {
+ "enabled": true,
+ "sqlite_path": null,
+ "timezone": "local"
}
}
}
diff --git a/docs/zh/guides/05-observability.md b/docs/zh/guides/05-observability.md
index 63541c3f6..cd60140e7 100644
--- a/docs/zh/guides/05-observability.md
+++ b/docs/zh/guides/05-observability.md
@@ -261,6 +261,7 @@ OpenViking 将信号级别的可观测性配置统一放在 `server.observabilit
- `server.observability.traces`:trace 导出配置
- `server.observability.logs`:log 导出配置
- `server.observability.dump_body`:把 HTTP 请求/响应 body(按 content-type 过滤、按字节截断)作为属性挂到当前 trace span 上,便于在 trace UI 中调试。默认关闭,因为 body 可能含密钥/高基数内容
+- `server.observability.usage_audit`:按请求记录用量/成本审计日志,使用 SQLite 存储。`sqlite_path` 可覆盖数据库位置(多实例部署时设为每实例独立的本地路径);`timezone` 控制时间戳的时区本地化。默认开启
示例:
@@ -310,6 +311,11 @@ OpenViking 将信号级别的可观测性配置统一放在 `server.observabilit
"dump_body": {
"enabled": false,
"max_bytes": 4096
+ },
+ "usage_audit": {
+ "enabled": true,
+ "sqlite_path": null,
+ "timezone": "local"
}
}
}