Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

Troubleshooting Commands

Use this topic to learn more about the Routing Director support and troubleshooting commands.

request deployment support information

The request deployment support information command displays an in-depth status report of your Routing Director cluster configuration.

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

Table 1: request deployment support information Commands

Command

Description

show deployment cluster nodes

Shows node information of your Routing Director cluster.

show deployment cluster pods

Shows pod information of your Routing Director cluster.

show deployment cluster namespaces

Shows namespace information of your Routing Director cluster.

show deployment cluster details

Shows storage and controller node information of your Routing Director cluster.

show deployment version

Shows the version of your Routing Director cluster.

show deployment images version

Shows the version of pods in your Routing Director cluster.

show deployment cluster pods namespace healthbot sort memory

Shows the top pods of the healthbot namespace sorted by memory utilization.

show deployment cluster pods namespace healthbot sort cpu

Shows the top pods of the healthbot namespace sorted by CPU utilization.

show deployment pvc details

Shows the persistent volume (PV) and persistent volume claim (PVC) information.

The request deployment 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 deployment troubleshooting information

The request deployment troubleshooting information command provides troubleshooting information of the ems, foghorn, insights, paa, trust, and pathfinder Routing Director services.

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

When you run the request deployment 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 deployment troubleshooting information command are listed in Table 2.

Table 2: request deployment troubleshooting information Commands

Command

Description

request deployment 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 deployment 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 deployment debug logs namespace airflow service service-name

Generates a log file of the workflow-manager service within the airflow namespace.

request deployment 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 deployment 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 deployment 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 Routing Director cluster. These commands are not part of the Deployment 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 deployment debug kafka ?

Display possible completions for the request deployment debug kafka command.

request deployment 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 deployment debug insights-kafka-data ?

Display possible completions for the request deployment debug insights-kafka-data command.

request deployment 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 deployment debug redis ?

Display possible completions for the request deployment debug redis command.

request deployment debug redis redis-key-pattern "insights"

Display Redis key pattern information forredis-keys with pattern "insights".

request deployment debug redis-key-pattern "insights" output file

Generate an output file of Redis key pattern information forredis-keys with pattern "insights".

Service Logs
request deployment debug logs ?

Display possible completions for the request deployment debug logs command.

request deployment 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 deployment debug get-tsdb-data ?

Display possible completions for the request deployment debug get-tsdb-data command.

request deployment 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 deployment debug postgres ?

Display possible completions for the request deployment debug postgres command.

request deployment 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.