Troubleshooting Commands

date_range 17-Dec-24

arrow_backward

arrow_forward

Use this topic to learn more about the Paragon Automation support and troubleshooting commands.

request paragon support information

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

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

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

The request paragon support information command also runs many kubectl commands. These commands provide you debugging information such as Helm deployment service information for the NorthStar namespace, Kubernetes deployment information for api-aggregator service, and so on.

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 service-name`	Generates log files of different services within the `healthbot` namespace. Replace `service-name` with: `tsdb-shim` `tand` `jtimon` `config-server` `api-server` `analytical-engine` `alerta`
`request paragon debug logs namespace foghorn service service-name`	Generates log files of different services within the `foghorn` namespace. Replace `service-name` with: `order-management` `placement` `cmgd`
`request paragon debug logs namespace airflow service service-name`	Generates a log file of the `workflow-manager` service within the `airflow` namespace.
`request paragon debug logs namespace northstar service service-name`	Generates log files of different services within the `northstar` namespace. Replace `service-name` with: `toposerver` `web` `configmonitor` `api-aggregator`
`request paragon debug logs namespace papi service service-name`	Generates log files of different services within the `papi` namespace. Replace `service-name` with: `oc-term` `papi` `papi-ws`
`request paragon debug postgres`	Generates a text file (JSON format) with Postgres information.

Additional Debugging Commands

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: Additional 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 Troubleshooting Overview

NEXT arrow_forward Perform a Health Check

Juniper Paragon Automation Monitoring and Troubleshooting Guide

ON THIS PAGE

Troubleshooting Commands

request paragon support information

request paragon troubleshooting information

Additional Debugging Commands

Stay in touch

Helped me install or use the product
Accelerated my deployment

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