- play_arrow Introduction
- play_arrow Overview
- play_arrow Access and Manage Paragon Automation Account
-
- play_arrow Administration
- play_arrow Introduction
- play_arrow Organization Management
- play_arrow Site Management
- play_arrow User Management
- play_arrow Inventory Management
- play_arrow Audit Logs
- play_arrow Tags
-
- play_arrow Device Life Cycle Management
- play_arrow Introduction
- play_arrow Day-Wise Activities for Device Life Cycle Management
- play_arrow Field Technician User Interface
- play_arrow Onboarding Profiles
- play_arrow Plan Device Onboarding
- play_arrow View Device Onboarding
- play_arrow Device Management
- Device Management Workflow
- Device Licenses Overview
- About the Features Tab
- About the Licenses Tab
- Manage Device Licenses
- About the Software Images Page
- Upload a Software Image
- Delete a Software Image
- About the Configuration Backups Page
- Configuration Templates Overview
- About the Configuration Templates Page
- Add a Configuration Template
- Edit and Delete a Configuration Template
- Preview a Configuration Template
- Deploy a Configuration Template to a Device
-
- play_arrow Trust and Compliance
- play_arrow Introduction
- play_arrow Manage Trust Settings and Trust Scores
- Compliance Standards Overview
- About the Compliance Benchmarks Page
- About the Compliance Tailorings Page
- Example: Create a Tailoring Document for NTP Settings
- About the Compliance Checklist Page
- Add a Checklist Template
- Add Checklist for a Device
- Import Scans and Update Rule Results in a Checklist
- Trust Plans Overview
- About the Network Score Formula Page
- Trust Score Overview
- About the Network Score Page
- About the Snapshots Page
- Add a Snapshot for a Target
- play_arrow Manage Compliance Scans
- play_arrow Manage Vulnerabilities
- play_arrow Monitor Integrity
-
- play_arrow Service Orchestration
- play_arrow Introduction
- play_arrow View Service Design Catalog
- play_arrow Manage Customers
- play_arrow Add Resources for Network Services
- play_arrow Manage Service Instances
- Service Instance Overview
- About the Service Instances Page
- View Service Instance Details
- View VPN Service Health Monitoring Data
- Physical Interfaces Health Check Results
- Logical Interfaces Health Check Results
- L2 Circuit Service Health Check Results
- Performance Graphs to View Service Health Monitoring Data
- play_arrow Provision VPN Services
- play_arrow Monitor Service Order Execution Workflows
-
- play_arrow Active Assurance
- play_arrow Introduction
- play_arrow Test Agents
- play_arrow Tests and Monitors
- play_arrow Test Templates
-
- play_arrow Paragon Shell CLI Reference
- play_arrow Introduction
- play_arrow Operational Mode Commands
- file copy
- monitor
- request paragon backup
- request paragon cluster pods reset
- request paragon cluster upgrade
- request paragon config
- request paragon deploy
- request paragon deploy cluster
- request paragon destroy cluster
- request paragon fix-permission
- request paragon load
- request paragon repair-node
- request paragon replace-node
- request paragon restore
- request paragon running-config
- request paragon ssh
- request paragon ssh-key
- request paragon storage cleanup
- request paragon super-user password reset
- request system decrypt password
- request system reboot
- show configuration paragon cluster
- show host disk usage
- show paragon backup
- show paragon certificate expiry-date certificate-type
- show paragon cluster (o)
- show paragon cluster applications (o)
- show paragon cluster common-services ingress (o)
- show paragon cluster details
- show paragon cluster namespaces
- show paragon cluster nodes
- show paragon cluster pods
- show paragon cluster pods namespace healthbot sort
- show paragon images version
- show paragon images version namespace
- show paragon pvc details
- show paragon version
- play_arrow Configuration Mode Commands
- delete paragon cluster
- load set
- set paragon cluster applications
- set paragon cluster common-services ingress
- set paragon cluster insights victoria-metrics
- set paragon cluster install
- set paragon cluster mail-server
- set paragon cluster nodes
- set paragon cluster ntp
- set paragon cluster papi
- set paragon monitoring
- set system login
- show paragon cluster (c)
- show paragon cluster applications (c)
- show paragon cluster common-services ingress (c)
- play_arrow Troubleshooting Commands
- Troubleshoot Using the Paragon Shell CLI Commands
- request paragon support information
- request paragon troubleshooting information
- request paragon debug
- request paragon debug get-tsdb-data
- request paragon debug insights-kafka-data
- request paragon debug kafka
- request paragon debug logs
- request paragon debug logs namespace
- request paragon debug postgres
- request paragon debug redis
- play_arrow Service Orchestration
- About the Service Orchestration cMGD CLI
- set foghorn:core org-id
- set service design default version
- show service order status
- show service order as-json
- show service order as-yaml
- show service designs
- show device dependent configuration
- show insights configuration
- show configuration foghorn:customers
- show service instance lock status
- show service instance lock token
- show service projects
- show service order history
- request service project add
- request service order sync
- request network resources load
- request service order load
- request service order place
- request service order modify
- request service order delete
- request service order submit
- request service order provision
- request service design install
- request service design uninstall
- request create graphdb
- request service order set
- request service instance lock
- request service instance unlock
-
ON THIS PAGE
About the Troubleshoot Devices Page
To access this page, click Observability > Health > Troubleshoot Devices.
Troubleshooting network issues is an important feature of the observability use case. Paragon Automation notifies you about significant events and anomalies within the network through alerts and alarms. You can use the information in the alert and alarm notifications to fix the anomalies and minimize the impact of the issues on the network.
The Troubleshoot Devices page provides you (superusers and network administrators) with a convenient way to monitor the health and connectivity of network devices, troubleshoot events, and manage device configurations. This page provides a summarized view of the events generated by the devices and the urgency of actions required to remediate the issues causing the events. You can also view a list and details of devices managed by Paragon Automation.
An observer can monitor the health and connectivity of network devices and troubleshoot events but cannot manage device configurations.
The widgets on top of the table in the Troubleshoot Devices page display the following information:
Urgent Action Needed—The number of critical alerts that need urgent attention. It also displays a comparison (as a number or percentage) of alerts generated in the current week against those in the past week. Hover over the widget to view the number of critical alerts generated in the current week and in the past week.
Action Needed—The number of major alerts that need attention. It also displays a comparison (as a number or percentage) of major alerts generated in the current week against the alerts in the past week. Hover over the widget to view the number of major alerts generated in the current week and in the past week. While these alerts do not require immediate attention, they do require user intervention eventually to fix the issues causing them.
Connected—The number of devices connected to Paragon Automation.
Disconnected— The number of devices that are not connected to Paragon Automation.
Tasks You Can Perform
You can perform the following tasks from this page:
View the details of devices managed by Paragon Automation.
Select the device and click More > Detail or hover over the device hostname and click the Details icon that appears. The Device Details pane appears on the right, displaying general information and the site information about the device. Click the close (x) icon to close the pane.
Click the hostname of a device and the Device-Name page appears. The Device-Name page consists of the Overview and Inventory tabs.
In the Overview tab, you can view the results of the tests that Paragon Automation executes to determine the health and connectivity of the network devices. You can monitor device health and view the details of alerts and alarms in the accordions on this page.
In the Inventory tab, you can view the information about the hardware components of the chassis and associated interfaces, licenses applied on the device, and the features available on the licenses.
Export inventory details of a device as a CSV file— To export a device's inventory details as a comma-separated value (CSV) file, select one or more devices and click Export > Export as CSV. A CSV file is downloaded to your local system.
The CSV file contains information about the hostname, IPv4 address, IPv6 address, model, serial number, OS version, type, connection status, and site of the device.
Assign a device to a site—Sites are the physical location that host devices, such as routers, switches, and firewalls within an organization network.
To assign a device to a site:
Select one or more devices and click More > Assign to Site.
The Assign Devices to Site page appears.
Select the site to which you want to assign the devices from the drop-down list.
Click OK.
A message confirming that the device is assigned to the selected site appears and the site is displayed under the Site column in the Troubleshoot Devices page. The connection status of the device is Yes in the Connected column when the device is assigned to a site.
Note:You must assign a device to a site to view the statistics and inventory data of that device.
You can perform operations like reboot, back up, open CLI, upgrade the image only on the devices that are assigned to sites.
Reboot a device—Rebooting is the process by which a running device is restarted. You can reboot a device when there are connection or operational errors on the device.
To reboot a device:
Select one or more devices and click More > Reboot.
A reboot confirmation message appears.
Click OK.
A message indicating that the reboot has started is displayed with a link to the Audits Logs (Settings Menu > Audit Logs) page. You can view the progress of the reboot job in the Audit Logs page.
Note:You can reboot a device only if the device is assigned to a site and the connection status is Yes in the Connected column.
Back up a device configuration—The backup operation retrieves a device's configuration and stores it in a configuration file in the database. You can use this file to restore a device's configuration in case of faulty device configurations.
To back up a device configuration:
Select one or more devices and click More > Backup.
A backup confirmation message appears.
Click OK.
A message confirming that the backup is successful appears and two links are displayed, which will redirect you to:
The Configuration Backups (Inventory > Devices > Configuration Backups) page where you can view the list of backed-up device configurations. See About the Configurations Backups Page.
The Audit Logs (Settings Menu > Audit Logs) page where you can track the progress of the backup operation. See About the Audit Logs Page .
Note:You can backup a device configuration only if the device is assigned to a site and the connection status is Yes in the Connected column.
On the Configuration accordion (Observability > Health > Troubleshoot Devices > Device-Name), you can compare an active version of the configuration committed on a device against other backed-up versions of the same device. For more information, see Configuration Data and Test Results.
Upgrade the image on a device— You can upgrade the image running on a device to the latest available image. Device image upgrade ensures that all the devices in your network are running efficiently and support the latest features. A device image can be upgraded only to a version that is available in Paragon Automation. To upload a required software image to Paragon Automation, see Upload a Software Image.
To upgrade a device image:
Select one or more devices and click More > Upgrade.
The Upgrade Device(s) page appears.Select the device for which you want to upgrade the image and click the Edit (pencil) icon.
A list of images is displayed in the Upgrade Image column.
Select the image to which you want to upgrade from the list and click the ✓ icon.
(Optional) If you want to upgrade the image of more than one device at the same time, repeat Steps 2 through 3 for each device.
Click OK to start the upgrade process.
A message confirming that the upgrade request is successful is displayed along with a link to the Audit Logs (Settings Menu > Audit Logs) page. You can view the progress of the image upgrade in the Audit Logs page.
On the Software accordion (Observability > Health > Troubleshoot Devices > Device-Name), you can upgrade a device image by clicking the Upgrade button. For more information, see Software Data and Test Results.
Filter the devices— You can filter the devices based on:
the severity of events such as Urgent Action Needed, Action Needed, and Being Monitored, or the Healthy status of the devices.
the site where you deployed the devices.
You can also perform the following tasks on this page:
Sort, resize, or re-arrange columns in a table (grid).
Show or hide columns in the table or reset page preferences, using the vertical ellipsis menu.
Search by using keywords—Click the search icon (magnifying glass), enter the search term in the text box, and press Enter. The search results are displayed on the same page.
Filter the data displayed in the table—Click the filter icon (funnel) and select whether you want to show or hide advanced filters. You can then add or remove filter criteria, save criteria as a filter, apply or clear filters, and so on. The filtered results are displayed on the same page.
For more information, see GUI Overview.
Field Descriptions
Table 1 describes the fields on the Troubleshoot Devices page:
Field | Description |
---|---|
Hostname | The hostname of the device. |
Severity | Indicates the seriousness of the events on the device. The severity of the events are categorized as: Urgent Action Needed—Indicates that a critical event has occurred on the device. The functioning of the device is affected and needs urgent user intervention to fix the issue. Action Needed—Indicates that a major event has occurred on the device and needs user action but not urgently. The functioning of the device is affected but not drastically. Being Monitored—Indicates that a minor event has occurred on the device but needs no user action. The device is being monitored. Healthy—Indicates that the device is healthy without any issues. |
IPv4 address | The IPv4 address assigned to the device. |
IPv6 address | The IPv6 address assigned to the device. |
Model | The model of the device. |
Serial Number | The serial number of the device. |
OS version | The OS version of the device. |
Type | The type of the device. For example, router or switch. |
Connected | Indicates whether the device is connected to Paragon Automation. For example, Yes or No. |
Site | The site on which the device is deployed. |