Microsoft.SystemCenter.WebApplication.UrlProbe

Artikel
10/01/2024

Das Testmodul Microsoft.SystemCenter.WebApplication.UrlProbe stellt eine Verbindung mit einer oder mehreren URLs her und gibt Microsoft.SystemCenter.WebApplication.WebApplicationData zurück. Diese Daten können dann mit anderen Modulen aus dem Microsoft.SystemCenter.WebApplication.Library verwendet werden, um den Integritätszustand verschiedener Aspekte der Zielwebsite auszuwerten.

Verbrauch

Die primäre Funktion von Microsoft.SystemCenter.WebApplication.UrlProbe besteht darin, eine Anforderung an eine oder mehrere URLs zu senden und die Ergebnisse zu melden. Das Format der Anforderung ist ein komplexer Typ und wird mit anderen Modulen verwendet, um den Integritätszustand der Ziel-URL auszuwerten. Da eine große Anzahl von Anforderungen mit einem einzigen Test durchgeführt werden kann und die Ergebnisse der Anforderung eine große Menge an Daten enthalten können, führt der Test selbst eine Auswertung der Anforderung durch, bevor die Ausgabe erstellt wird. Anstatt z. B. nur den Statuscode aus der abgefragten URL als Ausgabe bereitzustellen, vergleicht das Modul den Statuscode mit einem angegebenen Bereich und stellt als Ausgabe einen Erfolgs- oder Fehlercode bereit. Das Modul kann auch den Inhalt des HTML-Codes abgleichen, der von der Anforderung zurückgegeben wird, z. B. das Wort „Fehler“ abgleichen, um festzustellen, ob eine Fehlerseite zurückgegeben wurde. Diese vom Modul durchgeführte Auswertung macht eine komplexe Logik zum Abgleich von Ausdrücken in Ihrer Regel oder Ihrer Überwachung überflüssig.

Dieses Modul wird häufig mithilfe von Microsoft.SystemCenter.WebApplication.PerProbe.Scheduler ausgelöst.

Das Modul Microsoft.SystemCenter.WebApplication.UrlProbe wird häufig mit einer Reihe von Bedingungserkennungsmodulen verwendet, die die Ausgabe auswerten sollen. Das Modul bewertet verschiedene Aspekte der Integrität der URL basierend auf Parametern, die in der Anforderung definiert sind, und gibt für jeden die entsprechende Ausgabe zurück.

Einige dieser Parameter werden direkt in einen Integritätszustand ausgewertet. Für diese Parameter würden Sie drei Bedingungserkennungsmodule verwenden, die jeweils mit einer bestimmten ganzzahligen Ausgabe des Tests übereinstimmen, die einen bestimmten Integritätszustand angibt, wie in der folgenden Tabelle gezeigt:

Bedingungserkennungsmodul	Übereinstimmender Wert
Microsoft.SystemCenter.WebApplication.OKCriteriaMatch	1
Microsoft.SystemCenter.WebApplication.WarningCriteriaMatch	2
Microsoft.SystemCenter.WebApplication.ErrorCriteriaMatch	3

Andere Parameter geben einen binären Status zurück. In diesen Fällen werden zwei Bedingungserkennungsmodule verwendet, die jeweils mit einem booleschen Typ des Testes übereinstimmen, wie in der folgenden Tabelle dargestellt:

Bedingungserkennungsmodul	Übereinstimmender Wert
Microsoft.SystemCenter.WebApplication.Boolean.CriteriaDoesNotMatch	false
Microsoft.SystemCenter.WebApplication.Boolean.CriteriaMatch	true

Schließlich werden einige Rohwerte zurückgegeben, die Sie entweder für Analysen und Berichte sammeln oder mit Ausdrucksfilter-Bedingungserkennungsmodulen verwenden können.

Typdefinition

<ProbeActionModuleType ID="Microsoft.SystemCenter.WebApplication.UrlProbe" Accessibility="Public" Batching="false" PassThrough="false">
   <Configuration>
      <IncludeSchemaTypes>
         <SchemaType>Microsoft.SystemCenter.WebApplication.WebModulesSchema</SchemaType>
      </IncludeSchemaTypes>
      <xsd:element name="Proxy" type="xsd:string" xmlns:xsd="http://www.w3.org/2001/XMLSchema" />
      <xsd:element name="ProxyUserName" type="xsd:string" xmlns:xsd="http://www.w3.org/2001/XMLSchema" />
      <xsd:element name="ProxyPassword" type="xsd:string" xmlns:xsd="http://www.w3.org/2001/XMLSchema" />
      <xsd:element name="ProxyAuthenticationScheme" type="AuthenticationSchemeType" xmlns:xsd="http://www.w3.org/2001/XMLSchema" />
      <xsd:element name="CredentialUserName" type="xsd:string" xmlns:xsd="http://www.w3.org/2001/XMLSchema" />
      <xsd:element name="CredentialPassword" type="xsd:string" xmlns:xsd="http://www.w3.org/2001/XMLSchema" />
      <xsd:element name="AuthenticationScheme" type="AuthenticationSchemeType" xmlns:xsd="http://www.w3.org/2001/XMLSchema" />
      <xsd:element name="IgnoreServerCertError" type="xsd:boolean"  xmlns:xsd="http://www.w3.org/2001/XMLSchema" />
      <xsd:element name="FollowRedirects" type="xsd:boolean" xmlns:xsd="http://www.w3.org/2001/XMLSchema" />
      <xsd:element name="RetryCount" type="xsd:unsignedInt" xmlns:xsd="http://www.w3.org/2001/XMLSchema" />
      <xsd:element name="RequestTimeout" type="xsd:unsignedInt" xmlns:xsd="http://www.w3.org/2001/XMLSchema" />
      <xsd:element name="Requests" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
         <xsd:complexType>
            <xsd:sequence>
               <xsd:element name="Request" type="RequestType" minOccurs="0" maxOccurs="unbounded" />
            </xsd:sequence>
         </xsd:complexType>
      </xsd:element>
      <xsd:element name="TransactionResponseTimeWarningCriteria" type="RequestEvaluationNumericCriteriaType" minOccurs="0" maxOccurs="1" xmlns:xsd="http://www.w3.org/2001/XMLSchema" />
      <xsd:element name="TransactionResponseTimeErrorCriteria" type="RequestEvaluationNumericCriteriaType" minOccurs="0" maxOccurs="1" xmlns:xsd="http://www.w3.org/2001/XMLSchema" />
      <xsd:element name="PerformanceCollectionFrequencyInCycles" type="xsd:unsignedInt" minOccurs="0" maxOccurs="1" default="1" xmlns:xsd="http://www.w3.org/2001/XMLSchema" />
   </Configuration>
   <OverridableParameters>
      <OverridableParameter ID="Proxy" Selector="$Config/Proxy$" ParameterType="string" />
      <OverridableParameter ID="ProxyUserName" Selector="$Config/ProxyUserName$" ParameterType="string" />
      <OverridableParameter ID="ProxyPassword" Selector="$Config/ProxyPassword$" ParameterType="string" />
      <OverridableParameter ID="ProxyAuthenticationScheme" Selector="$Config/ProxyAuthenticationScheme$" ParameterType="string" />
      <OverridableParameter ID="CredentialUserName" Selector="$Config/CredentialUserName$" ParameterType="string" />
      <OverridableParameter ID="CredentialPassword" Selector="$Config/CredentialPassword$" ParameterType="string" />
      <OverridableParameter ID="AuthenticationScheme" Selector="$Config/AuthenticationScheme$" ParameterType="string" />
      <OverridableParameter ID="IgnoreServerCertError" Selector="$Config/IgnoreServerCertError$"  ParameterType="bool"/>
      <OverridableParameter ID="FollowRedirects" Selector="$Config/FollowRedirects$" ParameterType="bool" />
      <OverridableParameter ID="RetryCount" Selector="$Config/RetryCount$" ParameterType="int" />
      <OverridableParameter ID="RequestTimeout" Selector="$Config/RequestTimeout$" ParameterType="int" />
   </OverridableParameters>
   <ModuleImplementation Isolation="Any">
      <Native>
         <ClassID>92C599FD-6639-4A9F-90DA-E1350162A318</ClassID>
      </Native>
   </ModuleImplementation>
   <OutputType>Microsoft.SystemCenter.WebApplication.WebApplicationData</OutputType>
   <TriggerOnly>true</TriggerOnly>
</ProbeActionModuleType>

Parameter

Das Modul Microsoft.SystemCenter.WebApplication.UrlProbe unterstützt die in der folgenden Tabelle beschriebenen Konfigurationsparameter.

Parameter	Typ	Overrides	Beschreibung
Proxy	Zeichenfolge	True	Erforderlicher Parameter, kann aber leer sein. Gibt den Namen des Proxyservers an, wenn der Agent einen für den Zugriff auf die URL benötigt.
ProxyUserName	Zeichenfolge	True	Erforderlicher Parameter, kann aber leer sein. Gibt den Benutzernamen an, der mit dem Proxyserver verwendet werden soll, wenn der angegebene Proxyserver eine Authentifizierung erfordert.
ProxyPassword	Zeichenfolge	True	Erforderlicher Parameter, kann aber leer sein. Gibt das Kennwort an, das mit dem Proxyserver verwendet werden soll, wenn der angegebene Proxyserver eine Authentifizierung erfordert.
ProxyAuthenticationScheme	AuthenticationSchemeType	True	Erforderlicher Parameter. Gibt das Authentifizierungsschema an, das mit dem Proxyserver verwendet werden soll, wenn der Agent ein solches für den Zugriff auf die URL benötigt. Gültige Werte sind Keine, Basic, NTLM, Digest, und Negotiate.
CredentialUserName	Zeichenfolge	True	Erforderlicher Parameter, kann aber leer sein. Gibt den Benutzernamen an, der mit der abgefragten URL verwendet werden soll.
CredientialPassword	Zeichenfolge	True	Erforderlicher Parameter, kann aber leer sein. Gibt das Kennwort an, das mit der abgefragten URL verwendet werden soll.
AuthenticationScheme	AuthenticationSchemeType	True	Erforderlicher Parameter. Gibt das Authentifizierungsschema an, das mit der abgefragten URL verwendet werden soll. Gültige Werte sind Keine, Basic, NTLM, Digest, und Negotiate.
IgnoreServerCertError	Boolescher Wert	True	Gibt an, ob die Serverzertifikatfehler ignoriert werden sollen.
FollowRedirects	Boolescher Wert	True	Erforderlicher Parameter. Gibt an, ob die Abfrage URL-Umleitungen folgen soll.
RetryCount	Ganzzahl	True	Erforderlicher Parameter. Gibt an, wie oft das Modul die angegebene URL vor dem Timeout wiederholen soll.
RequestTimeout	Ganzzahl	True	Erforderlicher Parameter. Gibt die Dauer des Wartens auf eine Antwort der angegebenen URL vor dem Wiederholen an.
Anforderungen	Komplexer Typ	False	Sammlung von Anforderungs- Elementen (siehe unten).
TransactionResponseTimeWarningCriteria	RequestEvaluationNumericCriteriaType	False	Optionaler Parameter. Gibt die Antwortzeit an, zu der eine Warnung angegeben werden soll.
TransactionResponseTimeErrorCriteria	RequestEvaluationNumericCriteriaType	False	Optionaler Parameter. Gibt die Antwortzeit an, zu der ein Fehler angegeben werden soll.
PerformanceCollectionFrequencyInCycles	Ganzzahl	False	Optionaler Parameter. Gibt an, wie viele Abfrageintervalle vor jeder Auflistung abgeschlossen werden müssen. Wenn der Wert 1 ist, werden die Leistungsindikatoren jedes Mal erfasst, wenn die Browsersitzung ausgeführt wird. Wenn er 2 ist, werden die Leistungsindikatoren nur jedes zweite Mal erfasst, wenn die Browsersitzung ausgeführt wird usw.

Anforderungselement

Das Anforderungs- Element ist eine Sammlung von einem oder mehreren Anforderungs- Elementen. Jedes Anforderungs- Element hat ein RequestID Unterelement, das die Anforderung innerhalb dieser Menge von Anforderungen eindeutig identifiziert. Anforderungen werden in der Reihenfolge ihrer RequestID bearbeitet. Das Element Anforderung besteht aus den folgenden Elementen:

Element	Typ	Beschreibung
RequestID	Ganzzahl	Da jeder Test mehrere Anforderungen initiieren kann, wird mit der RequestID jede Anforderung eindeutig identifiziert, und es wird die Reihenfolge angegeben, in der die Anforderungen verarbeitet werden.
URL	Zeichenfolge	Die URL, die abgefragt werden soll.
Verb	VerbType	Gibt das Verb an, das mit der URL-Anforderung verwendet werden soll. Kann einen der folgenden Werte annehmen: GET, HEAD oder POST.
Version	VersionType	Gibt den HTTP-Typ für die Anforderung an. Gültige Werte sind HTTP/1.0 und HTTP/1.1.
httpHeaders	HttpHeadersType	HTTP-Header in der Anforderung. HttpHeadersType ist ein komplexer Typ mit 0 oder mehr HttpHeader-Elementen, die den Typ NameValueType aufweisen. NameValueType besteht wiederum aus den beiden erforderlichen Elementen Name und Value.
Text	Zeichenfolge	Der Wert ist leer, wenn der VerbType GET oder HEAD ist. Wenn der VerbType POST ist. Dies ist der Textkörper der vom Post übermittelten Anforderung.
CheckContentChange	Boolescher Wert	Bei true wird eine zusätzliche Inhaltsüberprüfung bereitgestellt.
ContentHash	ContentHashType	Besteht aus einer Zeichenfolge von 36 Zeichen, hexadezimal 8-4-4-4-12.
Depth	Ganzzahl	Gibt die Anzahl der Ebenen von externen Links an, die gesammelt werden sollen. Wenn der Wert 0 ist, werden nur die Links auf der Seite selbst ausgewertet. Wenn der Wert 1 ist, werden die Links auf jeder Zielseite ausgewertet. Wenn der Wert 2 ist, werden die Links auf diesen Zielseiten ausgewertet usw.
ThinkTime	Ganzzahl	Der Zeitraum, der zwischen der Anforderung und der Sammlung des Textkörpers gewartet werden muss.
CheckInternalLinks	Boolescher Wert	Ermöglicht die Erfassung des Status jeder internen Verbindung und bezieht interne Verbindungen in die Auswertung des Monitors für die Anforderung ein. Eine interne Verknüpfung ist eine Verknüpfung, die auf eine Stelle auf derselben Seite verweist.
CheckExternalLinks	Boolescher Wert	Ermöglicht die Erfassung des Status der einzelnen externen Verknüpfungen und schließt externe Links in die Auswertung des Monitors für die Anforderung ein. Ein externer Link ist ein Link, der auf eine Stelle außerhalb der aktuellen Seite verweist.
CheckResources	Boolescher Wert	Wenn true, gibt der Monitor den Status der Ressourcen für die Seite zurück. Anstatt jede einzelne Ressource zu messen, wird die Gesamtheit aller Ressourcen bewertet. Wenn false, ist der Ressourcenmonitor für die Anforderung nicht funktionsfähig.
RequestEvaluationCriteria	RequestEvaluationCriteriaType	Ein komplexer Typ, der die von der Anforderung zurückgegebenen Daten auswertet (siehe unten).
FormsAuthCredentials	FormsAuthCredentialsType	Komplexer Typ, der aus den Zeichenfolgen CredentialName, UserName und Password besteht.

RequestEvaluationCriteria-Element

Das RequestEvaluationCriteria-Element bietet die Möglichkeit, die von der Anforderung zurückgegebenen Daten auszuwerten und den Status der URL zu bestimmen. Jedes Element ist ein komplexer Typ, der Kriterien enthält, die auf eine von drei Arten übereinstimmen können:

Numerische Kriterien. Dies ist die gebräuchlichste Methode, um einen messbaren Wert zu bewerten, z. B. einen zurückgegebenen Statuscode oder eine Antwortzeit.
Kriterien für die Übereinstimmung von Inhalten. Dies wird verwendet, um den Inhalt des zurückgegebenen HTML-Codes auszuwerten, um zu bestimmen, ob er eine bestimmte Textzeichenfolge enthält.
Benutzerdefinierte Kriterien. Hierbei handelt es sich um einen Ausdruck, der auf eine Vielzahl von verschiedenen, vom Benutzenden definierten Parametern passt.

Es kann eine beliebige Anzahl numerischer Kriterien oder benutzerdefinierter Kriterien verwendet werden, es ist jedoch nur ein Kriterium für die Übereinstimmung von Inhalten zulässig. Der RequestEvaluationCriteriaType besteht aus den folgenden Elementen:

Element	Typ	Beschreibung
StopProcessingIfWarningCriteriaIsMet	Boolean	Wenn true, wird die Bearbeitung der Anforderung gestoppt, sobald die Warnbedingung erfüllt ist.
StopProcessingIfErrorCriteriaIsMet	Boolean	Wenn true, wird die Bearbeitung der Anforderung gestoppt, sobald die Fehlerbedingung erfüllt ist.
BasePageEvaluationCriteria	Komplexer Typ	Besteht aus den zwei Elementen WarningCriteria und ErrorCriteria, mit denen die Basisseite ausgewertet wird und die beide den Typ BasePageEvaluationCriteriaType aufweisen.
LinksEvaluationCriteria	Komplexer Typ	Besteht aus den zwei Elementen WarningCriteria und ErrorCriteria, mit denen die Links auf der Seite ausgewertet werden und die beide den Typ ChildRequestsEvaluationCriteriaType aufweisen. ChildRequestsEvaluationCriteriaType besteht aus 0 oder mehr NumericCriteriaExpressions-Elementen vom Typ RequestEvaluationNumericCriteriaType, 0 oder einem StatusCodeCriteria-Element vom Typ ListNumericRequestCriteriaType und 0 oder mehr CustomCriteria-Elementen vom Typ ExpressionType.
ResourcesEvaluationCriteria	Komplexer Typ	Besteht aus den zwei Elementen WarningCriteria und ErrorCriteria, mit denen die Ressourcen auf der Seite ausgewertet werden und die beide den Typ ChildRequestsEvaluationCriteriaType aufweisen. ChildRequestsEvaluationCriteriaType besteht aus 0 oder mehr NumericCriteriaExpressions-Elementen vom Typ RequestEvaluationNumericCriteriaType, 0 oder einem StatusCodeCriteria-Element vom Typ ListNumericRequestCriteriaType und 0 oder ein CustomCriteria-Element vom Typ ExpressionType.
WebPageTotalEvaluationCritieria	Komplexer Typ	Besteht aus den zwei Elementen WarningCriteria und ErrorCriteria, die beiden den Typ WebPageTotalEvaluationCriteriaType aufweisen (siehe unten). WebPageTotalEvaluationCriteriaType misst die Gesamtstatistik für die Seite, einschließlich der Basisseite, Links und Ressourcen, und ist vom Typ WebPageTotalEvaluationCriteriaType. WebPageTotalEvaluationCriteriaType besteht ausschließlich aus 0 oder mehr Instanzen von NumericCriteriaExpression mit dem Typ RequestEvaluationNumericCriteriaType, siehe Beschreibung unten.
DepthEvaluationCriteria	Komplexer Typ	Besteht aus den zwei Elementen: WarningCriteria und ErrorCriteria, die beide den Typ DepthEvaluationCriteriaType aufweisen. DepthEvaluationCriteriaType besteht aus 0 oder mehr Instanzen von ListNumericRequestCriteriaType, siehe Beschreibung unten.

Die gebräuchlichste Art der Auswertung ist die numerische, bei der ein Element der zurückgegebenen Daten, z. B. eine Auflösungszeit, mit einem konfigurierten Schwellenwert verglichen wird. NumericCriteriaExpression ist vom Typ RequestEvaluationNumericCriteriaType, der drei Elemente hat: NumericRequestMetric, Operator, und Wert.

NumericRequestMetric ist vom Typ NumericRequestMetricType, der eine Aufzählung ist, die aus einer Reihe von Metriken bestehen kann. Jede Metrik ist einem bestimmten Bewertungskriterium zugeordnet, wie folgt:

Kriterien	Metrik
BasePageData	DNSResolutionTime
	TCPConnectTime
	TimeToFirstByte
	TimeToLastByte
	RedirectTime
	DownloadTime
	TotalResponseTime
	ContentSize
	StatusCode
	DaysToExpiry
LinkData	AggregateDNSResolutionTime
	AggregateTCPConnectTime
	AggregateTimeToFirstByte
	AggregateTimeToLastByte
	AggregateRedirectTime
	AggregateDownloadTime
	AggregateTotalResponseTime
	AggregateContentSize
ResourceData	AggregateDNSResolutionTime
	AggregateTCPConnectTime
	AggregateTimeToFirstByte
	AggregateTimeToLastByte
	AggregateRedirectTime
	AggregateDownloadTime
	AggregateTotalResponseTime
	AggregateContentSize
TotalData	AggregateDNSResolutionTime
	AggregateTCPConnectTime
	AggregateTimeToFirstByte
	AggregateTimeToLastByte
	AggregateRedirectTime
	AggregateDownloadTime
	AggregateTotalResponseTime
	AggregateContentSize
Keine	TransactionResponseTime

Das Element Operator ist vom Typ CriteriaCompareType, der aus einem der folgenden Elemente besteht: Equal, NotEqual, Greater, Less, GreaterEqual, oder LessEqual.

Das Element Wert ist vom Typ doppelt und gibt den Typ des zu vergleichenden Wertes an.

Wenn das zurückgegebene Datenelement, das Sie auswerten möchten, nicht numerisch ist, z. B. eine Inhaltsauswertung, müssen Sie mit einer Zeichenfolge vergleichen. ContentMatchCriteria ist vom Typ RequestEvaluationStringCriteriaType, der zwei Unterelemente hat: Operator und Wert. Der Operator kann einer von zwei Typen sein:

SimpleStringOperator, der vom Typ CriteriaCompareType ist, einer Enumeration bestehend aus Equal, NotEqual, Greater, Less, oder GreaterEqual.
RegExOperator vom Typ RegExCompareType, wobei es sich um einen Enumerationstyp mit den Elementen ContainsSubstring, MatchesWildcard, MatchesRegularExpression, MatchesMOM2005RegularExpression, MatchesMOM2005BooleanRegularExpression, DoesNotContainSubstring, DoesNotMatchWildcard, DoesNotMatchRegularEspression, DoesNotMatchMOM2005RegularExpression oder DoesNotMatchMOM2005BooleanRegularExpression handelt.

Das andere Element von RequestEvaluationStringCriteriaType ist Value, das eine zu vergleichende Zeichenfolge ist.

Das Element CustomCriteria ist vom Typ ExpressionType.

Das StatusCodeCriteria-Element in LinksEvaluationCriteria und ResourcesEvaluationCriteria weist den Typ ListNumericRequestCriteriaType auf ListNumericRequestCriteriaType besteht aus einer Sequenz mit drei Elementen: das Element ListNumericRequestMetric, das nur die Zeichenfolge StatusCode sein kann, das Element Operator, das den Typ CriteriaCompareType aufweist (siehe oben) und das Element Value, das den double-Typ aufweisen muss.

Der Schlüssel zur Erstellung eines nützlichen URL-Tests liegt im Anforderungs-Element und normalerweise im NumericRequestMetric. Wenn Sie wissen, welchen Teil der Webseite Sie auswerten wollen, können Sie die richtige Metrik aus der Enumeration auswählen. Stellen Sie jedoch sicher, dass Sie die richtige Kategorie der Metrik auswählen. Die Metriken für Verknüpfungsdaten, Ressourcendaten und Gesamtdaten sind alle Aggregate und stehen für alle drei Kategorien zur Verfügung. Achten Sie also darauf, dass Sie die richtige Kategorie angeben und im richtigen Teil des Anforderungs-Elements nach ihr fragen.

Wenn Sie nur den Statuscode für einen bestimmten Teil der Seite auswerten möchten (Basisseite, Links), verwenden Sie das StatusCodeCriteria-Element. Dieses sieht wie folgt aus:

<StatusCodeCriteria>
  <ListNumericRequestMetric>StatusCode</ListNumericRequestMetric>
  <Operator>GreaterEqual</Operator>
  <Value>400</Value>
</StatusCodeCriteria>

Dieser StatusCodeCriteria-Abschnitt prüft auf eine erfolgreiche Antwort des Tests (Statuscode größer oder gleich 400).

Zusammensetzung

Das Microsoft.SystemCenter.WebApplication.UrlProbe Modul ist ein natives Modul.

Modultyp	Verwendung
Microsoft.SystemCenter.WebApplication.OKCriteriaMatch	Modul zur Erkennung von Bedingungen, das zur Auswertung verwendet wird, wenn das Datenquellenmodul den Wert 1 (OK) zurückgibt.
Microsoft.SystemCenter.WebApplication.WarningCriteriaMatch	Bedingungserkennungsmodul, das zur Auswertung verwendet wird, wenn das Datenquellenmodul den Wert 1 (Warnung) zurückgibt.
Microsoft.SystemCenter.WebApplication.ErrorCriteriaMatch	Bedingungserkennungsmodul, das verwendet wird, um zu bewerten, wenn das Datenquellenmodul einen Wert von 1 (Fehler) zurückgibt.
Microsoft.SystemCenter.WebApplication.Boolean.CriteriaDoesNotMatch	Das Bedingungserkennungsmodul, das verwendet wird, um auszuwerten, wenn das Datenquellenmodul einen Wert von false zurückgibt.
Microsoft.SystemCenter.WebApplication.Boolean.CriteriaMatch	Modul zur Erkennung von Bedingungen, das zur Auswertung verwendet wird, wenn das Datenquellenmodul den Wert true zurückgibt.

Externe Modulreferenzen

Modultyp	Verwendung
Microsoft.SystemCenter.WebApplication.SingleUrlProbe	Testet eine einzelne URL, um festzustellen, ob der Statuscode anders als 200 ist.

Beispiel

Im folgenden Beispiel wird ein einfacher URL-Prüfpunkt für die URL http://www.microsoft.comausgeführt. Die Datenquelle wertet den für die Basisseite zurückgegebenen Statuscode aus und gibt einen Wert von 3 zurück, wenn der Statuscode größer als 400 ist, was auf einen Fehlerzustand hinweist. Es wertet auch den für die Ressourcen und Links zurückgegebenen Statuscode aus und gibt einen Wert von 2 zurück, wenn der Statuscode größer als 400 ist, was auf einen Warnzustand hinweist.

<TypeDefinitions>
 <ModuleTypes>
   <DataSourceModuleType ID="MPAuthor.WebApplications.UrlDataSource" Accessibility="Public" Batching="false">
     <Configuration />
     <ModuleImplementation Isolation="Any">
       <Composite>
         <MemberModules>
           <DataSource ID="Scheduler" TypeID="MicrosoftSystemCenterWebApplicationLibrary!Microsoft.SystemCenter.WebApplication.PerProbe.Scheduler">
             <Scheduler>
               <SimpleReccuringSchedule>
                 <Interval Unit="Seconds">120</Interval>
                 <SpreadInitializationOverInterval Unit="Seconds">120</SpreadInitializationOverInterval>
               </SimpleReccuringSchedule>
               <ExcludeDates />
             </Scheduler>
             <UniquenessKey>$Target/Id$</UniquenessKey>
           </DataSource>
           <ProbeAction ID="Probe" TypeID="MicrosoftSystemCenterWebApplicationLibrary!Microsoft.SystemCenter.WebApplication.UrlProbe">
             <Proxy />
             <ProxyUserName />
             <ProxyPassword />
             <ProxyAuthenticationScheme>None</ProxyAuthenticationScheme>
             <CredentialUserName />
             <CredentialPassword />
             <AuthenticationScheme>None</AuthenticationScheme>
             <IgnoreServerCertError>false</IgnoreServerCertError>
             <FollowRedirects>true</FollowRedirects>
             <RetryCount>0</RetryCount>
             <RequestTimeout>0</RequestTimeout>
             <Requests>
               <Request>
                 <RequestID>1</RequestID>
                 <URL>http://www.microsoft.com</URL>
                 <Verb>GET</Verb>
                 <Version>HTTP/1.1</Version>
                 <HttpHeaders>
                   <HttpHeader>
                     <Name>User-Agent</Name>
                     <Value>Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1)</Value>
                   </HttpHeader>
                 </HttpHeaders>
                 <Body />
                 <CheckContentChange>false</CheckContentChange>
                 <ContentHash>00000000-0000-0000-0000-000000000000</ContentHash>
                 <Depth>0</Depth>
                 <ThinkTime>0</ThinkTime>
                 <CheckInternalLinks>false</CheckInternalLinks>
                 <CheckExternalLinks>false</CheckExternalLinks>
                 <CheckResources>false</CheckResources>
                 <RequestEvaluationCriteria>
                   <StopProcessingIfWarningCriteriaIsMet>false</StopProcessingIfWarningCriteriaIsMet>
                   <StopProcessingIfErrorCriteriaIsMet>false</StopProcessingIfErrorCriteriaIsMet>
                   <BasePageEvaluationCriteria>
                     <WarningCriteria />
                     <ErrorCriteria>
                       <NumericCriteriaExpressions>
                         <NumericCriteriaExpression>
                           <NumericRequestMetric>BasePageData/StatusCode</NumericRequestMetric>
                           <Operator>GreaterEqual</Operator>
                           <Value>400</Value>
                         </NumericCriteriaExpression>
                       </NumericCriteriaExpressions>
                     </ErrorCriteria>
                   </BasePageEvaluationCriteria>
                   <LinksEvaluationCriteria>
                     <WarningCriteria>
                       <StatusCodeCriteria>
                         <ListNumericRequestMetric>StatusCode</ListNumericRequestMetric>
                         <Operator>GreaterEqual</Operator>
                         <Value>400</Value>
                       </StatusCodeCriteria>
                     </WarningCriteria>
                     <ErrorCriteria />
                   </LinksEvaluationCriteria>
                   <ResourcesEvaluationCriteria>
                     <WarningCriteria>
                       <StatusCodeCriteria>
                         <ListNumericRequestMetric>StatusCode</ListNumericRequestMetric>
                         <Operator>GreaterEqual</Operator>
                         <Value>400</Value>
                       </StatusCodeCriteria>
                     </WarningCriteria>
                     <ErrorCriteria />
                   </ResourcesEvaluationCriteria>
                   <WebPageTotalEvaluationCriteria>
                     <WarningCriteria />
                     <ErrorCriteria />
                   </WebPageTotalEvaluationCriteria>
                   <DepthEvaluationCriteria>
                     <WarningCriteria />
                     <ErrorCriteria />
                   </DepthEvaluationCriteria>
                 </RequestEvaluationCriteria>
                 <FormsAuthCredentials />
                 <CollectResponseBody>OnContentMatchCriteria</CollectResponseBody>
                 <CollectLinksHeaders>false</CollectLinksHeaders>
                 <CollectResourcesHeaders>false</CollectResourcesHeaders>
               </Request>
             </Requests>
           </ProbeAction>
         </MemberModules>
         <Composition>
           <Node ID="Probe">
             <Node ID="Scheduler" />
           </Node>
         </Composition>
       </Composite>
     </ModuleImplementation>
     <OutputType>MicrosoftSystemCenterWebApplicationLibrary!Microsoft.SystemCenter.WebApplication.WebApplicationData</OutputType>
   </DataSourceModuleType>
 </ModuleTypes>
 <MonitorTypes>
   <UnitMonitorType ID="MPAuthor.WebApplications.BasePageErrorCodeMonitor" Accessibility="Internal">
     <MonitorTypeStates>
       <MonitorTypeState ID="ErrorCodeFailure" NoDetection="false" />
       <MonitorTypeState ID="ErrorCodeSuccess" NoDetection="false" />
     </MonitorTypeStates>
     <Configuration>
       <xsd:element minOccurs="1" name="RequestID" type="xsd:integer" />
     </Configuration>
     <MonitorImplementation>
       <MemberModules>
         <DataSource ID="DS1" TypeID="MPAuthor.WebApplications.UrlDataSource" />
         <ConditionDetection ID="CDErrorCodeFailureTrue" TypeID="System!System.ExpressionFilter">
           <Expression>
             <SimpleExpression>
               <ValueExpression>
                 <XPathQuery>RequestResults/RequestResult[@Id="$Config/RequestID$"]/BasePageData/ErrorCode</XPathQuery>
               </ValueExpression>
               <Operator>NotEqual</Operator>
               <ValueExpression>
                 <XPathQuery>0</XPathQuery>
               </ValueExpression>
             </SimpleExpression>
           </Expression>
         </ConditionDetection>
         <ConditionDetection ID="CDErrorCodeFailureFalse" TypeID="System!System.ExpressionFilter">
           <Expression>
             <SimpleExpression>
               <ValueExpression>
                 <XPathQuery>RequestResults/RequestResult[@Id="$Config/RequestID$"]/BasePageData/ErrorCode</XPathQuery>
               </ValueExpression>
               <Operator>Equal</Operator>
               <ValueExpression>
                 <XPathQuery>0</XPathQuery>
               </ValueExpression>
             </SimpleExpression>
           </Expression>
         </ConditionDetection>
       </MemberModules>
       <RegularDetections>
         <RegularDetection MonitorTypeStateID="ErrorCodeFailure">
           <Node ID="CDErrorCodeFailureTrue">
             <Node ID="DS1" />
           </Node>
         </RegularDetection>
         <RegularDetection MonitorTypeStateID="ErrorCodeSuccess">
           <Node ID="CDErrorCodeFailureFalse">
             <Node ID="DS1" />
           </Node>
         </RegularDetection>
       </RegularDetections>
     </MonitorImplementation>
   </UnitMonitorType>
 </MonitorTypes>
</TypeDefinitions>

Informationen


Modultyp	ProbeActionModuleType
Eingabetyp	Keine
Ausgabetyp	Microsoft.SystemCenter.WebApplication.WebApplicationData
Implementierung	Systemeigen
Bibliothek	Microsoft.SystemCenter.WebApplication.Library

Freigeben über

Microsoft.SystemCenter.WebApplication.UrlProbe

Verbrauch

Typdefinition

Parameter

Anforderungselement

RequestEvaluationCriteria-Element

Zusammensetzung

Externe Modulreferenzen

Beispiel

Informationen

Feedback

Zusätzliche Ressourcen

Freigeben über

Microsoft.SystemCenter.WebApplication.UrlProbe

Verbrauch

Typdefinition

Parameter

Anforderungselement

RequestEvaluationCriteria-Element

Zusammensetzung

Verwandte Module

Externe Modulreferenzen

Beispiel

Informationen

Feedback

Zusätzliche Ressourcen