Discovery Admin Workspace Diagnostics
Summarize
Summary of Discovery Admin Workspace Diagnostics
The Discovery Admin Workspace Diagnostics page in ServiceNow enables administrators to effectively identify, prioritize, and resolve errors and anomalies found in IP-based and Cloud Discovery schedules. Accessible via Workspaces > Discovery Admin Workspace > Diagnostics, this tool helps maintain discovery reliability by offering detailed insights, task creation, filtering, support tools, and logs review. These capabilities are available starting from Discovery Admin Workspace version 1.17.0.
Show less
Key Features
- Anomaly Detection Tab: Displays Discovery schedules with detected anomalies categorized by severity—Critical (failed runs), Major (low CI discovery rate), and Minor (long run time or high error count). Anomaly detection requires enabling and a minimum of five CIs to trigger. Visual indicators summarize metrics such as failed schedules, low CI discovery rates, increased errors, and long run times. Filters by schedule name, severity, and anomaly type help prioritize actions. Administrators can clear anomalies or adjust detection settings directly from this tab.
- Diagnostics Tab: Lists all errors from discovery processes, allowing creation or editing of error tasks for tracking resolution. Filters and sorting options include schedule, error name, code, priority, and error categories (e.g., CMDB, Network). Selecting error counts links to detailed error stats pages with instructions and associated knowledge base articles. Action menus provide options to ignore errors, retry discovery, exclude IPs globally, or check Shazzam port status.
- Case Management Tab: Offers an overview of error task statuses with Kanban and List views. Administrators can create new tasks tied to errors and filter tasks by schedule or search by task name.
- Support Tools Tab: Contains tools to assist with troubleshooting and investigation specific to Discovery Admin Workspace.
- Logs Tab: Provides access to ECC Queue and Discovery Logs, allowing filtering, detailed views, and export options to facilitate error diagnosis.
- Ignored Errors Tab: Maintains a rolling 30-day record of ignored errors, enabling administrators to restore any ignored error back to active diagnostics if needed.
- Virtual Agent Chat: Embedded in each tab, this chatbot aids in retrieving diagnostic information and troubleshooting. It supports functions like MID Server health validation (pre-upgrade checks, status, mutual authentication), pattern synchronization validation, retrieving MID Server settings, evaluating discovery performance metrics, and accessing various logs. Activation requires enabling the sndiscoworkspace.visibilitydiagnosticutility property.
Practical Benefits for ServiceNow Customers
- Quickly identify and categorize anomalies and errors in Discovery schedules to maintain CMDB accuracy and operational efficiency.
- Use filtering and prioritization to focus on the most critical discovery issues, reducing troubleshooting time.
- Create and manage error resolution tasks directly from diagnostics, providing clear accountability and tracking.
- Leverage integrated support tools, logs, and virtual agent assistance to streamline root cause analysis and remediation.
- Maintain control over ignored errors and easily restore them if necessary, ensuring no important issues are permanently overlooked.
The Diagnostics page helps you prioritize and address errors and anomalies in IP-based and Cloud Discovery schedules. Resolve issues by creating error tasks, tracking progress, and using support tools and logs.
Key features
- Anomaly detection tab
- Displays all the Discovery schedules with anomalies detected in a certain time period. You can configure this time scale on the Settings page.Important:This tab only displays anomalies when anomaly detection is enabled. Starting with v1.11.0, anomaly detection requires a minimum of five CIs to trigger. For more information, see the https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB2601541 article in the Now Support Knowledge Base.n the Now Support Knowledge Base.
Select the More options icon (
), then select Refresh to refresh the data for each visualization in this section.
Table 1. Data visualizations Report title Type Description Schedules with anomalies Indicator Number of Discovery schedules with anomalies detected over a certain time period. Schedules are categorized as the following: - Critical anomalies: Failed to run.
- Major anomalies: Have a low CI discovery rate.
- Minor anomalies: Have a long run time or a high error count.
Failed schedules Indicator Number of Discovery schedules that failed to run. Low CI discovery rate Indicator Number of Discovery schedules that have a low CI discovery rate. Note:The threshold for the CI discovery rate can be configured on the Settings page.Increased error count Indicator Number of Discovery schedules that have an increased error count. Note:The threshold for the error count can be configured on the Settings page.Long run time Indicator Number of Discovery schedules that had a long run time. Note:The threshold for the run time can be configured on the Settings page.Selecting any of the indicators filters the table to reflect the schedules represented in the data count. For each entry in the table, you can view details around the type and severity of anomalies.
The Actions drop-down menu provides a direct shortcut to the Settings page for configuring anomaly detection. Additionally, the menu includes a Clear all anomalies option so that administrators can quickly remove records in the Discovery Schedule Anomaly [discovery_schedule_anomaly] and Discovery Schedule Anomaly Metrics [discovery_schedule_anomaly_metrics] tables.
Use the Filter by options to prioritize and address anomalies. Filter Discovery schedules by name using the Schedules drop-down menu. Additionally, you can prioritize the results with the Severity drop-down menu, which includes options such as Critical, Major, and Minor. Use the Anomaly type drop-down menu to quickly view schedules with the same anomaly. Available options include Failed schedule, Low CI discovery rate, Increased error count, and Long run time.
- Diagnostics tab
-
Displays all errors from every discovery. For each entry in the Discovery errors table, you can either create an error task or ignore the error using the Create task and Ignore buttons. If an entry already has an error task, it displays the Edit task button along with the task's name and priority.
- Case Management tab
- Provides an overview of the statuses of error tasks. You can select each task to navigate to its detailed record. New tasks can be created and associated with existing errors using the Create Task button. You can filter by Discovery schedule with the Schedule drop-down menu, or search for the name of the error task with the Search bar. Use the Kanban Board View and List View to change the display style.
- Support tools
- The Support tools tab provides tools to investigate and troubleshoot your instance. For a full list of the tools available on this tab, see Discovery Admin Workspace support tools.
- Logs
- The Logs tab enables you to access the ECC Queue and Discovery Logs. Reviewing these logs can help diagnose and resolve errors. You can select an entry in the log to view more details. Additionally, the tables can be filtered or exported using the corresponding buttons.
- Ignored Errors tab
- Keeps a record of all errors ignored in the last 30 days. Errors older than 30 days are deleted. You can add an error back to the Discovery errors table using the Undo ignore button.
Virtual agent chat
- MID Server Pre-Upgrade Check: Enables you to run on-demand tests on the MID Server before upgrading. It identifies issues that might stop the upgrade process and provides a log to help resolve any issues found.
- MID Server Status Validation: Validates that the MID Server user is active and is part of the mid_server group, and checks for basic user authentication errors.
- MID Server Mutual Authentication: Enables you to select a specific user and verify that the user has an active, non-expired certificate.
- Pattern Synchronization Validation: Verifies that a pattern and its related libraries are synchronized with the given MID Server and determines if they’re custom.
Selecting the MID Server Settings Retriever prompt enables you to retrieve settings from the available MID Servers. If there’s more than one MID Server, the agent provides a list of MID Servers to choose from. Then, you can download the configuration file and analyze the configuration values for the selected MID Server.
- Average wait times for processing ECC Queue inputs.
- Average wait times for the MID Server to process ECC Queue outputs.
- Information about the probes or sensors that took the longest time to complete their tasks.
Selecting the Retrieve Logs prompt enables you to access Pattern Logs, Discovery Logs, or Node Logs. Pattern logs can be retrieved using the ECC Queue output ID or the Managed IP address and pattern name. Discovery logs can be accessed by log status or ECC Queue input, and node logs by transaction ID or ECC Queue input.