close

keyboard_arrow_left

Table of Contents Expand all

play_arrow Introduction
- play_arrow Overview
- play_arrow Access and Manage Paragon Automation Account
play_arrow Administration
- play_arrow Introduction
  - Administration Overview
  - Administration Workflow
- play_arrow Organization Management
- play_arrow Site Management
- play_arrow User Management
- play_arrow Inventory Management
  - About the Inventory Page
  - Assign a Device to a Site
- play_arrow Audit Logs
  - Audit Logs Overview
  - About the Audit Logs Page
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
  - Field Technician UI Overview
  - Working with Field Technician UI Pages
- play_arrow Onboarding Profiles
- play_arrow Plan Device Onboarding
- play_arrow View Device Onboarding
- play_arrow Device Management
play_arrow Observability
- play_arrow Introduction
  - Observability Overview
- play_arrow Troubleshoot Devices
- play_arrow View Network Topology
play_arrow Trust and Compliance
- play_arrow Introduction
  - Trust and Compliance Overview
  - Perform Compliance Scan and Manage Checklists
- play_arrow Manage Trust Settings and Trust Scores
- play_arrow Manage Compliance Scans
- play_arrow Manage Vulnerabilities
- play_arrow Monitor Integrity
play_arrow Service Orchestration
- play_arrow Introduction
  - Service Orchestration Overview
  - L3VPN Service Provisioning Workflow
- play_arrow View Service Design Catalog
  - Service Design Overview
  - About the Service Designs Page
- play_arrow Manage Customers
- play_arrow Add Resources for Network Services
  - Add Network Resources for L3VPN Service
- play_arrow Manage Service Instances
- play_arrow Provision L3VPN Service
- 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 Paragon Shell CLI Reference

list Table of Contents

English

Troubleshoot Using the Paragon Shell CLI Commands

date_range 11-Dec-24

arrow_backward

arrow_forward

Read the following topics to understand how to use the Paragon Shell CLI commands to troubleshoot issues with your Paragon Automation cluster.

Overview

Paragon Automation enables you to troubleshoot Paragon Automation cluster-related issues using Paragon Shell CLI commands. To execute these Paragon Shell CLI troubleshooting commands, you must log in to any of the cluster nodes. When you execute these commands, a series of commands are executed one after the other.

The Paragon Shell CLI troubleshooting commands are:

request support information
request paragon troubleshooting information

Paragon Automation also enables you to debug issues by collecting data from the Redis database, Kafka messages, service logs, and the time series database (TSDB). These commands are not part of the Paragon Shell CLI troubleshooting commands, and must be run separately. See Other Troubleshooting Commands to Debug Issues for more information.

request support information

The request support information command displays an in-depth status report of your Paragon Automation cluster.

The show commands that are executed when you run the request support information command are listed in Table 1.

Table 1: request support information Commands
Command	Description
`show paragon cluster nodes`	Show node information of your Paragon Automation cluster.
`show paragon cluster pods`	Show pod information of your Paragon Automation cluster.
`show paragon cluster namespaces`	Show namespace information of your Paragon Automation cluster.
`show paragon cluster details`	Show storage and controller node information of your Paragon Automation cluster.
`show paragon version`	Show the version of your Paragon Automation cluster.
`show paragon images version`	Show the version of pods in your Paragon Automation cluster.
`show paragon cluster pods namespace healthbot sort memory`	Show the top pods of the `healthbot` namespace sorted by memory utilization.
`show paragon cluster pods namespace healthbot sort cpu`	Show the top pods of the `healthbot` namespace sorted by CPU utilization.
`show paragon pvc details`	Show the persistent volume (PV) and persistent volume claim (PVC) information.

request paragon troubleshooting information

The request paragon troubleshooting information command provides troubleshooting information of the ems, foghorn, insights, paa, trust, and pathfinder Paragon Automation services.

To view the list of available services, run the following command:

content_copy zoom_out_map
user@node> request paragon troubleshooting information service ?

Possible completions:
  ems                  ems service
  foghorn              foghorn service
  insights             insights service
  paa                  paa service
  pathfinder           pathfinder service
  trust                trust service

When you run the request paragon troubleshooting information command, a troubleshooting_date_time.tar.gz file is generated. You can share this file with the Juniper Technical Assistance Center (JTAC) for further evaluation. This .tar.gz file is saved in the /root/troubleshooting/ directory.

The commands that are executed when you run the request paragon troubleshooting information command are listed in Table 2.

Table 2: request paragon troubleshooting information Commands
Command	Description
`request paragon debug logs namespace healthbot service tsdb-shim`	Generate a log file of the `tsdb-shim` service within the `healthbot` namespace.
`request paragon debug logs namespace healthbot service tand`	Generate a log file of the `tand` service within the `healthbot` namespace.
`request paragon debug logs namespace healthbot service jtimon`	Generate a log file of the `jtimon` service within the `healthbot` namespace.
`request paragon debug logs namespace healthbot service config-server container config-server`	Generate a log file of the `config-server` service within the `healthbot` namespace.
`request paragon debug logs namespace healthbot service api-server`	Generate a log file of the `api-server` service within the `healthbot` namespace.
`request paragon debug logs namespace healthbot service analytical-engine`	Generate a log file of the `analytical-engine` service within the `healthbot` namespace.
`request paragon debug logs namespace healthbot service alerta`	Generate a log file of the `alerta` service within the `healthbot` namespace.
`request paragon debug postgres database postgres username healthbot measurement db_counters output file`	Generate a text file (JSON format) with Postgres information.
`request paragon debug logs namespace foghorn service order-management`	Generate a log file of the `order-management` service within the `foghorn` namespace.
`request paragon debug logs namespace foghorn service placement`	Generate a log file of the `placement` service within the `foghorn` namespace.
`request paragon debug logs namespace foghorn service cmgd`	Generate a log file of the `cmgd` service within the `foghorn` namespace.
`request paragon debug logs namespace airflow service workflow-manager`	Generate a log file of the `workflow-manager` service within the `airflow` namespace.
`request paragon debug logs namespace northstar service toposerver`	Generate a log file of the `toposerver` service within the `northstar` namespace.
`request paragon debug logs namespace northstar service configmonitor`	Generate a log file of the `configmonitor` service within the `northstar` namespace.
`request paragon debug logs namespace northstar service web`	Generate a log file of the `web` service within the `northstar` namespace.
`request paragon debug logs namespace northstar service api-aggregator`	Generate a log file of the `api-aggregator` service within the `northstar` namespace.
`request paragon debug logs namespace papi service oc-term`	Generate a log file of the `oc-term` service within the `papi` namespace.
`request paragon debug logs namespace papi service papi`	Generate a log file of the `papi` service within the `papi` namespace.
`request paragon debug logs namespace papi service papi-ws`	Generate a log file of the `papi-ws` service within the `papi` namespace.

Other Troubleshooting Commands to Debug Issues

You can run commands to collect data from the Redis database, Kafka messages, service logs, and the time series database (TSDB). You can use this data to troubleshoot issues with your Paragon Automation cluster. These commands are not part of the Paragon Shell CLI troubleshooting commands, and must be run separately. Table 3 lists the commands.

Table 3: Alternative Commands to Debug Issues
Command	Description
Kafka
`request paragon debug kafka ?`	Display possible completions for the `request paragon debug kafka` command.
`request paragon debug kafka options "-C -t topic-name -o s@start-time -o e@end-time -e -JB" output-file "file-name"`	Generate an output file of Kafka messages for a topic for a specified period of time.
Insights Kafka
`request paragon debug insights-kafka-data ?`	Display possible completions for the `request paragon debug insights-kafka-data` command.
`request paragon debug insights-kafka-data device "device-id" time-period "duration"`	Display `insights-kafka-data` information for a device, for a specific time period. An output file of the information is generated.
Redis
`request paragon debug redis ?`	Display possible completions for the `request paragon debug redis` command.
`request paragon debug redis redis-key-pattern "insights"`	Display Redis key pattern information for `redis-keys` with pattern `"insights"`.
`request paragon debug redis-key-pattern "insights" output file`	Generate an output file of Redis key pattern information for `redis-keys` with pattern `"insights"`.
Service Logs
`request paragon debug logs ?`	Display possible completions for the `request paragon debug logs` command.
`request paragon debug logs namespace name service service-name time duration`	Generate a log file for a service within a namespace for the specified time period.
TSDB
`request paragon debug get-tsdb-data ?`	Display possible completions for the `request paragon debug get-tsdb-data` command.
`request paragon debug get-tsdb-data device device-id topic "topic-name" output file`	Generate an output file of TSDB data for a particular device.
Postgres
`request paragon debug postgres ?`	Display possible completions for the `request paragon debug postgres` command.
`request paragon debug postgres database database-name username username measurement measurement-name output (file)`	Generate an output file of the measurement value information of the Postgres database.

arrow_backward PREVIOUS set system login

NEXT arrow_forward request support information

Juniper Paragon Automation User Guide

ON THIS PAGE

Troubleshoot Using the Paragon Shell CLI Commands

Overview

request support information

request paragon troubleshooting information

Other Troubleshooting Commands to Debug Issues

Stay in touch

Helped me install or use the product
Accelerated my deployment

Discuss the product with a co-worker
Make a purchase inquiry