MID サーバーの ECC キュー

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：8分

    • 外部通信チャネル (ECC) キューは、インスタンスと MID サーバー間の接続ポイントです。MID サーバーが実行する必要があるジョブは、MID サーバーがそれらを処理できる状態になるまでこのキューに保存されます。

    各 MID サーバーセクションへのリンクMID サーバーがネットワークの内部と外部の要素に接続できることを確認するMID サーバーを Linux または Windows ホストにダウンロードしてインストールするMID サーバーを構成MID サーバーセキュリティを設定MID サーバーがネットワークの内部と外部の要素に接続できることを確認するMID サーバーを Linux または Windows ホストにダウンロードしてインストールするMID サーバーを構成MID サーバーセキュリティを設定

    Asynchronous Message Bus

    MID サーバーは Asynchronous Message Bus (AMB) によって発行されたメッセージに登録し、MID サーバーに処理待ちのタスクレコードが ECC キューにあることを通知します。その MID サーバーの ECC キューにタスクが存在する場合、MID サーバーはステータスを「処理中」に設定します。要求されたジョブの処理が終了すると、MID サーバーは結果とともに ECC キューにレポートします。

    MID サーバーは AMB クライアントを介してインスタンスへの永続的な接続を開き、/mid/server/<mid_sys_id> AMB チャネルでリッスンします。出力レコードがキュー [ecc_queue] テーブルに挿入されると、AMB メッセージが MID サーバーのチャネルに送信されます。MID サーバーは、このメッセージを受信し、MID サーバーがビジー状態で、メッセージの優先度レベルがインタラクティブでない場合を除き、直ちに作業のために ecc_queue テーブルをポーリングします。

    MID サーバーは、AMB メッセージアクティビティに関係なく、mid.poll.time 設定パラメーターで定義された最大の定期的な間隔 (デフォルトで 40 秒) で ECC キューをポーリングします。MID がビジー状態で、インタラクティブ以外の優先度レベルの AMB メッセージを受信した場合、キューのポーリング時間は mid.poll.time.standard (デフォルトで 5 秒) に変更されます。この定期的な間隔での ECC キューのポーリングは、AMB 接続が切断された場合に行われます。

    図 : 1. MID サーバーの ECC キューのポーリング プロセス
    MID サーバーの ECC キューのポーリング プロセス
    注:
    MID サーバー上の AMB クライアントはすべての環境で動作するわけではなく、パフォーマンスの問題を避けるために無効にする必要がある場合もあります。環境内の AMB を無効にするには、mid.disable_amb パラメーターを true に設定します。AMB を無効にすると、MID サーバーは新しい各 ECC キュー出力レコードの通知を受信しなくなります。詳細については、MID サーバーパラメーター の mid.poll.time を参照してください。

    ECC キューに関する情報

    次のいずれかのパスを移動すると、ECC キューにアクセスできます。
    • ディスカバリー > 出力とアーティファクト > ECC キュー
    • ディスカバリー > ディスカバリースケジュール > {スケジュール名} > {ディスカバリーステータスレコード}
    • ECC キュー > キュー
    • {ディスカバリーステータスレコード} > ECC キュー
    ECC キューは、次の情報を提供します。
    フィールド 入力値
    エージェント このメッセージの送信元または宛先の外部システムの名前。このメッセージの送信元または宛先が MID サーバーの場合、エージェント名は mid.server.xxx のフォームになります。ここで、xxx は特定の MID サーバーの名前です。
    トピック MID サーバーが実行したプローブの名前。ディスカバリーのためにパターンを使用している場合は、水平パターンプローブ水平パターンプローブが表示されます。
    名前 プローブが実際に実行したコマンド。たとえば、[トピック] が SSHCommand であれば、[名前] フィールドには、実行する実際のシェル コマンドが含まれます。ディスカバリーにパターンを使用している場合は、次のように表示されます。

    [パターン ランチャー：] その後にパターンの名前と複数ページ番号が続きます。
    ソース ディスカバリーが実行される IP アドレス。いくつかのプローブは複数の IP アドレスに対して実行されます。そのような場合、このフィールドには人間が判読できる説明が含まれます。
    応答先 このオプション フィールドには、このメッセージが応答する ECC キュー メッセージへの参照 (sys_id) が含まれます。ディスカバリーは、このフィールドを広範囲に利用して、指定のスケジュール済みディスカバリーの結果として生じるメッセージの階層を追跡します。このフィールドの値のレコード アイコンをクリックすると、現在のプローブまたはセンサー レコードを生成したアクティビティの ECC キュー レコードが開きます。
    キュー このメッセージが入力メッセージか出力メッセージかを示すインジケーター。
    状況 現在の ECC キュー レコードの状態。状況は自動的に更新されます。
    処理日時 このメッセージが処理された時刻。
    作成日時 このメッセージが作成された時刻。
    シーケンス このメッセージの一意のシーケンス番号。この値は、ECC キュー レコードが挿入されると自動的に生成されます。これは不使用になりました。
    エラー文字列 処理中にエラーが発生した場合のエラーメッセージ。このフィールドは、エラーがない限り標準フォーム上に表示されません。
    ペイロード XML 形式のメッセージ本文。返される XML のルート タグ <results> には 1 つまたは複数の <result> タグと単一の <parameters> タグが含まれます。これらのパラメーターは、単にプローブ内の MID サーバーに送信されたもののエコーです。それらはプローブごとに異なりますが、一般的にはプローブが何を行うべきか、どのように動作すべきかの詳細をプローブに伝えます。結果タグは最も興味深いタグです。プローブによって生成された実際のデータが含まれています。

    ECC キュー コントロール

    ECC キュー フォームには、次の関連リンクが含まれます。
    関連リンク 説明
    再実行 プローブを再実行します。ディスカバリーに失敗した場合や予期しないその他の結果が発生した場合は、プローブを再実行できます。
    CMDB アイテムに移動 ディスカバリー中に更新された CI の CI レコードを開きます。
    センサーに移動 関連するセンサーのレコードを開きます。

    ECC キュー再試行ポリシー

    ECC キュー再試行ポリシーモジュールとキュー再試行アクティビティモジュールを表示するには、次のプラグインをアクティブにする必要があります。

    • プラグイン名：ECC Queue Retry Policy

    • ID：com.glideapp.ecc_retry_policy

    MID サーバーの ECC キュー コンテンツを管理する

    ECC キューを使用すると、ECC キュー メッセージを作成したり、MID サーバーのログ エントリーにアクセスしたり、個々の MID サーバーレコードから統計情報を取得したりすることができます。

    始める前に

    必要なロール：admin、mid_server

    手順

    1. ディスカバリー を実行せずに MID サーバーを介して ECC キューから直接ホスティング デバイスにリモート コマンドを送信します。
      1. ECC キューに移動し、[新規] をクリックします。
      2. 次の設定でメッセージを作成します。
        • [エージェント]：コマンドを実行する MID サーバーの名前。
        • [トピック]：コマンド
        • [名前]：処理したい実際のコマンド。Windows の場合、これは DOS コマンド ライン構造で表されます。Linux の場合、構造は bash コマンド ライン エントリーになります。
        • [キュー]：出力
        • [ペイロード]：適切な XML タグを使用し、[名前] フィールドの代わりにコマンドを指定できます。これの利点は、コマンドが [名前] フィールドの長さである 120 文字に制限されないことです。コマンドには、次の XML 形式を使用します。
        <parameters>
   <parameter name="name" value="ACTUAL_COMMAND_LINE"/>
</parameters>
    2. 個々の MID サーバーの agent0.log.0 ログと wrapper.log ログを表示する ECC キューのエントリーにアクセスします。
      1. MID サーバーレコードを開きます。
      2. [関連リンク] で、[MID ログ、ファイル、およびスレッドダンプを取得] をクリックします。
        ECC キュー レコードは、次のフィルターを使用してリストに表示されます。
        • [トピック] [次の値に等しい (=)] [SystemCommand]
        • [ソース] [次の値に等しい (=)] [grabLog]
        • [エージェント] [次の値に等しい (=)] [あなたの MID サーバー]

        [agent0.log.0] と [wrapper.log] エントリーのみが表示されます。これらのログは、ファイル パス ~\agent\logs\ でもアクセスできます。

      3. ログ エントリーを開くには、[作成日] 列のリンクをクリックします。
    3. メモリや CPU 使用率データなどの個々の MID サーバーに関する有益な情報については、[queue.stats] のトピックにアクセスしてください。
      1. MID サーバーレコードを開きます。
      2. [関連リンク] で、[MID 統計情報] をクリックします。
        ECC キュー レコードは、次のフィルターを使用してリストに表示されます。
        • [トピック] [次の値に等しい (=)] [queue.stats]
        • [エージェント] [次の値に等しい (=)] [あなたの MID サーバー]