NAME

eclat-lsistat, eclat-describe-instance-status - describe status of EC2 instances

SYNOPSIS

eclat lsistat [-ar] [--all] [--running] [FILTER...]

eclat lsistat --help

DESCRIPTION

Describes the status of selected EC2 instances including any scheduled events. This information includes:

1.: Instance state
This describes the current state of the instance: running, stopped, etc.
2.: System status
The system status refers to the functionality depending on the systems that support the instance, such as the underlying hardware, network devices, etc.
3.: Instance status
The instance status describes those aspects of the functionality that depend on the instance itself (e.g. on its operating system, the services it runs, etc.)

OPTIONS

-a, --all: Return the status for all instances. This is the default.
-r, --running: Show only running instances.

FILTERS

The following filters are defined:

availability-zone=string: The Availability Zone of the instance.
event.code=value: The code identifying the type of event. Valid values are: instance-reboot, system-reboot, system-maintenance, instance-retirement.
event.description=string: A description of the event.
event.not-after=date: The latest end time for the scheduled event.
event.not-before=date: The earliest start time for the scheduled event.
instance-state-name=value: The state of the instance. The valid values are: pending, running, shutting-down, terminated, stopping, stopped.
Note that unless value is running you have to use the -a (--all) option for this filter to take effect.
instance-state-code=code: A code representing the state of the instance. Valid values are:

0: pending
16: running
32: shutting-down
48: terminated
64: stopping
80: stopped

Note that unless code is 0 you have to use the -a (--all) option for this filter to take effect.

system-status.status=value: The system status of the instance. Valid values are: ok, impaired, initializing, insufficient-data, not-applicable.
system-status.reachability=string: System reachability status, one of: passed, failed, initializing, insufficient-data.
instance-status.status=string: The status of the instance. One of: ok, impaired, initializing, insufficient-data, not-applicable.
instance-status.reachability=string: The instance reachability status. One of: passed, failed, initializing, insufficient-data.

OUTPUT

Each instance is described on a separate line. The fields are separated by single TAB characters. The fields displayed are (from left to right): instance ID, region, and instance state. If the instance is running, system and instance status are also displayed. If any events are reported, they are output on the standard error.

EXAMPLE

In the example below the long lines are split for readability:

$ eclat lsistat -a
i-283f9f47 us-east-1d running impaired Sys.reachability=failed Inst.reachability=failed
i-283f9f47	Event: "The instance is running on degraded hardware"
i-d2e36dbd us-east-1d running ok  Sys.reachability=passed	Inst.reachability=passed

AUTHORS

Sergey Poznyakoff

BUG REPORTS

Report bugs to <bug-eclat@gnu.org.ua>.

COPYRIGHT

Copyright © 2012-2018 Sergey Poznyakoff
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.