Microsoft.Insights webtests 2015-05-01
Bicep resource definition
The webtests resource type can be deployed with operations that target:
- Resource groups - See resource group deployment commands
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.Insights/webtests resource, add the following Bicep to your template.
resource symbolicname 'Microsoft.Insights/webtests@2015-05-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
kind: 'string'
properties: {
Configuration: {
WebTest: 'string'
}
Description: 'string'
Enabled: bool
Frequency: int
Kind: 'string'
Locations: [
{
Id: 'string'
}
]
Name: 'string'
RetryEnabled: bool
SyntheticMonitorId: 'string'
Timeout: int
}
}
Property values
webtests
| Name | Description | Value |
|---|---|---|
| name | The resource name | string (required) |
| location | Resource location | string (required) |
| tags | Resource tags | Dictionary of tag names and values. See Tags in templates |
| kind | The kind of web test that this web test watches. Choices are ping and multistep. | 'multistep' 'ping' |
| properties | Metadata describing a web test for an Azure resource. | WebTestProperties |
WebTestProperties
| Name | Description | Value |
|---|---|---|
| Configuration | An XML configuration specification for a WebTest. | WebTestPropertiesConfiguration |
| Description | Purpose/user defined descriptive test for this WebTest. | string |
| Enabled | Is the test actively being monitored. | bool |
| Frequency | Interval in seconds between test runs for this WebTest. Default value is 300. | int |
| Kind | The kind of web test this is, valid choices are ping and multistep. | 'multistep' 'ping' (required) |
| Locations | A list of where to physically run the tests from to give global coverage for accessibility of your application. | WebTestGeolocation[] (required) |
| Name | User defined name if this WebTest. | string (required) |
| RetryEnabled | Allow for retries should this WebTest fail. | bool |
| SyntheticMonitorId | Unique ID of this WebTest. This is typically the same value as the Name field. | string (required) |
| Timeout | Seconds until this WebTest will timeout and fail. Default value is 30. | int |
WebTestPropertiesConfiguration
| Name | Description | Value |
|---|---|---|
| WebTest | The XML specification of a WebTest to run against an application. | string |
WebTestGeolocation
| Name | Description | Value |
|---|---|---|
| Id | Location ID for the webtest to run from. | string |
Quickstart templates
The following quickstart templates deploy this resource type.
| Template | Description |
|---|---|
Dynamic Web Test Creation |
Create any number of App Insights web (ping) tests. |
| Metric alert rule for an availability test |
This template creates an Application Insights availability test along with a metric alert rule that monitors it. |
ARM template resource definition
The webtests resource type can be deployed with operations that target:
- Resource groups - See resource group deployment commands
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.Insights/webtests resource, add the following JSON to your template.
{
"type": "Microsoft.Insights/webtests",
"apiVersion": "2015-05-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"kind": "string",
"properties": {
"Configuration": {
"WebTest": "string"
},
"Description": "string",
"Enabled": "bool",
"Frequency": "int",
"Kind": "string",
"Locations": [
{
"Id": "string"
}
],
"Name": "string",
"RetryEnabled": "bool",
"SyntheticMonitorId": "string",
"Timeout": "int"
}
}
Property values
webtests
| Name | Description | Value |
|---|---|---|
| type | The resource type | 'Microsoft.Insights/webtests' |
| apiVersion | The resource api version | '2015-05-01' |
| name | The resource name | string (required) |
| location | Resource location | string (required) |
| tags | Resource tags | Dictionary of tag names and values. See Tags in templates |
| kind | The kind of web test that this web test watches. Choices are ping and multistep. | 'multistep' 'ping' |
| properties | Metadata describing a web test for an Azure resource. | WebTestProperties |
WebTestProperties
| Name | Description | Value |
|---|---|---|
| Configuration | An XML configuration specification for a WebTest. | WebTestPropertiesConfiguration |
| Description | Purpose/user defined descriptive test for this WebTest. | string |
| Enabled | Is the test actively being monitored. | bool |
| Frequency | Interval in seconds between test runs for this WebTest. Default value is 300. | int |
| Kind | The kind of web test this is, valid choices are ping and multistep. | 'multistep' 'ping' (required) |
| Locations | A list of where to physically run the tests from to give global coverage for accessibility of your application. | WebTestGeolocation[] (required) |
| Name | User defined name if this WebTest. | string (required) |
| RetryEnabled | Allow for retries should this WebTest fail. | bool |
| SyntheticMonitorId | Unique ID of this WebTest. This is typically the same value as the Name field. | string (required) |
| Timeout | Seconds until this WebTest will timeout and fail. Default value is 30. | int |
WebTestPropertiesConfiguration
| Name | Description | Value |
|---|---|---|
| WebTest | The XML specification of a WebTest to run against an application. | string |
WebTestGeolocation
| Name | Description | Value |
|---|---|---|
| Id | Location ID for the webtest to run from. | string |
Quickstart templates
The following quickstart templates deploy this resource type.
| Template | Description |
|---|---|
| Dynamic Web Test Creation |
Create any number of App Insights web (ping) tests. |
| Metric alert rule for an availability test |
This template creates an Application Insights availability test along with a metric alert rule that monitors it. |
Terraform (AzAPI provider) resource definition
The webtests resource type can be deployed with operations that target:
- Resource groups
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.Insights/webtests resource, add the following Terraform to your template.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Insights/webtests@2015-05-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
Configuration = {
WebTest = "string"
}
Description = "string"
Enabled = bool
Frequency = int
Kind = "string"
Locations = [
{
Id = "string"
}
]
Name = "string"
RetryEnabled = bool
SyntheticMonitorId = "string"
Timeout = int
}
kind = "string"
})
}
Property values
webtests
| Name | Description | Value |
|---|---|---|
| type | The resource type | "Microsoft.Insights/webtests@2015-05-01" |
| name | The resource name | string (required) |
| location | Resource location | string (required) |
| parent_id | To deploy to a resource group, use the ID of that resource group. | string (required) |
| tags | Resource tags | Dictionary of tag names and values. |
| kind | The kind of web test that this web test watches. Choices are ping and multistep. | "multistep" "ping" |
| properties | Metadata describing a web test for an Azure resource. | WebTestProperties |
WebTestProperties
| Name | Description | Value |
|---|---|---|
| Configuration | An XML configuration specification for a WebTest. | WebTestPropertiesConfiguration |
| Description | Purpose/user defined descriptive test for this WebTest. | string |
| Enabled | Is the test actively being monitored. | bool |
| Frequency | Interval in seconds between test runs for this WebTest. Default value is 300. | int |
| Kind | The kind of web test this is, valid choices are ping and multistep. | "multistep" "ping" (required) |
| Locations | A list of where to physically run the tests from to give global coverage for accessibility of your application. | WebTestGeolocation[] (required) |
| Name | User defined name if this WebTest. | string (required) |
| RetryEnabled | Allow for retries should this WebTest fail. | bool |
| SyntheticMonitorId | Unique ID of this WebTest. This is typically the same value as the Name field. | string (required) |
| Timeout | Seconds until this WebTest will timeout and fail. Default value is 30. | int |
WebTestPropertiesConfiguration
| Name | Description | Value |
|---|---|---|
| WebTest | The XML specification of a WebTest to run against an application. | string |
WebTestGeolocation
| Name | Description | Value |
|---|---|---|
| Id | Location ID for the webtest to run from. | string |
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for