本文演示如何将Kitex应用接入可观测链路 OpenTelemetry 版。
前提条件
背景信息
CloudWeGo-Kitex是字节跳动开源的Golang微服务RPC框架,具有高性能、强可扩展的主要特点。其默认支持Thrift、Kitex Protobuf和gRPC消息协议,且支持丰富服务治理能力及扩展能力。
步骤一:接入Kitex
在您的Kitex应用中,添加如下代码。
import (
"github.com/kitex-contrib/obs-opentelemetry/provider"
"github.com/kitex-contrib/obs-opentelemetry/tracing"
// ...
)
func main() {
// 省略部分初始化代码
// **接入OpenTelemetry,默认从环境变量配置**
p := provider.NewOpenTelemetryProvider(
provider.WithServiceName(constants.NoteServiceName),
provider.WithEnableMetrics(false),
)
defer p.Shutdown(context.Background())
Init()
svr := note.NewServer(new(NoteServiceImpl),
server.WithServerBasicInfo(&rpcinfo.EndpointBasicInfo{ServiceName: constants.NoteServiceName}), // server name
// ...
// **注入tracing到server实例中**
server.WithSuite(tracing.NewServerSuite()),
)
err = svr.Run()
if err != nil {
klog.Fatal(err)
}
}
步骤二:获取接入点信息
在左侧导航栏单击集群配置,然后在右侧页面单击接入点信息页签。
在页面顶部选择需要接入的地域,然后在集群信息区域打开显示Token开关。
在客户端采集工具区域单击OpenTelemetry。
在下方表格的相关信息列中,获取接入点信息。
说明如果应用部署于阿里云生产环境,则选择阿里云VPC网络接入点,否则选择公网接入点。
步骤三:部署应用
如果您使用的是ACK服务,可以在容器服务管理控制台目标集群的 页面创建Deployment。具体操作,请参见创建无状态工作负载Deployment。
根据上文步骤二获取的接入点信息配置如下环境变量,从而上报数据到可观测链路 OpenTelemetry 版。
Key
说明
示例值
OTEL_EXPORTER_OTLP_TRACES_ENDPOINT
Trace上报的Endpoint。
http://tracing-analysis-dc-zb.aliyuncs.com:8090
OTEL_EXPORTER_OTLP_TRACES_HEADERS
OTEL上报会带上的Header,用于鉴权。
authentication=cx0xxxxx@285xxxxx_cx0xxxxx@53xxxxx
验证
启动应用并引入流量。
在可观测链路 OpenTelemetry 版控制台的应用列表页面选择目标应用,查看链路数据。
反馈
- 本页导读 (1)
文档反馈