Go コレクターのインストール
お使いの環境にある Go アプリケーションを監視するには、 Go コレクターをインストールする必要があります。 コレクターのインストール方法については、以下のセクションを参照してください。
Go コレクター・モジュールのインストール
Instana Go コレクターのインストールは、2 つのステップからなる単純なプロセスです。 最初に github.com/instana/go-sensor モジュールを go.mod ファイルに追加します。
go get github.com/instana/go-sensor
コレクターがインストールされたので、これを使用してアプリケーション・コードを 装備 できます。 これを行う最も簡単な方法は、提供されている計測モジュールを使用することです。 これらのパッケージは、コードへの変更を最小限に抑えられるように設計されています。 詳しくは、それぞれのモジュールの資料と 例 を参照してください。
アプリケーションで使用しているライブラリに計測モジュールがない場合は、 Instana の「機能提案」 機能を利用して、機能追加のリクエストを送信することをご検討ください。
もう一つの選択肢は、 OpenTracing （ API ）を使用してそのようなコードに計測機能を追加することです。これにより、自身のアプリケーションコードについてより深い洞察を得ることができます。 詳細については、 OpenTracing の例を参照してください。
Instana を使用したプロセス・メトリックのみの収集
目標がプロセスのランタイム・メトリックのみの収集である場合、main() 関数の先頭に以下のコードを追加して、コードのインスツルメンテーション・ステップをスキップし、代わりにインプロセス・コレクターを初期化できます。
instana.InitSensor(instana.DefaultOptions())
よくある問題
Instana Go コレクターを使用してプロセス・メトリックのみを収集する場合、トレース・データは収集されません。 これは、トレース・コンテキストの伝搬によるメリットがないことも意味します。つまり、Instana によってモニターされるダウンストリーム・サービスが、ユーザーのアプリケーションによって作成された要求ごとに新しいトレースを開始します。