Destination Handler Destination Handler 包路径: github.com/caicloud/nirvana/service Nirvana 默认提供了 3 种类型的 Destination：Meta，Data，Error。 每种 Destination 对应一个 Handler。这些 Handler 负责一...

错误包 Error 介绍 errors 包 error 的 Reason 国际化 使用范例 错误包 包路径: github.com/caicloud/nirvana/errors Error 介绍 在业务函数中，除了正常的返回数据以外，还需要处理各种错误。在 golang 中，错误需要实现 error 接口。即： type err...

健康检查插件 健康检查插件 包路径: github.com/caicloud/nirvana/plugins/healthcheck 健康检查插件提供一个 API 返回服务当前是否健康。API 默认路径为 /healthz 。 插件提供了一个函数接口： type HealthChecker func ( ctx context . Con...

请求追踪插件 请求追踪插件 包路径: github.com/caicloud/nirvana/plugins/tracing 请求追踪插件基于 OpenTracing 接口实现了请求跟踪机制，会在 / 上添加一个中间件用于提取 Tracing 信息。 插件 Configurer： Disable() nirvana.Configurer ...

性能分析插件 性能分析插件 包路径: github.com/caicloud/nirvana/plugins/profiling 性能分析插件添加与 net/http/pprof 一致的 API，用于取得服务运行时信息。 默认情况下，插件会添加四个 Descriptor： /debug/pprof /debug/pprof/profile...

生成客户端 生成代码 注意事项 函数名称 API types 定义 使用客户端 限制 生成客户端 生成代码 API 文档通常足够使用者使用。但是在微服务场景下，服务之间也会存在调用关系。因此需要使调用者方便快速的进行 API 调用，可以生成客户端以供使用： $ nirvana client 该命令默认会在 ./client ...

监控指标插件 监控指标插件 包路径: github.com/caicloud/nirvana/plugins/metrics 监控指标插件基于 Prometheus，提供了一个 API 用于暴露服务端指标。 启用插件后，可以直接向 prometheus 包注册指标。采集端可以通过 /metrics 采集指标数据。 API 路径 /metri...

请求日志插件 请求日志插件 包路径: github.com/caicloud/nirvana/plugins/reqlog 请求日志插件会添加一个在 / 上的中间件，用于打印所有路由匹配成功的请求的日志。 插件 Configurer： Disable() nirvana.Configurer 关闭插件 Default() nirvan...

版本信息插件 版本信息插件 包路径: github.com/caicloud/nirvana/plugins/profiling 版本信息插件提供一个 API 返回服务的版本信息。API 路径默认为 /version 。 插件 Configurer： Disable() nirvana.Configurer 关闭插件 Path(path...

中间件 中间件执行顺序 中间件 包路径: github.com/caicloud/nirvana/definition Nirvana 中间件位于路由之后，业务函数执行之前。因此中间件可以对合法的请求进行一些额外的处理。中间件的接口如下： // Chain contains all subsequent actions. type Ch...