=head1 NAME

B<monshow> - Shows event data for monitoring.

=head1 SYNOPSIS

B<monshow [-h| --help]>

B<monshow [-v| --version]>

B<monshow> I<name> I<[noderange]> [B<-s>] [B<-t> I<time>] [B<-a> I<attributes>] [B<-w> I<attr> E<lt> I<operator> E<gt> I<val> [B<-w> I<attr> E<lt> I<operator> E<gt> I<val>] ... ][B<-o {p|e}>]



=head1 DESCRIPTION

This command displays the events that happened on the given nodes or the monitoring data that is collected from the given nodes for a monitoring plugin.


=head1 PARAMETERS

I<name> is the name of the monitoring plug-in module to be invoked.

I<noderange> is a list of nodes to be showed for. If omitted, the data for all the nodes will be displayed.

=head1 OPTIONS


B<-h | --help>          Display usage message.

B<-v | --version>      Command Version.

B<-s>	shows the summary data.

B<-t>	specifies a range of time for the data, The default is last 60 minutes. For example -t 6-4, it will display the data from last 6 minutes to 4 minutes; If it is -t 6, it will display the data from last 6 minutes until now.

B<-a>	specifies a comma-separated list of attributes or metrics names. The default is all.

B<-w>	specify one or multiple selection string that can be used to select events. The operators ==, !=, =,!,>,<,>=,<= are available.  Wildcards % and _ are supported in the pattern string. % allows you to match any string of any length(including zero length) and _ allows you to match on a single character. The valid attributes are eventtype, monitor, monnode, application, component, id, severity, message, rawdata, comments. Valid severity are: Informational, Warning, Critical.

Operator descriptions:

=over 10

=item B<==>
Select event where the attribute value is exactly this value.

=item B<!=>
Select event where the attribute value is not this specific value.

=item B<=~>
Select event where the attribute value matches this pattern string. Not work with severity.

=item B<!~E<gt>>
Select event where the attribute value does not match this pattern string. Not work with severity.

=item B<E<gt>>
Select event where the severity is higher than this value. Only work with severity.

=item B<E<lt>>
Select event where the severity is lower than this value. Only work with severity.

=item B<E<gt>=>
Select event where the severity is higher than this value(include). Only work with severity.

=item B<E<lt>=>
Select event where the severity is lower than this value(include). Only work with severity.

=back

Note: if the "val" or "operator" fields includes spaces or any other characters that will be parsed by shell, the "attr<operator>val" needs to be quoted. If the operator is "!~", the "attr<operator>val" needs to be quoted using single quote.

B<-o>	specifies montype, it can be p or e. p means performance, e means events.


=head1 RETURN VALUE

0 The command completed successfully.

1 An error has occurred.

=head1 EXAMPLES

1. To show summary data about PctRealMemFree and PctTotalTimeIdle of cluster in last 6 minutes, enter:

  monshow rmcmon -s -a PctRealMemFree,PctTotalTimeIdle -t 6

2. To show all data of node1 and node2, enter:

  monshow rmcmon node1,node2

3. To show summary data of nodes which managed by servicenode1, enter:

  monshow rmcmon servicenode1 -s

4. To show RMC event with severity Critical, enter:

  monshow rmcmon -w severity==Critical


=head1 FILES

/opt/xcat/bin/monshow


=head1 SEE ALSO

L<monls(1)|monls.1>, L<monstart(1)|monstart.1>, L<monstop(1)|monstop.1>, L<monadd(1)|monadd.1>, L<monrm(1)|monrm.1>, L<moncfg(1)|moncfg.1>, L<mondecfg(1)|mondecfg.1>



