ZenPack:Microsoft Internet Information Server (IIS)

From Zenoss Wiki
This is the approved revision of this page, as well as being the most recent.
Jump to: navigation, search

Note: This is a Core ZenPack which can be found in the Core Zenoss RPM, and is fully documented in the Zenoss Extended Monitoring Guide. If you did not install this pack when you installed Zenoss Core, it can be found in $ZENHOME/packs.

Organization
Zenoss, Inc.
ZenPack name
ZenPacks.zenoss.IISMonitor
Link to more docs
View Documentation




Microsoft Internet Information Server (IIS) ZenPack

Monitoring for Microsoft Internet Information Server (IIS).

Warning

The ZenPack Catalog has moved to its new home at https://www.zenoss.com/product/zenpacks as of January 17, 2017. The following information may be out of date, and this page will eventually be removed.

Support

This ZenPack is part of Zenoss Core. Open Source users receive community support for this ZenPack via our online forums. Enterprise support for this ZenPack is provided to Zenoss customers with an active subscription.

Background

The ZenPacks.zenoss.IISMonitor ZenPack uses Windows Perfmon to collect performance metrics from Microsoft Internet Information Server (IIS).


Note: This ZenPack is deprecated; see the Microsoft Windows ZenPack.


No agent need be installed on IIS servers to collect the following metrics.

  • Connections Attempts
  • Throughput (Bytes & Files)
  • Requests (GET, HEAD, POST, CGI, ISAPI)
    • Standard: GET, HEAD, POST, CGI, ISAPI
    • WebDAV: PUT, COPY, MOVE, DELETE, OPTIONS, PROPFIND, PROPPATCH, MKCOL
    • Other: SEARCH, TRACE, LOCK, UNLOCK


Prerequisites

Prerequisite Restriction
Product Zenoss platform 4.x
Required ZenPacks ZenPacks.zenoss.WindowsMonitor,

ZenPacks.zenoss.IISMonitor


Enable Monitoring

All IIS servers must have a device entry in an organizer below the /Devices/Server/Windows/WMI device class. In addition, verify that your Zenoss platform Windows service account has access to the IIS service.


  1. Bind the IIS template to the /Devices/Server/Windows/WMI class. To do this:
    1. Select the device class in the devices hierarchy.
    2. Click Details.
    3. Select Device_WMI under Monitoring Templates.
    4. Select Bind Templates from the Action menu. The Bind Templates dialog appears.
    5. Move IIS (/Server/Windows/WMI) from the Available area to the Selected area, and then click Save.
  2. Navigate to the device or device class in the Zenoss platform interface.
    • If applying changes to a device class:
      1. Select the class in the devices hierarchy.
      2. Click Details.
      3. Select Configuration Properties.
    • If applying changes to a device:
      1. Click the device in the device list.
      2. Select Configuration Properties.
  3. Verify the credentials for the service account to access the service.
    IIS Configuration Properties
    Name Description
    zWinUser Windows user with privileges to gather performance information.
    zWinPassword Password for the above user.


  4. Click Save to save your changes. You will now be able to start collecting the IIS server metrics from this device.
  5. Navigate to Graphs and you should see some placeholders for graphs. After approximately fifteen minutes you should see the graphs begin to be populated with information.


Daemons

Daemons
Type Name
Performance Collector zenwinperf

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.zenoss.IISMonitor-*.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.zenoss.IISMonitor
  4. Finally, restart these serivices:
    $ zenoss restart

Discuss

Purplemarker.png New: Don't forget to add yourself to the Zenoss User Map!

blog comments powered by Disqus