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

Cloud Monitor:ARMS Application Monitoring でサポート対象の Go コンポーネントとフレームワーク

最終更新日:Jun 22, 2026

このトピックでは、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

ロギング

コンポーネント

リポジトリアドレス

最小バージョン

最大バージョン

Go kit 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 クライアント

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

v0.27.0

v0.32.3

K8s コントローラーランタイム

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 関数の前に実行されるアクションを効果的に計装できません。

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 を使用します
	})
}

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

  1. カスタム設定 ページで、[プローブスイッチ設定] セクションで [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"
  )
  
  // メッセージハンドラー内の各メッセージに対してスパンを作成します。
  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(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()
              // その他の処理
          }
  
      }
  }