Microsoft.Insights-webtests

Bicep-resourcedefinitie

Het resourcetype webtests kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Resource microsoft.Insights/webtests wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.

resource symbolicname 'Microsoft.Insights/webtests@2022-06-15' = {
  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'
  }
}

Eigenschapswaarden

Microsoft.Insights/webtests

Naam Beschrijving Waarde
soort Het type WebTest dat door deze webtest wordt bewaakt. Keuzes zijn ping, multistep en standaard. 'Meerstaps'
ping
'standaard'
plaats Resourcelocatie tekenreeks (vereist)
naam De resourcenaam tekenreeks (vereist)
Eigenschappen Metagegevens die een webtest beschrijven voor een Azure-resource. WebTestProperties-
Tags Resourcetags Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen

Header veld

Naam Beschrijving Waarde
sleutel De naam van de koptekst. snaar
waarde De waarde van de koptekst. snaar

WebTestGeolocatie

Naam Beschrijving Waarde
Legitimatiebewijs Locatie-id voor de WebTest waaruit moet worden uitgevoerd. snaar

WebTestEigenschappen

Naam Beschrijving Waarde
Configuratie Een XML-configuratiespecificatie voor een WebTest. WebTestPropertiesConfiguration-
Beschrijving Door de gebruiker gedefinieerde beschrijving voor deze WebTest. snaar
Ingeschakeld Wordt de test actief bewaakt. Bool
Frequentie Interval in seconden tussen testuitvoeringen voor deze WebTest. De standaardwaarde is 300. Int
Soort Het soort webtest is dat geldige keuzes zijn ping, multistep en standaard. 'Meerstaps'
ping
'standaard' (vereist)
Locaties Een lijst met waar u de tests fysiek kunt uitvoeren om globale dekking te bieden voor toegankelijkheid van uw toepassing. WebTestGeolocation[] (vereist)
Naam Door de gebruiker gedefinieerde naam als deze WebTest. tekenreeks (vereist)
Verzoek De verzameling aanvraageigenschappen WebTestEigenschappenAanvraag
Opnieuw proberenEnabled Toestaan voor nieuwe pogingen als deze webtest mislukt. Bool
SyntheticMonitorId Unieke id van deze webtest. Dit is doorgaans dezelfde waarde als het veld Naam. tekenreeks (vereist)
Onderbreking Seconden totdat deze WebTest een time-out krijgt en mislukt. De standaardwaarde is 30. Int
Validatieregels De verzameling eigenschappen van validatieregels WebTestPropertiesValidationRules

WebTestEigenschappenConfiguratie

Naam Beschrijving Waarde
Webtest De XML-specificatie van een WebTest die moet worden uitgevoerd voor een toepassing. snaar

WebTestEigenschappenAanvraag

Naam Beschrijving Waarde
FollowRedirects Volg omleidingen voor deze webtest. Bool
Kopteksten Lijst met headers en de bijbehorende waarden om toe te voegen aan de webtest-aanroep. HeaderVeld
httpVerb Http-werkwoord dat moet worden gebruikt voor deze webtest. snaar
ParseDependentRequests ParseEr afhankelijke aanvraag voor deze WebTest. Bool
Lichaam aanvragen Met Base64 gecodeerde tekenreekstekst die met deze webtest moet worden verzonden. snaar
AanvraagURL Url-locatie die moet worden getest. snaar

WebTestPropertiesValidationRules

Naam Beschrijving Waarde
Validatie van inhoud De verzameling eigenschappen van inhoudsvalidatie WebTestPropertiesValidationRulesContentValidation
ExpectedHttpStatusCode Controleer of de WebTest de opgegeven HTTP-statuscode retourneert. Int
HttpStatusCode negeren Wanneer deze is ingesteld, negeert de validatie de statuscode. Bool
SSLCertRemainingLifetimeCheck Een aantal dagen om te controleren blijft bestaan voordat het bestaande SSL-certificaat verloopt. De waarde moet positief zijn en de SSLCheck moet zijn ingesteld op true. Int
SSLCheck Controleert of het SSL-certificaat nog steeds geldig is. Bool

WebTestPropertiesValidationRulesContentValidation

Naam Beschrijving Waarde
Inhoudsmatch Inhoud die moet worden gezocht in de return van de WebTest. Mag niet null of leeg zijn. snaar
Negeren Wanneer deze waarde is ingesteld, is de case voor validatie van ContentMatch niet hoofdlettergevoelig. Bool
PassIfTextFound Wanneer waar, wordt de validatie doorgegeven als er een overeenkomst is voor de ContentMatch-tekenreeks. Als dit onwaar is, mislukt de validatie als er een overeenkomst is Bool

WebtestsResourceTags

Naam Beschrijving Waarde

Gebruiksvoorbeelden

Bicep-voorbeelden

Een eenvoudig voorbeeld van het implementeren van Application Insights Standard WebTest.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource component 'Microsoft.Insights/components@2020-02-02' = {
  name: resourceName
  location: location
  kind: 'web'
  properties: {
    Application_Type: 'web'
    DisableIpMasking: false
    DisableLocalAuth: false
    ForceCustomerStorageForProfiler: false
    RetentionInDays: 90
    SamplingPercentage: 100
    publicNetworkAccessForIngestion: 'Enabled'
    publicNetworkAccessForQuery: 'Enabled'
  }
}

resource webTest 'Microsoft.Insights/webTests@2022-06-15' = {
  name: resourceName
  location: location
  kind: 'standard'
  properties: {
    Description: ''
    Enabled: false
    Frequency: 300
    Kind: 'standard'
    Locations: [
      {
        Id: 'us-tx-sn1-azr'
      }
    ]
    Name: 'acctest0001'
    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: 'acctest0001'
    Timeout: 30
    ValidationRules: {
      ExpectedHttpStatusCode: 200
      SSLCheck: false
    }
  }
  tags: {
    'hidden-link:azapi_resource.component.id': 'Resource'
  }
}

Geverifieerde Azure-modules

De volgende azure-geverifieerde modules kunnen worden gebruikt om dit resourcetype te implementeren.

Moduul Beschrijving
webtest AVM-resourcemodule voor webtest

Resourcedefinitie van ARM-sjabloon

Het resourcetype webtests kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Microsoft.Insights/webtests-resource wilt maken, voegt u de volgende JSON toe aan uw sjabloon.

{
  "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"
  }
}

Eigenschapswaarden

Microsoft.Insights/webtests

Naam Beschrijving Waarde
apiVersion De API-versie '2022-06-15'
soort Het type WebTest dat door deze webtest wordt bewaakt. Keuzes zijn ping, multistep en standaard. 'Meerstaps'
ping
'standaard'
plaats Resourcelocatie tekenreeks (vereist)
naam De resourcenaam tekenreeks (vereist)
Eigenschappen Metagegevens die een webtest beschrijven voor een Azure-resource. WebTestProperties-
Tags Resourcetags Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen
soort Het resourcetype 'Microsoft.Insights/webtests'

Header veld

Naam Beschrijving Waarde
sleutel De naam van de koptekst. snaar
waarde De waarde van de koptekst. snaar

WebTestGeolocatie

Naam Beschrijving Waarde
Legitimatiebewijs Locatie-id voor de WebTest waaruit moet worden uitgevoerd. snaar

WebTestEigenschappen

Naam Beschrijving Waarde
Configuratie Een XML-configuratiespecificatie voor een WebTest. WebTestPropertiesConfiguration-
Beschrijving Door de gebruiker gedefinieerde beschrijving voor deze WebTest. snaar
Ingeschakeld Wordt de test actief bewaakt. Bool
Frequentie Interval in seconden tussen testuitvoeringen voor deze WebTest. De standaardwaarde is 300. Int
Soort Het soort webtest is dat geldige keuzes zijn ping, multistep en standaard. 'Meerstaps'
ping
'standaard' (vereist)
Locaties Een lijst met waar u de tests fysiek kunt uitvoeren om globale dekking te bieden voor toegankelijkheid van uw toepassing. WebTestGeolocation[] (vereist)
Naam Door de gebruiker gedefinieerde naam als deze WebTest. tekenreeks (vereist)
Verzoek De verzameling aanvraageigenschappen WebTestEigenschappenAanvraag
Opnieuw proberenEnabled Toestaan voor nieuwe pogingen als deze webtest mislukt. Bool
SyntheticMonitorId Unieke id van deze webtest. Dit is doorgaans dezelfde waarde als het veld Naam. tekenreeks (vereist)
Onderbreking Seconden totdat deze WebTest een time-out krijgt en mislukt. De standaardwaarde is 30. Int
Validatieregels De verzameling eigenschappen van validatieregels WebTestPropertiesValidationRules

WebTestEigenschappenConfiguratie

Naam Beschrijving Waarde
Webtest De XML-specificatie van een WebTest die moet worden uitgevoerd voor een toepassing. snaar

WebTestEigenschappenAanvraag

Naam Beschrijving Waarde
FollowRedirects Volg omleidingen voor deze webtest. Bool
Kopteksten Lijst met headers en de bijbehorende waarden om toe te voegen aan de webtest-aanroep. HeaderVeld
httpVerb Http-werkwoord dat moet worden gebruikt voor deze webtest. snaar
ParseDependentRequests ParseEr afhankelijke aanvraag voor deze WebTest. Bool
Lichaam aanvragen Met Base64 gecodeerde tekenreekstekst die met deze webtest moet worden verzonden. snaar
AanvraagURL Url-locatie die moet worden getest. snaar

WebTestPropertiesValidationRules

Naam Beschrijving Waarde
Validatie van inhoud De verzameling eigenschappen van inhoudsvalidatie WebTestPropertiesValidationRulesContentValidation
ExpectedHttpStatusCode Controleer of de WebTest de opgegeven HTTP-statuscode retourneert. Int
HttpStatusCode negeren Wanneer deze is ingesteld, negeert de validatie de statuscode. Bool
SSLCertRemainingLifetimeCheck Een aantal dagen om te controleren blijft bestaan voordat het bestaande SSL-certificaat verloopt. De waarde moet positief zijn en de SSLCheck moet zijn ingesteld op true. Int
SSLCheck Controleert of het SSL-certificaat nog steeds geldig is. Bool

WebTestPropertiesValidationRulesContentValidation

Naam Beschrijving Waarde
Inhoudsmatch Inhoud die moet worden gezocht in de return van de WebTest. Mag niet null of leeg zijn. snaar
Negeren Wanneer deze waarde is ingesteld, is de case voor validatie van ContentMatch niet hoofdlettergevoelig. Bool
PassIfTextFound Wanneer waar, wordt de validatie doorgegeven als er een overeenkomst is voor de ContentMatch-tekenreeks. Als dit onwaar is, mislukt de validatie als er een overeenkomst is Bool

WebtestsResourceTags

Naam Beschrijving Waarde

Gebruiksvoorbeelden

Azure-snelstartsjablonen

De volgende Azure-quickstartsjablonen dit resourcetype implementeren.

Sjabloon Beschrijving
dynamische webtest maken

implementeren in Azure 		Maak een willekeurig aantal App Insights-webtests (ping).
Waarschuwingsregel voor metrische gegevens voor een beschikbaarheidstest

implementeren in Azure 		Met deze sjabloon maakt u een Application Insights-beschikbaarheidstest samen met een metrische waarschuwingsregel waarmee deze wordt bewaakt.

Resourcedefinitie van Terraform (AzAPI-provider)

Het resourcetype webtests kan worden geïmplementeerd met bewerkingen die zijn gericht op:

  • Resourcegroepen

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Microsoft.Insights/webtests-resource wilt maken, voegt u de volgende Terraform toe aan uw sjabloon.

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

Eigenschapswaarden

Microsoft.Insights/webtests

Naam Beschrijving Waarde
soort Het type WebTest dat door deze webtest wordt bewaakt. Keuzes zijn ping, multistep en standaard. 'Meerstaps'
ping
'standaard'
plaats Resourcelocatie tekenreeks (vereist)
naam De resourcenaam tekenreeks (vereist)
Eigenschappen Metagegevens die een webtest beschrijven voor een Azure-resource. WebTestProperties-
Tags Resourcetags Woordenlijst met tagnamen en -waarden.
soort Het resourcetype "Microsoft.Insights/webtests@2022-06-15"

Header veld

Naam Beschrijving Waarde
sleutel De naam van de koptekst. snaar
waarde De waarde van de koptekst. snaar

WebTestGeolocatie

Naam Beschrijving Waarde
Legitimatiebewijs Locatie-id voor de WebTest waaruit moet worden uitgevoerd. snaar

WebTestEigenschappen

Naam Beschrijving Waarde
Configuratie Een XML-configuratiespecificatie voor een WebTest. WebTestPropertiesConfiguration-
Beschrijving Door de gebruiker gedefinieerde beschrijving voor deze WebTest. snaar
Ingeschakeld Wordt de test actief bewaakt. Bool
Frequentie Interval in seconden tussen testuitvoeringen voor deze WebTest. De standaardwaarde is 300. Int
Soort Het soort webtest is dat geldige keuzes zijn ping, multistep en standaard. 'Meerstaps'
ping
'standaard' (vereist)
Locaties Een lijst met waar u de tests fysiek kunt uitvoeren om globale dekking te bieden voor toegankelijkheid van uw toepassing. WebTestGeolocation[] (vereist)
Naam Door de gebruiker gedefinieerde naam als deze WebTest. tekenreeks (vereist)
Verzoek De verzameling aanvraageigenschappen WebTestEigenschappenAanvraag
Opnieuw proberenEnabled Toestaan voor nieuwe pogingen als deze webtest mislukt. Bool
SyntheticMonitorId Unieke id van deze webtest. Dit is doorgaans dezelfde waarde als het veld Naam. tekenreeks (vereist)
Onderbreking Seconden totdat deze WebTest een time-out krijgt en mislukt. De standaardwaarde is 30. Int
Validatieregels De verzameling eigenschappen van validatieregels WebTestPropertiesValidationRules

WebTestEigenschappenConfiguratie

Naam Beschrijving Waarde
Webtest De XML-specificatie van een WebTest die moet worden uitgevoerd voor een toepassing. snaar

WebTestEigenschappenAanvraag

Naam Beschrijving Waarde
FollowRedirects Volg omleidingen voor deze webtest. Bool
Kopteksten Lijst met headers en de bijbehorende waarden om toe te voegen aan de webtest-aanroep. HeaderVeld
httpVerb Http-werkwoord dat moet worden gebruikt voor deze webtest. snaar
ParseDependentRequests ParseEr afhankelijke aanvraag voor deze WebTest. Bool
Lichaam aanvragen Met Base64 gecodeerde tekenreekstekst die met deze webtest moet worden verzonden. snaar
AanvraagURL Url-locatie die moet worden getest. snaar

WebTestPropertiesValidationRules

Naam Beschrijving Waarde
Validatie van inhoud De verzameling eigenschappen van inhoudsvalidatie WebTestPropertiesValidationRulesContentValidation
ExpectedHttpStatusCode Controleer of de WebTest de opgegeven HTTP-statuscode retourneert. Int
HttpStatusCode negeren Wanneer deze is ingesteld, negeert de validatie de statuscode. Bool
SSLCertRemainingLifetimeCheck Een aantal dagen om te controleren blijft bestaan voordat het bestaande SSL-certificaat verloopt. De waarde moet positief zijn en de SSLCheck moet zijn ingesteld op true. Int
SSLCheck Controleert of het SSL-certificaat nog steeds geldig is. Bool

WebTestPropertiesValidationRulesContentValidation

Naam Beschrijving Waarde
Inhoudsmatch Inhoud die moet worden gezocht in de return van de WebTest. Mag niet null of leeg zijn. snaar
Negeren Wanneer deze waarde is ingesteld, is de case voor validatie van ContentMatch niet hoofdlettergevoelig. Bool
PassIfTextFound Wanneer waar, wordt de validatie doorgegeven als er een overeenkomst is voor de ContentMatch-tekenreeks. Als dit onwaar is, mislukt de validatie als er een overeenkomst is Bool

WebtestsResourceTags

Naam Beschrijving Waarde

Gebruiksvoorbeelden

Terraform-monsters

Een eenvoudig voorbeeld van het implementeren van 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    = ["*"]
}
  • Last updated on