可视化观测 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 支持采集运行态 Metrics 指标并接入 Prometheus、Grafana 系统，实现对微服务集群的可视化监控，以下是一个具体的使用示例，可查看示例完整源码。

server/main.go - is the main definition of the service, handler and rpc server
client/main.go - is the rpc client
proto - contains the protobuf definition of the API

How to run

Run server

go run ./go-server/cmd/main.go

test server work as expected:

curl \
 --header "Content-Type: application/json" \
 --data '{"name": "Dubbo"}' \
 http://localhost:20000/greet.GreetService/Greet

Run client

go run ./go-client/cmd/main.go

deploy to local

install prometheus and open prometheus config file prometheus.yml, write the config like this

链路追踪

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 参数，则会使用默认行为：

可视化观测 on Apache Dubbo

配置和管理框架日志

注意

1. 日志配置

2. 应用共享日志组件

注意

2. 完全自定义日志

metrics监控

Contents

How to run

Run server

Run client

deploy to local

链路追踪

使用方式

示例详解