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

Application Real-Time Monitoring Service:ARMS アプリケーション監視でサポートされる Go のコンポーネントとフレームワーク

最終更新日:Jan 30, 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.4.0

v1.10.0

Segmentio Kafka

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

v0.4.10

v0.4.49

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.3

IBM Sarama

https://github.com/IBM/sarama

v1.22.0

v1.46.3

Shopify Sarama

https://github.com/Shopify/sarama

v1.22.0

v1.38.1

Mqtt Server

https://github.com/mochi-mqtt/server

v2.6.0

制限なし

franz-go

https://github.com/twmb/franz-go

v1.18.0

制限なし

confluent-kafka-go

https://github.com/confluentinc/confluent-kafka-go

v1.7.0

制限なし

streadway-amqp

https://github.com/streadway/amqp

v1.0.0

制限なし

RPC フレームワーク

コンポーネント

リポジトリアドレス

最小バージョン

以降のバージョン

Beego

https://github.com/beego/beego

v1.2.0

制限なし

Dubbo

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

v3.0.1

v3.3.0

Echo

https://github.com/labstack/echo

v4.0.0

制限なし

FastHTTP

https://github.com/valyala/fasthttp

v1.45.0

制限なし

Fiber

https://github.com/gofiber/fiber

v2.43.0

制限なし

Gin

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

v1.7.0

制限なし

GoFrame

https://github.com/gogf/gf

v2.4.0

制限なし

Go Micro

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

v4.9.0

v5.12.0

Go Restful

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

v3.7.0

制限なし

Go Zero

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

v1.5.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

制限なし

Kratos

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

v2.1.2

v2.9.2

Macaron

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

v1.1.0

制限なし

Mux

https://github.com/gorilla/mux

v1.3.0

制限なし

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.3

SQL/NoSQL

コンポーネント

リポジトリアドレス

最小バージョン

以降のバージョン

Go Elasticsearch

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

v7.0.0

制限なし

Go Redis

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

v8.10.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.31.1

GORM MySQL

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

v1.0.4

制限なし

Go standard library MySQL

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

v1.18

制限なし

Mongo

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

v1.11.1

制限なし

PostgreSQL

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

v10.10.0

v10.15.0

Redis Go

https://github.com/gomodule/redigo

v1.9.0

v1.9.3

Rueidis

https://github.com/redis/rueidis

v1.0.30

制限なし

sqlx

https://github.com/jmoiron/sqlx

v1.3.0

v1.4.0

Xorm

https://github.com/go-xorm

v0.2.2

制限なし

ClickHouse

https://github.com/ClickHouse/clickhouse-go

v2.0.1

制限なし

GORM ClickHouse

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

v0.2.0

制限なし

ロギング

コンポーネント

リポジトリアドレス

古いバージョン

新しいバージョン

Gokit Log

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

v0.1.0

v0.2.1

Zerolog

https://github.com/rs/zerolog

v1.10.0

制限なし

Zap

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

v1.13.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

制限なし

go-zero logx

https://github.com/zeromicro/go-zero/tree/master/core/logx

v1.6.5

制限なし

Kratos log

https://github.com/go-kratos/kratos/blob/main/middleware/logging

v2.1.2

v2.4.0

タスクスケジューリング

コンポーネント

リポジトリアドレス

最小バージョン

以降のバージョン

Cron

https://github.com/robfig/cron

v3.0.0

制限なし

XxlJob

https://github.com/xxl-job/xxl-job-executor-go

v1.2.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.39.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

制限なし

openai-go

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

v1.5.0

制限なし

go-openai

https://github.com/sashabaranov/go-openai

v1.30.0

制限なし

deepseek

https://github.com/cohesion-org/deepseek-go

v1.3.0

制限なし

coze-studio

https://github.com/coze-dev/coze-studio

v0.2.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

コンポーネント

リポジトリ URL

古いバージョン

上位バージョン

ants pool

https://github.com/panjf2000/ants

v1.1.0

制限なし

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.22.4

よくある質問

メッセージフレームワークを使用している場合にトレースチェーンが途切れるのはなぜですか?

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

コンポーネント

リポジトリアドレス

プロデューサー

コンシューマー

AMQP

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

制限なし。

Receive Span のみ記録されます。メッセージ内容に基づいて下流で生成された Span は Receive Span にリンクできません。

Segmentio Kafka

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

制限なし。

Receive Span のみ記録されます。メッセージ内容に基づいて下流で生成された Span は Receive Span にリンクできません。

Shopify Sarama

https://github.com/IBM/sarama

AsyncProducer を使用する場合、Publish Span を親呼び出し Span にリンクできません。

Receive Span のみ記録されます。メッセージ内容に基づいて下流で生成された Span は Receive Span にリンクできません。

IBM Sarama

https://github.com/IBM/sarama

AsyncProducer を使用する場合、Publish Span を親呼び出し Span にリンクできません。

Receive Span のみ記録されます。メッセージ内容に基づいて下流で生成された Span は Receive Span にリンクできません。

RocketMQ Client Go

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

制限なし。

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

  • 複数のメッセージを一度に消費し、消費中に下流への呼び出しを行う場合、すべての下流 Span はそのバッチの最後のメッセージの下にアタッチされます(1 回に 1 つのメッセージを消費する場合はこの問題は発生しません)。

RocketMQ Client

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

制限なし。

Receive Span のみ記録されます。メッセージ内容に基づいて下流で生成された Span は Receive Span にリンクできません。

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. カスタム設定ページで、[プローブスイッチ設定]セクションの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)
              tracer := otel.GetTracerProvider().Tracer("")
              opts := append([]oTrace.SpanStartOption{}, oTrace.WithSpanKind(oTrace.SpanKindConsumer))
              ctx, span := tracer.Start(ctx, "mq", opts...)
              defer span.End()
              // その他の処理
          }
  
      }
  }