UPDATE: Alle Informationen unter Fluxpunkt Monitoring für STARFACE (Neue URL)
I'm glad to announce the availability of the first public beta (v.67) of the CheckMK STARFACE module. This module installs a CheckMk monitoring agent (v1.2.0p1) on the STARFACE which listens on TCP port 6556 for incoming queries. Provided you have got a running CheckMK installation (checkout OMD ;)) you can now monitor a large number of STARFACE properties.
The module comes in two flavors:
The Basic Version
[INDENT]This version is free and supports the basic CheckMK checks offered by the official linux agent (v.1.2.0p1). The checks are active as soon as the module is installed and activated. Running check_mk -I <starface host> and check_mk -O on the monitoring host enables monitoring of all available parameters. Please make sure you have a recent version of CheckMK installed.
The basic version supports monitoring of cpu load, cpu utilization, disk I/O, network traffic, ram utilization and process statistics, including the collection of performance data.[/INDENT]
The Premium Version
[INDENT]The premium version requires the purchase of a license code which is bound to the STARFACE hardware ID a unique identifier of each appliance and installation. The premium version supports all checks of the basic version. Additionally it provides the following information to the monitoring host:
- The STARFACE Appliance Type (e.g. STARFACE light, STARFACE Advanced, STARFACE Pro,...)
- The serial number of this appliance
- The hardware ID of this appliance
- The maximum number of users supported by this appliance
- The maximum number of connections/calls supported by this appliance
- The STARFACE version
- Licensing information such as the owner of this appliance, the license key and the number of licensed users
- The RAID status including diagnostics information
- The status of internal security components (Password Check enabled/disabled, Attack Detection enabled/disabled)
- The number of blacklisted hosts
- The number of admin users
- The backup status
- Asterisk Call/Channel information
- The number of accounts (total), including active accounts, available accounts, unavailable accounts, ringing accounts
- Asterisk peer information and statistics
- ...
[/INDENT]
Some of these checks serve an informational purpose (and could allow automatic inventory) while others are security, utilization or hardware status related. For example the number of admin users is usually fixed and a warning could be triggered if it changed. Most users will probably want to monitor the utilization of channels (active calls vs. available lines) or users (registered users vs. supported users). If these numbers approach certain levels hardware might need to be added or additional lines need to be leased.
Please note that as long as this STARFACE module is not fully supported by the official CheckMK distribution, you will need to make changes to your CheckMK monitoring instance for it to make sense of the data exported by this module. The exported data needs to be turned into a format that CheckMK understands. Each agent section (see example output below) needs to be handled by a check-script in /usr/share/check_mk/checks. These scripts are currently being developed with a small number already being available, you can help writing checks and ask for inclusion in the official distribution.
An example of the data exported by the premium version:
<<<starface>>>
appliance_type "Starface Advanced v2.1"
appliance_serial_number 1122-3344-5566
appliance_max_users 250
appliance_max_connections 60
starface_version 5.1.0.10
hardware_id 9c24296d00ae2b227efe176a66941c291b3412f3
owner "n/a"
license_key n/a
license_max_users 4
raid_status UP_AND_RUNNING
raid_diagnosis HEALTHY
password_check disabled
attack_detection enabled
blacklisted_hosts 0
debug_mode disabled
<<<starface_backups>>>
[HDD] 1316127630691 de.vertico.backup.successful
[USB] 1341788449933 de.vertico.backup.unavailable
<<<starface_channels>>>
60 max calls
7 active channels
3 active calls
2 last5min calls
<<<starface_accounts>>>
total_accounts 3/4
admin_accounts 1
active_accounts 2
available_accounts 2
ringing_accounts 1
unavailable_accounts 0
<<<starface_peers>>>
smartnode.fxs1/smartnode. 10.0.10.20 D N 5060 OK (16 ms)
smartnode.fxs0/smartnode. 10.0.10.20 D N 5060 OK (16 ms)
1282.DE900IP/1282.DE900IP 10.0.10.30 D N 5060 Unmonitored
1229.polycom/1229.polycom (Unspecified) D N 0 Unmonitored
<<<starface_sip_provider>>>
sipgate.de:5060 1234567e0 585 Registered Thu, 12 Jul 2012 19:12:54
sipgate.de:5060 1234567e1 585 Registered Thu, 12 Jul 2012 19:12:54
<<<3ware_info>>>
/c0 Model = 9650SE-2LP
/c0 Firmware Version = FE9X 4.08.00.006
/c0 Serial Number = L325030B1123276
Port Status Unit Size Blocks Serial
<<<3ware_disks>>>
c0/p0 OK u0 232.88 GB 488397168 WD-WCAV2AK82951
c0/p1 OK u0 232.88 GB 488397168 WD-WCAV2AK82957
<<<3ware_units>>>
c0/u0 RAID-1 OK - - - 232.82 OFF ONFor more information on CheckMK visit http://mathias-kettner.de/check_mk.html
Premium License Purchase
Until a webshop is set up, a premium license can be ordered by sending an email to starface.module.checkmk.license@fluxpunkt.de (English or German). The price for the premium license is 79,00 Euro (plus tax if applicable).
UPDATE 07/12/2012 (v77):
Apart from Bugfixes, v77 adds more documentation and the following checks:
- STARFACE SIP status (the ability to answer SIP messages)
- The total number of registered phones/devices
- The number of phones/devices currently online/connected
- The number of devices that have changed their IP address since they were registered with the pbx
- The number of calls during the last 5 minutes
- Status of registered SIP providers/Line status
- NTP drift/offset
- Standard CheckMK RAID status of 3ware Controller (previously not working)
UPDATE 07/19/2012 (v86):
- Module now survives restarts of the PBX
- If the module gets killed by the PBX, a watchdog function now triggers a restart
- Module is more robust
- Firewall rules get cleaned up more thoroughly
- Entering the license code does not require the module instance to be restarted anymore
- Minor bugfixes
UPDATE 07/26/2012 (v87):
- Bugfix: Number of blacklisted hosts incorrect
UPDATE 01/10/2013 (v90):
- Bugfix: An empty monitoring host configuration was not interpreted correctly
UPDATE 05/30/2013 (v109):
- Support for STARFACE 5.6
6 und 2 (Host und Subnetz) sind in der IP-Adresse vertauscht.
