docs: OpenObserve 接口 QPS/耗时可观测设计 spec #145

2026-07-20T18:54:27+08:00

guke commented

2026-07-20 18:54:27 +08:00

openobserve上报

guke added 17 commits 2026-07-20 18:54:29 +08:00

docs: OpenObserve 接口 QPS/耗时可观测设计 spec 29aa6fbff8

方案 A:轻量自研 ASGI 中间件 + 后台 worker 批量直采到本地 Docker OpenObserve。
仅 app-server(8770);默认关、opt-in;队列满丢弃、上报失败不重试、跳过 /health。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

docs: OpenObserve 接口指标实现计划(分步 TDD) 20fa32e884

7 个任务:配置门槛 → 事件队列/record_event → 中间件 → 上报 worker →
main 接线 → OpenObserve compose/README/.env → 端到端验证。每任务 TDD + 提交。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

feat(observe): 加 OBSERVE_* 配置与 observe_configured 门槛 76cb981d84

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

test(observe): 补 observe_configured 缺用户名分支断言 804de02188

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

docs(plan): 拆分 observe.py 导入,避免 Task 2 提交时 ruff F401 70c5c4cf08

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

feat(observe): 加有界事件队列与 record_event(满则丢) 6c624c3cea

style(observe): 去冗余注解引号 + 整理 import(ruff UP037/I001) 9354588ba2

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

docs(plan): 去注解引号 + Task7 lint 只查改动文件(基线558既有ruff错) 822c2ca2a6

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

feat(observe): 加 RequestMetricsMiddleware(路由模板+状态码+耗时) 95a4c5c3cc

feat(observe): 加后台批量上报 worker(失败丢批不重试) 0350a140fe

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

fix(observe): 保留 asyncio.TimeoutError 捕获(3.10 兼容,撤销 UP041 自动改写) 65e9b422fe

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

harden(observe): 防重复 start 泄漏 client + 关停丢余量注释 + 补 stop/失败存活测试 a5f63cb53c

评审建议(Task4 code-quality):
- start 已启动则不重复建 client(避免泄漏旧连接池)
- 关停只发一批、超出丢弃,补注释说明 best-effort
- 补测: _run_loop 失败后存活 / stop drain+发最后一批+关 client

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

feat(observe): main.py 挂中间件 + lifespan 启停上报 worker 0cf4cc706b

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

feat(observe): OpenObserve 本地 compose + README(查询/仪表盘) + .env.example 8938b951fb

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

observe: 关停时补记残留丢弃计数(终审 minor:账不丢在关停期) 1f97b19d21

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

feat(observe): 现成 OpenObserve 仪表盘(QPS/P95/分位/错误率) + 导入说明 964032d16f

dashboard-api-metrics.json: v8 schema 4 面板,已在 v0.91.1 实例 test-import 验证可用。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

feat(observe): 生产部署(单机)—— 硬化 compose + nginx 反代 + README(SSH隧道/保留期/专用账号) 00404c8b45

- docker-compose.prod.yml: 只绑 127.0.0.1、命名卷、mem 1g、密码走 .env(:? 守卫)
- nginx/observe.shaguabijia.com.conf: 子域名反代 + IP白名单 + TLS + WS 透传
- .gitignore: 忽略 prod 密码 .env
- README: 生产部署步骤 + UI 访问两方案(SSH隧道推荐)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

guke added 3 commits 2026-07-20 18:55:03 +08:00

Merge branch 'main' of https://gitea.shaguabijia.com/WonderableAI/shaguabijia-app-server into feat/openobserve-api-metrics e0874112a9

Merge branch 'main' of https://gitea.shaguabijia.com/WonderableAI/shaguabijia-app-server into feat/openobserve-api-metrics 7ed942cb8c

# Conflicts:
#	app/main.py

feat(observe): 生产部署硬化 + nginx 反代(Certbot+BasicAuth) + 恢复采集中间件 216441a401

- app/main.py: 恢复 merge 丢失的 RequestMetricsMiddleware 注册,接口埋点重新生效
- docker-compose.prod.yml: 镜像 pin v0.91.2、数据保留 30 天、关匿名遥测(ZO_TELEMETRY)、容器日志上限、资源硬上限(2C/3G)、数据改 bind-mount 到宿主 /data
- observe.shaguabijia.com.conf: 改用 Certbot 证书(与 admin-web 一致)+ Basic Auth 兜底(办公网无固定 IP)+ 去掉与 admin-web 冲突的 ipv6only=on
- dashboard-api-metrics.json: 补 dashboardId 修复新版 OpenObserve 导入校验
- app-api.conf: client_max_body_size 4m->32m,修带截图反馈被 nginx 413(顺带)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

guke merged commit 48037f03fd into main

2026-07-20 18:55:39 +08:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: WonderableAI/shaguabijia-app-server#145