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.