Back to skills
SKILL.md
2709 07 System F4763a23
BSecurityOpenViking 提供系统健康检查、可观测性和调试 API，用于监控各组件状态。
- 9 stars
- 0 votes
- 0 copies
- 0 views
- Added October 11, 2026
Works with
Security analysis
88/100- Impersonates system messages to override safety constraints
npx -y skills add tools-only/X-Skills --skill 2709-07-system_f4763a23 --agent claude-codeAre you the author of 2709 07 System F4763a23?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/tools-only-2709-07-system-f4763a23)# 系统与监控
OpenViking 提供系统健康检查、可观测性和调试 API，用于监控各组件状态。
## API 参考
### health()
基础健康检查端点。无需认证。
**Python SDK**
```python
import openviking as ov
client = ov.OpenViking(path="./data")
client.initialize()
# 检查系统是否健康
if client.observer.is_healthy():
print("System OK")
client.close()
```
**HTTP API**
```
GET /health
```
```bash
curl -X GET http://localhost:1933/health
```
**响应**
```json
{
"status": "ok"
}
```
---
### status()
获取系统状态，包括初始化状态和用户信息。
**Python SDK**
```python
import openviking as ov
client = ov.OpenViking(path="./data")
client.initialize()
print(client.observer.system)
client.close()
```
**HTTP API**
```
GET /api/v1/system/status
```
```bash
curl -X GET http://localhost:1933/api/v1/system/status \
-H "X-API-Key: your-key"
```
**响应**
```json
{
"status": "ok",
"result": {
"initialized": true,
"user": "alice"
},
"time": 0.1
}
```
---
### wait_processed()
等待所有异步处理（embedding、语义生成）完成。
**参数**
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| timeout | float | 否 | None | 超时时间（秒） |
**Python SDK**
```python
import openviking as ov
client = ov.OpenViking(path="./data")
client.initialize()
# 添加资源
client.add_resource("./docs/")
# 等待所有处理完成
status = client.wait_processed()
print(f"Processing complete: {status}")
client.close()
```
**HTTP API**
```
POST /api/v1/system/wait
```
```bash
curl -X POST http://localhost:1933/api/v1/system/wait \
-H "Content-Type: application/json" \
-H "X-API-Key: your-key" \
-d '{
"timeout": 60.0
}'
```
**响应**
```json
{
"status": "ok",
"result": {
"pending": 0,
"in_progress": 0,
"processed": 20,
"errors": 0
},
"time": 0.1
}
```
---
## Observer API
Observer API 提供详细的组件级监控。
### observer.queue
获取队列系统状态（embedding 和语义处理队列）。
**Python SDK**
```python
import openviking as ov
client = ov.OpenViking(path="./data")
client.initialize()
print(client.observer.queue)
# Output:
# [queue] (healthy)
# Queue Pending In Progress Processed Errors Total
# Embedding 0 0 10 0 10
# Semantic 0 0 10 0 10
# TOTAL 0 0 20 0 20
client.close()
```
**HTTP API**
```
GET /api/v1/observer/queue
```
```bash
curl -X GET http://localhost:1933/api/v1/observer/queue \
-H "X-API-Key: your-key"
```
**响应**
```json
{
"status": "ok",
"result": {
"name": "queue",
"is_healthy": true,
"has_errors": false,
"status": "Queue Pending In Progress Processed Errors Total\nEmbedding 0 0 10 0 10\nSemantic 0 0 10 0 10\nTOTAL 0 0 20 0 20"
},
"time": 0.1
}
```
---
### observer.vikingdb
获取 VikingDB 状态（集合、索引、向量数量）。
**Python SDK**
```python
print(client.observer.vikingdb)
# Output:
# [vikingdb] (healthy)
# Collection Index Count Vector Count Status
# context 1 55 OK
# TOTAL 1 55
# 访问特定属性
print(client.observer.vikingdb.is_healthy) # True
print(client.observer.vikingdb.status) # Status table string
```
**HTTP API**
```
GET /api/v1/observer/vikingdb
```
```bash
curl -X GET http://localhost:1933/api/v1/observer/vikingdb \
-H "X-API-Key: your-key"
```
**响应**
```json
{
"status": "ok",
"result": {
"name": "vikingdb",
"is_healthy": true,
"has_errors": false,
"status": "Collection Index Count Vector Count Status\ncontext 1 55 OK\nTOTAL 1 55"
},
"time": 0.1
}
```
---
### observer.vlm
获取 VLM（视觉语言模型）token 使用状态。
**Python SDK**
```python
print(client.observer.vlm)
# Output:
# [vlm] (healthy)
# Model Provider Prompt Completion Total Last Updated
# doubao-1-5-vision-pro-32k volcengine 1000 500 1500 2024-01-01 12:00:00
# TOTAL 1000 500 1500
```
**HTTP API**
```
GET /api/v1/observer/vlm
```
```bash
curl -X GET http://localhost:1933/api/v1/observer/vlm \
-H "X-API-Key: your-key"
```
**响应**
```json
{
"status": "ok",
"result": {
"name": "vlm",
"is_healthy": true,
"has_errors": false,
"status": "Model Provider Prompt Completion Total Last Updated\ndoubao-1-5-vision-pro-32k volcengine 1000 500 1500 2024-01-01 12:00:00\nTOTAL 1000 500 1500"
},
"time": 0.1
}
```
---
### observer.system
获取整体系统状态，包括所有组件。
**Python SDK**
```python
print(client.observer.system)
# Output:
# [queue] (healthy)
# ...
#
# [vikingdb] (healthy)
# ...
#
# [vlm] (healthy)
# ...
#
# [system] (healthy)
```
**HTTP API**
```
GET /api/v1/observer/system
```
```bash
curl -X GET http://localhost:1933/api/v1/observer/system \
-H "X-API-Key: your-key"
```
**响应**
```json
{
"status": "ok",
"result": {
"is_healthy": true,
"errors": [],
"components": {
"queue": {
"name": "queue",
"is_healthy": true,
"has_errors": false,
"status": "..."
},
"vikingdb": {
"name": "vikingdb",
"is_healthy": true,
"has_errors": false,
"status": "..."
},
"vlm": {
"name": "vlm",
"is_healthy": true,
"has_errors": false,
"status": "..."
}
}
},
"time": 0.1
}
```
---
### is_healthy()
快速检查整个系统的健康状态。
**Python SDK**
```python
import openviking as ov
client = ov.OpenViking(path="./data")
client.initialize()
if client.observer.is_healthy():
print("System OK")
else:
print(client.observer.system)
client.close()
```
**HTTP API**
```
GET /api/v1/debug/health
```
```bash
curl -X GET http://localhost:1933/api/v1/debug/health \
-H "X-API-Key: your-key"
```
**响应**
```json
{
"status": "ok",
"result": {
"healthy": true
},
"time": 0.1
}
```
---
## 数据结构
### ComponentStatus
单个组件的状态信息。
| 字段 | 类型 | 说明 |
|------|------|------|
| name | str | 组件名称 |
| is_healthy | bool | 组件是否健康 |
| has_errors | bool | 组件是否存在错误 |
| status | str | 状态表格字符串 |
### SystemStatus
整体系统状态，包括所有组件。
| 字段 | 类型 | 说明 |
|------|------|------|
| is_healthy | bool | 整个系统是否健康 |
| components | Dict[str, ComponentStatus] | 各组件的状态 |
| errors | List[str] | 错误信息列表 |
---
## 相关文档
- [Resources](02-resources.md) - 资源管理
- [Retrieval](06-retrieval.md) - 搜索与检索
- [Sessions](05-sessions.md) - 会话管理
Attribution
Comments
Loading comments…