Application Real-Time Monitoring Service:ARMS アプリケーションモニタリングがサポートする Go コンポーネントとフレームワーク

メッセージ

RPC フレームワーク

SQL/NoSQL

ロギング

ジョブスケジューリング

トレース SDK

AI SDK

Alibaba Cloud SDK

その他の SDK

Asynq v0.26.0 未満のバージョンでトレースの継続性を維持するにはどうすればよいですか？

詳細については、「Asynq の v0.26.0 より前のバージョンでトレースの継続性を維持する方法」をご参照ください。

メッセージフレームワークを使用すると、なぜトレースが途切れるのですか？

特定のメッセージフレームワークは実装上の仕様により、現在の Go エージェントでは、それらを介してトレースコンテキストを伝播させる際に制限があります。

Redis クライアントを使用しているときに、コンソールにデータベースまたは NoSQL のコールが表示されないのはなぜですか？

フレームワークの実装上の仕様により、Go エージェントは init 関数より前に実行されるアクションを計装できません。

Redis またはデータベースクライアントは、init 関数内で初期化してください。

// 不適切なアプローチ
var rdb = redis.NewClient(&redis.Options{
	Addr:     "localhost:6379",
	Password: "", // パスワードなし
	DB:       0,  // デフォルトの DB を使用
})
// 適切なアプローチ
var rdb *redis.Client
func init() {
	rdb = redis.NewClient(&redis.Options{
		Addr:     "localhost:6379",
		Password: "", // パスワードなし
		DB:       0,  // デフォルトの DB を使用
	})
}

カスタムの OpenTelemetry SDK 計装が表示されないのはなぜですか？

1. [Custom Configuration] ページで、[Agent Switch Settings] セクションの [opentelemetry-plugin] を選択し、アプリケーションを再起動します。

2. デフォルトのサンプリングレートは 10% です。リクエストが少ない場合、トレースが表示されないことがあります。必要に応じてサンプリングレートを調整できます。

RabbitMQ のカスタムスパンを追加するにはどうすればよいですか？

次のサンプルコードを使用して、カスタムスパンを追加してください：

import (
    "context"
    oTrace "go.opentelemetry.io/otel/trace"
    "go.opentelemetry.io/otel/propagation"
    "go.opentelemetry.io/otel"
    "go.opentelemetry.io/otel/trace"
  )
  // handle は、各メッセージのスパンを作成します。
  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"] = d.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(ctx, "mq", opts...)
        defer span.End()
        // ここにメッセージ処理ロジックを記述します
      }
  }
  

Kafka のカスタムスパンを追加するにはどうすればよいですか？

次のサンプルコードを使用して、カスタムスパンを追加してください：

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 は、各メッセージのスパンを作成します。
  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)
              tracer := otel.GetTracerProvider().Tracer("")
              opts := append([]oTrace.SpanStartOption{}, oTrace.WithSpanKind(oTrace.SpanKindConsumer))
              ctx, span := tracer.Start(ctx, "mq", opts...)
              defer span.End()
              // ここにメッセージ処理ロジックを記述します
          }
      }
  }