Application Real-Time Monitoring Service:Go エージェントの手動インストール

ステップ 1：Go アプリケーションイメージのコンパイル

ARMS Go アプリケーション監視を使用するには、元の go build コマンドにプレフィックスとして instgo を追加し、ビルド時に instgo ツールを使用するだけです。ビジネスコードの変更や、OpenTelemetry SDK の統合は不要です。instgo エージェントは OpenTelemetry 標準に基づいて自動計装を実装し、コンパイル時の AST 分析段階で監視コードを自動的に挿入します。

ステップ 2：環境変数の設定

• ビルド後、次の環境変数を Go アプリケーションに追加します：

  export ARMS_ENABLE=true
  export ARMS_APP_NAME=xxx # アプリケーション名
  export ARMS_REGION_ID=xxx # Alibaba Cloud アカウントのリージョン ID
  export ARMS_LICENSE_KEY=xxx # ARMS コンソールから取得したライセンスキー

  説明

  デフォルトでインターネット経由でデータを報告する場合は、環境変数 ARMS_NETWORK_STRATEGY=public を設定できます。

• 環境変数をエクスポートする代わりに、-ldflags フラグを使用してビルドプロセス中に指定することもできます。

  以下のコード例の {agent_repository_path} を、実際のエージェントのリポジトリパスに置き換えてください。その他のパラメーターについては、環境変数を参照してください。

  instgo go build -ldflags " -X '{agent_repository_path}/pkg/exporters.ArmsApmName=${appName}' -X '{agent_repository_path}/pkg/exporters.ArmsEnable=true' -X '{agent_repository_path}/pkg/exporters.LicenseKey=${licenseKey}' -X '{agent_repository_path}/pkg/exporters.RegionId=${regionId}'"

• systemctl を使用してアプリケーションを起動する場合は、次のコマンドを使用して環境変数を設定できます：

  systemctl set-environment ARMS_ENABLE=true
  systemctl set-environment ARMS_APP_NAME=xxx # アプリケーション名
  systemctl set-environment ARMS_REGION_ID=xxx # Alibaba Cloud アカウントのリージョン ID
  systemctl set-environment ARMS_LICENSE_KEY=xxx # ARMS コンソールから取得したライセンスキー

(任意) Dockerfile の設定

Docker 環境を使用している場合は、次の例に従って Dockerfile を変更してください。

FROM golang:1.21 AS builder
WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN wget "http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/instgo/instgo-linux-amd64" -O instgo
RUN chmod +x instgo
RUN ./instgo go build -o myapp .

FROM debian:bookworm-slim
WORKDIR /app
COPY --from=builder /app/myapp .
ENV ARMS_ENABLE=true
ENV ARMS_APP_NAME=AppName
ENV ARMS_REGION_ID=regionId
ENV ARMS_LICENSE_KEY=licenseKey
EXPOSE 8080
CMD ["./myapp"]

結果の検証

約 1 分後、ARMS コンソールの Application Monitoring > アプリケーションリスト ページを確認してください。アプリケーションが表示され、データが報告されていれば、エージェントのインストールは成功です。