Windows Media Services MP Guide

advertisement
Windows Media Services Management
Pack Guide for Operations Manager 2007
Raphael Burri
http://rburri.wordpress.com
raburri@bluewin.ch
February, 2009
Revision History
Release Date
Changes
January, 2008
Original release of this guide
March, 2008
Update to 1.0.1.57 (SP1 compatibility)
February, 2009
Update to 1.0.2.10 (Windows Media Services
2008 compatibility)
Contents
1
Windows Media Services Management Pack ................................................................. 4
2
Getting Started .................................................................................................................. 5
2.1
Before importing the Management Pack .......................................................................... 5
2.2
Other Requirements ......................................................................................................... 6
2.3
Customizing the management pack ................................................................................. 6
3
Elements of the Windows Media Services management pack ..................................... 7
3.1
Object Type Model ........................................................................................................... 7
3.2
Object Discovery .............................................................................................................. 8
3.2.1
3.3
Objects Discovered ....................................................................................................... 8
Monitors ............................................................................................................................ 9
3.3.1
Windows Media Services 9 Server Role monitors ........................................................ 9
3.3.1.1
Allow Client Connection Status ................................................................................ 10
3.3.1.2
Error Status .............................................................................................................. 10
3.3.1.3
Publishing Point Availability ..................................................................................... 11
3.3.1.4
Windows Service ...................................................................................................... 11
3.3.1.5
Data Source Bottleneck ........................................................................................... 11
3.3.1.6
Memory Usage ......................................................................................................... 12
3.3.1.7
Stream Data Packet Discards .................................................................................. 12
3.3.1.8
Streaming Bandwidth Bottleneck ............................................................................. 13
3.3.2
Windows Media Services 9 Publishing Point monitors ............................................... 14
3.3.2.1
Allow Client Connection Status ................................................................................ 14
3.3.2.2
Broadcast Status ...................................................................................................... 15
3.3.2.3
Error Status .............................................................................................................. 15
3.3.2.4
Source Available (disabled by default) ..................................................................... 16
3.4
Rules .............................................................................................................................. 17
3.4.1
Performance Data Collection Rules ............................................................................ 17
3.4.2
Delete old WMS log files ............................................................................................. 18
3.5
Tasks .............................................................................................................................. 19
3.5.1
Windows Media Services 9 Role Tasks ...................................................................... 19
3.5.2
Windows Media Services 9 Publishing Point Tasks ................................................... 20
3.6
Reports ........................................................................................................................... 21
3.6.1.1
4
WMS Performance Information Reports .................................................................. 22
Using the Management Pack ......................................................................................... 23
4.1
Console Views ................................................................................................................ 23
4.2
Configuring Overrides .................................................................................................... 24
1
Windows Media Services Management Pack
The Windows Media Services management pack monitors the health of Microsoft Windows Media Services 9
(WMS), installed on Windows Server 2003 and Microsoft Windows Media Services 2008 on Windows Server
2008.
It provides discovery, availability and performance monitors, performance collection rules, performance
reports and WMS related tasks.
It is important to understand that the Windows Media Services management pack has been developed
entirely for Operations Manager 2007. It is not a port of the MOM 2005 pack available from Microsoft. Nor
has functionality of the latter been integrated.
The management pack has been tested against Operations Manager 2007 SP1.
A detailed discussion about how to tune Windows Media Services 9 is published in the White Paper
‘Optimizing Windows Media Services’ that can be downloaded from here:
http://www.microsoft.com/windows/windowsmedia/howto/articles/optimize_web.aspx
Windows Media Services Management Pack Guide
b
4/24
2
Getting Started
2.1
Before importing the Management Pack
The management pack consists of a single file. Use the Import Management Pack function from the
Administration pane of the Operations Console to import the management pack. Make sure you have all the
management pack, the WMS management pack depends on, imported as well. The import wizard will let you
know if some are missing.
All dependencies are defined against management packs provided by Microsoft. If you can’t find them on
your Operations Manager installation media, you should be able to download them from here:
http://go.microsoft.com/fwlink/?LinkId=82105
The following table lists the management pack files and the dependencies (in grey)
Management Pack File
Version
Vendor
Custom.WMS.x.mp
1.0.2.10
Custom
System.ApplicationLog.Library.mp
6.0.5000.0
Microsoft
System.Health.Library.mp
6.0.5000.0
Microsoft
System.Library.mp
6.0.5000.0
Microsoft
System.Performance.Library.mp
6.0.5000.15
Microsoft
Microsoft.SystemCenter.DataWarehouse.Library.mp
6.0.5000.26
Microsoft
Microsoft.SystemCenter.DataWarehouse.Report.Library.mp
6.0.5000.0
Microsoft
Microsoft.SystemCenter.InstanceGroup.Library.mp
6.0.5000.0
Microsoft
Microsoft.SystemCenter.Library.mp
6.0.5000.0
Microsoft
Microsoft.Windows.Library.mp
6.0.5000.0
Microsoft
Microsoft.Windows.Server.Library.mp
6.0.5000.25
Microsoft
Microsoft.Windows.Server.2003.mp
6.0.5000.0
Microsoft
Microsoft.Windows.Server.2008.mp
6.0.6278.22
Microsoft
Windows Media Services Management Pack Guide
b
5/24
2.2
Other Requirements
The Windows Media Services management pack makes use of the WMS WMI Event handler to monitor the
WMS’ health. Check if it is enabled on your WMS servers. Use the Windows Media Services MMC snap-in,
select a WMS server and choose the Properties tab. Then select Event notification.
2.3
Customizing the management pack
The Windows Media Services management pack is sealed. Changes to it are not possible. Using overrides
almost all aspects of it can be customized. When doing so it is recommended that you store your overrides
for the Windows Media Services management pack in a specifically for this purpose created one. The
‘Default Management Pack’ should not be used.
Doing so simplifies exporting, reporting on or altering your changes. Furthermore the ‘Default Management
Pack’ will not be made dependant on the Windows Media Services management pack. Removing the
Windows Media Services management pack will be possible.
Windows Media Services Management Pack Guide
b
6/24
3
Elements of the Windows Media Services management pack
3.1
Object Type Model
The following diagram shows the type model of the Windows Media Services management pack. Inheritance
is shown vertically while Hosting and Health Roll up are drawn horizontally. Blue object types are part of the
management pack, while green ones already exist. They are defined by the management pack’s
dependencies.
Graphic 1
Windows Media Services Management Pack Guide
b
7/24
3.2
Object Discovery
3.2.1
Objects Discovered
The Windows Media Services management pack discovers objects of the following types:
Object Type
Automatically Discovery Rule
Attributes
Windows Media
Services 9 Server Role
Yes

Name

Install Directory

Default Path

Log Directory

Version

Name

Install Directory

Default Path

Log Directory

Version
Windows Media Server 9
Publishing Point
Discovery

PP Name

PP Path

PP Type
Windows Media
Services 9 Server
Reverse Proxy Role
Yes
Custom Windows Media
Services 9 Role
Discovery and Custom
Windows Media Services
9 Role Details Discovery
Custom Windows Media
Services 9 Role
Discovery and Custom
Windows Media Services
9 Role Details Discovery
Windows Media
Services 9 Publishing
Point (Broadcast)
Yes
Windows Media
Services 9 Publishing
Point (Cache/Proxy)
Yes (if the
WMS Server
is a Reverse
Proxy
Windows Media Server 9
Publishing Point
Discovery

PP Name

PP Path

PP Type
Windows Media
Services 9 Publishing
Point (On Demand)
Yes
Windows Media Server 9
Publishing Point
Discovery

PP Name

PP Path

PP Type
Windows Media Services Management Pack Guide
b
8/24
3.3
Monitors
The management pack defines a series of monitors that keep track of the health of the objects discovered
and generate alerts. These are targeted against different object types.
3.3.1
Windows Media Services 9 Server Role monitors
A total of eight monitors are targeted against the Windows Media Services 9 Server Role. Where feasible,
recovery tasks are included to support troubleshooting an erroneous state.
Simplified Health Explorer screen shot:
Windows Media Services Management Pack Guide
b
9/24
3.3.1.1 Allow Client Connection Status
Windows Media Services can be set to deny new clients to connect to the server. Before performing
maintenance, this can be used to drain out connections to the server. Under normal circumstances a WMS
server denying new connections is considered a warning condition.
Severity
Alert Name
Possible
Diagnostic
Overrides
and Recovery
Implementation Details
Tasks
Warning
Windows Media Server
does not allow client
connections
Only
standard
Allow new
client
connections
checking COM object
WMSServer.server
every minute
3.3.1.2 Error Status
Windows Media Services may report an error state condition. This monitor checks if that is the case.
Severity
Alert Name
Possible
Diagnostic
Overrides
and Recovery
Implementation Details
Tasks
Warning
Windows Media Server
has a critical error
Only
standard
none
checking COM object
WMSServer.server
every minute
Windows Media Services Management Pack Guide
b
10/24
3.3.1.3 Publishing Point Availability
This is a Dependency Rollup monitor, mapping the health of individual Publishing Points hosted by this
server to the WMS server role.
Rollup Policy
Alert settings
Worst of any member
do not generate an alert
3.3.1.4 Windows Service
Checks if the WMS windows service (WMServer) is running.
Severity Alert Name
Possible
Diagnostic
Overrides
and Recovery
Implementation Details
Tasks
Critical
Windows Media Server
Service stopped
Only standard
Start
windows
service
Microsoft.Windows.Check
NTServiceStateMonitorTy
pe
3.3.1.5 Data Source Bottleneck
Threshold type monitor targeting at the performance counter Windows Media Services\Current Late Read
Rate. This counter should not be higher than zero over an extended period of time. If it does it indicates that
WMS server is not able to read from its data sources fast enough.
Severity
Alert Name
Possible
Diagnostic
Overrides
and
Implementation Details
Recovery
Tasks
Warning
Windows Media Server
data source bottleneck
Only standard
Windows Media Services Management Pack Guide
none
Consecutive Samples over
Threshold monitor

Sample Interval: 5 min

Threshold: > 0

N° of samples: 3
b
11/24
3.3.1.6 Memory Usage
Combined performance counter threshold. It looks at how much of the physical memory of the server is used
by the WMS service. If the WMServer process uses too much, the overall performance of the WMS server will
suffer. If the WMS server is mainly used for publishing broadcast media, the threshold should be set to 70%.
For an on-demand scenario, WMServer should not use more than 50% of the server’s physical memory.
Severity
Alert Name
Possible
Diagnostic
Overrides
and
Implementation Details
Recovery
Tasks
Warning
Windows Media Server
doesn't have enough
free memory
Standard
none
Threshold
Consecutive Samples over
Threshold monitor
Frequency

Sample Interval: 5 min

Threshold: >= 50

N° of samples: 3
The % value is calculated by using
a WMI query for the total physical
memory installed and by querying
Process\Private Bytes\WMServer
3.3.1.7 Stream Data Packet Discards
Threshold type monitor targeting at the performance counter ‘Windows Media Services\Current Stream Error
Rate’. If this value is higher than zero for an extended period of time, it indicates, that the WMS server is
unable to keep up with the demand. It is likely to suffer from late reads as well.
Severity
Alert Name
Possible
Diagnostic
Overrides
and
Implementation Details
Recovery
Tasks
Warning
Windows Media Server
is dropping packets
Only standard
Windows Media Services Management Pack Guide
none
Consecutive Samples over
Threshold monitor

Sample Interval: 5 min

Threshold: > 0

N° of samples: 2
b
12/24
3.3.1.8 Streaming Bandwidth Bottleneck
Threshold type monitor which compares the two performance counters ‘Windows Media Services\Current
Player Allocated Bandwidth (kbps)’ and ‘Windows Media Services\Current Player Send Rate (kbps)’. If the
send rate is dropping below the allocated bandwidth, WMS is unable to service all clients. Usually this
indicates an outbound network bottleneck.
Severity
Alert Name
Possible
Diagnostic
Overrides
and
Implementation Details
Recovery
Tasks
Warning
Windows Media Server
is failing to stream data
fast enough
Only standard
Windows Media Services Management Pack Guide
none
Consecutive Samples over
Threshold monitor

Sample Interval: 5 min

Threshold: > 0

N° of samples: 3
b
13/24
3.3.2
Windows Media Services 9 Publishing Point monitors
Windows Media Services knows different types of Publishing Points. Since their monitoring requirements are
slightly different, three sub object types are defined in management pack. The monitors described here are
targeted at the relevant object types.
Simplified screen shot of the Health Explorer:
3.3.2.1 Allow Client Connection Status
As the WMS server on the whole, a single WMS Publishing Point can set to deny new clients to. Under
normal circumstances a WMS Publishing Point denying connections is considered a warning condition. The
monitor is targeted at the generic object type ‘Windows Media Services 9 Publishing Point’. Hence it is
active for all Publishing Points, regardless of their type.
Severity
Alert Name
Possible
Diagnostic
Overrides
and Recovery
Implementation Details
Tasks
Warning
Windows Media Services
Publishing Point does not
allow client connections
Only
standard
Windows Media Services Management Pack Guide
Allow new
client
connections
checking COM object
WMSServer.server
every 2 minutes
b
14/24
3.3.2.2 Broadcast Status
Broadcast type WMS Publishing Points can be stopped. This is considered a warning condition. The monitor
is targeted only at ‘Windows Media Services 9 Publishing Point (Broadcast)’ object types only.
Severity
Alert Name
Possible
Diagnostic
Implementation Details
Overrides
and Recovery
Tasks
Warning
Windows Media Services
Publishing Point stopped
Only
standard
Start
Broadcast
Publishing
Point
checking COM object
WMSServer.server
every 2 minutes
3.3.2.3 Error Status
A WMS Publishing Point may report an error state. This monitor checks if that is the case. The monitor is
targeted at the generic object type ‘Windows Media Services 9 Publishing Point’. Hence it is active for all
Publishing Points, regardless of their type.
Severity
Alert Name
Possible
Diagnostic
Overrides
and Recovery
Implementation Details
Tasks
Warning
Windows Media Server
has a critical error
Only
standard
Windows Media Services Management Pack Guide
none
checking COM object
WMSServer.server every 2
minutes
b
15/24
3.3.2.4 Source Available (disabled by default)
The monitor is targeted only at ‘Windows Media Services 9 Publishing Point (On Demand)’. It checks the
WMS server’s log file for 404 (file not found) events in the context of the Publishing Point.
This monitor is not enabled by default. Consider it as an example for how to write a monitor which reacts on
events in the WMS server’s log file. If required, it may be enabled for the Publishing Points it is required for
by Overrides.
Severity
Alert Name
Possible
Diagnostic
Overrides
and Recovery
Implementation Details
Tasks
Warning
Windows Media Server
(disabled) Publishing Point source
is not available
Only
standard
Windows Media Services Management Pack Guide
none
Generic CSV log reader

Directory: WMS log
directory according to
discovery

Pattern: WMS_*.log

Separator: “ “ (white space)
b
16/24
3.4
Rules
The Rules defined for the management pack collect performance counters to be used by reports or are used
internally to trigger the monitors described above. The following description only lists the performance
counter collection rules. All of them are targeted at ‘Windows Media Services 9 Publishing Point’ object
type. Currently no performance data is collected on individual Publishing Points.
3.4.1
Performance Data Collection Rules
Rule Name
Performance Counter
Implementation Details
Collect Windows Media
Services\Current Player
Send Rate (Kbps)
Windows Media

Interval: 5 min
Services\Current Player

Optimization Tolerance: 15 %
Collect Process\Private
Bytes % of Physical
Memory\WMServer
Windows Media

Interval: 30 min
Services\Private Bytes % of
The % value is calculated by using a WMI
query for the total physical memory installed
and by querying Process\Private
Send Rate (Kbps)
Physical Memory\WMServer
Bytes\WMServer
Collect Windows Media
Services\Current
Streaming Players
Windows Media Services\

Interval: 5 min
Current Connected Players

Optimization Tolerance: 15 %
Collect Redirector\Bytes
Received/sec
Redirector\Bytes

Interval: 5 min
Received/sec

Optimization Tolerance: 15 %
Collect Windows Media
Services\Current Player
Allocated Bandwidth
(Kbps)
Windows Media Services\

Interval: 5 min
Current Player Allocated

Optimization Tolerance: 15 %
Collect LogicalDisk\Disk
Read Bytes/sec\_Total
LogicalDisk\ Disk Read

Interval: 5 min
Bytes/sec\ _Total

Optimization Tolerance: 15 %
Collect Process\Private
Bytes\WMServer
Process\Private

Interval: 5 min
Bytes\WMServer

Optimization Tolerance: 15 %
Collect Windows Media
Services\Current Late
Read Rate
Windows Media

Interval: 5 min
Services\Current Late Read

Optimization Tolerance: 15 %
Bandwidth (Kbps)
Rate
Windows Media Services Management Pack Guide
b
17/24
Rule Name
Performance Counter
Implementation Details
Collect Windows Media
Services\Current Player
Overallocated Bandwidth
%
Windows Media

Services\Current Player
compares the two performance counters
Overallocated Bandwidth %
Windows Media Services\Current Player
Interval: 5 min
Allocated Bandwidth (kbps)
and Windows
Media Services\Current Player Send Rate
(kbps)
Collect Windows Media
Services\Current File
Read Rate (Kbps)
Windows Media Services\

Interval: 5 min
Current File Read Rate

Optimization Tolerance: 15 %
Collect Windows Media
Services\Current Late
Send Rate
Windows Media Services\

Interval: 5 min
Current Late Send Rate

Optimization Tolerance: 15 %
Collect Windows Media
Services\Current Stream
Error Rate
Windows Media Services\

Interval: 5 min
Current Stream Error Rate

Optimization Tolerance: 15 %
3.4.2
(Kbps)
Delete old WMS log files
The rule ‘Delete old WMS log files’ deletes files found in the log directory of the Windows Media
Server. It is disabled by default. If required, override the rule for the servers you require it running.
Rule Name
Default Settings
Overrides
Delete old WMS log files

Disabled

Enable

Runs every night

File age

Deletes log files (*.log) older than 100
days

Execution time
Windows Media Services Management Pack Guide
b
18/24
3.5
Tasks
Tasks are targeted at object types. Whenever an object of a specific type is selected within the Operations
Manager GUI, the relevant tasks can be executed against that specific object.
Some of these tasks are defined as recoveries. They are available in the context of an alert, the Health
Explorer or the knowledge of a monitor.
3.5.1
Windows Media Services 9 Role Tasks
Four tasks are targeted at WMS Server roles.
Name
Parameters Implementation Details
Allow new client
connections
None
script COM object ‘WMSServer.server’
Deny new client
connections
None
script COM object ‘WMSServer.server’
Start windows service
None
Net start command
Stop windows service
None
Net stop command
Windows Media Services Management Pack Guide
b
19/24
3.5.2
Windows Media Services 9 Publishing Point Tasks
As with the monitors, the tasks targeted at the Publishing Points are also specific to their type.
‘Allow / Deny new client connections’ are available for all publishing point object types.
‘Start / Stop Broadcast Publishing Point’ is only possible for ‘Broadcast’ types.
The built in Cache and Proxy types do not have any tasks configured.
Name
Parameters Implementation Details
Allow new client
connections
None
script COM object ‘WMSServer.server’
Deny new client
connections
None
script COM object ‘WMSServer.server’
Start Broadcast
Publishing Point
None
script COM object ‘WMSServer.server’
Stop Broadcast
Publishing Point
None
script COM object ‘WMSServer.server’
Windows Media Services Management Pack Guide
b
20/24
3.6
Reports
Three reports are included with the Windows Media Services management pack. To successfully execute
them, they must be targeted against ‘Windows Media Services Role’ or ‘Windows Media Services Server
Group’.
Additionally Operations Manager’s standard reports can also be used. Specifically ‘ Alerts’, ‘Availability’
and ‘Health’ will contain valuable information.
Windows Media Services Management Pack Guide
b
21/24
3.6.1.1 WMS Performance Information Reports
Report Name
Description
WMS Bandwidth Performance Analysis
Displays a chart with the following performance items:
WMS Data Source Performance Analysis
WMS Memory Performance Analysis
Windows Media Services Management Pack Guide

Windows Media Services\Current Streaming
Players

Windows Media Services\Current Late Send Rate

Windows Media Services\Current Player Allocated
Bandwidth (kbps)

Windows Media Services\Current Player Send
Rate (kbps)

Windows Media Services\Current Player Over
allocated Bandwidth %
Displays a chart with the following performance items.

Windows Media Services\Current Streaming
Players

Windows Media Services\Current Late Read Rate

Logical Disk\ Disk Read Bytes/sec\_Total

Redirector\Bytes Received/sec
Displays a chart with the following performance items.

Process\Private Bytes % of Physical
Memory\WMServer

Process\Private Bytes\WMServer
b
22/24
4
Using the Management Pack
After importing the management pack, Operations Manager will automatically discover any instances of
Windows Media Services installed. Most monitoring and data collection is going to work automatically.
4.1
Console Views
In Operations Manager’s Console, the monitoring pane contains the following views under ‘ Windows Media
Services’.

Alert View

Performance View

State View
As these are rather basic, consider using ‘My Workspace‘ or adding views to a custom management pack to
get a more customized view especially if you are using a large amount of WMS servers.
Using the ‘Distributed Application Designer’ you can integrate the WMS objects into your custom diagram
view. When adding components to your application, refer to the diagram on page 7 to choose the correct
object types.
Windows Media Services Management Pack Guide
b
23/24
4.2
Configuring Overrides
Overrides are particularly useful to change the behavior of the management pack’s monitors. The following
table contains scenarios and lists which monitors would have to be overridden.
Overrides can be configured for individual servers, groups or all objects of a type.
Note that it is recommended to use a specifically created management pack for your overrides instead of
saving them into ‘Default Management Pack’.
Scenario
Overrides to configure
WMS is mainly used for Change the default threshold of the monitor ‘Memory Usage’ targeted at
broadcast type
‘Windows Media Services 9 Server Role’ from 50% to 70%
publishing point
Exclude publishing
points from monitoring
Disable all or individual of the following monitors:
‘Error Status’ at ‘Windows Media Services 9 Publishing Point’
‘Allow Client Connection Status (Broadcast)’ at ‘Windows Media
Services 9 Publishing Point (Broadcast)’
‘Broadcast Status’ at ‘Windows Media Services 9 Publishing Point
(Broadcast)’
‘Allow Client Connection Status (On Demand)’ at ‘Windows Media
Services 9 Publishing Point (On Demand)’
or disable publishing point discovery rule
‘Windows Media Services 9 Publishing Point Discovery’ at ‘Windows
Media Services 9 Server Role’
Windows Media Services Management Pack Guide
b
24/24
Download