すべてのプロダクト
Search

このプロダクト

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

    ドキュメントセンター

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

    最終更新日:Jun 21, 2026

    Golang アプリケーションに ARMS エージェントを手動でインストールし、 SAE にデプロイすると、 ARMS を使用してアプリケーションを監視できます。 ARMS を使用すると、アプリケーション トポロジー、呼び出しトレース分析、SQL パフォーマンス分析など、さまざまな監視データを表示できます。このトピックでは、アプリケーションに ARMS エージェントを手動でインストールし、 SAE にデプロイする方法について説明します。

    前提条件

    制限事項

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

    概要

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

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

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

    4. アプリケーション監視データの表示：アプリケーションによって生成されたさまざまなタイプの監視データを表示します。

    1. プロジェクトの準備

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

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

    2.1 イメージのビルド

    このセクションでは、コンパイルツールをダウンロードし、アプリケーションをビルドするコマンドについて説明します。

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

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

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

      説明

      コンパイルツールは、すべてのリージョンで同じバイナリです。お使いの環境からパブリックインターネット経由で OSS にアクセスできる場合は、China (Hangzhou) のパブリックエンドポイントを使用して、対象の OS とアーキテクチャ用のコンパイルツールをダウンロードできます。

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

      RUN chmod +x instgo

    3. OpenAPI を呼び出して LicenseKey を取得します。詳細については、「ListLicenseKey」をご参照ください。

    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

        -

        開発モードを有効にします。このモードでは、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 イメージを Alibaba Cloud イメージリポジトリにプッシュします。詳細については、「イメージのプッシュとプル (Enterprise Edition)」または「イメージのプッシュとプル (Personal Edition)」をご参照ください。

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

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

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

    1. Specify Image パネルで、Technology Stack Programming Language を [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] セクションで、追加されたパブリック Server Load Balancer (SLB) レコードを表示できます。レコードには、IP アドレス、ポート (例： 2222)、およびプロトコル (例： HTTP) が含まれます。

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

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

    SAE コンソール

    アプリケーションの Basic Information ページに移動します。左側のナビゲーションペインで、Application Monitoring をクリックします。Application Monitoring ページで、モニタリングデータ を表示します。

    [Application Overview] ページには、リクエスト数、エラー数、平均応答時間、インスタンス数などの監視メトリクスと、それらのトレンドチャートが表示されます。これにより、アプリケーションの監視データが正しく収集されていることが確認できます。

    ARMS コンソール

    1. にログインします。 ARMSコンソールを使用します。

    2. 左側のナビゲーションペインで、Application Monitoring > アプリケーションリスト を選択します。トップメニューバーで、対象のリージョンを選択します。

      このページには、接続されているアプリケーションの監視メトリクス ([秒間リクエスト数]、[エラー率]、[平均応答時間]、[CVE 数]、[Smart Insight]、[応答時間の傾向]など) が表示されます。これにより、アプリケーションデータが正しく収集されていることが確認できます。

    3. アプリケーションリスト ページの検索ボックスでアプリケーションを検索し、アプリケーション名をクリックします。

    4. 詳細ページで監視データを表示します。

      eysHShmevA