NAME

helios_service_status - check the status of services running in a Helios collective

SYNOPSIS

helios_service_status [--service=<service name>] [--hostname=<hostname>] [--epoch-time]

# list status of all service instances running on current host
helios_service_status 

# list status of all service instances running on host wrkhost1
helios_service_status --hostname=wrkhost1

# list status of all service instances running on all hosts in the collective
helios_service_status --hostname=*

# list status of all instances of MyService
# -H is shortcut for --hostname
helios_service_status --service=MyService -H=*

# list information on the MyService instance running on wrkhost1
# report the start and last check in times in epoch seconds
helios_service_status -s MyService -H wrkhost1 --epoch-time

DESCRIPTION

The helios_service_status command reports status information on services running in a Helios collective. You can use this command for general administration purposes or to build monitoring scripts for services.

The helios_service_status command currently reports 6 key pieces of information:

Service

name of the service.

Version

the version of the service, if one is set.

Host

the hostname of the host on which the service is running.

PID

The process id of the service daemon.

Online Since

the start time of the service daemon.

Last Registered

the last time the service daemon "checked in" to the collective. How often this happens is controlled by the "registration_interval" configuration parameter. The default is 60 sec, which should be fine for most purposes.

This command basically reports the same type of information as the Helios::Panoptes Collective Admin view, but having it available at the command line adds convenience and enhances the Helios system's scriptability.

AUTHOR

Andrew Johnson, <lajandy at cpan dot org>

COPYRIGHT AND LICENSE

Copyright (C) 2013-4 by Logical Helion, LLC.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.0 or, at your option, any later version of Perl 5 you may have available.

WARRANTY

This software comes with no warranty of any kind.