ZenPacks

Windows SNMP Service Monitor ZenPack

The Windows SNMP Service Monitor ZenPack allows Zenoss to monitor Windows Services via SNMP.

Support

This ZenPack is developed by the Zenoss user community and supported via our online forums. Zenoss, Inc. does not provide direct support for this ZenPack.

Releases

Version 1.1 (4.2.x)- Download
Compatible with Zenoss Core 4.2.x
Incompatible with Zenoss Core 2.5.x, Zenoss Core 3.1.x, Zenoss Core 3.2.x
Version 1.0 (3.2.x)- Download
Compatible with Zenoss Core 3.2.x
Incompatible with Zenoss Core 2.5.x, Zenoss Core 4.2.x
Version 1.0 (2.5.x)- Download
Compatible with Zenoss Core 2.5.x
Incompatible with Zenoss Core 3.2.x, Zenoss Core 4.2.x

Background

DESCRIPTION:

The Windows SNMP Service Monitor ZenPack allows Zenoss to monitor Windows Services via SNMP. It automatically links to the /Server/Windows device class. After installing the pack you can simply remodel devices in /Server/Windows and Zenoss will discover any services running on them.

Make sure that you lock the services to prevent them from being removed during a remodel while a service is down. Modeling will only pick up services that are running.

INSTALLATION:

During installation and removal the ZenPack rebuilds device relations for all devices within the /Server/Windows device class. Depending on the number of devices that you have in that class, it can take a long time. You will notice some errors in the UI while the relations are being rebuilt, which is normal. Please be patient and allow it to complete. After the relations have been rebuilt Zenoss should be restarted. Make sure that the zenwinsrvsnmp daemon is running after the restart is performed.

ZPROPERTIES:

  • zWinServiceSNMPIgnoreNames: Place the full names of any services that you want to ignore in this line by line.
  • zWinServiceSNMPMonitorNames: Place the full names of any services which you explicitly want to monitor (ignoring all others) in this line by line.
  • zWinServiceSNMPMonitorNamesEnable: This enables/disables the use of zWinServiceSNMPMonitorNames

Note that you need to remodel your devices for the above to take effect.

Keep in mind that zWinServiceSNMPIgnoreNames is constantly in use. If you put the same service name in both zWinServiceSNMPIgnoreNames and zWinServiceSNMPMonitorNames it will be ignored.

DAEMON:

  • zenwinsrvsnmp: Make sure this daemon is running or service monitoring won't work.

TEMPLATE:

  • WinServiceSNMP in /Server/Windows: This template is required for monitoring services. Do not bind this template to the device. Make sure the template is in the class that the device is in (or a higher class). The template will automatically be used for the windows services components.

MODELER PLUGIN:

  • community.snmp.WinServiceMap: This plugin is required during modeling.

TIPS:

Generally changes to monitoring status are immediately pushed to collector daemons, but sometimes if the daemon is too busy the daemon misses the change. In those cases the monitoring status doesn't get picked up by the daemon until the next reconfig cycle, which can take a while. If you notice that you're often still getting windows service down notifications shortly after you've toggled monitoring off on a windows service, you can add the following transform to the /Status/WinServiceSNMP event class to resolve this (this transform will only work on Zenoss 4.2.x and later).

# drop events for unmonitored winservicesnmp components
if component.monitor == False: evt._action = 'drop'

SCREENSHOTS:

ZP1.png

ZP2.png

ZP3.png

Installation

Normal Installation (packaged egg)

  1. Download the appropriate egg file for the version of Zenoss you are running.
  2. Ensure you are logged in as the zenoss user:
    $ sudo su - zenoss
  3. Install the ZenPack:
    $ zenpack --install ZenPacks.Nova.WinServiceSNMP-*.egg
  4. Restart these services:
    $ zenoss restart

Developer Mode Installation

In order to do a development mode installation you will want to clone the existing git repository, and then use the --link flag with the zenpack command:

  1. Ensure you are logged in as the zenoss user:
    $ sudo su - zenoss
  2. Start by cloning the upstream repository:
    $ git clone git://github.com/path/to/repo
  3. Next, perform the installation:
    $ zenpack --link --install ZenPacks.Nova.WinServiceSNMP
  4. Finally, restart these serivices:
    $ zenoss restart

Community

This ZenPack is developed and supported by the Zenoss User Community. Contact Zenoss to request more information regarding this or any other ZenPacks. Click here to view all available Zenoss Community ZenPacks.