The system collects logs to reflect the activity that takes place during a horizontal discovery based on both patterns and probes. Use the logs to fine-tune or troubleshoot the discovery process.

For horizontal discovery the system generates logs of the following types:
Probe-based
The logs for probe-based horizontal discovery cover classification failures, CMDB updates, and authentication failures. A Discovery Log record is created for each action associated with a discovery status.
Note: The Discovery log also displays errors that occur during identification by taking log entries from the Identification Engine log. See Examine run logs for more information about the identification engine and possible errors.
Pattern-based
The logs for pattern-based horizontal discovery include the information about discoveries that were performed with patterns. A horizontal discovery log record is created for an entire horizontal discovery run, which includes the results of all the operations specified in the pattern.

Review the logs for horizontal discovery

Access the logs to understand the discovery process and fine-tune the discovery process.

Before you begin

Role required: discovery_admin

Procedure

  1. Navigate to All > Discovery > Status.
  2. Open a Discovery Status record.
    The Discovery Log related list displays the logs for probe-based discovery. See Discovery log details.
    Discovery Log Records
  3. (Optional) Find out the information related to the relevant log entry:
    • Select the link in the CI column to open the record for that CI.
    • Select the link in the Created column to view the log record.
    • Select the IP address link in the Device column to view the log records for a particular device.
  4. To view logs for pattern-based discovery, select the Here link for a log entry that has HorizontalDiscoveryProbe in the ECC queue input.

    The link to the pattern-based discovery log.

    The Horizontal Discovery Log window opens showing the list of pattern-based log entries. For information on logged discovery phases, see Discovery log details.

    Figure 1. Horizontal Discovery log
    Horizontal Discovery log
  5. Select an item in the left-hand column to see more information about it in the right-hand column.
  6. (Optional) To debug the pattern, select the name of the Identification Section, and then select the Debug button.
  7. To return to the log record, select Close.

What to do next

  • To fine-tune or troubleshoot the pattern-based discovery, retrieve the payload as described in KB0998923: Retrieve Payload Feature.
  • Validate commands used in pattern-based discovery, if there is one of the following errors:
    • Authentication issue
    • Authorization/Permission issue
    • No Valid credentials present
    • IP not reachable from mid
    • Command with wrong syntax
  • If there is an error in payload processing, select the IRE Error Documentation button to learn about the Identification and Reconciliation Engine (IRE) error that occurred and how to resolve it.Horizontal Discovery Log window showing a payload processing error

Change retention time for probe-based discovery logs

You can configure the amount of time that Discovery retains log entries for the probe-based horizontal discovery.

Before you begin

Role required: admin

About this task

By default, the probe-based discovery log retains information for 30 days, or 2,592,000 seconds.

Procedure

  1. Open the Auto Flushes table by typing sys_auto_flush.list in the navigation filter.
  2. Open the discovery_status record.
  3. Change the value in the Age in seconds field.
  4. For the change to take effect immediately, run the Table Cleaner Job in the Schedule [sys_trigger] table.
  5. Click Update.