Using rosa commands and accessing log files to troubleshoot issues.

Troubleshooting with the rosa CLI

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

whoami

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

version

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.

logs install

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

logs uninstall

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