Troubleshooting with the rosa CLI

Using rosa commands and accessing log files to troubleshoot issues.

Use the following commands to help troubleshoot Red Hat OpenShift Service on AWS (ROSA).

Display information about your AWS and Red Hat accounts.

Syntax

$ rosa whoami [arguments]

Table 1. Optional arguments inherited from parent commands
Option	Definition
--help	Shows help for this command.
--debug	Enables debug mode.
--profile	Specifies an AWS profile (string) from your credentials file.
--v level	Log level for V logs.

Example

$ rosa whoami

Display the version of your rosa CLI.

Syntax

$ rosa version [arguments]

Table 2. Optional arguments inherited from parent commands
Option	Definition
--help	Shows help for this command.
--debug	Enables debug mode.
--profile	Specifies an AWS profile (string) from your credentials file.
--v level	Log level for V logs.

Example

$ rosa version

Checking logs with the rosa CLI

Use the following commands to check your install and uninstall logs.

Show the cluster install logs.

Syntax

$ rosa logs install <id> | <name> [arguments]

Table 3. Arguments
Option	Definition
--cluster	The name or ID (string) of the cluster to get logs for.
--tail	The number (integer) of lines to get from the end of the log. Default: `2000`
--watch	Watches for changes after getting the logs.

Table 4. Optional arguments inherited from parent commands
Option	Definition
--help	Shows help for this command.
--debug	Enables debug mode.
--profile	Specifies an AWS profile (string) from your credentials file.
--v <level>	The log level for V logs.

Examples

Show the last 100 install log lines for a cluster named mycluster:

$ rosa logs install mycluster --tail=100

Show the install logs for a cluster using the --cluster argument:

$ rosa logs install --cluster=mycluster

Show the cluster uninstall logs.

Syntax

$ rosa logs uninstall <id> | <name> [arguments]

Table 5. Arguments
Option	Definition
--cluster	The name or ID (string) of the cluster to get logs for.
--tail	The number (integer) of lines to get from the end of the log. Default: `2000`
--watch	Watches for changes after getting the logs.

Table 6. Optional arguments inherited from parent commands
Option	Definition
--help	Shows help for this command.
--debug	Enables debug mode.
--profile	Specifies an AWS profile (string) from your credentials file.
--v <level>	The log level for V logs.

Example

Show the last 100 uninstall logs for a cluster:

$ rosa logs uninstall --cluster=mycluster --tail=100