README
¶
ekit-hertz
Hertz 运行时集成——日志桥接、生命周期、SSE/health/metrics 子包、注册发现与 NNS 适配器、OTel 桥接。
本仓库是 ekit（git.enjoye.top/enjoydream/ekit v0.34.0）
拆分出的独立 Go module，属于 oekit ekit 子项目矩阵（Round-2 深拆粒度）。
安装
go get github.com/oekit/hertz@v0.3.0
包清单
- `hertz/` — 运行时集成：日志桥接（hlog→logx）、RunServer 生命周期、Shutdown Hook；子包 adaptor/health/metrics/render/sse
- `handler/` — crudh（CRUD HTTP handler）、validatorh（参数绑定）、versionh
- `registry/hertz/`、`nns/hertz/` — Hertz 注册发现适配器
- `governance/hertz/` — 动态限流/超时中间件
- `observability/tracing/instrumentation/hertzotel|hertztracer/` — OTel / OpenTracing 桥接
自研标准中间件栈与 contrib 桥接已迁 ekit-middleware；handler 层（crudh/validatorh/versionh）已迁 ekit-handler——本仓库因此不再依赖 GORM 与 middleware 栈。
矩阵总览（20 活跃仓 + 19 微库，自动生成）
ekit-observability已在 Round-2 解散归档；本表由源码 import 自动生成。 依赖严格单向：工具微库/L0 → 可观测门面 → registry → data/httpx/middleware → nns/bootstrap → hertz/kitex。
当前仓库依赖
详见上方矩阵表中本仓库行。
与 ekit 单体仓库的关系
- 代码与 ekit v0.34.0 等价，module 路径
git.enjoye.top/enjoydream/ekit/...→github.com/oekit/hertz/... - 各子仓库独立发版（SemVer）；开发规范沿用 ekit AGENTS.md 约定
License
见 LICENSE
Directories
¶
| Path | Synopsis |
|---|---|
|
governance
|
|
|
hertz
Package govhertz 把 governance.Store 消费成 hertz server 治理中间件 (audit 5.2 阶段 1:hertz 侧治理)。
|
Package govhertz 把 governance.Store 消费成 hertz server 治理中间件 (audit 5.2 阶段 1:hertz 侧治理)。 |
|
Package hertz 为 Hertz HTTP 框架提供 ekit 生态集成。
|
Package hertz 为 Hertz HTTP 框架提供 ekit 生态集成。 |
|
adaptor
Package adaptor 提供 hertz-contrib/adaptor 常用 helper,让 ekit 业务 用 1 行代码把 net/http 生态(http.FileServer / embed.FS / gorilla/websocket)接入 hertz。
|
Package adaptor 提供 hertz-contrib/adaptor 常用 helper,让 ekit 业务 用 1 行代码把 net/http 生态(http.FileServer / embed.FS / gorilla/websocket)接入 hertz。 |
|
health
Package health 提供 Hertz 健康检查端点。
|
Package health 提供 Hertz 健康检查端点。 |
|
metrics
Package metrics 提供 Hertz Prometheus 指标端点。
|
Package metrics 提供 Hertz Prometheus 指标端点。 |
|
render
Package render 提供业务特定的 hertz Render interface 实现,与 hertz 官方 render 子包(https://www.cloudwego.io/zh/docs/hertz/tutorials/basic-feature/render/) 风格一致。
|
Package render 提供业务特定的 hertz Render interface 实现,与 hertz 官方 render 子包(https://www.cloudwego.io/zh/docs/hertz/tutorials/basic-feature/render/) 风格一致。 |
|
sse
Package sse 提供 Hertz SSE（Server-Sent Events）封装。
|
Package sse 提供 Hertz SSE（Server-Sent Events）封装。 |
|
nns
|
|
|
hertz
Package hertz 提供 nns 与 CloudWeGo Hertz 集成的适配器。
|
Package hertz 提供 nns 与 CloudWeGo Hertz 集成的适配器。 |
|
observability
|
|
|
tracing/instrumentation/hertzotel
Package hertzotel 提供 Hertz HTTP client/server 的 OpenTelemetry tracing 集成 helper,桥接 hertz-contrib/obs-opentelemetry/tracing。
|
Package hertzotel 提供 Hertz HTTP client/server 的 OpenTelemetry tracing 集成 helper,桥接 hertz-contrib/obs-opentelemetry/tracing。 |
|
tracing/instrumentation/hertztracer
Package hertztracer 提供 Hertz HTTP client/server 的 OpenTracing tracing 集成 helper,桥接 hertz-contrib/tracer。
|
Package hertztracer 提供 Hertz HTTP client/server 的 OpenTracing tracing 集成 helper,桥接 hertz-contrib/tracer。 |
|
registry
|
|
|
hertz
Package hertz 提供 ekit registry 抽象到 CloudWeGo Hertz 框架的适配器。
|
Package hertz 提供 ekit registry 抽象到 CloudWeGo Hertz 框架的适配器。 |
Click to show internal directories.
Click to hide internal directories.