Cloud Monitor:OpenClaw アプリケーションの統合

制限事項

ステップ 1：インストールコマンドの取得

プラグインをインストールする前に、Cloud Monitor 2.0 コンソールからインストールコマンドを取得します。

1. Cloud Monitor 2.0 コンソールにログインし、対象のワークスペースを選択します。

2. 左側のナビゲーションウィンドウで、インテグレーションセンター をクリックします。

3. AI アプリケーション可観測性 セクションで、OpenClaw カードをクリックします。

4. パラメーター設定エリアでアプリケーション名を入力し、必要に応じて接続方法を選択してから、LicenseKey の横にある 取得 をクリックします。

   コンソールは設定に基づいてインストールコマンドを生成します。右上隅のコピーアイコンをクリックしてコマンドをコピーできます。このコマンドにはエンドポイント情報（Endpoint や LicenseKey など）が含まれています。手動インストールを計画している場合は、以下の情報を記録してください。

   パラメーター	説明	例
   Endpoint	OTLP トレースおよびメトリックレポートエンドポイント	https://proj-xtrace-xxx.cn-hangzhou-intranet.log.aliyuncs.com/apm/trace/opentelemetry/v1/traces https://proj-xtrace-xxx.cn-hangzhou-intranet.log.aliyuncs.com/apm/trace/opentelemetry/v1/metrics
   x-arms-license-key	データ書き込み認証用の LicenseKey	d95vgxi0cn@xxxxx
   x-arms-project	Simple Log Service プロジェクト名	proj-xtrace-xxx-cn-hangzhou
   x-cms-workspace	Cloud Monitor 2.0 ワークスペース ID	default-cms-xxx-cn-hangzhou
   serviceName	アプリケーション名	openclaw-xxx

ステップ 2：インストールおよび統合

curl -fsSL https://arms-apm-cn-hangzhou-pre.oss-cn-hangzhou.aliyuncs.com/opentelemetry-instrumentation-openclaw/install.sh | bash -s -- \
  --endpoint "https://<YOUR_ENDPOINT>" \
  --x-arms-license-key "<YOUR_LICENSE_KEY>" \
  --x-arms-project "<YOUR_PROJECT>" \
  --x-cms-workspace "<YOUR_WORKSPACE>" \
  --serviceName "<YOUR_SERVICE_NAME>"

[INFO]  Checking prerequisites...
[OK]    Node.js v24.14.0
[OK]    npm 11.9.0
[OK]    OpenClaw CLI found
[INFO]  Downloading plugin...
[OK]    Downloaded
[INFO]  Extracting...
[OK]    Extracted
[INFO]  Installing npm dependencies...
[OK]    Dependencies installed
[INFO]  Locating diagnostics-otel extension...
[OK]    Found diagnostics-otel at: /home/.../extensions/diagnostics-otel
[OK]    diagnostics-otel dependencies already present
[INFO]  Updating config...
[OK]    Config updated
[INFO]  Restarting OpenClaw gateway...
[OK]    Gateway restarted
════════════════════════════════════════════════════
  ✅ opentelemetry-instrumentation-openclaw installed successfully!
════════════════════════════════════════════════════

curl -fsSL -o opentelemetry-instrumentation-openclaw.tar.gz https://arms-apm-cn-hangzhou-pre.oss-cn-hangzhou.aliyuncs.com/opentelemetry-instrumentation-openclaw/opentelemetry-instrumentation-openclaw.tar.gz
tar -xzf opentelemetry-instrumentation-openclaw.tar.gz
cd opentelemetry-instrumentation-openclaw
npm install --omit=dev

openclaw plugins enable diagnostics-otel

{
  "plugins": {
    "allow": ["opentelemetry-instrumentation-openclaw", "diagnostics-otel"],
    "load": {
      "paths": ["<PATH_TO_OPENTELEMETRY_INSTRUMENTATION_OPENCLAW>"]
    },
    "entries": {
      "opentelemetry-instrumentation-openclaw": {
        "enabled": true,
        "hooks": {
          "allowConversationAccess": true
        },
        "config": {
          "endpoint": "<ENDPOINT>",
          "headers": {
            "x-arms-license-key": "<YOUR_LICENSE_KEY>",
            "x-arms-project": "<YOUR_ARMS_PROJECT>",
            "x-cms-workspace": "<YOUR_WORKSPACE_ID>"
          },
          "serviceName": "<YOUR_SERVICE_NAME>"
        }
      },
      "diagnostics-otel": {
        "enabled": true
      }
    }
  },
  "diagnostics": {
    "enabled": true,
    "otel": {
      "enabled": true,
      "endpoint": "<ENDPOINT>",
      "protocol": "http/protobuf",
      "headers": {
        "x-arms-license-key": "<YOUR_LICENSE_KEY>",
        "x-arms-project": "<YOUR_ARMS_PROJECT>",
        "x-cms-workspace": "<YOUR_WORKSPACE_ID>"
      },
      "serviceName": "<YOUR_SERVICE_NAME>",
      "traces": false,
      "metrics": true,
      "logs": false
    }
  }
}

openclaw gateway restart

FROM ghcr.io/openclaw/openclaw:latest
RUN curl -fsSL https://arms-apm-cn-hangzhou-pre.oss-cn-hangzhou.aliyuncs.com/opentelemetry-instrumentation-openclaw/install.sh | bash -s -- \
  --endpoint "https://<YOUR_ENDPOINT>" \
  --x-arms-license-key "<YOUR_LICENSE_KEY>" \
  --x-arms-project "<YOUR_PROJECT>" \
  --x-cms-workspace "<YOUR_WORKSPACE>" \
  --serviceName "<YOUR_SERVICE_NAME>"

FROM ghcr.io/openclaw/openclaw:latest
RUN curl -fsSL https://arms-apm-cn-hangzhou-pre.oss-cn-hangzhou.aliyuncs.com/opentelemetry-instrumentation-openclaw/install-ack.sh | bash -s

ステップ 3：インストールの確認

以下のコマンドを実行して、プラグインがアクティブになっているかを確認します。

openclaw plugins list

期待される出力は以下のようになります。

┌───────────────────┬─────────────────┬──────────┬──────────┬────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┬────────────┐
│ Name              │ ID              │ Format   │ Status   │ Source                                                                                                                                                                     │ Version    │
├───────────────────┼─────────────────┼──────────┼──────────┼────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┼────────────┤
│ OpenClaw OTel     │ opentelemetry-  │ openclaw │ enabled  │ ~/.openclaw/extensions/opentelemetry-instrumentation-openclaw/dist/index.js                                                                                                │ 0.1.3-beta │
│ Plugin            │ instrumentation │          │          │ Report OpenClaw AI agent execution traces to any OTLP-compatible backend via OpenTelemetry                                                                                 │            │
│ @openclaw/        │ diagnostics-    │ openclaw │ enabled  │ ~/.openclaw/npm/node_modules/@openclaw/diagnostics-otel/dist/index.js                                                                                                      │ 2026.5.6   │
│ diagnostics-otel  │ otel            │          │          │                                                                                                                                                                            │            │
└───────────────────┴─────────────────┴──────────┴──────────┴────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┴────────────┘

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

インストール完了後、OpenClaw にいくつかのメッセージを送信してエージェントの実行をトリガーします。その後、Cloud Monitor 2.0 コンソールで OpenClaw からレポートされたモニタリングデータを確認できます。

1. Cloud Monitor 2.0 コンソールにログインし、対象のワークスペースを選択します。

2. 左側のナビゲーションウィンドウで、アプリケーション可観測性 ＞ AI アプリケーション可観測性 を選択します。

3. アプリケーション一覧で、構成したサービス名（例：openclaw-gateway）を見つけます。

4. アプリケーション名をクリックするか、トレース分析 を選択して、トレース、トークン消費、LLM 入出力、レイテンシ分布を確認します。

アンインストール

プラグインをアンインストールするには、以下のコマンドを実行します。

curl -fsSL https://arms-apm-cn-hangzhou-pre.oss-cn-hangzhou.aliyuncs.com/opentelemetry-instrumentation-openclaw/uninstall.sh | bash

アンインストールスクリプトは自動的に opentelemetry-instrumentation-openclaw インストールディレクトリおよび openclaw.json 内の関連構成をすべてクリーンアップします。diagnostics-otel の構成も無効化されます。

よくある質問