ekit-kitex

module
v0.2.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 14, 2026 License: MIT

README

ekit-kitex

Kitex RPC 生态——日志桥接、治理热更、生命周期、BizError 桥接、方法级指标与 OTel。

本仓库是 ekit(git.enjoye.top/enjoydream/ekit v0.34.0) 拆分出的独立 Go module,属于 yi-nology ekit 子项目矩阵(Round-2 深拆粒度)。

安装

go get github.com/yi-nology/ekit-kitex@v0.2.0

包清单

  • `kitex/` — klog→logx 桥接、GovernanceConfig(Nacos 热更)、RunServer、WithBizErrorBridge、PanicLogMiddleware、NewServerTracingSuite
  • `kitex/kitexmeta/` — trace_id + metainfo 跨 RPC 透传
  • `registry/kitex/`、`nns/kitex/` — Kitex 注册发现适配器
  • `observability/metrics/instrumentation/kitexprom/` — 方法级 RPC 指标
  • `observability/tracing/instrumentation/kitexotel/` — OTel server/client suite
  • `examples/` — kitex echo 示例;`internal/e2e/` — e2e 生成代码

Istio Proxyless 已迁 ekit-istio。

依赖关系

子项目矩阵与依赖方向(自底向上,19 仓):

ekit-core            文本/数据工具 + governance/lifecycle/version      (零内部依赖)
ekit-concurrency     并发与流控原语                                     (零内部依赖)
ekit-logx            日志门面 + shutdown                                (零内部依赖)
ekit-istio           Istio Proxyless                                    (零内部依赖)
  ekit-metrics       Prometheus 门面                          → core
  ekit-tracing       OTel + traceid                           → logx
  ekit-registry      注册发现 + 配置                          → core, logx
    ekit-data        缓存抽象 + 定时任务                      → core, logx, concurrency
      ekit-gorm      SQL/GORM 全家                            → core, logx
      ekit-redis     Redis 全家                               → data, core, logx
    ekit-httpx       HTTP 客户端 + 负载均衡                   → core, concurrency, logx, metrics, tracing, registry
      ekit-nns       服务治理客户端                           → httpx, registry, core, logx, tracing, metrics
        ekit-bootstrap 应用引导
    ekit-middleware  Hertz 中间件栈                           → core, concurrency, logx, metrics, tracing, registry
    ekit-hertz       Hertz 运行时/适配/instrumentation        → middleware, gorm, nns, registry, metrics, tracing, logx, core
    ekit-kitex       Kitex 生态                               → nns, registry, core, concurrency, logx, metrics
  ekit-workflow      流程编排                                 → concurrency, logx

注:ekit-observability 已在 Round-2 深拆中解散——logx 迁 [ekit-logx]、metrics 迁 [ekit-metrics]、 tracing/traceid 迁 [ekit-tracing]、shutdown 迁 [ekit-logx];原仓库已归档。

依赖:ekit-nns、ekit-registry、ekit-core、ekit-concurrency、ekit-logx、ekit-metrics(examples 另引 ekit-bootstrap)。

与 ekit 单体仓库的关系

  • 代码与 ekit v0.34.0 等价,module 路径 git.enjoye.top/enjoydream/ekit/... → github.com/yi-nology/ekit-kitex/...
  • 各子仓库独立发版(SemVer);开发规范沿用 ekit AGENTS.md 约定

License

见 LICENSE

Directories

Path Synopsis
examples
kitex/client command
kitex/kitex_gen/kitex/echo/echoservice
Code generated by Kitex v0.16.3.
Code generated by Kitex v0.16.3.
kitex/server command
internal
e2e/kitex_gen/kitex/echo/echoservice
Code generated by Kitex v0.16.3.
Code generated by Kitex v0.16.3.
Package kitex 为 CloudWeGo Kitex RPC 框架提供 ekit 生态集成。
Package kitex 为 CloudWeGo Kitex RPC 框架提供 ekit 生态集成。
kitexmeta
Package kitexmeta 桥接 kitex transmeta 体系 + ekit traceid,让 trace_id / 用户身份 / 空间码等业务元数据在 kitex server 入口注入 到 ctx,通过 kitex client transmeta 自动透传到下游 server。
Package kitexmeta 桥接 kitex transmeta 体系 + ekit traceid,让 trace_id / 用户身份 / 空间码等业务元数据在 kitex server 入口注入 到 ctx,通过 kitex client transmeta 自动透传到下游 server。
nns
kitex
Package kitex 提供 NNS 门面到 CloudWeGo Kitex 框架的适配器。
Package kitex 提供 NNS 门面到 CloudWeGo Kitex 框架的适配器。
observability
metrics/instrumentation/kitexprom
Package kitexprom 桥接 kitex-contrib/monitor-prometheus,为 Kitex 提供 方法级 RPC 指标(吞吐/时延,labels 含 caller/callee/method/status/retry)。
Package kitexprom 桥接 kitex-contrib/monitor-prometheus,为 Kitex 提供 方法级 RPC 指标(吞吐/时延,labels 含 caller/callee/method/status/retry)。
tracing/instrumentation/kitexotel
Package kitexotel 提供 Kitex 客户端/服务端的 metainfo propagation 启用 helper,以及 OTel 链路透传(通过 metainfo carrier)选项。
Package kitexotel 提供 Kitex 客户端/服务端的 metainfo propagation 启用 helper,以及 OTel 链路透传(通过 metainfo carrier)选项。
registry
kitex
Package kitex 提供 ekit registry 抽象到 CloudWeGo Kitex 框架的适配器。
Package kitex 提供 ekit registry 抽象到 CloudWeGo Kitex 框架的适配器。

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL