Compartilhar via


Webtests do Microsoft.Insights

Definição de recurso do Bicep

O tipo de recurso webtests pode ser implantado com operações de destino:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso microsoft.insights/webtests, adicione o Bicep a seguir ao seu modelo.

resource symbolicname 'Microsoft.Insights/webtests@2022-06-15' = {
  scope: resourceSymbolicName or scope
  kind: 'string'
  location: 'string'
  name: 'string'
  properties: {
    Configuration: {
      WebTest: 'string'
    }
    Description: 'string'
    Enabled: bool
    Frequency: int
    Kind: 'string'
    Locations: [
      {
        Id: 'string'
      }
    ]
    Name: 'string'
    Request: {
      FollowRedirects: bool
      Headers: [
        {
          key: 'string'
          value: 'string'
        }
      ]
      HttpVerb: 'string'
      ParseDependentRequests: bool
      RequestBody: 'string'
      RequestUrl: 'string'
    }
    RetryEnabled: bool
    SyntheticMonitorId: 'string'
    Timeout: int
    ValidationRules: {
      ContentValidation: {
        ContentMatch: 'string'
        IgnoreCase: bool
        PassIfTextFound: bool
      }
      ExpectedHttpStatusCode: int
      IgnoreHttpStatusCode: bool
      SSLCertRemainingLifetimeCheck: int
      SSLCheck: bool
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propriedade

Microsoft.Insights/webtests

Nome Descrição Valor
tipo O tipo de WebTest que este teste da Web observa. As opções são ping, multistep e padrão. 'multipasso'
'ping'
'padrão'
local Local do recurso cadeia de caracteres (obrigatório)
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades Metadados que descrevem um teste da Web para um recurso do Azure. Propriedades do WebTest
escopo Use ao criar um recurso em um escopo diferente do escopo de implantação. Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão .
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos

Campo de cabeçalho

Nome Descrição Valor
chave O nome do cabeçalho. cadeia
valor O valor do cabeçalho. cadeia

WebTestGeolocalização

Nome Descrição Valor
ID ID de localização da qual o WebTest será executado. cadeia

Propriedades do WebTest

Nome Descrição Valor
Configuração Uma especificação de configuração XML para um WebTest. WebTestPropertiesConfiguration
Descrição Descrição definida pelo usuário para este WebTest. cadeia
Habilitado O teste está sendo monitorado ativamente. Bool
Frequência Intervalo em segundos entre as execuções de teste para este WebTest. O valor padrão é 300. int
Variante O tipo de teste da Web, ou seja, opções válidas são ping, multistep e padrão. 'multipasso'
'ping'
'standard' (obrigatório)
Locais Uma lista de onde executar fisicamente os testes para fornecer cobertura global para acessibilidade do seu aplicativo. WebTestGeolocation[] (obrigatório)
Nome Nome definido pelo usuário se este WebTest. cadeia de caracteres (obrigatório)
Pedir A coleção de propriedades de solicitação WebTestPropertiesRequest
Tentar Ativado Permitir novas tentativas caso este WebTest falhe. Bool
Identificação do Monitor Sintético ID exclusiva deste WebTest. Normalmente, esse é o mesmo valor que o campo Nome. cadeia de caracteres (obrigatório)
Intervalo Segundos até que este WebTest faça o tempo limite e falhe. O valor padrão é 30. int
Regras de validação A coleção de propriedades da regra de validação WebTestPropertiesValidationRules

Configuração WebTestProperties

Nome Descrição Valor
Teste de Web A especificação XML de um WebTest a ser executado em um aplicativo. cadeia

Solicitação de WebTestProperties

Nome Descrição Valor
Redirecionamentos de Acompanhamento Siga os redirecionamentos para este teste na Web. Bool
Cabeçalhos Lista de cabeçalhos e seus valores a serem adicionados à chamada webTest. headerfield[]
Verbo Http Verbo http a ser usado para este teste da Web. cadeia
ParseDependentRequests Analisar solicitação dependente para este WebTest. Bool
Corpo do pedido Corpo da cadeia de caracteres codificado em Base64 para enviar com este teste da Web. cadeia
Url de solicitação Local da URL a ser testada. cadeia

WebTestPropertiesValidationRules

Nome Descrição Valor
Validação de conteúdo A coleção de propriedades de validação de conteúdo WebTestPropertiesValidationRulesContentValidation
ExpectedHttpStatusCode Valide se o WebTest retorna o código de status http fornecido. int
IgnoreHttpStatusCode Quando definido, a validação ignorará o código de status. Bool
SSLCertRemainingLifetimeCheck Alguns dias para verificar ainda permanecem antes que o certificado SSL existente expire. O valor deve ser positivo e o SSLCheck deve ser definido como true. int
SSLCheck Verifica se o certificado SSL ainda é válido. Bool

WebTestPropertiesValidationRulesContentValidation

Nome Descrição Valor
Correspondência de conteúdo Conteúdo a ser buscado no retorno do WebTest. Não deve ser nulo ou vazio. cadeia
Ignorar caso Quando definido, esse valor não diferencia o caso de validação ContentMatch. Bool
PassIfTextFound Quando true, a validação será aprovada se houver uma correspondência para a cadeia de caracteres ContentMatch. Se for false, a validação falhará se houver uma correspondência Bool

WebtestsResourceTags

Nome Descrição Valor

Exemplos de uso

Módulos verificados do Azure

O módulos verificados do Azure a seguir pode ser usado para implantar esse tipo de recurso.

Módulo Descrição
de teste web Módulo de recurso da AVM para teste na Web

Definição de recurso de modelo do ARM

O tipo de recurso webtests pode ser implantado com operações de destino:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso microsoft.insights/webtests, adicione o JSON a seguir ao seu modelo.

{
  "type": "Microsoft.Insights/webtests",
  "apiVersion": "2022-06-15",
  "name": "string",
  "kind": "string",
  "location": "string",
  "properties": {
    "Configuration": {
      "WebTest": "string"
    },
    "Description": "string",
    "Enabled": "bool",
    "Frequency": "int",
    "Kind": "string",
    "Locations": [
      {
        "Id": "string"
      }
    ],
    "Name": "string",
    "Request": {
      "FollowRedirects": "bool",
      "Headers": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "HttpVerb": "string",
      "ParseDependentRequests": "bool",
      "RequestBody": "string",
      "RequestUrl": "string"
    },
    "RetryEnabled": "bool",
    "SyntheticMonitorId": "string",
    "Timeout": "int",
    "ValidationRules": {
      "ContentValidation": {
        "ContentMatch": "string",
        "IgnoreCase": "bool",
        "PassIfTextFound": "bool"
      },
      "ExpectedHttpStatusCode": "int",
      "IgnoreHttpStatusCode": "bool",
      "SSLCertRemainingLifetimeCheck": "int",
      "SSLCheck": "bool"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propriedade

Microsoft.Insights/webtests

Nome Descrição Valor
apiVersion A versão da API '2022-06-15'
tipo O tipo de WebTest que este teste da Web observa. As opções são ping, multistep e padrão. 'multipasso'
'ping'
'padrão'
local Local do recurso cadeia de caracteres (obrigatório)
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades Metadados que descrevem um teste da Web para um recurso do Azure. Propriedades do WebTest
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos
tipo O tipo de recurso 'Microsoft.Insights/webtests'

Campo de cabeçalho

Nome Descrição Valor
chave O nome do cabeçalho. cadeia
valor O valor do cabeçalho. cadeia

WebTestGeolocalização

Nome Descrição Valor
ID ID de localização da qual o WebTest será executado. cadeia

Propriedades do WebTest

Nome Descrição Valor
Configuração Uma especificação de configuração XML para um WebTest. WebTestPropertiesConfiguration
Descrição Descrição definida pelo usuário para este WebTest. cadeia
Habilitado O teste está sendo monitorado ativamente. Bool
Frequência Intervalo em segundos entre as execuções de teste para este WebTest. O valor padrão é 300. int
Variante O tipo de teste da Web, ou seja, opções válidas são ping, multistep e padrão. 'multipasso'
'ping'
'standard' (obrigatório)
Locais Uma lista de onde executar fisicamente os testes para fornecer cobertura global para acessibilidade do seu aplicativo. WebTestGeolocation[] (obrigatório)
Nome Nome definido pelo usuário se este WebTest. cadeia de caracteres (obrigatório)
Pedir A coleção de propriedades de solicitação WebTestPropertiesRequest
Tentar Ativado Permitir novas tentativas caso este WebTest falhe. Bool
Identificação do Monitor Sintético ID exclusiva deste WebTest. Normalmente, esse é o mesmo valor que o campo Nome. cadeia de caracteres (obrigatório)
Intervalo Segundos até que este WebTest faça o tempo limite e falhe. O valor padrão é 30. int
Regras de validação A coleção de propriedades da regra de validação WebTestPropertiesValidationRules

Configuração WebTestProperties

Nome Descrição Valor
Teste de Web A especificação XML de um WebTest a ser executado em um aplicativo. cadeia

Solicitação de WebTestProperties

Nome Descrição Valor
Redirecionamentos de Acompanhamento Siga os redirecionamentos para este teste na Web. Bool
Cabeçalhos Lista de cabeçalhos e seus valores a serem adicionados à chamada webTest. headerfield[]
Verbo Http Verbo http a ser usado para este teste da Web. cadeia
ParseDependentRequests Analisar solicitação dependente para este WebTest. Bool
Corpo do pedido Corpo da cadeia de caracteres codificado em Base64 para enviar com este teste da Web. cadeia
Url de solicitação Local da URL a ser testada. cadeia

WebTestPropertiesValidationRules

Nome Descrição Valor
Validação de conteúdo A coleção de propriedades de validação de conteúdo WebTestPropertiesValidationRulesContentValidation
ExpectedHttpStatusCode Valide se o WebTest retorna o código de status http fornecido. int
IgnoreHttpStatusCode Quando definido, a validação ignorará o código de status. Bool
SSLCertRemainingLifetimeCheck Alguns dias para verificar ainda permanecem antes que o certificado SSL existente expire. O valor deve ser positivo e o SSLCheck deve ser definido como true. int
SSLCheck Verifica se o certificado SSL ainda é válido. Bool

WebTestPropertiesValidationRulesContentValidation

Nome Descrição Valor
Correspondência de conteúdo Conteúdo a ser buscado no retorno do WebTest. Não deve ser nulo ou vazio. cadeia
Ignorar caso Quando definido, esse valor não diferencia o caso de validação ContentMatch. Bool
PassIfTextFound Quando true, a validação será aprovada se houver uma correspondência para a cadeia de caracteres ContentMatch. Se for false, a validação falhará se houver uma correspondência Bool

WebtestsResourceTags

Nome Descrição Valor

Exemplos de uso

Modelos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir implantar esse tipo de recurso.

Modelo Descrição
de criação de teste web dinâmico

Implantar no Azure
Crie qualquer número de testes web do App Insights (ping).
regra de alerta de métrica para um teste de disponibilidade

Implantar no Azure
Esse modelo cria um teste de disponibilidade do Application Insights junto com uma regra de alerta de métrica que o monitora.

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso webtests pode ser implantado com operações de destino:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso microsoft.insights/webtests, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Insights/webtests@2022-06-15"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    kind = "string"
    properties = {
      Configuration = {
        WebTest = "string"
      }
      Description = "string"
      Enabled = bool
      Frequency = int
      Kind = "string"
      Locations = [
        {
          Id = "string"
        }
      ]
      Name = "string"
      Request = {
        FollowRedirects = bool
        Headers = [
          {
            key = "string"
            value = "string"
          }
        ]
        HttpVerb = "string"
        ParseDependentRequests = bool
        RequestBody = "string"
        RequestUrl = "string"
      }
      RetryEnabled = bool
      SyntheticMonitorId = "string"
      Timeout = int
      ValidationRules = {
        ContentValidation = {
          ContentMatch = "string"
          IgnoreCase = bool
          PassIfTextFound = bool
        }
        ExpectedHttpStatusCode = int
        IgnoreHttpStatusCode = bool
        SSLCertRemainingLifetimeCheck = int
        SSLCheck = bool
      }
    }
  }
}

Valores de propriedade

Microsoft.Insights/webtests

Nome Descrição Valor
tipo O tipo de WebTest que este teste da Web observa. As opções são ping, multistep e padrão. 'multipasso'
'ping'
'padrão'
local Local do recurso cadeia de caracteres (obrigatório)
nome O nome do recurso cadeia de caracteres (obrigatório)
parent_id A ID do recurso ao qual aplicar esse recurso de extensão. cadeia de caracteres (obrigatório)
Propriedades Metadados que descrevem um teste da Web para um recurso do Azure. Propriedades do WebTest
Tags Marcas de recurso Dicionário de nomes e valores de marca.
tipo O tipo de recurso "Microsoft.Insights/webtests@2022-06-15"

Campo de cabeçalho

Nome Descrição Valor
chave O nome do cabeçalho. cadeia
valor O valor do cabeçalho. cadeia

WebTestGeolocalização

Nome Descrição Valor
ID ID de localização da qual o WebTest será executado. cadeia

Propriedades do WebTest

Nome Descrição Valor
Configuração Uma especificação de configuração XML para um WebTest. WebTestPropertiesConfiguration
Descrição Descrição definida pelo usuário para este WebTest. cadeia
Habilitado O teste está sendo monitorado ativamente. Bool
Frequência Intervalo em segundos entre as execuções de teste para este WebTest. O valor padrão é 300. int
Variante O tipo de teste da Web, ou seja, opções válidas são ping, multistep e padrão. 'multipasso'
'ping'
'standard' (obrigatório)
Locais Uma lista de onde executar fisicamente os testes para fornecer cobertura global para acessibilidade do seu aplicativo. WebTestGeolocation[] (obrigatório)
Nome Nome definido pelo usuário se este WebTest. cadeia de caracteres (obrigatório)
Pedir A coleção de propriedades de solicitação WebTestPropertiesRequest
Tentar Ativado Permitir novas tentativas caso este WebTest falhe. Bool
Identificação do Monitor Sintético ID exclusiva deste WebTest. Normalmente, esse é o mesmo valor que o campo Nome. cadeia de caracteres (obrigatório)
Intervalo Segundos até que este WebTest faça o tempo limite e falhe. O valor padrão é 30. int
Regras de validação A coleção de propriedades da regra de validação WebTestPropertiesValidationRules

Configuração WebTestProperties

Nome Descrição Valor
Teste de Web A especificação XML de um WebTest a ser executado em um aplicativo. cadeia

Solicitação de WebTestProperties

Nome Descrição Valor
Redirecionamentos de Acompanhamento Siga os redirecionamentos para este teste na Web. Bool
Cabeçalhos Lista de cabeçalhos e seus valores a serem adicionados à chamada webTest. headerfield[]
Verbo Http Verbo http a ser usado para este teste da Web. cadeia
ParseDependentRequests Analisar solicitação dependente para este WebTest. Bool
Corpo do pedido Corpo da cadeia de caracteres codificado em Base64 para enviar com este teste da Web. cadeia
Url de solicitação Local da URL a ser testada. cadeia

WebTestPropertiesValidationRules

Nome Descrição Valor
Validação de conteúdo A coleção de propriedades de validação de conteúdo WebTestPropertiesValidationRulesContentValidation
ExpectedHttpStatusCode Valide se o WebTest retorna o código de status http fornecido. int
IgnoreHttpStatusCode Quando definido, a validação ignorará o código de status. Bool
SSLCertRemainingLifetimeCheck Alguns dias para verificar ainda permanecem antes que o certificado SSL existente expire. O valor deve ser positivo e o SSLCheck deve ser definido como true. int
SSLCheck Verifica se o certificado SSL ainda é válido. Bool

WebTestPropertiesValidationRulesContentValidation

Nome Descrição Valor
Correspondência de conteúdo Conteúdo a ser buscado no retorno do WebTest. Não deve ser nulo ou vazio. cadeia
Ignorar caso Quando definido, esse valor não diferencia o caso de validação ContentMatch. Bool
PassIfTextFound Quando true, a validação será aprovada se houver uma correspondência para a cadeia de caracteres ContentMatch. Se for false, a validação falhará se houver uma correspondência Bool

WebtestsResourceTags

Nome Descrição Valor

Exemplos de uso

Exemplos do Terraform

Um exemplo básico de implantação do Application Insights Standard WebTest.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "component" {
  type      = "Microsoft.Insights/components@2020-02-02"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    kind = "web"
    properties = {
      Application_Type                = "web"
      DisableIpMasking                = false
      DisableLocalAuth                = false
      ForceCustomerStorageForProfiler = false
      RetentionInDays                 = 90
      SamplingPercentage              = 100
      publicNetworkAccessForIngestion = "Enabled"
      publicNetworkAccessForQuery     = "Enabled"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "webTest" {
  type      = "Microsoft.Insights/webTests@2022-06-15"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    kind = "standard"
    properties = {
      Description = ""
      Enabled     = false
      Frequency   = 300
      Kind        = "standard"
      Locations = [
        {
          Id = "us-tx-sn1-azr"
        },
      ]
      Name = var.resource_name
      Request = {
        FollowRedirects = false
        Headers = [
          {
            key   = "x-header"
            value = "testheader"
          },
          {
            key   = "x-header-2"
            value = "testheader2"
          },
        ]
        HttpVerb               = "GET"
        ParseDependentRequests = false
        RequestUrl             = "http://microsoft.com"
      }
      RetryEnabled       = false
      SyntheticMonitorId = var.resource_name
      Timeout            = 30
      ValidationRules = {
        ExpectedHttpStatusCode = 200
        SSLCheck               = false
      }
    }
    tags = {
      "hidden-link:${azapi_resource.component.id}" = "Resource"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}