Manual Chapter :
Basic Troubleshooting Tools
Applies To:
Show VersionsARX
- 6.3.0
A log component is a source of syslog messages, typically an internal process or group of processes. The table below is an alphabetical list of all log components, with a brief description and an indication of the board(s) where the software runs.
You can set up auto-diagnostics to regularly gather system information and send it to F5 Support. F5 can use this information to monitor your ARX from off site, watching for gradual loss of service or resource degradation. The information sent to F5 is the output from a series of CLI show commands. You can use the additional-command operation to add another show command to this collection of diagnostics. | |||||||||||||||
additional-command "show-command-string" no additional-command "show-command-string" | |||||||||||||||
This command adds an additional show command to the following list, which is always included in the auto-diags collection:
| |||||||||||||||
In a redundant pair of ARX machines (see redundancy), both peers collect and send auto-diagnostics information through E-mail. All of the commands in gbl mode are shared between the peers, so only the active peer collects gbl-mode information (such as show global-config and show namespace all). Both peers collect and send commands related to cfg mode (such as show running-config and show ron). This also applies to any commands you add to the collection with additional-command; if the command relates to gbl mode, it is only included in collections from the currently-active peer. If the command relates to cfg mode, it is included in auto-diagnostic collections from both peers. | |||||||||||||||
prtlndA(gbl-auto-diag)# additional-command "show channel summary" | |||||||||||||||
F5 Support can monitor your ARX from off site, watching for gradual loss of service or resource degradation. This is accomplished by the ARX gathering diagnostic information and sending it (encrypted) as an E-mail attachment to F5. You can set the schedule, along with additional E-mail recipients and other options. Use the auto-diagnostics command to begin setting up auto monitoring by F5 Support. Use the no auto-diagnostics command to disable auto-diagnostics and remote monitoring. | |||||||||||||||
You must configure SMTP on the ARX before you enable auto-diagnostics, which uses E-mail as a delivery mechanism. Start with the smtp command in cfg mode. This command places you in gbl-auto-diag mode, where you must use the schedule (gbl-auto-diag) command to assign a schedule for collecting and sending diagnostic information. You can optionally use the mail-to (gbl-auto-diag) command to add additional E-mail recipients; the attachment is only encrypted for the E-mail to F5 Support. You can also use additional-command to add more show commands to the E-mail. To test the configuration, you can use the auto-diagnostics test command in priv-exec mode. The show auto-diagnostics command shows the current configuration for this utility, along with the status of the most-recent auto-diagnostics collection. In a redundant pair of ARX machines (see redundancy), both peers collect and send auto-diagnostics information through E-mail. All of the commands in gbl mode are shared between the peers, so only the active peer collects gbl-mode information (such as show global-config and show namespace all). Both peers collect and send commands related to cfg mode (such as show running-config and show ron). This also applies to any commands you add to the collection with additional-command; if the command relates to gbl mode, it is only included in collections from the currently-active peer. If the command relates to cfg mode, it is included in auto-diagnostic collections from both peers. To address an immediate issue, use the collect command to gather a larger amount of diagnostic information and possibly send it to F5 Support. | |||||||||||||||
The process always includes the following show commands in its E-mail attachment:
| |||||||||||||||
bstnA(gbl)# auto-diagnostics | |||||||||||||||
F5 Support can monitor your ARX from off site, watching for gradual loss of service or resource degradation. This is accomplished by the ARX gathering diagnostic information and sending it (encrypted) as an E-mail attachment to F5. After you set up the schedule for this auto-diagnostics data collection, you can use the auto-diagnostics test command to perform a test run. | |
local (optional) sends the E-mail to local recipients only, defined by the mail-to (gbl-auto-diag) command. This does not send any E-mail to F5. | |
This command gathers auto diagnostics (as determined by the auto-diagnostics command and its sub-mode commands), compresses them into a Unix Tape Archive (tar) file, and sends the file through smtp as an E-mail attachment. This tests both the auto-diagnostics configuration and the smtp configuration. By default, the E-mail goes to F5 Support and all configured mail-to (gbl-auto-diag) addresses. The E-mail attachment for F5 Support is encrypted, as it must travel outside your local network. The E-mail attachment is un encrypted for each of the local mail-to (gbl-auto-diag) addresses, for convenience. You can use the local option to send the test message only to the local addresses. | |
bstnA# auto-diagnostics test local | |
Certain SNMP traps raise persistent alarms on the system. For each raise trap, there is a corresponding clear trap that clears the alarm condition. You can use the clear health command to manually clear a raised alarm condition. | |
clear health trap trap (1-64 characters) identifies the trap(s) to be cleared. Use show health to see a list of traps with open alarm conditions. Use the Event name from the output of show health. | |
The show health command shows all currently-raised traps on the system. For cases where a raised trap is unlikely to every be cleared by its corresponding clear trap, you can use this command to manually clear the trap. This clears all instances of the given trap. Then the alarm condition no longer appears in the show health output. | |
bstnA# clear health diskFail | |
Some machine problems require more diagnosis than is possible on-site. Use the collect command to collect diagnostic data on the switch and either upload it or store it locally. | |
collect {all | diag-info | config | cores | logs | stats-logs | reports | state | capture} ftp://[user:password@]server/file.tgz [async] all | diag-info | config | cores | logs | stats-logs | report | state | capture chooses the type of diagnostics to be collected: all collects all diagnostic files on the switch. diag-info collects all diagnostic files on the switch except reports, which can be excessively large. config collects the configuration database, database logs, and the output from show running-config and show global-config. cores gathers any core-dump files on the system, along with all shared-object libraries used by the system. logs assembles the syslog, the procdat log (process data; a more-detailed log file for diagnosis by engineers), upgrade and installation logs, disk-usage logs, Kerberos state files, and logs from the systems service manager. For options to collect logs from specific times, see the documentation for collect logs. stats-logs selects all stats-log files, .csv files with performance data relevant to the ARX, its filers and servers, and other external devices. You can use the show stats-logs command to list all of the stats-log files currently available. reports chooses all reports. state collects individual log files from every processor in the switch, three system log files (syslog, procdat, and traplog), a chronological list of all CLI commands used since the switch booted, the latest of each of the stats-log files, and the output from a series of useful show commands. capture selects only the packet-capture files, if there are any. These files show the flow of IP traffic through the ARX during a capture session. You can use show capture to list all of the capture files currently available. user[:password]@ (optional) is the username and password (for example, random:pw@). If you omit the password, the CLI prompts you for one. server is the machine name (for example, mymachine.myco.com). file.tgz is the desired path name for the file. Lead with an extra slash (/) if the path is absolute: for example, ...myserver//var/log/acopiaDiags.tgz specifies /var/log/acopiaDiags.tgz on myserver. Use only a single slash if the path is local to the users home directory. | |
async (optional) makes this command return immediately, rather than waiting for the collection process to finish. The CLI generates a report that you can use to chart the collection process; the report name appears after the process starts. | |
{all | ... | capture} define the collection process, as explained above. user@ (optional if someone created an ip scp-user) is the username to present to the other end of the SCP connection. This user must be valid at the remote host. If you omit this and an ip scp-user is defined, it defaults to the username set by that command. server: is the IP address or hostname for the SCP host. End with a colon (:). file.tgz is the destination-file path. Lead with a slash (/) if the path is absolute (for example, scp://root@10.1.1.5:/var/diags/arx.tgz). Use no slash if the path is local to the home directory for user (for example, scp://root@10.1.1.5:diags.tgz). accept-host-key (optional) indicates that if the other end of the connection has an unknown SSH host key (that is, if it is new, or if its key has changed since the last time the host was contacted), the ARX should accept the new host key and continue with the upload. Otherwise, the ARX stops the upload if the host presents an unknown key. async (optional) was explained above. | |
{all | ... | capture} are explained above. nfs | cifs is a required choice. This chooses the protocol for the file transfer. namespace (1-30 characters) identifies the namespace to hold the collect file. path (1-1024 characters) is the volume name. file.tgz is the path to the collect file, starting at the root of the volume. async (optional) was explained above. | |
{all | ... | capture} are explained above. server is the machine name (for example, mymachine.myco.com). file.tgz is the desired path name for the file. Lead with an extra slash (/) if the path is absolute: for example, ...myserver//var/log/acopiaDiags.tgz specifies /var/log/acopiaDiags.tgz on myserver. Use only one slash if the path is local to the servers tftpboot directory. This conforms with the specification for FTP URLs in RFC 1738. async (optional) was explained above. | |
{all | ... | capture} are explained above. smtp:// declares that the destination is an E-mail address. e-mail-address (optional) is the recipient of the E-mail in username@host format (for example, jsmith@myco.com). If you omit this, the CLI uses the default address set by the cfg-smtp to command. file.tgz is the name of the copy. This is sent as an attachment to the outbound E-mail message. This is not a path, so do not use slashes (/). You must use a .tgz extension. For example, ...acopiaDiags.tgz is a valid file name. async (optional) was explained above. | |
collect {all | diag-info | ... |capture} local-file.tgz [async] {all | ... | capture} are described above. local-file.tgz (1-1024 characters) saves the file locally, to the diag-info directory. To preserve disk space, you can only save one diag-info file at a time. You must use a .tgz extension. async (optional) was explained above. | |
(FTP only) If you omit the user:password from the FTP URL, the CLI uses the username and password set by the ip ftp-user command. | |
This file contains multiple log files and possibly core files, so it can be very large. If you upload it, choose a host with ample disk space. If you send the message through SMTP, configure the local E-mail server (chosen with the mail-server command) and the recipient E-mail server to allow very large E-mail messages. (The E-mail server at F5 Support allows for large messages.) For SCP uploads, the CLI prompts for a password; enter the password for the user that you identified in the URL. The CLI also prompts for a password for FTP uploads where you do not supply one in the command. The CLI prompts for confirmation before collecting the diagnostics. Answer yes to continue. The collection process can be time-consuming; prompts appear to show the progress of the operation as it occurs. | |
bstnA# collect diag-info ftp://jpublic@arxftp.f5.com/10-24-03.tgz Password: jpassword bstnA# collect diag-info cifs medarcv /rcrds admin/collect.tgz bstnA# collect config ftp://arxftp.f5.com/10-24-03.tgz sends only config information. This uses the FTP credentials established by the ip ftp-user command. bstnA# collect diag-info investigate.tgz prtlndA# collect logs smtp://logsAndReports.tgz | |
You can collect all log files on the system at once, or you can focus on the logs from a specific time. This is an extension of the collect command that applies to log files only. | |||||
start-time start [utc] (optional) sets a starting time for collected logs. If you omit this, the CLI collects all of its logs up to the end-time. start is a time stamp in one of two formats:
utc (optional) declares that the start is in UTC instead of local time. This is typically used for time stamps copied from a log file (the second format from above). end-time end [utc] (optional) sets an end time for collected logs. If you omit this, the CLI collects all of its logs after the start-time. The details of this time stamp are otherwise the same as above. destination is a local-file name, an ARX volume, or a URL. The URL can use FTP, SCP, TFTP, or SMTP. The documentation for the collect command describes the exact syntax. async (optional) makes this command return immediately, rather than waiting for the collection process to finish. The CLI generates a report that you can use to chart the collection process; the report name appears after the process starts. | |||||
This is an alternative syntax for the collect command. It is useful for collecting logs from a specific time frame; this can reduce the size of the collection as well as focus a diagnosis. | |||||
bstnA# collect logs start-time 06/05/2007:12:00:00 end-time 06/05/2007:13:00:00 ftp://jpublic@arxftp.f5.com/1hr Password: jpassword prtlndA# collect logs start-time 2007-01-07T05:00:34 utc sinceBoot.tgz | |||||
seconds is the number of seconds to wait between each invocation of the command. show-command is a valid CLI show command, surrounded by quotation marks (). Use any of the show commands documented in this manual. search-string (optional) also requires quotes. If you use this, the command stops repeating as soon as the search-string appears in the output. Otherwise, the command repeats until you use <Ctrl-C> to stop it. timeout-seconds (optional, 1-2096) sets a time limit on this monitor process. The show commands stop repeating when this time expires. You can also use <Ctrl-C> to stop the process at any time. | |
timeout-seconds - 21,600 (6 hours) | |
You can use this command to watch the progress of a configuration change from the CLI. For example, this command can repeat the show redundancy command after you enable (cfg-redundancy) redundancy for a pair of ARXes, to monitor their initial rendezvous. You cannot issue other CLI commands in this session while the expect monitor command is running. Use <Ctrl-C> to stop the repetition at any time. To run a full CLI script, copy the script onto the ARX (using copy ftp, copy scp, copy {nfs|cifs}, or copy tftp), and then use run to invoke it. To perform any command in the future (possibly on a schedule), use the at command. | |
bstnA# expect monitor 5 show namespace wwmed bstnA# expect monitor 10 show namespace medarcv /rcrds | |
Use the logging destination command to define an external syslog server as an external logging destination. Use the no form of the command to remove a syslog server. | |
no logging destination server-name server-name (1-80) is the IP address or hostname of the external syslog server. udp | tcp (optional) is the transport protocol over which to send the syslog messages. port port (optional, 1-65,535) is the UDP or TCP port number where the external server is listening. | |
Use the show logging destination command to list all configured external syslog servers. | |
bstnA(cfg)# logging destination 10.1.1.76 tcp bstnA(cfg)# no logging destination 172.16.44.7 | |
Each group of log messages, known as a log component, has a separately-tunable logging level. Critical level is the most terse, displaying critical log messages only; debug level is the most verbose, displaying all log messages from critical down to debug. The messages appear in the syslog file. Use the logging level command to set a logging level. Use the no form of this command to revert a logging level back to the default. | |
logging level component {critical | error | warning | notice | info | debug | disable} no logging level {component | all} component (up to 255 characters) is the component to tune. See Log Components for a complete list of components. all selects all components. critical | error | warning | notice | info | debug | disable is a required choice. This is the logging level you choose for the component. The disable option stops all logging from the chosen component. | |
Use show logging levels to verify the log-level settings for each component. From any mode, use show logs syslog or grep pattern logs syslog to view the log messages in the syslog file. See the manual, ARX Log Catalog, for a full list of log messages. | |
bstnA(cfg)# logging level NSCKRPT debug bstnA(cfg)# logging level all error bstnA(cfg)# no logging level all bstnA(cfg)# logging level RON disable bstnA(cfg)# no logging level POLICY_ACTION | |
The auto-diagnostics utility gathers performance data and sends it to F5 Support. It sends the data as an E-mail attachment. You can use the mail-to command to add an additional destination address for these E-mails. Use the no mail-to command to remove an E-mail recipient. | |
mail-to recipient no mail-to recipient recipient (1-128 characters) is one E-mail recipient (for example, juser@nemed.com). | |
bstnA(gbl-auto-diag)# mail-to juser@wwmed.com prtlndA(gbl-auto-diag)# no mail-to ex@nemed.com | |
Use the management source command to set a source address for sending syslog messages. Use the no form to remove the management-source configuration. | |
mgmt is the switchs out-of-band management interface, the default. You specify the out-of-band management IP address at switch boot-up. vlan-id (1-4096) identifies the VLAN to use as the source. Use the show vlan summary command for a list of all configured VLANs. | |
mgmt on platforms that support this command vlan 1 on platforms that do not support this command. | |
any except ARX-VE | |
Use logging destination to send syslog messages to an external syslog server. This command sets the source address for those log messages. Use the show logging destination command to view the current management source. | |
bstnA(cfg)# management source vlan 9 | |
*** This is a beta-level command. It does not appear in the CLI unless you use the terminal beta command to unlock all beta-level commands. *** The ARX records the round-trip times between itself and external devices, such as CIFS clients and back-end filers. The stats-monitor process keeps moving averages of these round-trip times and other statistics, and records them in .csv files in the stats-log directory. The stats monitor also can log notification messages if the number of errors and/or response time from an external device increases dramatically. The stats monitor only logs a notification if the device has these increases multiple times in a row. Use the moving-average command to define the percentage of increase required, and the number of times that the errors or response times must increase that much to merit a notification. Use no moving-average to return to the default thresholds. | |
moving-average {response-time | errors} threshold pct-threshold moving-average {response-time | errors} interval num-samples response-time | errors is a required choice. This determines the type of threshold or interval you are setting, response times or errors. threshold pct-threshold (optional, 1-65,535) is the percentage above the moving average that could trigger an alarm. For example, if you set moving-average response-time threshold 200, the stats monitor may trigger a notification if a devices response time is 200% above (or, 3 times) its current moving average. As another example, if you set moving-average errors threshold 150, stats monitor may trigger a notification if the devices number of errors is 150% above its current average. The stats monitor process only triggers the notification if this occurs for some number of samples, as set by the interval option. interval num-samples (optional, 1-65,535) is the number of high samples in a row that are required to trigger a notification. If this many samples in a row are at least pct-threshold above the current average, the stats-monitor process logs a notification. | |
either threshold - 100% either interval - 6 | |
This is a beta-level command. Use the terminal beta command to unlock all beta-level commands, including this one. This command changes the moving-average thresholds for one set of filers or ARX front-end services, chosen when you use the notify command to enter the mode. The moving average is the average for a number (for example, 8) of the most-recent samples. The 8th time the software calculates a moving average, it takes the average of samples 1 to 8; the 9th time it runs, it averages samples 2 to 9; the 10th time, it takes the average of samples 3 to 10; and so on. If a group of samples deviates from the current moving average, the stats monitor generates a notification. Use this command, moving-average, to decide how many samples in a row it takes to log the notification, and to decide how far over the current average a sample must be to qualify. These notifications are recorded in the syslog; you can use show logs syslog to view them along with all other syslog messages. Look for the log component named SMON_ANALYSIS, or use grep to search for it. To create an additional SNMP trap for each notification, use the trap command. The stats monitor collects data for a long period of time, called a moving-average window, before it starts using the moving average for notifications. This window is calculated from the moving average and sampling interval commands: it is 8 * moving-average interval * sampling interval. By default, that is 8 * 6 * 5 minutes, or four hours. The moving-average window restarts if you use the sampling interval command to change the sampling interval. | |
bstnA(gbl-stmon-nfy)# moving-average response-time threshold 10 bstnA(gbl-stmon-nfy)# moving-average response-time interval 3 sets the following tolerances for response times: if a devices response time is 10% (or more) slower than its current average for 3 samples in a row, stats monitor logs a notification message. It also sends an SNMP trap if trap is enabled. bstnA(gbl-stmon-nfy)# moving-average errors threshold 5 bstnA(gbl-stmon-nfy)# moving-average errors interval 3 sets the following tolerances for errors: if a device returns 5% (or more) errors than its current average for 3 samples in a row, stats monitor logs a notification message. As above, stats monitor also sends an SNMP trap if trap is enabled. | |
*** This is a beta-level command. It does not appear in the CLI unless you use the terminal beta command to unlock all beta-level commands. *** The ARX records the round-trip times between itself and external devices, such as CIFS clients and back-end filers. You can use the notify command to trigger analysis for one group of external devices: CIFS-service clients, NFS-service clients, CIFS filers, and or NFS filers. Whenever an issue is discovered for one of the analyzed device groups, the stats-monitor process logs a notification in the syslog. Optionally, the stats monitor can also send an SNMP trap. This command also brings you into a submode, where you can alter the notification settings for the chosen group of devices. You can use the negative form of the command, no notify, to deactivate this stats-monitor process for front-end or back-end services. | |
cifs-service | nfs-service is a required choice. The nfs-service option starts analyzing all nfs front-end services, and the cifs-service option starts analyzing all cifs front-end services. cifs | nfs is a required choice if you choose to monitor filer shares. This chooses between analyzing CIFS or NFS on back-end filers. | |
This is a beta-level command. Use the terminal beta command to unlock all beta-level commands, including this one. The notify command places you in gbl-stmon-nfy mode, where you can use other CLI commands to edit the notifications for the set of devices you have chosen. The notifications only occur when some number of samples deviates from the moving average by some percentage; for example, a notification occurs when 6 samples from a particular CIFS service have twice as many NetworkErrors as the moving average, or when 6 samples from a particular back-end NFS export have progressively-higher round-trip times for GETATTR requests. You can use the moving-average command to reset the number of samples to trigger a notification, and/or to change the threshold for each sample to qualify as too high. By default, a notification goes to the syslog only; the trap command enables SNMP traps in addition to those syslog messages. The stats monitor records its notifications in the syslog; you can use show logs syslog to view them along with all other syslog messages. Look for the log component named SMON_ANALYSIS, or use grep to search for it. To create an additional SNMP trap for each notification, use the trap command. | |
bstnA(gbl-stmon)# notify cifs-service enables analysis of all front-end cifs services. | |
The auto-diagnostics utility gathers data about the ARX, encrypts it, and sends it in an E-mail message to F5 Support. Use this schedule command to assign a schedule for this operation. Use no schedule to remove the auto-diag schedule, thereby disabling auto diagnostics. | |
schedule name name (1-64 characters) identifies the schedule for auto diagnostics. Use show schedule for a list of configured schedules. Choose a schedule that has a frequency measured in days, weeks, or a longer time measure; for example, every day, every 3 days, every 1 week, or every 2 months. This command does not accept a schedule with a higher frequency, such as every 12 hours. | |
To create a schedule, use the gbl-mode schedule command. The schedule cannot run more frequently than once per day; you can define this with the every command. | |
minturnA(gbl-auto-diag)# schedule every2am | |
F5 Support can monitor your ARX from off site, watching for gradual loss of service or resource degradation. This is accomplished by the ARX gathering diagnostic information and sending it (encrypted) as an E-mail attachment to F5. After you set up the schedule for this auto-diagnostics data collection, you can use the show auto-diagnostics command to show the auto-diagnostics configuration along with the status of the latest auto-diagnostics run. | |
Schedule is the schedules configured name, chosen with the schedule (gbl-auto-diag) command. The fields in this table show the configuration of the schedule. Description only appears if set by the gbl-schedule description (gbl-schedule) command. Start Time can be reset by the gbl-schedule start command. This is the date and time of day used for all time-based calculations: for example, if a schedule runs every Saturday, this determines the time of day on Saturdays when the schedule fires. Stop Time only appears if set by the gbl-schedule stop command. This is the expiration time for the schedule, after which the schedule never fires. Duration appears only if set by the gbl-schedule duration command. This is not applicable to auto-diagnostics. Status is Paused (the schedule is between run times), Running, or Waiting for start time (the schedule has never been invoked). Previous is a sub-table showing the Run time (when the run started) and End time of the most-recent run. Current appears if the rule is currently running. This has the same fields as the Previous table, Run time and End time. Mail-to is a list of local E-mail addresses, added with the mail-to (gbl-auto-diag) command. Every time the above schedule fires, the system sends a tar file with auto-diagnostic output to each of these addresses. It also sends an encrypted version of the same tar file to F5 Support. | |
Additional commands are extra CLI-show commands that are collected along with the default auto-diagnostics. You can add or remove these with the [no] additional-command command. Status describes the most-recent auto-diagnostics collection and delivery operation since the last reboot. The following fields appear only if an auto-diagnostics collection has occurred: Last time executed is the most-recent time that the schedule fired and the collection process started. Status of last execution is either Success or Failure with a report name in square brackets. You can use show reports report-name to read the report and find the specific failure. Date last sent is a time stamp for the most-recent E-mail delivery. Number of times sent since last reboot shows how many times the system has collected and delivered auto-diagnostics data since the last ARX reboot. | |
bstnA(cfg)# show auto-diagnostics | |
Figure 38.1 Sample Output: show auto-diagnostics
bstnA(cfg)# show auto-diagnostics
Many syslog and CLI-response messages have further documentation to help with problem assessment and diagnosis. Use the show documentation command to display the documentation for a given message. | |
show documentation msg-catalog-id msg-catalog-id (1-255 characters) identifies the message. Every message-catalog message has an uppercase ID that appears with it in the syslog and in the CLI. | |
bstnA(cfg)# show documentation SQM_CANNOT_BE_PROMOTED_GRACE_PERIOD shows the documentation for one message ID. See Figure 38.2 for sample output. | |
show logs syslog |
Figure 38.2 Sample Output: show documentation
bstnA(cfg)# show documentation SQM_CANNOT_BE_PROMOTED_GRACE_PERIOD
Certain SNMP traps raise persistent alarms on the system. For each raise trap, there is a corresponding clear trap that clears the alarm condition. Use the show health command to see all SNMP-related alarms that have been raised but not cleared. | |
Date is the date and time when the event occurred. ID is the last three digits in the traps OID. Event is the name of the trap. Description explains the alarm condition. Refer to the ARX SNMP Reference for a full list of all traps, along with explanations for each trap and procedures to address the issue. Follow the Guidelines for the command, snmp-server traps, to set up a remote host to receive SNMP traps. For an overall view of the system hardware, use show chassis. | |
prtlndA(cfg)# show health shows any raised alarms on the prtlndA chassis. See Figure 38.3 on page 38-40 for sample output. bstnA> show health shows any raised alarms on the bstnA chassis. See Figure 38.4 on page 38-41 for sample output. | |
Figure 38.3 Sample Output: show health (No Active Alarms)
prtlndA(cfg)# show health
Figure 38.4 Sample Output: show health (with Active Alarms)
bstnA> show health
Several ARX applications require clock synchronization between the ARX and its network peers. These applications include Kerberos, which frequently uses time stamps, and the policy engine, which often places files based on their last-modified times. Use the show health time-skew command to see the clock differences between the ARX and other stations with which it communicates. | |
show health time-skew [timeout seconds] timeout seconds (optional, 1-3600) is the maximum number of seconds to wait for each server response. The default timeout is 3 seconds. The ARX makes two or more attempts in some cases, and this timeout applies to each attempt. Also, the timeout applies to each individual server; the overall time for all servers to respond may be significantly longer. You can use <Ctrl-C> to stop the command at any time. | |
We strongly recommend using NTP to keep the ARX clock synchronized with other system clocks on the network. Use the ntp server command to connect the current switch to one or more NTP servers. IP Address identifies the network device. Role shows the relationship of this device to the ARX. Possible values here are External Filer or Domain Controller. Use the show external-filer command for a full list of external filers used by this ARX. Use the show active-directory command for a full list of DCs and a general understanding of how the ARX is using them. Observed Time Skew ... shows a time value in HH:MM:SS format, followed by ahead, behind, or (for a time value of 00:00:00) nothing. | |
bstnA> show health time-skew timeout 30 | |
Figure 38.5 Sample Output: show health time-skew
bstnA> show health time-skew
Syslog messages use numeric IDs to identify namespaces, volumes, shares, and file-history archives. Use the show id-mappings command to map these IDs to the names used in the CLI. | |
Namespace lists all namespaces on the switch, one per row. The ID column contains the numeric ID. Volume lists all volumes on the switch, one per row. The Namespace column shows the volumes namespace, and the ID column contains the volumes numeric ID. Share lists all shares on the switch, one per row. The Volume and Namespace columns show the shares context, and the ID column contains the shares numeric ID. Contact F5 Support if Not Found appears at the end of any of these rows; this indicates an issue in the configuration database. Archive Name is a table of file-history archives on the ARX. A file-history archive is a repository for a managed volumes file-location records. You can use the file-history archive command to create one. The ID column in this table contains the archives numeric ID. | |
bstnA(cfg)# show id-mappings shows the ID mappings on the current switch. See Figure 38.6 for sample output. | |
show logs syslog |
Figure 38.6 Sample Output: show id-mappings
bstnA(cfg)# show id-mappings
Use the show logging destination command to view a list of configured external syslog servers. | |
Use the logging destination command to define a syslog server. | |
bstnA# show logging destination | |
Log messages are divided into groups based on the system components that generate them. You can set a logging level for each component, from critical (terse; shows only the most-urgent messages) to debug (verbose). Use the show logging levels command to list all of the log components and the current logging level for each. | |
show logging levels [component] component (optional) specifies that you only want the logging level for the given component. | |
The log components are listed in an earlier section; see Log Components. This command shows the logging levels in a graph: for each log component, an X appears in the column of its logging level. Use the logging level command to change any or all component-logging levels. | |
bstnA(cfg)# show logging levels bstnA(cfg)# show logging levels POLICY | |
Figure 38.7 Sample Output: show logging levels
bstnA(cfg)# show logging levels
Figure 38.8 Sample Output: show logging levels POLICY
bstnA(cfg)# show logging levels POLICY
The stats-monitor process keeps round-trip-time (RTT) and error statistics for communication between the ARX and external devices, as well as internal performance statistics. It also analyzes this data, watches for sudden changes in RTT or error rates, and notifies you of these changes. Use the show stats-monitor command to see the current administrative state of the stats monitor. | |||||||
The output contains a configuration table, followed by a table of configured notifications. The notification table only appears if at least one notification is set up with the notify command. Statistics Monitor Configuration is a table with the high-level configuration for the stats monitor. You can edit this configuration with the stats-monitor command and its sub commands. Status is always Enabled. Sampling Interval is the time between the data samples (such as average RTTs and error rates) recorded in the stats-log. The stats monitor records these samples in a series of .csv files. Each .csv file represents one group of external devices (such as back-end CIFS filers or NFS clients for a particular NFS service), or an internal process (such as file migrations or an internal CIFS work queue). You can use show stats-logs to view these .csv files. The default sampling interval is adequate for most sites, but you can use the sampling interval command to change it if necessary. Max Data Size is the storage limit for all statistics (.csv) files stored in the stats-logs partition. Max Raw Data Size is the percentage of Max Data Size permitted for .csv files with raw (not hourly) in their names. Used Data Size and Used Raw Data Size are the amounts of the above storage that are already used. These are for all statistics (hourly and raw) and raw statistics, respectively. Notification Parameters only appears if at least one notification is active; use the notify command to enable analysis and notification for front-end services or back-end filers. This shows each notification in one row of the table, with the following fields: Applies To identifies the type of service, process, or device that is configured for notifications. You set this with the notify command. This is :
| |||||||
Statistics shows the type of notification. This is Errors for a notification of an unusual number of errors, or RespTime for a notification of an increase in response time. You can use the moving-average command to enable or disable notifications for this type of event. Traps indicates whether or not the stats monitor sends an SNMP trap with this notification. This is Enabled or Disabled, and you can use the trap command to change the setting. Metric is always Mov.Avg. Parameters shows the threshold settings that trigger a notification. You can use the moving-average command to change these thresholds. | |||||||
bstnA# show stats-monitor | |||||||
Figure 38.9 Sample Output: show stats-monitor
bstnA# show stats-monitor
Use the show system tasks command to see a list of subsystem tasks running on the ARX. | |
Proc - is the module slot (number) and processor on which this task is running. This column only appears for platforms with more than one physical processor, such as the ARX-4000. Subsystem - is the name of the subsystem task. If the task is a script, that fact is noted in parentheses: (script). Instance - is how many instances of the same task are running on this processor. This column does not appear for the ARX-1500 or ARX-2500. Memory (Kb) - is the amount of memory used by this task. CPU% - measures the CPU cycles that the task is consuming. This percentage is measured since the last invocation of show system tasks. For a measurement of overall CPU usage, use show processors and/or show processors usage. CPU-Time - only appears on an ARX-1500 or an ARX-2500. This shows the CPU time used by the current subsystem task since the process last started. The time is expressed in HH:MM:SS format. | |
bstnA> show system tasks shows all subsystem tasks. See Figure 38.10 for sample output. stoweA> show system tasks shows all subsystem tasks running on an ARX-2500 named stoweA. Figure 38.11 on page 38-52 shows sample output. | |
Figure 38.10 Sample Output: show system tasks
bstnA> show system tasks
Figure 38.11 Sample Output: show system tasks (ARX-2500)
stoweA> show system tasks
*** This is a beta-level command. It does not appear in the CLI unless you use the terminal beta command to unlock all beta-level commands. *** The ARX records the round-trip times and errors between its own software and other external devices (such as back-end filers and front-end clients), as well as time required for migrations and internal operations. You can use the stats-monitor command to begin configuring an analysis process that keeps a running average of this data and monitors it for sudden changes. Whenever an issue is discovered, the stats-monitor process logs a notification of the issue. Optionally, it also sends an SNMP trap and raises and alarm that is visible with the show health command. You can use the stats-monitor command to enter gbl-stmon mode and edit the analysis parameters. | |
This is a beta-level command. Use the terminal beta command to unlock all beta-level commands, including this one. This command puts you into gbl-stmon mode, where you can use commands to change the stats-monitor configuration. The stats monitor takes periodic samples of errors, computation times, and round-trip times for analysis; you can use the sampling interval command to change the time between these samples. To change the set of external devices that are analyzed (such as front-end client machines and/or back-end filers), you can use the notify command. The notify command also leads to a submode, where you can enable traps for the group of devices and change the thresholds for the device sets notifications. The stats monitor records its notifications in the syslog; you can use show logs syslog to view them along with all other syslog messages. Look for the log component named SMON_ANALYSIS, or use grep to search for it. | |
bstnA(gbl)# stats-monitor | |