MID サーバー での Websocket サーバーの構成

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：2分

    • エージェントから MID サーバー への接続を有効にするには、MID サーバー で Websocket サーバーを構成します。MID サーバー ごとに Websocket サーバーを 1 つのみ構成できます。

    始める前に

    • MID サーバー Windows マシンに curl (または同様のソフトウェア) をダウンロードしてインストールしてください。
    • 必要なロール：agent_client_collector_admin

    手順

    1. 移動先 すべて > MID サーバー > サーバー.
    2. 関連する MID サーバー 名を選択します。
    3. [関連リンク] セクションで、[Setup ACC Listener (ACC リスナーのセットアップ)] をクリックします。
      [エージェントクライアントコレクターのセットアップ (Agent Client Collector Setup)] ダイアログボックスが表示されます。

      [エージェントクライアントコレクターのセットアップ (Agent Client Collector Setup)] ダイアログボックス

    4. 表示されたフィールドに MID Web サーバーポート (8800) を入力します。
      注:
      必要に応じて、デフォルトのポート 8800 を変更できます。
      • セキュアな TLS 構成を呼び出すには、 acc.yml ファイルで次のように設定します。 wss://<mid_ip>:<websocket_port>/ws/events
      • MID Web サーバーで TLS 1.3 サポートを呼び出すには、MID サーバー上の wrapper-override.conf ファイルで、-Djdk.tls.server.protocols="TLSv1.3" というパラメーターを設定します。
      • Linux 環境では、1024 未満のポート番号は、スーパーユーザー権限でのみ使用できます。
    5. [OK] をクリックします。
      エージェント構成ファイルの URL を含む確認メッセージが表示されます。

      MID サーバー に Web サーバーと Websocket 拡張が構成されています。構成を確認するには、次のメニューオプションに移動します。

      • エージェントクライアントコレクター > MID Web サーバー. 結果フォームのフィールドを編集した場合は、MID Web サーバー拡張を再起動して変更を保存する必要があります。
      • エージェントクライアントコレクター > Websocket エンドポイント
    6. curl を使用して、Websocket の有効性を確認します。
      1. cmd またはターミナルウィンドウにコマンド「curl -Lk -H "Authorization: Key <API_KEY>" https://<mid_server_address>:<port>/api/mid/mon」を入力します。
      2. 次のような有効な JSON 応答 (エラーメッセージではない) を受信していることを確認します。
        図 : 1. インストール成功の JSON スクリプト

        インストール成功の JSON スクリプト