E-mail
Topics marked with * relate to features available only in vFabric Hyperic.
Monitoring a Windows Service
Hyperic can monitor a windows service. You configure a platform service of type "Windows Service" on a Windows platform
Resource Plugin, Functions, and Classes
The Windows Service service type is managed by Hyperic's netservices plugin and performs the following functions:
- Metric collection using the org.hyperic.hq.plugin.netservices.TCPSocketCollector class.
- event tracking using the reportEvent method in the Collector class.
Configure the Windows Service in Hyperic
The "Windows Service" service type must be manually configured.
- If you know the name of the Windows Service, proceed to step 2. Otherwise:
- Select Run from the Windows Start menu.
- Type services.msc in the run dialog and click OK.
- In the list of services displayed, right-click the service you wish to monitor and choose Properties.
- Locate the Service Name on the General tab.
- In the Hyperic user interfaace, navigate to the Windows platform where the service runs.
- Select New Platform Service from the Tools menu.
- On New Service page, enter a name for the service and select "Windows Service" from the Service Type pull-down.
- Supply all required values on the Configuration Properties page. Configuration options are defined below in Windows Service Configuration Options.
Windows Service Configuration Properties Page
The Configuration Properties page for the Windows Service service type is shown below.
Unable to render embedded object: File (WindowsServiceConfig.png) not found.
Windows Service Configuration Options
The tables below define the options in the configuration schema for the "Windows Service" service type. These are the resource attributes that are displayed, and may be edited, on the Configuration Properties page for a Windows Service, shown above.
Windows Service Metrics
- Availability - A Windows Service is considered available if the Hyperic Agent can...
| Name | Alias | Units | Category | Default On | Default Interval |
|---|---|---|---|---|---|
| Availability | Availability | percentage | Availability | true | 10 |
| Start Type | StartType | None | false | 30 | |
| Memory Size | MemSize | B | UTILIZATION | 5 | |
| Resident Memory Size | ResidentMemSize | B | UTILIZATION | 5 | |
| Cpu System Time | SystemTime | UTILIZATION | 10 | ||
| Cpu User Time | UserTime | ms | UTILIZATION | 10 | |
| Cpu Total Time | TotalTime | ms | UTILIZATION | 10 | |
| Cpu Usage | Usage | ms | UTILIZATION | true | 5 |
| Start Time | StartTime | epoch-millis | UTILIZATION | 30 | |
| Open Handles | OpenHandles | UTILIZATION | |||
| Threads | none | UTILIZATION |
Windows Service Monitoring Defaults Page
You can enable and disable metrics, select indicator metrics, and change the collection interval for a resource type on its Monitoring Defaults page. To navigate to a resource type's Monitoring Defaults page:
- Click the Administration tab.
- Click Monitoring Defaults.
- Scroll down to the resource type and click Edit Metric Template.
The Monitoring Defaults page for the Windows Service service type is shown below:
Event Tracking
You can enable log tracking for a network service. If you do, the agent will log an event for responses that match the criteria you specify.
To enable log tracking, click the Enable Log Tracking box in the Monitoring section of the Configuration Properties page.
For information about Hyperic log tracking functionality and configuration options, and how to view log events, see Set Up Log Tracking for a Resource.