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

前提条件

• SAE を有効化する。

• Application Real-Time Monitoring Service を有効化する。

• Container Registry を有効化し、Enterprise Edition インスタンスを作成するか、Personal Edition インスタンスを作成する。

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

• ネットワーク環境を確認します。詳細については、「Golang アプリケーション監視のネットワーク構成」をご参照ください。

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

制限事項

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

手順の概要

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

2. イメージをビルドして ACR イメージリポジトリにアップロードする: プロジェクトからイメージをビルドし、Alibaba Cloud Container Registry (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

   本番環境では、ビルドマシンのリージョンに基づいてダウンロード URL を選択します。ダウンロード URL の詳細については、「各リージョンのダウンロードコマンド」をご参照ください。

   説明

   コンパイルツールはすべてのリージョンで同じです。お使いの環境がインターネット経由で Object Storage Service (OSS) にアクセスできる場合は、対応するオペレーティングシステムとアーキテクチャの杭州のパブリックエンドポイントを使用してコンパイルツールを取得できます。

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

   RUN chmod +x instgo

3. OpenAPI を呼び出して LicenseKey を取得します。詳細については、「DescribeTraceLicenseKey - LicenseKey の一覧表示」をご参照ください。

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

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

   コンパイルをテストする場合、または LicenseKey を取得できない場合は、--dev を追加して開発コンパイルモードを有効にします。このモードでは、LicenseKey を渡す必要はありません。

   説明

   元のコンパイルコマンドに他のコンパイルパラメーターが含まれている場合は、すべてのオプションの後に -- セパレーターを追加し、元のフォーマットでパラメーターを追加します。例:

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

   • 次の表に、instgo の一般的なコマンドとフラグを示します。

     コマンド	フラグ	パラメータータイプ	説明	必須
     build (コンパイル)	--licenseKey, -l	string	ARMS の LicenseKey を指定します。	はい (dev モードではオプション)
     	--dev	-	開発コンパイルモードを指定します。このモードでは、LicenseKey を指定せずにコンパイルできます。これは、基本的な可用性をテストするために使用されます。 重要	いいえ
     	--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 の LicenseKey を指定します。	はい
     	--cacheDir	string	エージェントのキャッシュディレクトリを指定します。	いいえ
     	--regionId, -r	string	エージェントパッケージの依存関係がある OSS のリージョン ID を指定します。デフォルト値: cn-hangzhou。	いいえ
     	--timeout, -t	int	エージェントをプルするタイムアウト期間を指定します。デフォルト値: 180 秒。	いいえ
     	--vpc		有効にすると、エージェントパッケージの依存関係はデフォルトで内部ネットワーク経由でプルされます。	いいえ
     version (バージョン番号の出力)	-	-	-	-

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

2.2 イメージリポジトリへのイメージのプッシュ

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

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

このセクションでは、主要なステップのみを説明します。アプリケーションの作成方法の詳細については、「イメージを使用したアプリケーションのデプロイ」をご参照ください。

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

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

   

2. [詳細設定] ページで、[アプリケーション監視] セクションの [アプリケーション監視] をオンにします。

   

3. [アプリケーションの作成] をクリックします。

3.2 アクセスのテスト

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

   

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

5. アプリケーション監視データの表示