NAME

       mon-collector - Command line interface for the data collectors of the monitoring system

SYNOPSIS

       mon-collector {collector}

DESCRIPTION

       mon-collector  is  a  suite  of tools designed to provide a command line interface to the data collectors
       implemented by the ganeti monitoring system.  mon-collector is also  the  generic  binary  that  must  be
       invoked specifying, as the first command line parameter, the name of the actual desired data collector to
       be run.

       When  executed,  mon-collector  will  run the specified collector and will print its output to stdout, in
       JSON format.

COLLECTORS

   DISKSTATS
       diskstats [ [ -f | --file ] = input-file ]

       Collects the information about the status of the disks of the system, as listed by /proc/diskstats, or by
       an alternate file with the same syntax specified on the command line.

       The options that can be passed to the DRBD collector are as follows:

       -f input-file, --file=input-file
              Where to read the data from.  Default if not specified: /proc/diskstats

   DRBD
       drbd [ [ -s | --drbd-status ] = status-file ] [ [ -p | --drbd-pairing] = pairing-file ]

       Collects the information about the version and status of the DRBD kernel module, and of the disks  it  is
       managing.

       If  status-file and pairing-file are specified, the status and the instance-minor paring information will
       be read from those files.  Otherwise, the collector will read them,  respectively,  from  /proc/drbd  and
       from the Confd server.

       The options that can be passed to the DRBD collector are as follows:

       -s status-file, --drbd-status=status-file
              Read the DRBD status from the specified file instead of /proc/drbd.

       -p pairing-file, --drbd-pairing=pairing-file
              Read  the  information about the pairing between instances and DRBD minors from the specified file
              instead of asking the Confd servers for them.

   INSTANCE STATUS
       inst-status-xen [ [ -a | --address ] = ip-address ] [ [ -p | --port ] = port-number ]

       Collects the information about the status of the instances of the current node.  In order to perform this
       task, it needs to connect to the ConfD daemon to fetch some  configuration  information.   The  following
       parameters  allow  the  user  to specify the position where the daemon is listening, in case it's not the
       default one:

       -a ip-address, --address=ip-address
              The IP address the ConfD daemon is listening on.

       -p port-number, --port=port-number
              The port the ConfD deamon is listening on.

   LOGICAL VOLUMES
       lv [ [ -a | --address ] = ip-address ] [ [ -p | --port ] = port-number ] [ [ -f | --file ] = input-file ]
       [ [ -i | --instances ] = instances-file ]

       Collects the information about the logical volumes of the current node.

       In order to perform this task, it needs to interact with the lvs command line tool and to connect to  the
       ConfD daemon to fetch some configuration information.  The following parameters allow the user to specify
       the position where the daemon is listening, in case it's not the default one:

       -a ip-address, --address=ip-address
              The IP address the ConfD daemon is listening on.

       -p port-number, --port=port-number
              The port the ConfD deamon is listening on.

       Instead  of  accessing  the  live  data  on  the cluster, the tool can also read data serialized on files
       (mainly for testing purposes).  Namely:

       -f input-file, --file input-file
              The name of the file containing a recorded output of the lvs tool.

       -i instances-file, --instances=instances-file
              The name of the file containing a JSON serialization of instances the current node is primary  and
              secondary for, listed as:

                     ([Instance], [Instance])

              where  the  first  list  contains the instances the node is primary for, the second list those the
              node is secondary for.

REPORTING BUGS

       Report bugs to project website (http://code.google.com/p/ganeti/) or contact  the  developers  using  the
       Ganeti mailing list (ganeti@googlegroups.com).

SEE ALSO

       Ganeti  overview  and  specifications:  ganeti(7)  (general  overview),  ganeti-os-interface(7) (guest OS
       definitions), ganeti-extstorage-interface(7) (external storage providers).

       Ganeti commands: gnt-cluster(8) (cluster-wide commands), gnt-job(8) (job-related  commands),  gnt-node(8)
       (node-related  commands),  gnt-instance(8)  (instance  commands),  gnt-os(8)  (guest  OS  commands), gnt-
       storage(8) (storage commands), gnt-group(8) (node group commands), gnt-backup(8) (instance  import/export
       commands), gnt-debug(8) (debug commands).

       Ganeti  daemons: ganeti-watcher(8) (automatic instance restarter), ganeti-cleaner(8) (job queue cleaner),
       ganeti-noded(8) (node daemon), ganeti-masterd(8) (master daemon), ganeti-rapi(8) (remote API daemon).

       Ganeti htools: htools(1) (generic binary), hbal(1) (cluster balancer), hspace(1) (capacity  calculation),
       hail(1) (IAllocator plugin), hscan(1) (data gatherer from remote clusters), hinfo(1) (cluster information
       printer), mon-collector(7) (data collectors interface).

COPYRIGHT

       Copyright  (C)  2006,  2007,  2008,  2009,  2010,  2011, 2012 Google Inc.  Permission is granted to copy,
       distribute and/or modify under the terms of the GNU General Public  License  as  published  by  the  Free
       Software Foundation; either version 2 of the License, or (at your option) any later version.

       On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-
       licenses/GPL.

Ganeti                                                                                          mon-collector(7)