可视化观测 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 支持采集运行态 Metrics 指标，并接入 Prometheus + Grafana 实现微服务可观测性。

当前示例支持两种监控模式：

Pull 模式：Prometheus 主动抓取 Dubbo-Go 应用暴露的指标，适合长期运行的服务。
Push 模式：Dubbo-Go 应用主动将指标推送到 Pushgateway，仅建议用于短生命周期任务。

示例源码：

https://github.com/apache/dubbo-go-samples/tree/main/metrics

1. 监控架构说明

1.1 Pull 模式（推荐生产模式）

Dubbo-Go 应用 ---> Prometheus ---> Grafana
 (暴露 /metrics 或 /prometheus 接口)

Prometheus 主动抓取 Dubbo-Go 应用指标。

1.2 Push 模式（适用于短生命周期任务）

Dubbo-Go 应用 ---> Pushgateway ---> Prometheus ---> Grafana

应用主动推送指标到 Pushgateway，Prometheus 再拉取。

Pushgateway 适用于 短生命周期任务（如 batch / cron job），不推荐用于长期运行的服务。

2. 示例组件说明

组件	端口	说明
Grafana	3000	指标可视化
Prometheus	9090	指标存储与查询
Pushgateway	9091	接收应用推送指标
go-server 指标端口	本示例中为 9099	Pull 模式下 Provider 指标暴露端口
go-client 指标端口	本示例中为 9097	Pull 模式下 Consumer 指标暴露端口

如果不使用本示例，而是直接使用 Dubbo-Go 默认配置，则默认指标端点为 http://localhost:9090/metrics。当前 sample 将指标路径改成了 /prometheus。

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（推荐） 与 Old 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 参数，则会使用默认行为：