サポート対象の Go ライブラリおよびプラットフォーム

Instana および Go コレクターパッケージは、以下の Go ライブラリおよびプラットフォームのトレースをサポートします。

不要な依存関係を追加しないため、 InstanaGitHub のメインモジュールは、 Go 標準ライブラリの一部であるパッケージに対する計測機能のみを提供します。 サードパーティ製パッケージの計測機能は、 Instrumentations 内に存在する別個のモジュールとして提供され、個別に go.mod 追加する必要があります。

注記: トレースの継続性は、 データベースおよびロギングライブラリには適用されません。

HTTP

以下の表は、 Go コレクターがトレース用にサポートする HTTP ライブラリの概要を示しています:

ターゲット・ライブラリー サポート・ポリシー ターゲットライブラリバージョン インスツルメンテーション・パッケージ 計測機器パッケージのバージョン トレースの継続性
net/http 0日 github.com/instana/go-sensor 1.73.2
github.com/labstack/echo/v4 45 日間 4.15.4 github.com/instana/go-sensor/tree/main/instrumentation/instaecho 1.46.2
github.com/labstack/echo/v5 45 日間 5.2.1 github.com/instana/go-sensor/instrumentation/instaecho/v2 2.4.1
github.com/gin-gonic/gin 45 日間 1.12.0 github.com/instana/go-sensor/instrumentation/instagin 1.45.0
github.com/gorilla/mux 45 日間 1.8.1 github.com/instana/go-sensor/instrumentation/instamux 1.41.0
github.com/julienschmidt/httprouter 45 日間 1.3.0 github.com/instana/go-sensor/instrumentation/instahttprouter 1.39.0
github.com/gofiber/fiber/v2 45 日間 2.52.13 github.com/instana/go-sensor/instrumentation/instafiber 0.38.0
github.com/gofiber/fiber/v3 45 日間 3.3.0 github.com/instana/go-sensor/instrumentation/instafiber/v2 2.3.0
github.com/beego/beego 45 日間 2.3.10 github.com/instana/go-sensor/instrumentation/instabeego 0.35.0
github.com/valyala/fasthttp 45 日間 1.71.0 github.com/instana/go-sensor/instrumentation/instafasthttp 0.35.0

RPC

以下の表は、 Go コレクターがトレース用にサポートする RPC ライブラリの概要を示しています:

ターゲット・ライブラリー サポート・ポリシー ターゲットライブラリバージョン インスツルメンテーション・パッケージ 計測機器パッケージのバージョン トレースの継続性
google.golang.org/grpc 45 日間 1.81.1 github.com/instana/go-sensor/instrumentation/instagrpc 1.64.0

データベース

以下の表は、 Go コレクターがトレース用にサポートするデータベースライブラリの概要を示しています:

ターゲット・ライブラリー サポート・ポリシー ターゲットライブラリバージョン インスツルメンテーション・パッケージ 計測機器パッケージのバージョン トレースの継続性
データベース/SQL 0日 ゴーセンサー 1.73.2
go.mongodb.org/mongo-driver 45 日間 2.7.0 github.com/instana/go-sensor/instrumentation/instamongo 2.23.0
ジャックC/PGX 45 日間 5.10.0 github.com/instana/go-sensor/instrumentation/instapgx 2.29.0
redis 45 日間 9.20.1 github.com/instana/go-sensor/instrumentation/instaredis 2.48.1
redigo 45 日間 1.9.3 github.com/instana/go-sensor/instrumentation/instaredigo 0.41.0
ゴーラム 45 日間 1.31.0 github.com/instana/go-sensor/instrumentation/instagorm 1.40.0
gocb 45 日間 2.12.4 github.com/instana/go-sensor/instrumentation/instagocb 1.35.1
アズコスモス 45 日間 1.4.2 github.com/instana/go-sensor/instrumentation/instacosmos 1.30.0

メッセージング

以下の表は、 Go コレクターがトレース用にサポートするメッセージングライブラリの概要を示しています:

ターゲット・ライブラリー サポート・ポリシー ターゲットライブラリバージョン インスツルメンテーション・パッケージ 計測機器パッケージのバージョン トレースの継続性
cloud.google.com/go/pubsub 45 日間 1.50.2 github.com/instana/go-sensor/instrumentation/cloud.google.com/go/pubsub 1.89.1
github.com/IBM/sarama 45 日間 1.50.3 github.com/instana/go-sensor/instrumentation/instasarama 1.57.2
github.com/rabbitmq/amqp091-go 45 日間 1.12.0 github.com/instana/go-sensor/instrumentation/instaamqp091 0.42.0

GraphQL

以下の表は、 Go コレクターがトレース用にサポートする GraphQL ライブラリの概要を示しています:

ターゲット・ライブラリー サポート・ポリシー ターゲットライブラリバージョン インスツルメンテーション・パッケージ 計測機器パッケージのバージョン トレースの継続性
graphql-go/graphql 45 日間 0.8.1 github.com/instana/go-sensor/instrumentation/instagraphql 1.36.0

その他

以下の表は、 Go コレクターがトレース用にサポートするその他のライブラリの概要を示しています:

ターゲット・ライブラリー サポート・ポリシー ターゲットライブラリバージョン インスツルメンテーション・パッケージ 計測機器パッケージのバージョン トレースの継続性
cloud.google.com/go/storage 45 日間 1.62.3 github.com/instana/go-sensor/instrumentation/cloud.google.com/go/storage 1.89.1
github.com/aws/aws-sdk-go 45 日間 1.55.8 github.com/instana/go-sensor/instrumentation/instaawssdk 1.53.0
github.com/aws/aws-lambda-go 45 日間 1.54.0 github.com/instana/go-sensor/instrumentation/instalambda 1.54.0
github.com/sirupsen/logrus 45 日間 1.9.4 github.com/instana/go-sensor/instrumentation/instalogrus 1.42.0
github.com/aws/aws-sdk-go-v2 45 日間 1.42.0 github.com/instana/go-sensor/instrumentation/instaawsv2 0.50.0

プラットフォーム

Go コレクターは、ホスト・エージェントの代わりにサーバーレス・アクセプター・エンドポイントにメトリックとトレースを送信する場合、サーバーレス・モードをサポートします。 コレクターをサーバーレスモードに切り替えるには、環境 INSTANA_ENDPOINT_URL 変数をサーバーレスアクセプター(` URL `)に設定し、 Instana インストール先を指定します。さらに、環境変数を使用して INSTANA_AGENT_KEY エージェントキーを提供してください。 サーバーレスモードで利用可能な設定オプションの詳細については、 「サーバーレス監視」 を参照してください

汎用サーバーレスエージェント

サーバーレス環境(例: AWS Lambda )やホストエージェントのないサーバー上で Go アプリケーションを監視するには、 Instana Go Tracer SDKでアプリケーションを計測し、デプロイした後、` INSTANA_AGENT_KEYINSTANA_ENDPOINT_URL Tracer`および`Tracer`環境変数を設定します。

注記: この汎用的なサーバーレスエージェント設定では、トレースのみが利用可能であり、メトリクスは利用できません。 ただし、 AWS Lambda やFargateなどの特定のサーバーレスサービスについては、 Instana もメトリクスを収集し、インフラストラクチャを関連付けます。

特定のサーバーレスサービスに関する詳細については、以下のリストを参照してください。

AWS Fargate

Instana の Go コレクターは、サーバーレス・モードでの実行時にサービスが AWS Fargate で実行されているかどうかを自動的に検出します。

Google Cloud Run

Instana の Go コレクターは、サーバーレス・モードでの実行時にサービスが Google Cloud Run で実行されているかどうかを自動的に検出します。

Azure コンテナ・アプリ

InstanaGo コレクターは、 Azure コンテナアプリにデプロイされた Go アプリケーションのトレースをサポートします。 トレースを有効にするには、アプリケーションに InstanaGo トレーサーSDKを組み込み、 Azure コンテナアプリにデプロイし、必要な環境変数が設定されていることを確認してください。 詳細については、 「 Azure コンテナアプリの監視」 を参照してください。

Kubernetes および OpenShift

Go アプリケーションと Instana エージェントが Kubernetes クラスターで実行されている場合、この構成に必要な設定については、 Kubernetes ネットワークアクセスに関するドキュメントを参照してください。

Go アプリケーションの監視に関する詳細については、 「 Go の監視」 を参照してください。