可视化观测 on Apache Dubbo

配置和管理框架日志

Mon, 01 Jan 0001 00:00:00 +0000

本示例演示如何配置 dubbo-go 框架日志组件，将框架运行态日志保存到指定的位置。可在此查看完整示例源码地址。

注意

这里配置的只是 dubbo-go 框架自身的日志组件行为，即框架内部使用的日志，不影响业务日志框架的使用！

1. 日志配置

如下所示，可以通过 log.WithZap()、log.WithLevel("warn") 设置 dubbo 框架日志行为：

ins, err := dubbo.NewInstance(
	dubbo.WithLogger(
		log.WithLevel("warn"),
		log.WithZap(),
	),
)

2. 应用共享日志组件

注意，这里配置的只是 dubbo-go 框架自身的日志组件行为（即框架内部使用的日志），不影响业务日志框架的使用！

通过以下方式，业务应用也可以选择复用这个日志组件：

import app_logger "github.com/dubbogo/gost/log/logger"

app_logger.Info("hello")

日志 Interface

type Logger interface {
	Info(args ...interface{})
	Warn(args ...interface{})
	Error(args ...interface{})
	Debug(args ...interface{})
	Fatal(args ...interface{})

	Infof(fmt string, args ...interface{})
	Warnf(fmt string, args ...interface{})
	Errorf(fmt string, args ...interface{})
	Debugf(fmt string, args ...interface{})
	Fatalf(fmt string, args ...interface{})
}

注意

日志API不可以在Init 阶段使用，否则可能会发生意料之外的问题。

2. 完全自定义日志

当前 dubbo-go 框架支持 zap、logrus 两个日志框架，如果您想让 dubbo 框架内核使用其他日志框架打印日志，推荐以标准扩展形式增加支持，具体可参考核心库中内置的源码实现。

指标监控 (Metrics)

Mon, 01 Jan 0001 00:00:00 +0000

Dubbo-Go 指标监控

Dubbo-Go 可以采集 RPC、元数据、注册中心、配置中心等运行态指标，并通过 Prometheus 与 Grafana 构建可观测性看板。本文以 dubbo-go-samples/observability/prometheus_grafana 为例，说明 Pull 与 Pushgateway 两种运行方式。

说明：部分旧文档或任务描述可能仍写作 metrics/prometheus_grafana，当前 sample 仓库中的实际目录是 observability/prometheus_grafana。

1. 工作模式

1.1 Pull 模式

Dubbo-Go 应用暴露 /prometheus 或 /metrics
 |
 v
Prometheus 定时拉取
 |
 v
Grafana 查询 Prometheus 并展示大盘

Pull 模式是 Prometheus 的标准模式，适合长期运行的 Dubbo-Go Provider 与 Consumer。当前 sample 中：

应用	指标地址
go-server	`http://localhost:9099/prometheus`
go-client	`http://localhost:9097/prometheus`

Dubbo-Go 默认指标地址是 http://localhost:9090/metrics。sample 通过 metrics.WithPort(9099)、metrics.WithPort(9097) 和 metrics.WithPath("/prometheus") 改成了上面的端口与路径。

1.2 Pushgateway 模式

Dubbo-Go 应用推送指标
 |
 v
Pushgateway 暂存指标
 |
 v
Prometheus 拉取 Pushgateway
 |
 v
Grafana 查询 Prometheus 并展示大盘

Pushgateway 更适合 batch、cron job 等短生命周期任务。长期运行的服务优先使用 Pull 模式；如果必须使用 Pushgateway，请配合清理机制，避免停止后的旧指标继续留在 Pushgateway 中。

Kubernetes 生命周期探针

Mon, 01 Jan 0001 00:00:00 +0000

Dubbo-Go Kubernetes 生命周期探针

Dubbo-Go 提供内置的 Kubernetes HTTP Probe 服务，用于支持：

✅ liveness
✅ readiness
✅ startup

该模块通过独立 HTTP 端口暴露探针接口，并支持：

自定义健康检查逻辑
可选内部生命周期对齐
可控的重启风险

以下是一个具体的使用示例，可查看示例完整源码。

一、设计目标

目标	说明
可扩展	支持注册自定义检查回调
可控风险	liveness 默认不绑定内部复杂逻辑
生命周期对齐	readiness / startup 可对齐 Dubbo 生命周期
独立端口	与业务端口隔离

二、默认行为

启用 Probe 后，默认在：

端口: 22222

暴露以下路径：

Endpoint	说明
GET /live	进程存活检查
GET /ready	服务就绪检查
GET /startup	启动阶段检查

响应规则

条件	HTTP 状态码
所有检查通过	200
任意检查失败	503

三、配置方式

Dubbo-Go 支持 New API（推荐） 与 配置文件方式（YAML） 两种配置方式。

链路追踪

Mon, 01 Jan 0001 00:00:00 +0000

Dubbo-go 支持基于 OpenTelemetry 标准的全链路追踪埋点，同时支持通过以下 exporter 导出到不同的 tracing 后端系统。

使用方式

请注意，仅支持通过 dubbo.NewInstance 方式创建 dubbo 应用时开启 tracing 功能，也就是我们快速开始中提到的微服务应用模式，对于轻量 RPC API暂时不支持开启 tracing。

示例详解

可在此查看完整示例源码。

使用 dubbo.WithTracing() 开启 tracing，可以通过多个参数控制 tracing 行为：

package main

import (
 "dubbo.apache.org/dubbo-go/v3"
 _ "dubbo.apache.org/dubbo-go/v3/imports"
 "dubbo.apache.org/dubbo-go/v3/otel/trace"
)

func main() {
 instance, err := dubbo.NewInstance(
 dubbo.WithTracing(
 // add tracing options here
 trace.WithEnabled(), // enable tracing feature
 trace.WithStdoutExporter(),
 trace.WithW3cPropagator(),
 trace.WithAlwaysMode(),
 trace.WithRatioMode(), // use ratio mode
 trace.WithRatio(0.5), // sample ratio, only active when use ratio mode
 ),
 )
}

如果你在 dubbo.WithTracing() 调用中不指定任何 option 参数，则会使用默认行为：