Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This tool is used to check the state of your Shinken Enterprise installation and configuration.

 

If launch on the arbiter daemon, will check all the daemons of your architecture (simulate shinken-global-healthcheck)

If launch from a distant server (scheduler, poller, etc...) only the local daemons will be check (simulate shinken-local-healthcheck)

Usage:

shinken-healthcheck

Options:

NameDescription
--version
Show program's version number and exit.
-h, --help
Show this help message and exit.
-
w
f, --
write-output
file

Write output that can be send to the Shinken Solutions team.

Support file is available at /root/shinken-healthcheck_date_hour

Sample Output

Code Block
languagebash
##########################################################################################
This tool is used to check the state of your Shinken Enterprise (202.03.03.02U01) installation and configuration
########################################
[ ..........
Note: Global check launch as launch from a arbiter server
##################################################
Versions:
  Original installed version: 02.03.03.U01-137.fr
  Updated version           : 02.03.03.U01-137.fr
##################################################
[..........................................................................................  ] 100%
Architecture] 100%
Architecture
    ------------
    OK: |Realm All/|
     ------------
   [/etc/shinken/synchronizers/synchronizer-master.cfg:13] connection to daemon is     --------
        |In All|
        OK--------
    OK:         [/etc/shinken/schedulers/scheduler-master.cfg:14] connection to daemon is OK
- localhost (127.0.0.1):
          OK:  ^^^^^^^^^^^^^^^^^^^^^^^^
       [/etc/shinken/brokers/broker-master.cfg:15] connection to daemon is OK
    OK[receiver:         [/etc/shinken/receivers/receiver-master.cfg:7] connection to daemon is OK
receiver-1]
          OK:         [/etc/shinken/reactionners/reactionner-master.cfg:9] connection to daemon is OK
    OK:         [/etc/shinken/pollers/poller-master.cfg:9] connection to daemon is OK
    OK: AT RISK: receiver-1 is defined with the localhost address. It is a problem in distributed mode. Please configure it with the LAN IP/FQDN address instead
                  [/etc/shinken/arbiters/arbiter-master.cfg:13] connection  OK:      Connection to daemon is OK
 at port 7773
 AT RISK:    [/etc/shinken/synchronizers/synchronizer-master.cfg:13] is defined with
           OK:     localhost address,Daemon willversion be a problem in distributed mode. Please configure it
is: 02.03.03.U01-137.fr
                [reactionner: reactionner-master]
           with the LAN IP/FQDN address instead
    AT RISK: reactionner-master is defined with  [/etc/shinken/schedulers/scheduler-master.cfg:14] is defined with localhost
                address, will be the localhost address. It is a problem in distributed mode. Please configure it with the LAN
 IP/FQDN address instead
             IP/FQDN address instead
    AT RISKOK:    [/etc/shinken/brokers/broker-master.cfg:15]  Connection to daemon is definedOK withat localhostport address,7769
                will be a problem in distributedOK: mode. Please configure it with theDaemon LAN IP/FQDN
 version is: 02.03.03.U01-137.fr
                address instead
 [broker: broker-master]
   AT RISK:    [/etc/shinken/receivers/receiver-master.cfg:7] is defined with localhost
        AT RISK: broker-master is defined with the localhost address,. willIt beis a problem in distributed mode. Please configure it with the LAN
 IP/FQDN address instead
             IP/FQDN address instead
    AT RISKOK:      Connection  [/etc/shinken/reactionners/reactionner-master.cfg:9]to daemon is definedOK at withport localhost7772
                address, will be a problemOK: in distributed mode. Please configure itDaemon withversion the LAN
is: 02.03.03.U01-137.fr
                  IP/FQDN address insteadModules
    AT RISK:    [/etc/shinken/pollers/poller-master.cfg:9] is defined with localhost address,
          OK:      willName: beLivestatus a problem  in distributed mode. Please configure it with the LAN IP/FQDN
 Type: livestatus
              address instead
    AT RISK:    [/etc/shinken/arbiters/arbiter-master.cfg:13] is defined with localhost address,
  OK:      Name: Simple-log              will be a problem in distributed mode. Please configure it with the LAN IP/FQDN
Type: simple-log
                        OK:   address instead
Libs
  Name: WebUI OK:         [lib check] pymongo is is available
    OKType: webui
         [lib check] pycurl is is available
    OK:      OK:   [lib check] gevent is is available
Name: Graphite-Perfdata     OK:  Type: graphite_perfdata
      [lib check] ldap is is available
    OK:         [libOK: check] gevent is is available
Licence key
  Name: sla   ERROR:      The licence key is invalid
    ERROR:    Type:  The key format is invalid.sla
            - 127.0.0.1 (127.0.0.1):
    ERROR:      No licence key.^^^^^^^^^^^^^^^^^^^^^^^^
    ERROR:      The licence key is expired
Modules
  [poller: poller-central]
 OK:         [Synchronizer] auth_secret is a custom variable
          OK:      Configuration seems valid
   [Synchronizer] master_key is a custom variable
    OK:        OK: [WebUI] auth_secret is a custom variable
Storage
Connection to daemon is OK: at port 7771
      [Synchronizer] mongodb server is  available: mongodb://localhost/?safe=false
    OK:    OK:     [graphite] serverDaemon localhost:2003version is available: 02.03.03.U01-137.fr
    OK:        -  [webui::mongodb module /etc/shinken/modules/mongodb.cfg:5] mongodb server islocalhost (192.168.56.101):
            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
                available: mongodb://localhost/?safe=true
[scheduler: scheduler-central]
           OK:         [webui::graphite] server 127.0.0.1 is available with 10 top level elements

...

OK:      Configuration seems valid
                    OK:      Connection to daemon is OK at port 7768
                    OK:      Daemon version is: 02.03.03.U01-137.fr
                    Modules
                        OK:      Name: PickleRetentionFile     Type: pickle_retention_file
            ------------------
            |Realm All/Extra/|
            ------------------
                ----------
                |In Extra|
                ----------
                    - 192.168.56.102 (192.168.56.102):
                    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
                        [poller: poller-distant]
                            AT RISK: Cannot get module details from your daemon (HTTP Error 404: Not Found). Please update it.
                            OK:      Configuration seems valid
                            OK:      Connection to daemon is OK at port 7771
                    -------------------------
                    |Realm All/Extra/Extra2/|
                    -------------------------
                        -----------
                        |In Extra2|
                        -----------
                            - 192.168.56.102 (192.168.56.102):
                            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
                                [scheduler: scheduler-distant]
                                    AT RISK: Cannot get module details from your daemon (HTTP Error 404: Not Found). Please update it.
                                    OK:      Configuration seems valid
                                    OK:      Connection to daemon is OK at port 7768
                            - localhost (127.0.0.1):
                            ^^^^^^^^^^^^^^^^^^^^^^^^
                                [arbiter: synchronizer-master]
                                    AT RISK: synchronizer-master is defined with the localhost address. It is a problem in distributed mode. Please configure it with the LAN IP/FQDN address instead
                                    OK:      Connection to daemon is OK at port 7765
                                    OK:      Daemon version is: 02.03.03.U01-137.fr
                                    Modules
                                        OK:      Name: Cfg_password            Type: cfg_password_webui
                                        OK:      Name: syncui-import           Type: syncui-import
                                        OK:      Name: cfg-file-shinken        Type: cfg-file-import
                                        OK:      Name: active-dir              Type: active-dir-import
                                        OK:      Name: sync-vmware             Type: sync-vmware
                                        OK:      Name: cfg-file-nagios         Type: cfg-file-import
                                        OK:      Name: discovery-import        Type: discovery-import
                                        OK:      Name: ip-tag-dmz              Type: sync_ip_tag
                                        OK:      Name: sync-regexp-tag         Type: sync-regexp-tag
                                [arbiter: arbiter-master]
                                    AT RISK: arbiter-master is defined with the localhost address. It is a problem in distributed mode. Please configure it with the LAN IP/FQDN address instead
                                    OK:      Connection to daemon is OK at port 7770
                                    OK:      Daemon version is: 02.03.03.U01-137.fr
                                    Modules
                                        OK:      Name: synchronizer-import     Type: synchronizer-import
Licence key
    ERROR:   The licence key is invalid
    ERROR:   No licence key. Trial mode Node limits : 20
Local libraries
    [gevent]
        OK:      Library gevent is available. Version: 0.13.8
    [pycurl]
        OK:      Library pycurl is available. Version: libcurl/7.19.7 NSS/3.16.2.3 Basic ECC zlib/1.2.3 libidn/1.18 libssh2/1.4.2
    [pymongo]
        OK:      Library pymongo is available. Version: 2.9.2
    [ldap]
        OK:      Library ldap is available. Version: 2.3.10
Modules
    [WebUI]
        OK:      Auth_secret is a custom variable
        OK:      Mongodb server is available at: mongodb://localhost/?safe=true
    [Synchronizer]
        OK:      Mongodb server is available at: mongodb://localhost/?safe=false
        OK:      Auth_secret is a custom variable
        OK:      The master_key is a custom variable
Storage
    [graphite]
        OK:      Graphite server 127.0.0.1 is available with 1 top level elements
        OK:      Graphite server localhost:2003 is available



 

Output parts

The healthcheck output is separated into several parts:

  • Architecture: about your daemons configuration
  • Libs: about installed librairies need by Shinken Enterprise
  • Licence key: all about your licence key
  • Modules: information about UIs
  • Storage: information about the mongodb and graphite storage system

There are 3 level for output:

  • OK: all is valid
  • At Risk: it works, but something can go wrong in the future if you don't fix something
  • Error: this part is in error and must be fix now

 

 

shinken-local-healthcheck

This tool is used to check the state of your local Shinken Enterprise installation and configuration.

With this command, only the local installation and daemons will be checked.

Usage:

shinken-local-healthcheck

Options:

NameDescription
--version
Show program's version number and exit.
-h, --help
Show this help message and exit.
-f, --file

Write output that can be send to the Shinken Solutions team.

Support file is available at /root/shinken-healthcheck_date_hour

Output parts

The healthcheck output is separated into several parts:

  • Architecture: about your daemons configuration
  • Libs: about installed librairies need by Shinken Enterprise
  • Licence key: all about your licence key
  • Modules: information about UIs, if launch on a broker daemon
  • Storage: information about the mongodb and graphite storage system, if need by daemons

There are 3 level for output:

  • OK: all is valid
  • At Risk: it works, but something can go wrong in the future if you don't fix something
  • Error: this part is in error and must be fix now

 

shinken-global-healthcheck

This tool is used to check the state of your local Shinken Enterprise installation and configuration.

With this command, all the local and distant daemons will be checked. This should be launched only for the central (synchronizer/arbiter) daemon.

Usage:

shinken-global-healthcheck

Options:

NameDescription
--version
Show program's version number and exit.
-h, --help
Show this help message and exit.
-f, --file

Write output that can be send to the Shinken Solutions team.

Support file is available at /root/shinken-healthcheck_date_hour

Output parts

The healthcheck output is separated into several parts:

  • Architecture: about your daemons configuration
  • Libs: about installed librairies need by Shinken Enterprise
  • Licence key: all about your licence key
  • Modules: information about UIs, if launch on a broker daemon
  • Storage: information about the mongodb and graphite storage system, if need by daemons

There are 3 level for output:

...