ARMS应用监控支持的Go组件和框架

消息

RPC框架

SQL/NOSQL

日志

任务调度

Trace SDK

AI SDK

阿里云SDK

其他SDK

为什么使用消息框架时存在断链？

受限于消息框架的具体实现，当前版本的Go探针对某些消息框架的Trace上下文传递存在一定限制，具体如下：

为什么使用Redis数据库的客户端时控制台看不见数据库/NoSQL相关调用？

受限于框架的具体实现，Go Agent无法对init函数执行之前的动作进行有效的插桩。

请确保已在init函数中执行Redis客户端或者数据库客户端的初始化动作。

// 无效写法
var rdb = redis.NewClient(&redis.Options{
	Addr:     "localhost:6379",
	Password: "", // no password set
	DB:       0,  // use default DB
})

// 生效写法
var rdb *redis.Client

func init() {
	rdb = redis.NewClient(&redis.Options{
		Addr:     "localhost:6379",
		Password: "", // no password set
		DB:       0,  // use default DB
	})
}

为什么看不到自定义的OTel SDK埋点？

1. 请在自定义配置页面的探针开关设置区域选中opentelemetry-plugin，然后重启应用。

2. 默认采样率为10%，请求次数少的情况下可能会看不到，建议调整采样率。

如何为RabbitMQ增加自定义Span？

增加自定义Span的示例代码如下：

增加自定义Span的示例代码如下：

import (
    "context"
    oTrace "go.opentelemetry.io/otel/trace"
    "go.opentelemetry.io/otel/propagation"
    "go.opentelemetry.io/otel"
    "go.opentelemetry.io/otel/trace"
  )
  
  //在消息的handle对每个消息处理时候创建一个span
  func handle(deliveries <-chan amqp.Delivery, done chan error) {
      cleanup := func() {
          Log.Printf("handle: deliveries channel closed")
          done <- nil
      }
  
      defer cleanup()
      for d := range deliveries {
        var headerMap propagation.MapCarrier
        headerMap = make(map[string]string)
        headerMap["traceparent"] = delivery.Headers["traceparent"]
        ctx := otel.GetTextMapPropagator().Extract(context.Background(), headerMap)
        ctx = oTrace.ContextWithSpanContext(context.Background(), oTrace.SpanFromContext(ctx).SpanContext())
        tracer = otel.GetTracerProvider().Tracer("")
        opts := append([]oTrace.SpanStartOption{}, oTrace.WithSpanKind(oTrace.SpanKindConsumer))
        ctx, span := tracer.Start(context.Background(), "mq", opts...)
        defer span.End()
        //other process
      }
  }
  

如何为Kafka增加自定义Span？

增加自定义Span的示例代码如下：

import (
    kafka "github.com/segmentio/kafka-go"
      "go.opentelemetry.io/otel"
      "go.opentelemetry.io/otel/propagation"
      "go.opentelemetry.io/otel/trace"
      oTrace "go.opentelemetry.io/otel/trace"
  )
  
  //在消息的handle对每个消息处理时候创建一个span
  func handle(msg kafka.Message) {
      for _, attr := range msg.Headers {
          if attr.Key == "traceparent" {
              var headerMap propagation.MapCarrier
              headerMap = make(map[string]string)
              headerMap["traceparent"] = string(attr.Value)
              ctx := otel.GetTextMapPropagator().Extract(context.Background(), headerMap)
              ctx = oTrace.ContextWithSpanContext(context.Background(), oTrace.SpanFromContext(ctx).SpanContext())
              tracer := otel.GetTracerProvider().Tracer("")
              opts := append([]oTrace.SpanStartOption{}, oTrace.WithSpanKind(oTrace.SpanKindConsumer))
              ctx, span := tracer.Start(context.Background(), "mq", opts...)
              defer span.End()
              //other process
          }
  
      }
  }