Microsoft.SystemCenter.WebApplication.UrlProbe

O módulo de pesquisa Microsoft.SystemCenter.WebApplication.UrlProbe liga-se a um ou mais URLs e devolve Microsoft.SystemCenter.WebApplication.WebApplicationData. Estes dados podem ser utilizados com outros módulos do Microsoft.SystemCenter.WebApplication.Library para avaliar o estado de funcionamento de vários aspetos do site de destino.

Utilização

A função principal de Microsoft.SystemCenter.WebApplication.UrlProbe é enviar um pedido para um ou mais URLs e reportar os resultados. O formato do pedido é um tipo complexo e é utilizado com outros módulos para avaliar o estado de funcionamento do URL de destino. Uma vez que um grande número de pedidos pode ser feito com uma única sonda e como os resultados do pedido podem conter uma grande quantidade de dados, a própria sonda realiza alguma avaliação do pedido antes de produzir o resultado. Por exemplo, em vez de apenas fornecer o código de estado do URL consultado como saída, o módulo compara o código de estado com um intervalo especificado e fornece um código de êxito ou falha como saída. O módulo também pode corresponder ao conteúdo do HTML devolvido pelo pedido, por exemplo, que corresponde ao erro da palavra para determinar se foi devolvida uma página de erro. Esta avaliação realizada pelo módulo remove a necessidade de lógica de correspondência de expressões complexas na sua regra ou monitor.

Geralmente, este módulo é acionado com Microsoft.SystemCenter.WebApplication.PerProbe.Scheduler.

O módulo Microsoft.SystemCenter.WebApplication.UrlProbe é geralmente utilizado com vários módulos de deteção de condição, que se destinam a avaliar o resultado. O módulo avalia diferentes aspetos do estado de funcionamento do URL com base nos parâmetros definidos no pedido e devolve o resultado adequado para cada um.

Alguns desses parâmetros são avaliados diretamente para um estado de funcionamento. Para estes parâmetros, utilizaria três módulos de deteção de condição, cada um dos quais corresponde a um resultado inteiro específico da sonda que indica um estado de funcionamento específico, conforme mostrado na tabela seguinte:

Outros parâmetros devolvem um estado binário. Nesses casos, são utilizados dois módulos de deteção de condição, cada um dos quais corresponde a um tipo booleano da sonda, conforme mostrado na tabela seguinte:

Por fim, são devolvidos alguns valores não processados, que pode recolher para análise e criação de relatórios ou utilizar com módulos de deteção de condição de filtro de expressão.

Definição de tipo

<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>

Parâmetros

O módulo Microsoft.SystemCenter.WebApplication.UrlProbe suporta os parâmetros de configuração descritos na tabela seguinte.

Elemento de pedido

O elemento Pedidos é uma coleção de um ou mais elementos de Pedido . Cada elemento Pedido tem um subelement RequestID que identifica exclusivamente o pedido nesse conjunto de Pedidos. Os pedidos são processados por ordem, de acordo com o RequestID. O elemento Pedido consiste nos seguintes elementos:

Elemento RequestEvaluationCriteria

O elemento RequestEvaluationCriteria fornece a capacidade de avaliar os dados devolvidos pelo pedido e determinar o estado de funcionamento do URL. Cada elemento é um tipo complexo, que contém critérios que podem ser correspondidos de uma de três formas:

• Critérios numéricos. Esta é a mais comum e é utilizada para avaliar um valor mensurável, como um código de estado devolvido ou tempo de resposta.
• Os conteúdos correspondem aos critérios. Isto é utilizado para avaliar o conteúdo do HTML devolvido para determinar se contém uma cadeia de texto específica.
• Critérios personalizados. Esta é uma expressão que corresponde a uma variedade de diferentes parâmetros disponíveis definidos pelo utilizador.

Qualquer número de critérios numéricos ou critérios personalizados pode ser utilizado, mas só é permitido um critério de correspondência de conteúdo. O RequestEvaluationCriteriaType consiste nos seguintes elementos:

O tipo de avaliação mais comum é numérico, no qual um item de dados devolvidos, como um tempo de resolução, é comparado com um limiar configurado. NumericCriteriaExpression é do tipo RequestEvaluationNumericCriteriaType, que tem três elementos: NumericRequestMetric, Operator e Value.

NumericRequestMetric é do tipo NumericRequestMetricType, que é uma enumeração que pode consistir numa de várias métricas. Cada métrica está associada a um critério de avaliação específico, da seguinte forma:

O elemento Operador é do tipo CriteriaCompareType, que consiste num dos seguintes: Equal, NotEqual, Greater, Less, GreaterEqual ou LessEqual.

O elemento Valor é do tipo duplo e especifica o tipo do valor que está a ser comparado.

Se o item de dados devolvido que pretende avaliar não for numérico, como uma avaliação de conteúdo, terá de comparar com uma cadeia. ContentMatchCriteria é do tipo RequestEvaluationStringCriteriaType, que tem dois subelementos: Operador e Valor. O operador pode ser um de dois tipos:

• SimpleStringOperator, que é do tipo CriteriaCompareType, que é uma enumeração composta por Equal, NotEqual, Greater, Less ou GreaterEqual.
• RegExOperator, que é do tipo RegExCompareType, que é um tipo de enumeração composto por ContainsSubstring, MatchesWildcard, MatchesRegularExpression, MatchesMOM2005RegularExpression, MatchesMOM2005BooleanRegularExpression, DoesNotContainSubstring, DoesNotMatchWildcard, DoesNotMatchRegularEspression, DoesNotMatchMOM2005RegularExpression, ou DoesNotMatchMOM2005BooleanRegularExpression

O outro elemento de RequestEvaluationStringCriteriaType é Value, que é uma cadeia a comparar.

O elemento CustomCriteria é do tipo ExpressionType.

O elemento StatusCodeCriteria encontrado em LinksEvaluationCriteria e ResourcesEvaluationCriteria é do tipo ListNumericRequestCriteriaType. ListNumericRequestCriteriaType consiste numa sequência de três elementos: ListNumericRequestMetric, que só pode ser a cadeia StatusCode, Operador, que é de CriteriaCompareType, abrangida anteriormente, e um Valor, que tem de ser do tipo duplo.

A chave para criar uma sonda de URL útil está no elemento Request e, normalmente, no NumericRequestMetric. Se souber que parte da página Web está a tentar avaliar, pode escolher a métrica correta na enumeração. No entanto, certifique-se de que seleciona a categoria correta da métrica. As métricas para dados de ligação, dados de recursos e dados totais são agregados e estão disponíveis para as três categorias. Por isso, certifique-se de que especifica a categoria correta e peça-a na parte correta do elemento Request .

Se quiser avaliar apenas o código de estado de uma determinada parte da página (página base, ligações), utilize o elemento StatusCodeCriteria , que teria o seguinte aspeto:

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

Esta secção StatusCodeCriteria procura uma resposta de êxito da sonda (Código de estado maior ou igual a 400).

Composição

O módulo Microsoft.SystemCenter.WebApplication.UrlProbe é um módulo nativo.

Módulos relacionados

Referências de módulos externos

Sample

O exemplo seguinte executa uma pesquisa de URL simples no URL http://www.microsoft.com. A origem de dados avalia o código de estado devolvido para a página base e devolve um valor de 3 se o código de estado for superior a 400, indicando um estado de erro. Também avalia o código de estado devolvido para os recursos e ligações e devolve um valor de 2 se o código de estado for superior a 400, indicando um estado de aviso.

<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>

Informações