Skip to content

Commit e1f2b7a

Browse files
committed
Removing leftovers from TrackAvailability-specific content
1 parent 9eefb35 commit e1f2b7a

File tree

1 file changed

+27
-36
lines changed

1 file changed

+27
-36
lines changed

articles/azure-monitor/app/availability.md

Lines changed: 27 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -37,16 +37,17 @@ There are four types of availability tests:
3737

3838
## Create an availability test
3939

40+
## [Standard test](#tab/standard)
41+
4042
> [!TIP]
4143
> If you're currently using other availability tests, like URL ping tests, you might add Standard tests alongside the others. If you want to use Standard tests instead of one of your other tests, add a Standard test and delete your old test.
4244
43-
### [Standard test](#tab/standard)
44-
45-
#### Prerequisites
45+
### Prerequisites
4646

47-
To create an availability test, you must use an existing Application Insights resource or [create an Application Insights resource](create-workspace-resource.md).
47+
> [!div class="checklist"]
48+
> * [Workspace-based Application Insights resource](create-workspace-resource.md)
4849
49-
#### Get started
50+
### Get started
5051

5152
1. Go to your Application Insights resource and select the **Availability** pane.
5253

@@ -69,26 +70,26 @@ To create an availability test, you must use an existing Application Insights re
6970
| **HTTP request verb** | Indicate what action you want to take with your request. |
7071
| **Request body** | Custom data associated with your HTTP request. You can upload your own files, enter your content, or disable this feature. |
7172

72-
#### Success criteria
73+
### Success criteria
7374

7475
| Setting | Description |
7576
|--------|--------------|
7677
| **Test timeout** |Decrease this value to be alerted about slow responses. The test is counted as a failure if the responses from your site haven't been received within this period. If you selected **Parse dependent requests**, all the images, style files, scripts, and other dependent resources must have been received within this period. |
7778
| **HTTP response** | The returned status code that's counted as a success. The number 200 is the code that indicates that a normal webpage has been returned. |
7879
| **Content match** | A string, like "Welcome!" We test that an exact case-sensitive match occurs in every response. It must be a plain string, without wildcards. Don't forget that if your page content changes, you might have to update it. *Only English characters are supported with content match.* |
7980

80-
#### Alerts
81+
### Alerts
8182

8283
| Setting | Description |
8384
|---------|-------------|
8485
| **Near real time** | We recommend using near real time alerts. Configuring this type of alert is done after your availability test is created. |
8586
| **Alert location threshold** |We recommend a minimum of 3/5 locations. The optimal relationship between alert location threshold and the number of test locations is **alert location threshold** = **number of test locations - 2, with a minimum of five test locations.** |
8687

87-
#### Location population tags
88+
### Location population tags
8889

8990
You can use the following population tags for the geo-location attribute when you deploy an availability URL ping test by using Azure Resource Manager.
9091

91-
##### Azure
92+
#### Azure
9293

9394
| Display name | Population name |
9495
|----------------------------------------|-------------------|
@@ -109,7 +110,7 @@ You can use the following population tags for the geo-location attribute when yo
109110
| West US | us-ca-sjc-azr |
110111
| UK South | emea-ru-msa-edge |
111112

112-
##### Azure Government
113+
#### Azure Government
113114

114115
| Display name | Population name |
115116
|----------------|---------------------|
@@ -119,7 +120,7 @@ You can use the following population tags for the geo-location attribute when yo
119120
| USDoD East | usgov-ddeast-azr |
120121
| USDoD Central | usgov-ddcentral-azr |
121122

122-
##### Microsoft Azure operated by 21Vianet
123+
#### Microsoft Azure operated by 21Vianet
123124

124125
| Display name | Population name |
125126
|----------------|---------------------|
@@ -128,25 +129,26 @@ You can use the following population tags for the geo-location attribute when yo
128129
| China North | mc-cnn-azr |
129130
| China North 2 | mc-cnn2-azr |
130131

131-
### [TrackAvailability()](#tab/track)
132+
## [TrackAvailability()](#tab/track)
132133

133134
> [!IMPORTANT]
134135
> [TrackAvailability()](/dotnet/api/microsoft.applicationinsights.telemetryclient.trackavailability) requires making a developer investment in writing and maintanining potentially complex custom code. *[Standard tests](#standard-test) should always be used if possible* as they require little investment, no maintenance, and have few prerequisites.
135136
136-
#### Prerequisites
137-
138-
To create an availability test, you must use an existing Application Insights resource or [create an Application Insights resource](create-workspace-resource.md).
137+
### Prerequisites
139138

140-
#### Get started
139+
> [!div class="checklist"]
140+
> * [Workspace-based Application Insights resource](create-workspace-resource.md)
141+
> * Access to the source code of a [function app](../../azure-functions/functions-how-to-use-azure-function-app-settings.md) in Azure Functions
142+
> * Developer expertise capable of authoring [custom code](#basic-code-sample) for [TrackAvailability()](/dotnet/api/microsoft.applicationinsights.telemetryclient.trackavailability), tailored to your specific business needs
141143
142-
##### Basic code sample
144+
### Basic code sample
143145

144146
> [!NOTE]
145147
> This example is designed solely to show you the mechanics of how the `TrackAvailability()` API call works within an Azure function. It doesn't show you how to write the underlying HTTP test code or business logic that's required to turn this example into a fully functional availability test. By default, if you walk through this example, you'll be creating a basic availability HTTP GET test.
146148
>
147149
> To follow these instructions, you must use the [dedicated plan](../../azure-functions/dedicated-plan.md) to allow editing code in App Service Editor.
148150
149-
###### Create a timer trigger function
151+
#### Create a timer trigger function
150152

151153
1. Create an Azure Functions resource.
152154
If you already have an Application Insights resource:
@@ -173,7 +175,7 @@ To create an availability test, you must use an existing Application Insights re
173175

174176
:::image type="content" source="media/availability-azure-functions/add-function.png" alt-text="Screenshot that shows how to add a timer trigger function to your function app." lightbox="media/availability-azure-functions/add-function.png":::
175177

176-
###### Add and edit code in the App Service Editor
178+
#### Add and edit code in the App Service Editor
177179

178180
Go to your deployed function app, and under **Development Tools**, select the **App Service Editor** tab.
179181

@@ -305,7 +307,7 @@ To create a new file, right-click under your timer trigger function (for example
305307

306308
```
307309

308-
###### Multi-step web test code sample
310+
#### Multi-step web test code sample
309311

310312
Follow the same instructions above and instead paste the following code into the **runAvailabilityTest.csx** file:
311313

@@ -382,17 +384,17 @@ To automate this process with Azure Resource Manager templates, see [Create a me
382384

383385
## See your availability test results
384386

385-
Availability test results can be visualized with both **Line** and **Scatter Plot** views. After a few minutes, select **Refresh** to see your test results.
386-
387+
This section explains how to review availability test results in the Azure portal and query the data using [Log Analytics](../logs/log-analytics-overview.md#overview-of-log-analytics-in-azure-monitor). Availability test results can be visualized with both **Line** and **Scatter Plot** views.
388+
387389
### Check availability
388390

389391
Start by reviewing the graph on the **Availability** tab of your Application Insights resource.
390392

391-
#### [Standard test](#tab/standard)
393+
### [Standard test](#tab/standard)
392394

393395
:::image type="content" source="./media/monitor-web-app-availability/availability-refresh-002.png" alt-text="Screenshot that shows the Availability page with the Refresh button highlighted.":::
394396

395-
#### [TrackAvailability](#tab/track)
397+
### [TrackAvailability](#tab/track)
396398

397399
> [!NOTE]
398400
> Tests created with `TrackAvailability()` will appear with **CUSTOM** next to the test name.
@@ -446,18 +448,7 @@ In addition to the raw results, you can also view two key availability metrics i
446448
* **Availability**: Percentage of the tests that were successful across all test executions.
447449
* **Test Duration**: Average test duration across all test executions.
448450

449-
### Custom TrackAvailability test
450-
451-
This section explains how to review [TrackAvailability()](/dotnet/api/microsoft.applicationinsights.telemetryclient.trackavailability) test results in the Azure portal and query the data using [Log Analytics](../logs/log-analytics-overview.md#overview-of-log-analytics-in-azure-monitor).
452-
453-
#### Prerequisites
454-
455-
> [!div class="checklist"]
456-
> * [Workspace-based Application Insights resource](create-workspace-resource.md)
457-
> * Access to the source code of a [function app](../../azure-functions/functions-how-to-use-azure-function-app-settings.md) in Azure Functions
458-
> * Developer expertise capable of authoring [custom code](#basic-code-sample) for [TrackAvailability()](/dotnet/api/microsoft.applicationinsights.telemetryclient.trackavailability), tailored to your specific business needs
459-
460-
#### Query in Log Analytics
451+
### Query in Log Analytics
461452

462453
You can use Log Analytics to view your availability results, dependencies, and more. To learn more about Log Analytics, see [Log query overview](../logs/log-query-overview.md).
463454

0 commit comments

Comments
 (0)