Thank you for your feedback.
Form temporarily unavailable. Please try again or contact docfeedback@servicenow.com to submit your comments.
Versions
  • London
  • Kingston
  • Jakarta
  • Istanbul
  • Helsinki
  • Geneva
  • Store
Close

Generate and simulate payload execution using identification simulation

Generate and simulate payload execution using identification simulation

Identification simulation is a central location for automatically constructing a payload that is guaranteed to be complete and valid. You can then simulate the processing of the payload by the identification engine and examine the results before actually submitting it for execution by the identification engine.

Use identification simulation to construct an input payload, and simulate processing of the payload by the identification engine. You can then examine the results, adjust identification rules if needed, and re-run the simulation of the updated payload.

Use the identification simulation to:
  • Automatically construct input payload that is based on existing identification rules, hosting and containment rules.
  • Simulate execution of a payload (automatically constructed by identification simulation, or manually created).
  • Browse payload output and execution log messages for a simulated run.
Note: Identification simulation does not commit any updates to the CMDB, other than setting the discovery_source attribute to Duplicate for a CI that is determined to be duplicate.

Automatically generate payload using identification simulation

Use identification simulation to automatically construct an input payload for a specified class. The constructed payload is complete with any required dependent CIs, correctly structured, and syntactically valid for processing by the identification engine.

Before you begin

Role required: itil

About this task

The payload that is constructed during identification simulation is for the specified class. For a dependent CI class, you will be prompted for information about all dependencies. After you provide the required details, identification simulation constructs the payload based on your input.

Procedure

  1. Navigate to Configuration > Identification Simulation.
  2. In the Start with CI Class box click Start.
  3. On the Payload Information form, in the Source field, select the data source that is associated with this class update.
    For the ServiceNow Discovery data source, select ServiceNow.
  4. Select the Class in the payload.
    1. In the Criterion Attributes area select the CI identifier attributes and then specify the values that uniquely identify a CI.
    2. In the Additional Attributes area specify attributes and values that matching CIs will be updated with.
  5. For dependent CIs associated with dependent identification rules, fill out the Criterion Attributes and Additional Attributes sections in all Container level sections that display.
  6. Click Generate. If any errors indicate that there are missing fields, fill in the missing fields and then click Generate again.
  7. You can optionally click Execute to simulate processing of the payload by the identification engine.

What to do next

Examine the results of the simulation, fine-tune the payload as needed, and combine with other payloads for other classes as desired. After finalizing the payload, use the createOrUpdateCI() API to execute the payload by the identification engine which will result in actual updates to the CMDB.

Simulate payload processing using identification simulation

Use identification simulation to simulate the identification engine process of CI identification for an input payload. Provide a valid payload, which was constructed using identification simulation or that was created manually.

Before you begin

Role required: itil

Procedure

  1. Navigate to Configuration > Identification/Reconciliation, and click Identification Simulation.
  2. To execute an existing payload:
    1. Click Start in the Start with Existing Payload tile.
    2. In the Source field, select the data source that is associated with this class update.
    3. Paste the JSON payload into the empty canvas.
  3. Or, to construct a new payload click Start in the Start with CI Class tile. See Automatically generate payload using identification simulation for more information.
  4. Click Execute to simulate processing of the payload by the identification engine.

What to do next

  1. Examine the results of the simulation in the results pane, and fine-tune the payload as needed:
    1. Click Run #1 to display the Context ID and the Run ID of the simulated run.
    2. Click the drop down arrow next to Run #1 to display additional details.
      • Input: Displays the payload for the simulation.
      • Logs: Displays all the logged messages that the identification engine generated while simulating processing of the payload, according to the specified logging level.
      • Output: Displays the output payload returned by the identification engine.
  2. After finalizing the payload, use the createOrUpdateCI() API to execute the payload by the identification engine which will result in actual updates to the CMDB.

Set logging level for identification simulation

Identification simulation logs each step of a simulated payload processing. You can then examine these run logs to determine if a payload was processed as expected, and if identification rules are effective. You can adjust the level of logging so it is helpful, and so that the amount of messages is not excessive or insufficient.

Before you begin

Role required: itil

Procedure

  1. Navigate to Configuration > Identification Simulation.
  2. Click the Settings icon.
  3. Select logging level for the identification engine under IE Log Level and for the service cache under Service Cache Log Level.
    The logging levels are displayed in ascending order, from the minimum level to the maximum level of logging.
  4. Click on the Settings icon again to close the Settings dialog box.