すべてのプロダクト
Search
ドキュメントセンター

Cloud Monitor:ARMS アプリケーション監視でサポートされている Go コンポーネントとフレームワーク

最終更新日:Nov 09, 2025

このトピックでは、Go アプリケーション監視のオペレーティングシステムとアーキテクチャの要件について説明し、サポートされているサードパーティのコンポーネントとフレームワークをリストアップします。

オペレーティングシステムの要件

コンパイラ名

オペレーティングシステム

アーキテクチャ

instgo_linux_amd64

Linux

amd64

instgo_linux_arm64

Linux

arm64

instgo_darwin_amd64

Darwin

amd64

instgo_darwin_arm64

Darwin

arm64

instgo_windows_amd64.exe

Windows

amd64

サポートされている Go のバージョン

1.18 以降

サポートされているプラグインのバージョン

メッセージング

コンポーネント

リポジトリアドレス

最小バージョン

最大バージョン

AMQP

https://github.com/rabbitmq/amqp091-go

v1.9.0

v1.10.0

Segmentio Kafka

https://github.com/segmentio/kafka-go

v0.4.10

v0.4.48

RocketMQ Client Go

https://github.com/apache/rocketmq-client-go

v2.1.0

v2.1.2

RocketMQ Client

https://github.com/apache/rocketmq-clients/tree/master/golang

v5.0.0

v5.1.2

IBM Sarama

https://github.com/IBM/sarama

v1.22.0

v1.45.2

Shopify Sarama

https://github.com/Shopify/sarama

v1.22.0

v1.38.1

RPC フレームワーク

コンポーネント

リポジトリアドレス

最小バージョン

最大バージョン

Beego

https://github.com/beego/beego

v1.2.0

v2.3.8

Dubbo

https://github.com/apache/dubbo-go

v3.0.1

v3.3.0

Echo

https://github.com/labstack/echo

v4.0.0

v4.13.4

FastHTTP

https://github.com/valyala/fasthttp

v1.45.0

v1.65.0

Fiber

https://github.com/gofiber/fiber

v2.43.0

v2.52.8

Gin

https://github.com/gin-gonic/gin

v1.7.0

制限なし

GoFrame

https://github.com/gogf/gf

v2.4.0

v2.9.0

Go Micro

https://github.com/go-micro/go-micro

v4.9.0

v5.3.1

Go Restful

https://github.com/emicklei/go-restful

v3.7.0

v3.12.1

Go Zero

https://github.com/zeromicro/go-zero

v1.5.0

v1.9.0

gRPC

https://github.com/grpc/grpc-go

v1.44.0

制限なし

Iris

https://github.com/kataras/iris

v12.0.0

v12.2.11

Kitex

https://github.com/cloudwego/kitex

v0.5.1

v0.14.1

Kratos

https://github.com/go-kratos/kratos

v2.1.2

v2.8.4

Macaron

https://github.com/go-macaron/macaron

v1.1.0

v1.5.0

Mux

https://github.com/gorilla/mux

v1.3.0

v1.8.1

Net/HTTP

https://pkg.go.dev/net/http

v1.18

制限なし

Thrift

https://github.com/apache/thrift/tree/master/lib/go

v0.19.0

v0.20.0

Hertz

https://github.com/cloudwego/hertz

v0.8.0

v0.10.2

SQL/NoSQL

コンポーネント

リポジトリアドレス

最小バージョン

最大バージョン

Go Elasticsearch

https://github.com/elastic/go-elasticsearch

v8.0.0

v8.18.1

Go Redis

https://github.com/redis/go-redis

v8.10.0

v9.11.0

Go SQL Driver

https://github.com/go-sql-driver/mysql

v1.4.0

v1.9.3

Gorm

https://github.com/go-gorm/gorm

v1.20.12

v1.30.0

GORM MySQL

https://github.com/go-gorm/mysql

v1.0.4

v1.5.7

Go 標準ライブラリ database/sql

https://pkg.go.dev/database/sql

v1.18

v1.24

Mongo

https://github.com/mongodb/mongo-go-driver

v1.11.1

v1.17.3

PostgreSQL

https://github.com/go-pg/pg

v10.10.0

v10.14.0

Redis Go

https://github.com/gomodule/redigo

v1.9.0

v1.9.2

ロギング

コンポーネント

リポジトリアドレス

最小バージョン

最大バージョン

Gokit Log

https://github.com/go-kit/log

v0.1.0

v0.2.1

Zerolog

https://github.com/rs/zerolog

v1.10.0

v1.34.0

Zap

https://github.com/uber-go/zap

v1.13.0

v1.27.0

Logrus

https://github.com/sirupsen/logrus

v1.5.0

制限なし

Log

https://pkg.go.dev/log

v1.21

制限なし

Slog

https://pkg.go.dev/log/slog

v1.21

制限なし

タスクスケジューリング

コンポーネント

リポジトリアドレス

最小バージョン

最大バージョン

Cron

https://github.com/robfig/cron

v3.0.0

制限なし

トレース SDK

コンポーネント

リポジトリアドレス

最小バージョン

最大バージョン

OpenTracing SDK

https://github.com/opentracing/opentracing-go

v1.1.0

v1.2.0

OpenTelemetry SDK

https://github.com/open-telemetry/opentelemetry-go

v1.6.0

v1.37.0

AI SDK

コンポーネント

リポジトリアドレス

最小バージョン

最大バージョン

Dify Sandbox

https://github.com/langgenius/dify-sandbox

v0.2.0

制限なし

Dify Plugin Daemon

https://github.com/langgenius/dify-plugin-daemon

v0.0.6

制限なし

MCP SDK

https://github.com/mark3labs/mcp-go

v0.20.0

制限なし

Langchain SDK

https://github.com/tmc/langchaingo

v0.1.0

制限なし

Alibaba Cloud SDK

コンポーネント

リポジトリアドレス

最小バージョン

最大バージョン

FC Go SDK

https://github.com/aliyun/fc-runtime-go-sdk

v0.2.9

v0.3.1

OTS Go SDK

https://github.com/aliyun/aliyun-tablestore-go-sdk

v1.5.0

制限なし

その他の SDK

コンポーネント

リポジトリアドレス

最小バージョン

最大バージョン

K8s Client

https://github.com/kubernetes/client-go

v0.27.0

v0.32.3

K8s Controller Runtime

https://github.com/kubernetes-sigs/controller-runtime

v0.13.1

v0.18.7

よくある質問

メッセージングフレームワークを使用するとトレースが壊れるのはなぜですか?

一部のメッセージングフレームワークの実装の詳細により、Go エージェントにはトレースコンテキストの伝播に制限があります。制限は次のとおりです。

コンポーネント

リポジトリアドレス

プロデューサー

コンシューマー

AMQP

https://github.com/rabbitmq/amqp091-go

制限事項はありません。

Receive スパンのみが収集されます。メッセージコンテンツに基づくダウンストリーム呼び出しによって作成されたスパンは、Receive スパンにリンクできません。

Segmentio Kafka

https://github.com/segmentio/kafka-go

制限なし。

Receive スパンのみが収集されます。メッセージコンテンツに基づくダウンストリーム呼び出しによって作成されたスパンは、Receive スパンにリンクできません。

Shopify Sarama

https://github.com/IBM/sarama

AsyncProducer を使用する場合、Publish スパンをその親呼び出しスパンにリンクすることはできません。

Receive スパンのみが収集されます。メッセージコンテンツに基づくダウンストリーム呼び出しによって作成されたスパンは、Receive スパンにリンクできません。

IBM Sarama

https://github.com/IBM/sarama

AsyncProducer を使用する場合、Publish スパンをその親呼び出しスパンにリンクすることはできません。

Receive スパンのみが収集されます。メッセージコンテンツに基づくダウンストリーム呼び出しによって作成されたスパンは、Receive スパンにリンクできません。

RocketMQ Client Go

https://github.com/apache/rocketmq-client-go

制限なし。

  • PushConsumer のみがサポートされています。

  • 一度に複数のメッセージが消費され、ダウンストリームサービスが呼び出されると、ダウンストリーム呼び出しのスパンはすべてバッチ内の最後のメッセージのスパンにアタッチされます。この問題は、一度に 1 つのメッセージを消費する場合には発生しません。

RocketMQ Client

https://github.com/apache/rocketmq-clients/tree/master/golang

制限なし。

Receive スパンのみが収集されます。メッセージコンテンツに基づくダウンストリーム呼び出しによって作成されたスパンは、Receive スパンにリンクできません。

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

フレームワーク固有の実装のため、Go エージェントは init 関数の前に実行されるアクションを効果的にイベントトラッキングできません。

init 関数で Redis クライアントまたはデータベースクライアントを初期化します。

// 無効なコード
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 を使用します
	})
}

カスタム OTel SDK のイベントトラッキングが表示されないのはなぜですか?

  1. カスタム設定ページで、「プローブスイッチ設定」セクションの opentelemetry-plugin を選択します。その後、アプリケーションを再起動します。

    image

  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"
  )
  
  // メッセージハンドラで各メッセージのスパンを作成します。
  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()
        // その他のプロセス
      }
  }
  
  

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"
  )
  
  // メッセージハンドラで各メッセージのスパンを作成します。
  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()
              // その他のプロセス
          }
  
      }
  }