Container Service for Kubernetes:Go アプリケーションモニタリング

前提条件

• ACK クラスターを作成済みであること。 ACK マネージドクラスターを推奨します。 手順については、「ACK マネージドクラスターの作成」をご参照ください。

  ACK 専用クラスターの新規作成は利用できなくなりましたが、既存の専用クラスターは引き続きサポートされます。 詳細については、「ACK 専用クラスターの作成 (提供終了)」をご参照ください。

• お使いの Go アプリケーションが Go 1.18 以降を使用していること。

• ARMS が有効化されていること。

  ARMS は Alibaba Cloud のアプリケーションパフォーマンス管理 (APM) サービスです。 ARMS の詳細については、「ARMS とは」および「アプリケーションモニタリングとは」をご参照ください。

ステップ 1： ARMS アプリケーションモニタリングアドオン ack-onepilot のインストール

1. ACK コンソールにログインします。 ナビゲーションウィンドウで、[クラスター] をクリックします。

2. [クラスター] ページで、クラスターの名前をクリックします。 ナビゲーションウィンドウで、[コンポーネントとアドオン] をクリックします。

ステップ 2： Go バイナリファイルのコンパイルとコンテナイメージのビルド

拡張 Go ビルドツール instgo をローカルの Go ビルド環境 (Go 1.18 以降) と共に使用して、Go プログラムをモニタリングデータを ARMS にレポートするバイナリファイルにコンパイルします。

1. (オプション) ビルド中にプロジェクトに vendor ディレクトリが含まれている場合は、go build の後に -mod=vendor を追加します。

2. wget コマンドを使用して instgo ビルドツールをダウンロードします。

   ビルドプロセス中に、instgo は自動的に更新されます。 ビルドユーザーが書き込み権限を持つディレクトリに instgo を保存してください。

   説明

   instgo は、Go プロジェクトをインストルメント化し、ARMS によるアプリケーションのモニタリングを可能にする ARMS のビルドツールです。

   ビルド環境が Object Storage Service (OSS) へのインターネットアクセス権を持つ場合は、ビルド環境のオペレーティングシステムとアーキテクチャに対応する中国 (杭州) のインターネットダウンロード URL を選択します。

   ダウンロードコマンド

   Linux (AMD64)

   wget "http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/instgo/instgo-linux-amd64" -O instgo

   Linux (ARM64)

   wget "http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/instgo/instgo-linux-arm64" -O instgo

   Mac (ARM64)

   wget "http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/instgo/instgo-darwin-arm64" -O instgo

   Mac (AMD64)

   wget "http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/instgo/instgo-darwin-amd64" -O instgo

   Windows (AMD64)

   wget "http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/instgo/instgo-windows-amd64.exe" -O instgo.exe

3. ビルドツールを実行可能にします。

   Linux/Mac

   # 実行権限を付与します。
   chmod +x instgo

   Windows

   Windows では実行権限を付与する必要はありません。

4. (オプション) ビルドパラメーターとして UID を設定します。

   重要

   この手順をスキップした場合、instgo はデフォルトで最新バージョンの ARMS エージェントをインストールします。

   UID を設定するには、instgo 1.4.5 以降が必要です。 set コマンドを使用して、ビルドパラメーターとして UID を設定します。

   # UID は、Alibaba Cloud プライマリアカウントの ID です。
   instgo set --uid={YourAliyunUid}

5. 元のビルドコマンドのプレフィックスとして instgo を追加し、コマンドを実行します。

   instgo go build {arg1} {arg2} {arg3}

   go install を使用してプロジェクトをビルドする場合も、元のビルドコマンドのプレフィックスとして instgo を追加できます。

6. 前の手順で生成されたバイナリファイルを使用して、コンテナイメージをビルドします。

ステップ 3： Go アプリケーションでの ARMS アプリケーションモニタリングの有効化

1. ACK コンソールにログインします。 ナビゲーションウィンドウで、[クラスター] をクリックします。

2. [クラスター] ページで、クラスターの名前をクリックします。 ナビゲーションウィンドウで、[Workloads] > [Deployments] を選択します。

3. [Deployments] ページで、アプリケーションを見つけ、[操作] 列の [YAML を編集] をクリックします。

4. YAML ファイルで、spec.template.metadata レベルに次の labels を追加します。

   labels:
     aliyun.com/app-language: golang # Go アプリケーションに必須です。 これが Go アプリケーションであることを示します。
     armsPilotAutoEnable: 'on'
     armsPilotCreateAppName: "<YOUR-DEPLOYMENT-NAME>"    # <YOUR-DEPLOYMENT-NAME> をお使いのアプリケーション名に置き換えます。

ステップ 4： モニタリング詳細の表示

1. 約 1 分後、ARMS コンソールにアクセスします。 ナビゲーションウィンドウで、[アプリケーションモニタリング] > [アプリケーション] を選択し、Go アプリケーションとレポートされたデータを表示します。

   otel-go-server という名前のアプリケーションがアプリケーションリストに表示されます。 緑色のステータスは、アプリケーションが正常に実行されていることを示します。 1 秒あたりのリクエスト数、エラー率、平均応答時間などのモニタリングメトリクスを表示し、データがレポートされていることを確認します。

2. 名前 列で、アプリケーションの名前をクリックして ARMS コンソールのアプリケーションモニタリングページに移動し、モニタリング詳細を表示します。 詳細については、「アプリケーション概要」をご参照ください。

(オプション) ステップ 5： リソースの解放

アプリケーションをモニタリングする必要がなくなった場合は、ARMS エージェントをアンインストールしてください。 詳細については、「Go 用 ARMS エージェントのアンインストール」をご参照ください。

関連ドキュメント

ACK クラスター内の Java または Python アプリケーションを ARMS アプリケーションモニタリングに接続するには、「Java アプリケーションモニタリング」および「Python アプリケーションモニタリング」をご参照ください。