サポート対象の Go ライブラリおよびプラットフォーム
Instana および Go コレクターパッケージは、以下の Go ライブラリおよびプラットフォームのトレースをサポートします。
不要な依存関係を追加しないため、 InstanaGitHub のメインモジュールは、 Go 標準ライブラリの一部であるパッケージに対する計測機能のみを提供します。 サードパーティ製パッケージの計測機能は、 Instrumentations 内に存在する別個のモジュールとして提供され、個別に go.mod 追加する必要があります。
ライブラリー
HTTP
以下の表は、 Go コレクターがトレース用にサポートする HTTP ライブラリの概要を示しています:
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 Fargate
Instana の Go コレクターは、サーバーレス・モードでの実行時にサービスが AWS Fargate で実行されているかどうかを自動的に検出します。
Google Cloud Run
Instana の Go コレクターは、サーバーレス・モードでの実行時にサービスが Google Cloud Run で実行されているかどうかを自動的に検出します。
AWS Lambda
Instana Go コレクタは、 Go で記述された AWS Lambda 関数のトレースをサポートします。 v1.23.0 トレースデータを収集および送信するには、ハンドラーを パッケージ github.com/instana/go-sensor/tree/main/instrumentation/instalambda を使用して計測する必要があります。 詳細については、 AWS Lambda および Go をご覧ください。
Azure Functions
Instana Go Collectorは、 Go で記述された Azure Functions のトレースをサポートします。 ハンドラーは、トレースデータを収集して送信するために、パッケージ github.com/instana/go-sensor/tree/main/instrumentation/instaazurefunction を使用して計測する必要があります。 詳細については、 「 Go のトレース」 ( Azure Functions ) を参照してください。
Azure コンテナ・アプリ
InstanaGo コレクターは、 Azure コンテナアプリにデプロイされた Go アプリケーションのトレースをサポートします。 トレースを有効にするには、アプリケーションに InstanaGo トレーサーSDKを組み込み、 Azure コンテナアプリにデプロイし、必要な環境変数が設定されていることを確認してください。 詳細については、 「 Azure コンテナアプリの監視」 を参照してください。
Kubernetes および OpenShift
Go アプリケーションと Instana エージェントが Kubernetes クラスターで実行されている場合、この構成に必要な設定については、 Kubernetes ネットワークアクセスに関するドキュメントを参照してください。
Go アプリケーションの監視に関する詳細については、 「 Go の監視」 を参照してください。