Serverless App Engine:Go アプリケーションのエージェントのインストール

前提条件

• Serverless App Engine (SAE) を有効化します。

• Application Real-Time Monitoring Service (ARMS) を有効化します。

• Container Registry (ACR) を有効化し、Enterprise Edition インスタンスまたはPersonal Edition インスタンスを作成します。

• イメージビルド環境がパブリックインターネットまたは Alibaba Cloud の内部ネットワークに接続でき、ビルド環境のセキュリティグループがポート 8080、9990、80、443 でのアウトバウンド TCP トラフィックを許可していることを確認します。

• ネットワーク環境を確認します。詳細については、「Go アプリケーションモニタリングのネットワーク設定」をご参照ください。

• イメージビルド環境のオペレーティングシステム、アーキテクチャ、Go のバージョン、フレームワークのバージョンを確認します。詳細については、「ARMS アプリケーションモニタリングでサポートされる Go コンポーネントとフレームワーク」をご参照ください。

制限事項

この機能は、イメージを使用してデプロイされた Go アプリケーションにのみ適用されます。

概要

1. プロジェクトの準備：このトピックでは、デモプロジェクトを例として使用します。

2. イメージのビルドと ACR イメージリポジトリへのプッシュ：プロジェクトからイメージをビルドし、Alibaba Cloud ACR リポジトリにプッシュして、SAE でマイクロサービスアプリケーションを作成します。

3. アプリケーションの作成：イメージリポジトリから SAE にイメージをデプロイし、アプリケーションにアクセスします。

4. アプリケーションモニタリングデータの表示：アプリケーションが生成するさまざまな種類のモニタリングデータを表示します。

1. プロジェクトの準備

Go プロジェクトを環境にアップロードします。

2. イメージのビルドとリポジトリにプッシュ

2.1 イメージのビルド

コンパイルツールをダウンロードし、アプリケーションをビルドします。

1. コンパイルツールをダウンロードします。

   # wget コマンドをインストールします。
   RUN yum -y install wget
   # この例では、中国 (杭州) リージョンのパブリックエンドポイントからコンパイルツールをダウンロードする方法を示します。
   RUN wget "http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/instgo/instgo-linux-amd64" -O instgo

   本番環境では、ビルドマシンが配置されているリージョンに基づいてダウンロードアドレスを選択してください。ダウンロードアドレスの一覧については、「各リージョンのダウンロードコマンド」をご参照ください。

   説明

   コンパイルツールのバイナリはすべてのリージョンで同じです。環境がパブリックインターネット経由で OSS にアクセスできる場合は、中国 (杭州) のパブリックエンドポイントを使用して、お使いの OS およびアーキテクチャ用のコンパイルツールをダウンロードしてください。

2. バイナリファイルに実行権限を追加します。

   RUN chmod +x instgo

3. OpenAPI を呼び出してライセンスキーを取得します。詳細については、「ListLicenseKey」をご参照ください。

4. go build コマンドを ./instgo build コマンドに置き換えて、アプリケーションをビルドします。

   # ./instgo build コマンドを使用して Go プロジェクトをコンパイルします。
   # {licenseKey} を前の手順で取得したライセンスキーに置き換えます。
   RUN ./instgo build --licenseKey="{licenseKey}" --cacheDir=./

   ビルドをテストする場合、またはまだライセンスキーを取得できない場合は、--dev フラグを追加して開発モードを有効にすることができます。このモードでは、ライセンスキーを渡す必要はありません。

   説明

   元のビルドコマンドに追加のビルド引数が含まれている場合は、-- 区切り文字の後に追加します。例：

   RUN ./instgo build --licenseKey="{licenseKey}" --cacheDir=./ -- {arg1} {arg2} ...

   • instgo コマンドリファレンス

     コマンド	フラグ	タイプ	説明	必須
     build (コンパイル)	--licenseKey, -l	string	ARMS のライセンスキー。	はい (開発モードではオプション)
     	--dev	-	開発モードを有効にし、ビルドテストのためにライセンスキーなしでコンパイルできます。	いいえ
     	--agentVersion	string	エージェントのバージョン。	いいえ
     	--agentPath	string	ローカルエージェントのパス。	いいえ
     	--cacheDir	string	エージェントのキャッシュディレクトリ。	いいえ
     	--regionId, -r	string	エージェントの依存関係を格納する OSS バケットのリージョン ID。デフォルト： cn-hangzhou。	いいえ
     	--timeout, -t	int	エージェントをプルする際のタイムアウト (秒)。デフォルト： 180。	いいえ
     	--verbose, -v	-	詳細なコンパイルログを出力します。	いいえ
     	--vpc	-	内部ネットワーク経由でエージェントパッケージの依存関係をプルします。	いいえ
     clean (アーティファクトのクリア) (アーティファクトを削除します)	-	-	-	-
     update (エージェントの更新)	--licenseKey, -l	string	ARMS のライセンスキー。	はい
     	--cacheDir	string	エージェントのキャッシュディレクトリ。	いいえ
     	--regionId, -r	string	エージェントパッケージの依存関係を格納する OSS バケットのリージョン ID。デフォルト： cn-hangzhou。	いいえ
     	--timeout, -t	int	エージェントをプルする際のタイムアウト (秒)。デフォルト： 180。	いいえ
     	--vpc	-	内部ネットワーク経由でエージェントパッケージの依存関係をプルします。	いいえ
     version (バージョン番号の出力) （バージョン番号を出力します）	-	-	-	-

   • 最初のビルド中に、エージェントはデフォルトで /opt ディレクトリにダウンロードされます。--cacheDir フラグを使用して、カスタムキャッシュディレクトリを指定できます。

2.2 イメージをリポジトリにプッシュ

ビルドした Go イメージを Alibaba Cloud イメージリポジトリにプッシュします。詳細については、「イメージのプッシュとプル (Enterprise Edition)」または「イメージのプッシュとプル (Personal Edition)」をご参照ください。

3. Go アプリケーションの作成

ここでは主要な手順のみを説明します。完全な手順については、「イメージを使用したアプリケーションのデプロイ」をご参照ください。

3.1 アプリケーションの作成

1. イメージの設定 パネルで、技術スタック言語 を [Go] に設定し、イメージのバージョンを選択します。

   [My Alibaba Cloud Images] タブを選択し、[Container Registry Personal Edition] を選択します。[Select Image Version] ドロップダウンリストから [go-demo-2] を選択します。

2. Advanced Settings ページの Application Monitoring セクションで、Application Monitoring を有効にします。

   この機能を有効にする前に、カスタムイメージを変更し、ビルドプロセス中にエージェントを手動でインストールする必要があります。ARMS は、SAE ユーザーに月間 200 GB の無料クォータを提供します。有効にすると、SAE はリクエスト数、エラー数、平均応答時間、インスタンスの GC、ヒープメモリなどのメトリクスをモニタリングし、コールトレース分析をサポートします。

3. Create Application をクリックします。

3.2 アクセスのテスト

1. アプリケーションにパブリックエンドポイントを追加します。詳細については、「SLB インスタンスをアプリケーションにバインドし、アプリケーションのパブリックまたはプライベート IP アドレスを生成する」をご参照ください。

   設定が完了すると、[Application Access Settings] ページの [Public Endpoint] セクションに、SLB のレコードとして IP アドレス、ポート (例：2222)、プロトコル (例：HTTP) などが表示されます。

2. パブリックエンドポイントをコピーし、ブラウザで開いてアクセスをテストします。

4. アプリケーションモニタリングの表示