MID Server の ECC キュー

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

Asynchronous Message Bus

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

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

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

図 : 1. MID Serverの ECC キューのポーリング プロセス

注:

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

ECC キューに関する情報

次のいずれかのパスを移動すると、ECC キューにアクセスできます。

• ディスカバリー > 出力とアーティファクト > ECC キュー
• ディスカバリー > ディスカバリースケジュール > {スケジュール名} > {検出ステータス レコード}
• ECC キュー > キュー
• {検出ステータス レコード} > ECC キュー

ECC キューは、次の情報を提供します。

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

ECC キュー コントロール

ECC キュー フォームには、次の関連リンクが含まれます。

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

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

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

始める前に

必要なロール：admin、mid_server

手順

1. ディスカバリー を実行せずに MID Serverを介して ECC キューから直接ホスティング デバイスにリモート コマンドを送信します。
   1. ECC キューに移動し、[新規] をクリックします。
   2. 次の設定でメッセージを作成します。
      • [エージェント]：コマンドを実行する MID Serverの名前。
      • [トピック]：コマンド
      • [名前]：処理したい実際のコマンド。Windows の場合、これは DOS コマンド ライン構造で表されます。Linux の場合、構造は bash コマンド ライン エントリーになります。
      • [キュー]：出力
      • [ペイロード]：適切な XML タグを使用し、[名前] フィールドの代わりにコマンドを指定できます。これの利点は、コマンドが [名前] フィールドの長さである 120 文字に制限されないことです。コマンドには、次の XML 形式を使用します。

      <parameters>
         <parameter name="name" value="ACTUAL_COMMAND_LINE"/>
      </parameters>

2. 個々の MID Serverの agent0.log.0 ログと wrapper.log ログを表示する ECC キューのエントリーにアクセスします。
   1. MID Server レコードを開きます。
   2. [関連リンク] で、[MID ログ、ファイル、およびスレッドダンプを取得] をクリックします。
      ECC キュー レコードは、次のフィルターを使用してリストに表示されます。

      • [トピック] [次の値に等しい (=)] [SystemCommand]
      • [ソース] [次の値に等しい (=)] [grabLog]
      • [エージェント] [次の値に等しい (=)] [あなたの MID Server]

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

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

      • [トピック] [次の値に等しい (=)] [queue.stats]
      • [エージェント] [次の値に等しい (=)] [あなたの MID Server]