識別シミュレーションの使用

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：7分

    • 識別シミュレーションは、完全かつ有効であることが保証されたペイロードを自動的にビルドするための中心的な場所です。その後、識別および調整エンジン (IRE) によるペイロードの処理をシミュレートし、実際に送信して IRE で実行する前に結果を調べることができます。

    識別シミュレーションを使用して入力ペイロードをビルドし、IRE によるペイロードの処理をシミュレートします。次に結果を確認し、必要に応じて識別ルールを調整し、更新されたペイロードのシミュレーションを再実行することができます。

    次を実行するために識別シミュレーションを使用します。
    • 既存の識別ルール、ホスティングルールおよび格納規則に基づいて入力ペイロードを自動的にビルドする。
    • (識別シミュレーションによって自動的にビルドまたは手動で作成された) ペイロードの実行をシミュレートする。
    • シミュレートされた実行のペイロード出力と実行ログメッセージを参照する。
    注:
    • 識別シミュレーションは CMDB に更新をコミットしません。
    • 識別シミュレーションは、提供されている非 CMDB テーブルを含む処理ペイロードのシミュレーションをサポートしていますが、そのようなペイロードの生成はサポートしていません。

    ペイロードを自動的に生成

    識別シミュレーションを使用して、指定されたクラスの入力ペイロードを自動的にビルドします。ビルドされたペイロードは、必要な依存型 CI を備え、正しく構造化され、識別および調整エンジン (IRE) による処理に対して構文的に有効です。

    始める前に

    必要なロール：admin

    このタスクについて

    識別シミュレーション中にビルドされるペイロードは、指定されたクラス用です。依存 CI クラスの場合は、すべての依存関係に関する情報の入力を求められます。必要な詳細を入力すると、識別シミュレーションによって入力に基づいてペイロードがビルドされます。

    注:
    非 CMDB テーブルを含むペイロードの自動生成はサポートされていません。

    手順

    1. 移動先 すべて > 設定 > 識別/調整をクリックし、[ 識別シミュレーション] をクリックします。
    2. [CI クラスから開始] ボックスで [開始] をクリックします。
    3. [ペイロード情報] フォームの [データソース] フィールドで、このクラスの更新に関連付けられているデータソースを選択します。
      ServiceNow ディスカバリーデータソースの場合は、[ServiceNow] を選択します。
    4. ペイロードで [クラス] を選択します。
      1. [基準属性] エリアで CI ID 属性を選択し、CI を一意に識別する値を指定します。
      2. [追加の属性] エリアで、一致する CI を更新する属性と値を指定します。
    5. 依存識別ルールに関連付けられた依存 CI の場合は、表示されるすべての [コンテナー レベル] セクションの [基準属性] および [追加の属性] セクションに入力します。
    6. [スクリプトを生成] をクリックします。
    7. 欠損フィールドがあることを示すエラーがある場合は、欠損フィールドに記入し、[スクリプトを生成] を再びクリックします。

    次のタスク

    • [シミュレーションを実行] をクリックして IRE によるペイロードの処理をシミュレートします。
    • シミュレーションの結果を調べ、必要に応じてペイロードを微調整し、必要に応じて他のクラスの他のペイロードと結合します。ペイロードを完成させたら、createOrUpdateCI() API を使用し、IRE によってペイロードを実行します。この結果、CMDB への実際の更新が行われます。
    • [スクリプトをコピー] をクリックして、JSON スクリプトをクリップボードにコピーします。その後、そのスクリプトをサードパーティソフトウェアまたは識別シミュレーションの別の画面に貼り付けることができます。

    識別シミュレーションを使用したペイロード処理のシミュレーション

    識別シミュレーションを使用して、入力ペイロードの CI 識別の識別および調整エンジン (IRE) プロセスをシミュレートします。識別シミュレーションを使用してビルドされた、または手動で作成された有効なペイロードを指定します。

    始める前に

    必要なロール：admin

    手順

    1. 移動先 すべて > 設定 > 識別/調整をクリックし、[ 識別シミュレーション] をクリックします。
    2. オプション: 既存のペイロードのシミュレーションを実行するには：
      1. [既存のペイロードから開始] タイルで [開始] をクリックします。
      2. [JSON ペイロードを挿入] ページで、このクラスの更新に関連付けられている [データソース] を選択します。
      3. オプション: identifyCI API を使用する代わりに、[拡張識別を使用] を選択して identifyCIEnhanced を拡張 CI 識別に適用します。
      4. JSON ペイロードを空のキャンバスに貼り付けます。
    3. オプション: 新しいペイロードを作成するには、[CI クラスから開始] タイルで [開始] をクリックします。
      詳細については、「ペイロードを自動的に生成」を参照してください。
    4. [シミュレーションを実行] をクリックして IRE によるペイロードの処理をシミュレートします。

    次のタスク

    1. 結果ペインでシミュレーションの結果を確認し、必要に応じてペイロードを微調整します。
      1. [実行 #1] をクリックしてシミュレーションした実行の [コンテキスト ID] と [実行 ID] を表示します。
      2. [実行 #1] の横のドロップ ダウン矢印をクリックして追加の詳細を表示します。
        • [入力]：シミュレーションのペイロードを表示します。
        • [ログ]：指定されたログ記録レベルに従って、ペイロードの処理をシミュレートしながら IRE が生成したすべてのログメッセージを表示します。
        • [出力]：IRE によって返される出力ペイロードを表示します。
    2. ペイロードを完成させたら、createOrUpdateCI() API を使用し、IRE によってペイロードを実行します。この結果、CMDB への実際の更新が行われます。

    識別シミュレーションのロギング レベルを設定する

    識別シミュレーションは、シミュレートされたペイロード処理の各ステップを記録します。これらの実行ログを調べて、ペイロードが期待どおりに処理されたかどうか、および識別ルールが有効かどうかを判断できます。ロギングのレベルを調整して、ログが役に立ち、メッセージの量が過剰または不足しないようにすることができます。

    始める前に

    必要なロール：admin

    手順

    1. 移動先 すべて > 設定 > 識別/調整をクリックし、[ 識別シミュレーション] をクリックします。
    2. [設定] アイコンをクリックします。
    3. [IE ログレベル] で識別および調整エンジン (IRE) のログ記録レベル、[サービスキャッシュログレベル] でサービスキャッシュのログ記録レベルを選択します。
      ロギング レベルは、ロギングの最小レベルから最大レベルまでの昇順で表示されます。
    4. [設定] アイコンをもう一度クリックして [設定] ダイアログ ボックスを閉じます。

    実行ログの確認

    識別シミュレーションは、識別および調整エンジン (IRE) によって生成された実行ログを提供します。これらの実行ログにアクセスしてペイロードを実行したり、結果を調べたり、デバッグしたりすることができます。IRE ペイロード出力ログは、中央のページに分かりやすい形式で表示されます。

    始める前に

    必要なロール：admin

    このタスクについて

    また、IRE を使用する内部アプリケーション (ディスカバリー など) は、内部 API を呼び出して IRE 実行ログを表示するための URL を提供できます。

    ログ記録は識別エンジンの特定の実行のコンテキスト内にあり、特定のデータソースと時間範囲でログのリストをフィルタリングできます。2 か月前までの実行ログ 1000 件までが、コンテキスト ID、および実行時間別にグループ化してリストされます。glide.identification_logs.max_run_ids プロパティを使用して 1000 の制限を変更します。

    ログレベルを制御するには、glide.discovery.identification.log_level ディスカバリーシステムプロパティを使用し、次のいずれかの値を設定します。
    • Info
    • 警告
    • エラー
    • Debug
    • DebugVerbose
    • DebugObnoxious
    注:
    IRE は、識別ルールを処理する前に、ペイロードの初期検証を実行します。IRE がクラス識別子に基づいて重複 CI を検出すると、ペイロードが却下され、処理が停止します。

    手順

    1. 移動先 すべて > 設定 > 識別/調整 > 識別ログ.
    2. 実行リストを次のようにフィルタリングします。
      1. [ソース]：実行ログを表示するデータソースを選択します。
      2. [時間範囲]：実行ログを表示する時間範囲を指定します。
      [実行] は、指定した時間範囲の指定したデータソースのすべての実行を表示します。
    3. [実行] リストで [実行 #] をクリックし、その [コンテキスト ID] および [実行 ID] を表示します。
      固有のコンテキスト ID は、実行されている特定のペイロードに関連付けられています。そのペイロードの各実行は、一意の実行 ID に関連付けられています。複数回実行されるペイロードの単一のコンテキスト ID は、複数の実行 ID に関連付けられます。
    4. [実行 #] のドロップ ダウン矢印をクリックして追加の詳細を表示します。
      • [入力]：実行のペイロードを表示します。
      • [ログ]：指定されたロギング レベルに従って、ペイロードを実行しながら識別エンジンが生成したすべてのログメッセージを表示します。
      • [出力]：識別エンジンによって返される出力ペイロードを表示します。