Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

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.

Note:

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:

    1. Select one or more devices and click More > Assign to Site.

      The Assign Devices to Site page appears.

    2. Select the site to which you want to assign the devices from the drop-down list.

    3. 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:

    1. Select one or more devices and click More > Reboot.

      A reboot confirmation message appears.

    2. 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:

    1. Select one or more devices and click More > Backup.

      A backup confirmation message appears.

    2. 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:

    1. Select one or more devices and click More > Upgrade.

      The Upgrade Device(s) page appears.
    2. 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.

    3. Select the image to which you want to upgrade from the list and click the icon.

    4. (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.

    5. 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:

Table 1: 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.