Skip to content

Commit 0d8293b

Browse files
committed
Adding new screenshots
1 parent 298b8f5 commit 0d8293b

File tree

4 files changed

+13
-11
lines changed

4 files changed

+13
-11
lines changed

articles/azure-monitor/app/availability.md

Lines changed: 13 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,9 @@ ms.reviewer: cogoodson
88

99
# Application Insights availability tests
1010

11-
After deploying your web app or website, it's crucial to ensure its availability and responsiveness to provide a seamless user experience. [Application Insights](./app-insights-overview.md) allows you to set up recurring web tests that monitor your application's availability and responsiveness from various points around the world. These tests send web requests to your application at regular intervals and alert you if your application isn't responding or if the response time is too slow.
11+
[Application Insights](./app-insights-overview.md) allows you to set up recurring web tests that monitor your application's availability and responsiveness from various points around the world. These tests send web requests to your application at regular intervals and alert you if your application isn't responding or if the response time is too slow.
1212

13-
Availability tests are versatile and don't require any modifications to the website you're testing. They work for any HTTP or HTTPS endpoint accessible from the public internet, including REST APIs that your service depends on. This means you can monitor not only your own applications but also external services that are critical to your application's functionality.
13+
Availability tests don't require any modifications to the website you're testing. They work for any HTTP or HTTPS endpoint accessible from the public internet, including REST APIs that your service depends on. This means you can monitor not only your own applications but also external services that are critical to your application's functionality.
1414

1515
> [!NOTE]
1616
> Availability tests are stored encrypted, according to [Azure data encryption at rest](../../security/fundamentals/encryption-atrest.md#encryption-at-rest-in-microsoft-cloud-services) policies.
@@ -86,7 +86,7 @@ There are four types of availability tests:
8686
> [!div class="checklist"]
8787
> * [Workspace-based Application Insights resource](create-workspace-resource.md)
8888
> * Access to the source code of a [Azure Functions app](../../azure-functions/functions-how-to-use-azure-function-app-settings.md) in Azure Functions
89-
> * Developer expertise capable of authoring [custom code](#basic-code-sample) for [TrackAvailability()](/dotnet/api/microsoft.applicationinsights.telemetryclient.trackavailability), tailored to your specific business needs
89+
> * Developer expertise to author [custom code](#basic-code-sample) for [TrackAvailability()](/dotnet/api/microsoft.applicationinsights.telemetryclient.trackavailability), tailored to your specific business needs
9090
9191
### Basic code sample
9292

@@ -301,6 +301,8 @@ You can use the following population tags for the geo-location attribute when yo
301301

302302
1. On the **Alert rules** page, open your alert, then select **Edit** in the top navigation bar. Here you can set the severity level, rule description, and action group that have the notification preferences you want to use for this alert rule.
303303

304+
:::image type="content" source="media/availability/metric-alert-rule.png" alt-text="Screenshot that shows an alert rule page in the Azure portal with Edit highlighted." lightbox="media/availability/metric-alert-rule.png":::
305+
304306
### Alert criteria
305307

306308
Automatically enabled availability alerts trigger one email when the endpoint becomes unavailable, and another email when it's available again. Availability alerts that are created through this experience are *state based*. When the alert criteria are met, a single alert gets generated when the website is detected as unavailable. If the website is still down the next time the alert criteria is evaluated, it won't generate a new alert.
@@ -311,11 +313,13 @@ For example, suppose that your website is down for an hour and you set up an ema
311313

312314
You might not want to receive notifications when your website is down for only a short period of time, for example, during maintenance. You can change the evaluation frequency to a higher value than the expected downtime, up to 15 minutes. You can also increase the alert location threshold so that it only triggers an alert if the website is down for a specific number of regions.
313315

314-
> [TIP]
316+
> [!TIP]
315317
> For longer scheduled downtimes, temporarily deactivate the alert rule or create a custom rule. It gives you more options to account for the downtime.
316318

317319
To make changes to the location threshold, aggregation period, and test frequency, go to the **Edit alert rule** page (see step 2 under [Enable alerts](#enable-alerts)), then select the condition to open the **Configure signal logic** window.
318320

321+
:::image type="content" source="media/availability/configure-signal-logic.png" alt-text="Screenshot that shows a highlighted alert condition and the Configure signal logic window." lightbox="media/availability/configure-signal-logic.png":::
322+
319323
### Create a custom alert rule
320324

321325
If you need advanced capabilities, you can create a custom alert rule on the **Alerts** tab. Select **Create** > **Alert rule**. Choose **Metrics** for **Signal type** to show all available signals and select **Availability**.
@@ -361,7 +365,7 @@ Start by reviewing the graph in the **Availability** experience in the Azure por
361365

362366
By default, the Availability experience shows a line graph. Change the view to **Scatter Plot** to see samples of the test results that have diagnostic test-step detail in them. The test engine stores diagnostic detail for tests that have failures. For successful tests, diagnostic details are stored for a subset of the executions. To see the test, test name, and location, hover over any of the green dots or red crosses.
363367

364-
:::image type="content" source="media/availability/scatter-plot.png" alt-text="Screenshot that shows the Scatter Plot view in the Availability experience." lightbox="media/availability/scatter-plot.png":::
368+
:::image type="content" source="media/availability/scatter-plot.png" alt-text="Screenshot that shows the Scatter Plot view in the Availability experience.":::
365369

366370
Select a particular test or location. Or you can reduce the time period to see more results around the time period of interest. Use Search Explorer to see results from all executions. Or you can use Log Analytics queries to run custom reports on this data.
367371

@@ -373,7 +377,7 @@ To see the end-to-end transaction details, under **Drill into**, select **Succes
373377

374378
To edit, temporarily disable, or delete a test, open the context menu (ellipsis) by the test, then select **Edit**. It might take up to 20 minutes for configuration changes to propagate to all test agents after a change is made.
375379

376-
:::image type="content" source="media/availability/edit-availability-test.png" alt-text="Screenshot that shows the context menu to Edit, Disable, and Delete web tests." border="false":::
380+
:::image type="content" source="media/availability/edit-availability-test.png" alt-text="Screenshot that shows the context menu to Edit, Disable, and Delete web tests.":::
377381

378382
> [!TIP]
379383
> You might want to disable availability tests or the alert rules associated with them while you're performing maintenance on your service.
@@ -382,7 +386,7 @@ To edit, temporarily disable, or delete a test, open the context menu (ellipsis)
382386

383387
Open the **End-to-end transaction details** view by selecting a red cross on the Scatter Plot.
384388

385-
:::image type="content" source="./media/availability/end-to-end-transaction-details.png" alt-text="Screenshot that shows the End-to-end transaction details tab." border="false":::
389+
:::image type="content" source="media/availability/end-to-end-transaction-details.png" alt-text="Screenshot that shows the End-to-end transaction details tab." lightbox="media/availability/end-to-end-transaction-details.png":::
386390

387391
Here you can:
388392

@@ -396,7 +400,7 @@ To learn more about the end-to-end transaction diagnostics experience, see the [
396400

397401
Select the exception row to see the details of the server-side exception that caused the synthetic availability test to fail. You can also get the [debug snapshot](./snapshot-debugger.md) for richer code-level diagnostics.
398402

399-
:::image type="content" source="media/availability/end-to-end-open-debug-snapshot.png" alt-text="Screenshot that shows the Server-side diagnostics.":::
403+
:::image type="content" source="media/availability/end-to-end-open-debug-snapshot.png" alt-text="Screenshot that shows the Server-side diagnostics." lightbox="media/availability/end-to-end-open-debug-snapshot.png":::
400404

401405
In addition to the raw results, you can also view two key availability metrics in [metrics explorer](../essentials/metrics-getting-started.md):
402406

@@ -507,9 +511,7 @@ Set custom headers in [standard availability tests](availability-standard-tests.
507511

508512
Alternatively, set the availability test string identifier as a query parameter.
509513

510-
**Example:**
511-
512-
```https://yourtestendpoint/?x-customer-instanceid=applicationinsightsavailability:<your availability test string identifier>```
514+
**Example:** ```https://yourtestendpoint/?x-customer-instanceid=applicationinsightsavailability:<your availability test string identifier>```
513515

514516
#### Configure your firewall to permit incoming requests from availability tests
515517

106 KB
Loading
3.62 KB
Loading
141 KB
Loading

0 commit comments

Comments
 (0)