Sie sind hier: Startseite
 Liste aller Codebeispiele

Ereignisabfrage für Dienste

Ein Beispiel zum Einsatz der Klasse System.Management.EventQuery, ManagementEventWatcher aus der .NET-Klassenbibliothek.

Autor: Dr. Holger Schwichtenberg

Beschreibung

Eine Ereignisabfrage (Event Query) unterscheidet sich von einer Datenabfrage dadurch, dass sie nicht sofort ein Ergebnis liefert, sondern Veränderungen an WMI-Objekten durch Ereignisse zurückmeldet.

Aufbau einer Ereignisabfrage
Eine WMI-Ereignisabfrage bezieht sich immer auf einen WMI-Ereignistyp. Mit der WHERE-Klausel werden das zu beobachtende WMI-Objekt und die in dem Objekt zu beobachtenden Attribute definiert.

SELECT * FROM eventklasse WHERE bedingung

Ereignisabfragen unterstützen als zusätzliche SQL-Schlüsselwörter WITHIN, GROUP BY und HAVING:
  • Dabei gibt WITHIN 10 das Polling-Intervall in Sekunden an.
  • GROUP bündelt eine Anzahl von Einzelereignissen zu einem Gesamtereignis.
  • HAVING dient der Definition einer Bedingung innerhalb der Gruppierung.

Bitte beachten Sie, dass das Ereignis InstanceModificationEvent wirklich nur ausgeführt wird, wenn sich ein Attributwert ändert. Wenn Sie beispielsweise die Prozessorlast auf die Überschreitung der 80%-Grenze prüfen, dann bekommen Sie ein Ereignis beim Überschreiten der Grenze. Wenn danach der Wert konstant bei 100% liegt, bekommen Sie keine weiteren Ereignisse. Sie erhalten erst wieder ein Ereignis, wenn der Wert sich nochmals ändert (z.B. von 100% auf 99%).

Beispiele für Ereignisabfragen
Die folgende Tabelle zeigt Beispiele für WMI-Ereignisabfragen.
WQL Erläuterung
SELECT * FROM _InstanceModificationEvent WITHIN 5 WHERE TargetInstance ISA "Win32Service" AND TargetInstance.State="Stopped" Alle fünf Sekunden wird geprüft, ob ein Dienst den Status Stopped bekommen hat.
SELECT FROM EmailEvent GROUP
WITHIN 600
HAVING NumberOfEvents > 5 Wenn innerhalb von zehn Minuten mehr als fünf E-Mail-Ereignisse auftreten, wird dieses Ereignis ausgelöst.
SELECT * FROM _InstanceCreationEvent WHERE TargetInstance ISA "Win32NTLogEvent" AND TargetInstance.Logfile="Application" OR TargetInstance.Logfile="System"
Jeder neue Eintrag in den Ereignisprotokollen System und Application löst ein Event aus.

Ausführung einer WMI-Ereignisabfrage in .NET
Da die Ergebnisse als Ereignisse eintreffen, unterscheidet sich die Ausführung einer Ereignisabfrage natürlich von der Ausführung einer Datenabfrage.

Die Verwendung einer Ereignisabfrage sieht so aus:
  • Zunächst wird ein EventQuery-Objekt erzeugt.

Dim eq As New EventQuery(ABFRAGE)
  • Zusätzlich wird ein EventWatcher benötigt, den das EventQuery-Objekt verwendet.

Dim watcher As New ManagementEventWatcher(eq)
  • Der EventWatcher bietet ein Ereignis EventArrived(), das an eine Ereignisbehandlungsroutine gebunden werden muss.

AddHandler watcher.EventArrived, AddressOf EreignisBehandlung
  • Dann wird der EventWatcher gestartet.

watcher.Start()
  • Während das Hauptprogramm wartet, ruft der EventWatcher die entsprechende Ereignisbehandlungsroutine unter Angabe der Ereignisdaten auf.

Public Sub EreignisBehandlung(ByVal sender As Object, ByVal e As EventArrivedEventArgs)

Beispiel
Im folgenden Listing werden Zustandsänderungen in den Windows-Diensten überwacht.

Programmcodebeispiele Visual Basic .NET (VB.NET)

' ============================
' .NET-Code-Beispiel in Visual Basic .NET
' Ereignisabfrage für Dienste
' (C) Holger@Schwichtenberg.de
' ============================
Sub wmi_ereignisabfrage()

Const ABFRAGE = "SELECT * FROM _InstanceModificationEvent WITHIN 1 WHERE TargetInstance ISA 'Win32Service'"

' --- Abfrage definieren
Dim eq As New EventQuery(ABFRAGE)
' --- Überwachung definieren
Dim watcher As New ManagementEventWatcher(eq)
' --- Ereignisbehandlungsroutine festlegen

AddHandler watcher.EventArrived, _
AddressOf EreignisBehandlung
' --- Überwachung starten
watcher.Start()

MsgBox("Klicken Sie hier, um Überwachung zu beenden!")

watcher.Stop()

End Sub

Public Sub EreignisBehandlung(ByVal sender As Object, ByVal e As EventArrivedEventArgs)
Dim mo As ManagementBaseObject
Dim p As PropertyData
Dim wert As Object
mo = e.NewEvent

out("Veränderung in Dienst: " & mo.ClassPath.Path)
For Each p In mo.Properties
wert = p.Value
If Not wert Is Nothing Then
out(p.Name & "=" & wert.ToString())
Else
out(p.Name & "= (nicht belegt)")
End If
Next

End Sub

Programmcodebeispiele CSharp (C#)

using System;
using System.Management;
using System.Windows.Forms;

using FCL_Buch;

namespace FCLBuch._SystemManagement {

public class SamplesWMIAbfragen {
public void WMI_Ereignisabfrage() {

// Ereignisabfrage für Dienste
string abfrage = "SELECT * FROM _InstanceModificationEvent WITHIN 1 WHERE TargetInstance ISA 'Win32Service'";

// Abfrage definieren
EventQuery eq = new EventQuery(abfrage);
// Überwachung definieren
ManagementEventWatcher watcher = new ManagementEventWatcher(eq);
// Ereignisbehandlungsroutine festlegen

watcher.EventArrived += new EventArrivedEventHandler(watcher_EventArrived);
// Überwachung starten
watcher.Start();

MessageBox.Show("Klicken Sie hier, um die Überwachung zu beenden!");

watcher.Stop();

}
}
}

Hinweise

Ausgaben werden in den Beispielen durch Hilfsroutinen wie out() und PrintOut() erzeugt. Diese sind hier nicht angegeben, da deren Implementierung von der jeweiligen Umgebung abhängt. Für Konsolenanwendungen können hier z.B. Console.WriteLine() einsetzen.


 

Querverweise

 Definition '.NET Framework Class Library'  Verfügbarkeit der Klasse 'System.Management.EventQuery, ManagementEventWatcher'  Übersicht über den FCL-Namensraum 'System.Management'  .NET & Visual Studio Community Portal

Buchtipp

Beratung & Support:

Schulungen zu diesem Thema:

 Visual Basic .NET - Aufbauwissen
 Grundlagen der objektorientierten Programmierung anhand von C# oder Visual Basic .NET
 Unit Testing / Testgetriebene Entwicklung / Test Driven Development (TDD) von .NET-Anwendungen (C#/Visual Basic .NET)
 Visual Basic 6.0 (VB6.0)
 Objektorientierte Entwurfsmuster (Design Pattern) mit .NET (C#, Visual Basic .NET, C++/CLI)
 Visual Basic .NET - Basiswissen
 Windows Modern Apps/Windows Universal Apps entwickeln mit der Windows Runtime (WinRT), XAML und .NET/C#/Visual Basic
 Visual Basic Script (VBScript/VBS) - Sprachsyntax und Praxiseinsatz
 Word-Programmierung mit Visual Basic for Applications (VBA)
 Visual Studio Tools for Microsoft Office (VSTO) - Microsoft Office-Programmierung mit .NET und C# oder Visual Basic in Visual Studio
 Parallelprogrammierung mit .NET (Multi-Threading/Multi-Tasking) - mit C#/Visual Basic und/oder C++
 C# für Umsteiger von Visual Basic .NET
 Objektorientierte Programmierung (OOP) mit C#, Java, C++, Visual Basic.NET o.ä.
 Visual Basic .NET für Umsteiger von VBA/VB 4/5/6
 Visual Basic 2005 (Visual Basic 8.0)
 C# für Umsteiger von klassischem Visual Basic/COM
 Das Component Object Model - für Script- und Visual Basic-Entwickler
 .NET Micro Framework - Embedded-Entwicklung mit .NET/C# oder C++
 .NET-Akademie: .NET-/.NET Core-/C#-Basisseminar: Softwarearchitektur, Techniken, Pattern, Best Practices (2-Tages-Agenda des öffentlichen Seminars)
 Neuerungen in C# 5.0
 Windows 8/Windows 8.1 für Entwickler: Programmierung mit der Windows Runtime (WinRT) - Erstellen von Windows Apps mit C#/XAML und/oder JavaScript/HTML
 Neuerungen in C# 7.0/7.1/7.2/7.3
 .NET und C# für Umsteiger von Java
 .NET Akademie: Xamarin: .NET-/C#-Cross-Plattform-Entwicklung für iOS (iPhone, iPad) und Android sowie Windows Phone (3-Tages-Agenda des öffentlichen Seminars)
 Task Parallel Library (TPL) - Parallelprogrammierung/Multi-Threading in .NET/C#
 Neuerung in der CLR 2.0 und C# 2005
 Neuerungen in C# 4.0 (Visual C# 2010)
 Xamarin: .NET-/C#-Cross-Plattform-Entwicklung für iOS (iPhone, iPad) und Android sowie Windows/Windows Phone
 C#-Basiswissen (Grundlagen der Programmiersprache C#)
 ASP.NET Blazor - browserunabhängige Single Page WebApplications (SPA) mit C# und WebAssembly (WASM)
 Anfrage für eine individuelle Schulung zum Thema Visual Basic;C#  Gesamter Schulungsthemenkatalog

Bücher zu diesem Thema:

 Windows Scripting (5. Auflage)
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.1 (PDF)
 C# 7.3 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin (PDF)
 C# 8.0 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin (DRUCK)
 Windows Scripting Lernen 5. Auflage
 ASP.NET Core Blazor 3.0/3.1: Blazor Server und Blazor Webassembly - Moderne Single-Page-Web-Applications mit .NET, C# und Visual Studio (DRUCK)
 Microsoft ASP.NET 2.0 mit C# 2005 - Das Entwicklerbuch
 Essential PowerShell
 Moderne Datenzugriffslösungen mit Entity Framework 6 (EBOOK - PDF, MOBI, EPUB)
 Moderne Datenzugriffslösungen mit Entity Framework Core 5.0 (Buchversion 9.x, DRUCK)
 Microsoft ASP.NET 4.5 mit C# 2012 - Entwicklerbuch
 Datenbankprogrammierung mit .NET 4.0. Mit Visual Studio 2010 und SQL Server 2008 R2
 Moderne Datenzugriffslösungen mit Entity Framework 6 (gedruckte Ausgabe)
 Effizienter Datenzugriff mit Entity Framework Core: Datenbankprogrammierung mit C# für .NET Framework, .NET Core und Xamarin
 Microsoft ASP.NET 3.5 mit Visual Basic 2008 - Das Entwicklerbuch
 Moderne Datenzugriffslösungen mit Entity Framework Core 5.0 (Buchversion 9.x, PDF)
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.1 und 2.0-Preview2 (Buchversion 1.4)
 Moderne Datenzugriffslösungen mit Entity Framework Core 3.1 (Buchversion 8.x, DRUCK)
 ASP.NET Core Blazor 3.1/3.2: Blazor Server und Blazor Webassembly - Moderne Single-Page-Web-Applications mit .NET, C# und Visual Studio (Kindle)
 ASP.NET 4.0
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.1.2 und 2.0-Preview2: Datenbankprogrammierung mit .NET/.NET Core und C# (PDF)
 Webanwendungen mit ASP.NET 3.5 und AJAX Crashkurs
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.x und 2.0: Datenbankprogrammierung mit .NET/.NET Core und C# (EBOOK - PDF)
 Windows Scripting Lernen, 6. Auflage
 ASP.NET Core Blazor 3.1/3.2: Blazor Server und Blazor Webassembly - Moderne Single-Page-Web-Applications (PDF) mit .NET, C# und Visual Studio (PDF)
 C# 7.2 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin (PDF)
 Windows Scripting Lernen, 2. Auflage
 Moderne Datenzugriffslösungen mit Entity Framework Core 3.0 (Buchversion 6.x, Kindle)
 Microsoft ASP.NET 3.5 mit Visual C# 2008 - Das Entwicklerbuch
 Moderne Datenzugriffslösungen mit Entity Framework Core 2.0 (Buchversion 4.x): Datenbankprogrammierung mit .NET/.NET Core und C# (EBOOK - PDF)
 Microsoft .NET 4.5 Update - Crashkurs (EBOOK - PDF)
 Einblicke in C# 6.0 (shortcuts 181) Kindle Edition
 C# 8.0 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin (Kindle)
 Microsoft Visual C# 2010
 Moderne Datenzugriffslösungen mit Entity Framework Core 3.0 (Buchversion 7.x, PDF)
 Office 2010 Programmierung mit VSTO und .NET 4.0: Word, Excel und Outlook erweitern und anpassen
 Microsoft ASP.NET 2.0 mit Visual Basic 2005 - Das Entwicklerbuch
 C# 7.3 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin (DRUCK)
 Windows PowerShell - Konzepte, Praxiseinsatz, Erweiterungen
 Moderne Datenzugriffslösungen mit Entity Framework Core 3.1 (Buchversion 8.x, PDF)
 Moderne Datenzugriffslösungen mit Entity Framework 6 (Kindle)
 ASP.NET Core Blazor 3.0/3.1: Blazor Server und Blazor Webassembly - Moderne Single-Page-Web-Applications mit .NET, C# und Visual Studio (Kindle)
 Visual Basic 2010: Grundlagen, ADO.NET, Windows Presentation Foundation
 Moderne Datenzugriffslösungen mit Entity Framework Core 5.0 (Buchversion 9.x, Kindle)
 Microsoft ASP.NET 4.0 mit C# 2010
 Microsoft .NET 4.5 Update - Crashkurs
 Moderne Datenzugriffslösungen mit Entity Framework Core 3.1 (Buchversion 8.x, Kindle)
 .NET 3.5
 ASP.NET Core Blazor 3.1/3.2: Blazor Server und Blazor Webassembly - Moderne Single-Page-Web-Applications (DRUCK) mit .NET, C# und Visual Studio (Druck)
 ASP.NET 4.0 mit Visual C# 2010
 Moderne Webanwendungen für .NET-Entwickler: Server-Anwendungen, Web APIs, SPAs & HTML-Cross-Platform-Anwendungen mit ASP.NET, ASP.NET Core, JavaScript/TypeScript und Angular
 Windows 8 Apps entwickeln mit C# und XAML - Crashkurs
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.1.1 und 2.0-Preview2: Datenbankprogrammierung mit .NET/.NET Core und C# (gedruckte Ausgabe)
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.1: Datenbankprogrammierung mit .NET/.NET Core und C# (gedruckte Ausgabe)
 C# 7.3 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin (Kindle)
 Microsoft SQL Server 2008 R2 - Das Entwicklerbuch
 .NET 3.5 Crashkurs
 Modern Data Access with Entity Framework Core: Database Programming Using .NET, .NET Core, UWP, and Xamarin with C#
 Microsoft .NET 2.0 Crashkurs - Final Edition
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.x und 2.0: Datenbankprogrammierung mit .NET/.NET Core und C# (gedruckte Ausgabe)
 Visual Basic 2010
 ASP.NET Core Blazor 3.0/3.1: Blazor Server und Blazor Webassembly - Moderne Single-Page-Web-Applications mit .NET, C# und Visual Studio (PDF)
 Moderne Datenzugriffslösungen mit Entity Framework Core 2.0/2.1 (Buchversion 5.x, Ebook PDF)
 Docker und die Containerwelt - Einstieg und Expertentipps rund um Docker-Container (shortcut)
 C# 8.0 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin (PDF)
 Datenbankprogrammierung mit .NET 4.5. Mit Visual Studio 2012 und SQL Server 2012
 Moderne Datenzugriffslösungen mit Entity Framework Core 3.0 (Buchversion 6.x, Gedruckt)
 .NET 4.0 Crashkurs
 Moderne Datenzugriffslösungen mit Entity Framework Core 2.0 (Buchversion 4.x): Datenbankprogrammierung mit .NET/.NET Core und C# (gedruckte Ausgabe)
 Alle unsere aktuellen Fachbücher