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

前提条件

開始する前に、以下の条件を満たしていることを確認してください。

• ACK マネージドクラスターまたは ACK 専用クラスター。詳細については、「ACK マネージドクラスターの作成」または「ACK 専用クラスターの作成（非推奨）」をご参照ください。

• ローカルビルド環境に Go 1.18 以降がインストールされていること

• ARMS が有効化されていること。詳細については、「ARMS の有効化」をご参照ください。ARMS はアプリケーションパフォーマンス管理 (APM) サービスです。その概要については、「ARMS とは」および「アプリケーションモニタリングとは」をご参照ください。

セットアップ後の状態

以下の手順を完了すると、ARMS コンソールに以下のような情報が表示されます。

• アプリケーショントポロジー — サービス間のリアルタイム依存関係グラフ

• インタフェース呼び出し — 各 HTTP/RPC エンドポイントのレイテンシー、スループット、エラー率

• データベース分析 — 接続済みデータベースにおける遅延クエリと呼び出しパターン

ステップ 1：ack-onepilot コンポーネントのインストール

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

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

3. [ログおよびモニタリング] セクションで、ack-onepilot を見つけ、[インストール] をクリックします。ダイアログボックスで、デフォルトのパラメーター値をそのまま使用し、[OK] をクリックします。

インストール後に、[アドオン] ページから ack-onepilot のスペックアップ、再構成、またはアンインストールが可能です。

ステップ 2：ARMS によるクラスターリソースへのアクセス権限の付与

最近作成された ACK マネージドクラスターには、ARMS がパスワードなしのアクセスを自動的に実行できるようにするシークレット addon.arms.token が含まれています。クラスターにすでにこのシークレットが存在する場合は、ステップ 3 に進んでください。

シークレットの存在確認手順：

1. ACK コンソールでクラスター名をクリックします。左側のナビゲーションウィンドウで、[構成] > [シークレット] を選択します。

2. [名前空間] ドロップダウンリストから、[kube-system] を選択します。

3. addon.arms.token が一覧に表示されているか確認します。

シークレットが存在しない場合の手動権限付与手順：

1. ACK コンソールでクラスター名をクリックします。左側のナビゲーションウィンドウで、[クラスター情報] をクリックします。

2. [基本情報] タブで、[クラスターリソース] セクションへ移動し、[Worker RAM ロール] の横にあるリンクをクリックします。

3. [権限] タブで、[権限の付与] をクリックします。

4. [AliyunARMSFullAccess] ポリシーを選択し、[OK] をクリックします。

Elastic Container Instance (ECI) に接続された ACK マネージドクラスターの場合：

RAM クイック権限付与 ページに移動し、権限付与を完了します。その後、ack-onepilot 用に作成された Pod を再起動します。

ステップ 3：instgo を使用した Go バイナリのコンパイル

instgo は ARMS が提供する拡張型 Go コンパイルツールです。標準の go build コマンドをラップし、コンパイル時にモニタリング用のイベントトラッキングを挿入します。ソースコードの変更は一切不要です。

chmod +x instgo

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

ステップ 4：Deployment に対する ARMS モニタリングの有効化

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

2. [クラスター] ページで、クラスター名をクリックします。左側のナビゲーションウィンドウで、[ワークロード] > [デプロイメント] を選択します。

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

4. YAML ファイルの spec.template.metadata に、以下のラベルを追加します。

   labels:
     aliyun.com/app-language: golang        # このアプリケーションが Go アプリケーションであることを識別
     armsPilotAutoEnable: 'on'
     armsPilotCreateAppName: "<your-deployment-name>"    # デプロイメント名に置き換え

   

5. YAML を保存します。Kubernetes がラベルが更新された Pod を再起動します。

ステップ 5：モニタリングデータの確認

最初のデータが表示されるまで、約 1 分待ちます。

1. ARMS コンソールにログインします。左側のナビゲーションウィンドウで、[アプリケーションモニタリング] > [アプリケーション一覧] を選択します。Go アプリケーションがメトリックとともに一覧に表示されます。

   

2. アプリケーション名をクリックしてモニタリングダッシュボードを開きます。利用可能なメトリックの説明については、「アプリケーションの概要」をご参照ください。

トラブルシューティング

数分経過しても ARMS コンソールにデータが表示されない場合は、以下の項目を確認してください。

（任意）モニタリングの無効化

アプリケーションのモニタリングを停止するには、ARMS エージェントをアンインストールします。詳細については、「Go 向け ARMS エージェントのアンインストール」をご参照ください。

次のステップ

• ACK クラスター内の Java アプリケーションを監視する

• ACK クラスター内の Python アプリケーションのモニタリング

• アプリケーションの概要 — モニタリングダッシュボード全体を探索します