WmiWebEventProvider Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Implementiert einen Ereignisanbieter, der WMI (Windows Management Instrumentation)-Ereignissen ASP.NET-Systemüberwachungsereignisse zuordnet.
public ref class WmiWebEventProvider : System::Web::Management::WebEventProvider
public class WmiWebEventProvider : System.Web.Management.WebEventProvider
type WmiWebEventProvider = class
inherit WebEventProvider
Public Class WmiWebEventProvider
Inherits WebEventProvider
- Vererbung
Beispiele
Im folgenden Beispiel wird gezeigt, wie Sie einen Verbraucher von WMI-Ereignissen erstellen, die von ASP.NET Integritätsüberwachung als Ergebnis von Webanwendungsintegritätsereignissen ausgegeben werden.
Hinweis
Die WmiWebEventProvider zu überwachenden Klassen und die zu überwachenden Integritätsereignistypen sind standardmäßig bereits konfiguriert. Das einzige, was Sie tun müssen, besteht darin, die Regel für alle Integritätsereignisse zu definieren. Denken Sie daran, dass die Integritätsereignisse standardmäßig nicht an den WmiWebEventProvider Anbieter gesendet werden.
using System;
using System.Management;
namespace SamplesAspNet
{
// Capture WMI events associated with
// ASP.NET health monitoring types.
class SampleWmiWebEventListener
{
//Displays event related information.
static void DisplayEventInformation(
ManagementBaseObject ev)
{
// It contains the name of the WMI raised
// event. This is the name of the
// event class as defined in the
// Aspnet.mof file.
string eventTypeName;
// Get the name of the WMI raised event.
eventTypeName = ev.ClassPath.ToString();
// Process the raised event.
switch (eventTypeName)
{
// Process the heartbeat event.
case "HeartBeatEvent":
Console.WriteLine("HeartBeat");
Console.WriteLine("\tProcess: {0}",
ev["ProcessName"]);
Console.WriteLine("\tApp: {0}",
ev["ApplicationUrl"]);
Console.WriteLine("\tWorkingSet: {0}",
ev["WorkingSet"]);
Console.WriteLine("\tThreads: {0}",
ev["ThreadCount"]);
Console.WriteLine("\tManagedHeap: {0}",
ev["ManagedHeapSize"]);
Console.WriteLine("\tAppDomainCount: {0}",
ev["AppDomainCount"]);
break;
// Process the request error event.
case "RequestErrorEvent":
Console.WriteLine("Error");
Console.WriteLine("Url: {0}",
ev["RequestUrl"]);
Console.WriteLine("Path: {0}",
ev["RequestPath"]);
Console.WriteLine("Message: {0}",
ev["EventMessage"]);
Console.WriteLine("Stack: {0}",
ev["StackTrace"]);
Console.WriteLine("UserName: {0}",
ev["UserName"]);
Console.WriteLine("ThreadID: {0}",
ev["ThreadAccountName"]);
break;
// Process the application lifetime event.
case "ApplicationLifetimeEvent":
Console.WriteLine("App Lifetime Event {0}",
ev["EventMessage"]);
break;
// Handle events for which processing is not
// provided.
default:
Console.WriteLine("ASP.NET Event {0}",
ev["EventMessage"]);
break;
}
} // End DisplayEventInformation.
// The main entry point for the application.
static void Main(string[] args)
{
// Get the name of the computer on
// which this program runs.
// Note. The monitored application must also run
// on this computer.
string machine = Environment.MachineName;
// Define the Common Information Model (CIM) path
// for WIM monitoring.
string path = String.Format("\\\\{0}\\root\\aspnet",
machine);
// Create a managed object watcher as
// defined in System.Management.
string query = "select * from BaseEvent";
ManagementEventWatcher watcher =
new ManagementEventWatcher(query);
// Set the watcher options.
TimeSpan timeInterval = new TimeSpan(0, 1, 30);
watcher.Options =
new EventWatcherOptions(null,
timeInterval, 1);
// Set the scope of the WMI events to
// watch to be ASP.NET applications.
watcher.Scope =
new ManagementScope(new ManagementPath(path));
// Set the console background.
Console.BackgroundColor = ConsoleColor.Blue;
// Set foreground color.
Console.ForegroundColor = ConsoleColor.Yellow;
// Clear the console.
Console.Clear();
// Loop indefinitely to catch the events.
Console.WriteLine(
"Listener started. Enter CntlC to terminate");
while (true)
{
try
{
// Capture the WMI event related to
// the Web event.
ManagementBaseObject ev =
watcher.WaitForNextEvent();
// Display the Web event information.
DisplayEventInformation(ev);
// Prompt the user.
Console.Beep();
}
catch (Exception e)
{
Console.WriteLine("Error: {0}", e);
break;
}
}
}
}
}
Imports System.Management
' Capture WMI events associated with
' ASP.NET health monitoring types.
Class SampleWmiWebEventListener
'Displays event related information.
Shared Sub DisplayEventInformation(ByVal ev _
As ManagementBaseObject)
' It contains the name of the WMI raised
' event. This is the name of the
' event class as defined in the
' Aspnet.mof file.
Dim eventTypeName As String
' Get the name of the WMI raised event.
eventTypeName = ev.ClassPath.ToString()
' Process the raised event.
Select Case eventTypeName
' Process the heartbeat event.
Case "HeartBeatEvent"
Console.WriteLine("HeartBeat")
Console.WriteLine(vbTab + _
"Process: {0}", ev("ProcessName"))
Console.WriteLine(vbTab + "App: {0}", _
ev("ApplicationUrl"))
Console.WriteLine(vbTab + "WorkingSet: {0}", _
ev("WorkingSet"))
Console.WriteLine(vbTab + "Threads: {0}", _
ev("ThreadCount"))
Console.WriteLine(vbTab + "ManagedHeap: {0}", _
ev("ManagedHeapSize"))
Console.WriteLine(vbTab + "AppDomainCount: {0}", _
ev("AppDomainCount"))
' Process the request error event.
Case "RequestErrorEvent"
Console.WriteLine("Error")
Console.WriteLine("Url: {0}", _
ev("RequestUrl"))
Console.WriteLine("Path: {0}", _
ev("RequestPath"))
Console.WriteLine("Message: {0}", _
ev("EventMessage"))
Console.WriteLine("Stack: {0}", _
ev("StackTrace"))
Console.WriteLine("UserName: {0}", _
ev("UserName"))
Console.WriteLine("ThreadID: {0}", _
ev("ThreadAccountName"))
' Process the application lifetime event.
Case "ApplicationLifetimeEvent"
Console.WriteLine("App Lifetime Event {0}", _
ev("EventMessage"))
' Handle events for which processing is not
' provided.
Case Else
Console.WriteLine("ASP.NET Event {0}", _
ev("EventMessage"))
End Select
End Sub
' End DisplayEventInformation.
' The main entry point for the application.
Shared Sub Main(ByVal args() As String)
' Get the name of the computer on
' which this program runs.
' Note. The monitored application must also run
' on this computer.
Dim machine As String = Environment.MachineName
' Define the Common Information Model (CIM) path
' for WIM monitoring.
Dim path As String = _
String.Format("\\{0}\root\aspnet", machine)
' Create a managed object watcher as
' defined in System.Management.
Dim query As String = "select * from BaseEvent"
Dim watcher As New ManagementEventWatcher(query)
' Set the watcher options.
Dim timeInterval As New TimeSpan(0, 1, 30)
watcher.Options = _
New EventWatcherOptions(Nothing, timeInterval, 1)
' Set the scope of the WMI events to
' watch to be ASP.NET applications.
watcher.Scope = _
New ManagementScope(New ManagementPath(path))
' Set the console background.
Console.BackgroundColor = ConsoleColor.Blue
' Set foreground color.
Console.ForegroundColor = ConsoleColor.Yellow
' Clear the console.
Console.Clear()
' Loop indefinitely to catch the events.
Console.WriteLine( _
"Listener started. Enter CntlC to terminate")
While True
Try
' Capture the WMI event related to
' the Web event.
Dim ev As ManagementBaseObject = _
watcher.WaitForNextEvent()
' Display the Web event information.
DisplayEventInformation(ev)
' Prompt the user.
Console.Beep()
Catch e As Exception
Console.WriteLine("Error: {0}", e)
Exit While
End Try
End While
End Sub
End Class
Im folgenden Beispiel handelt es sich um einen Konfigurationsdateiauszug, der einen <healthMonitoring>
Konfigurationsabschnitt zeigt, mit dem ASP.NET den Anbieter verwenden WmiWebEventProvider kann, um alle Integritätsüberwachungsereignisse zu verarbeiten.
<healthMonitoring>
<rules>
<add
name="Using Wmi"
eventName="All Events"
provider="WmiWebEventProvider"
profile="Critical"/>
</rules>
</healthMonitoring>
Hinweise
ASP.NET Integritätsüberwachung ermöglicht Es Produktions- und Betriebsmitarbeitern, bereitgestellte Webanwendungen zu verwalten. Der System.Web.Management Namespace enthält die Integritätsereignistypen, die für das Verpacken von Anwendungsstatusdaten und den Anbietertypen, die für die Verarbeitung dieser Daten verantwortlich sind. Es enthält auch unterstützende Typen, die während der Verwaltung von Integritätsereignissen helfen.
ASP.NET verwendet diese Klasse zum Zuordnen von Integritätsüberwachungsereignissen zu WMI-Ereignissen. Um die Übermittlung von ASP.NET Integritätsüberwachungsereignissen an das WMI-Subsystem zu aktivieren, müssen Sie die WmiWebEventProvider Klasse konfigurieren, indem Sie die entsprechenden Einstellungen im <healthMonitoring>
Abschnitt der Konfigurationsdatei hinzufügen.
Die in der Aspnet.mof-Datei enthaltenen Informationen beschreiben die Parameter der WMI-Ereignisse, die ausgelöst werden, wenn ASP.NET Integritätsüberwachungsereignisse an die WmiWebEventProvider Klasse weitergeleitet und in WMI-Ereignisse zugeordnet werden. Die Aspnet.mof-Datei wird im .NET Framework Buildverzeichnis gespeichert, z. B. %windir%\Microsoft.NET*FrameworkBuildNumber*\. Weitere Informationen zum Melden von Integritätsüberwachungsereignissen als WMI-Ereignisse finden Sie unter Verwenden von WMI zum Bereitstellen von ASP.NET Integritätsüberwachungsereignissen.
Hinweis
In den meisten Fällen können Sie die ASP.NET Integritätsüberwachungstypen wie implementiert verwenden und das Integritätsüberwachungssystem steuern, indem Sie Werte im <healthMonitoring>
Konfigurationsabschnitt angeben. Sie können auch von den Integritätsüberwachungstypen abgeleitet werden, um eigene benutzerdefinierte Ereignisse und Anbieter zu erstellen. Ein Beispiel für das Erstellen eines benutzerdefinierten Anbieters finden Sie in der Vorgehensweise: Implementieren des Benutzerdefinierten Anbieterbeispiels für die Integritätsüberwachung.
Konstruktoren
WmiWebEventProvider() |
Initialisiert eine neue Instanz der WmiWebEventProvider-Klasse. |
Eigenschaften
Description |
Ruft eine kurze, benutzerfreundliche Beschreibung ab, die für die Anzeige in Verwaltungstools oder anderen Benutzeroberflächen geeignet ist. (Geerbt von ProviderBase) |
Name |
Ruft den Anzeigennamen ab, der verwendet wird, um während der Konfiguration auf den Anbieter zu verweisen. (Geerbt von ProviderBase) |
Methoden
Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
Flush() |
Entfernt alle Ereignisse aus dem Puffer des Anbieters. |
GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
Initialize(String, NameValueCollection) |
Legt die Anfangswerte für dieses Objekt fest. |
MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
ProcessEvent(WebBaseEvent) |
Verarbeitet das an den Anbieter übergebene Ereignis. |
Shutdown() |
Führt mit dem Beenden des Anbieters verbundene Aufgaben aus. |
ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |