|
1 | 1 | ---
|
2 |
| -title: Downtime, SLA, and outage workbook - Application Insights |
3 |
| -description: Calculate and report SLA for Web Test through a single pane of glass across your Application Insights resources and Azure subscriptions. |
| 2 | +title: Downtime, SLA, and outages workbook - Application Insights |
| 3 | +description: Calculate and report SLA for web test through a single pane of glass across your Application Insights resources and Azure subscriptions. |
4 | 4 | ms.topic: conceptual
|
5 | 5 | ms.date: 05/4/2021
|
6 | 6 | ms.reviwer: casocha
|
7 | 7 | ---
|
8 | 8 |
|
9 | 9 | # Downtime, SLA, and outages workbook
|
10 | 10 |
|
11 |
| -Introducing a simple way to calculate and report SLA (service-level agreement) for Web Tests through a single pane of glass across your Application Insights resources and Azure subscriptions. The Downtime and Outage report provides powerful pre-built queries and data visualizations to enhance your understanding of your customer's connectivity, typical application response time, and experienced down time. |
| 11 | +This article introduces a simple way to calculate and report service-level agreement (SLA) for web tests through a single pane of glass across your Application Insights resources and Azure subscriptions. The downtime and outage report provides powerful prebuilt queries and data visualizations to enhance your understanding of your customer's connectivity, typical application response time, and experienced downtime. |
12 | 12 |
|
13 |
| -The SLA workbook template is accessible through the workbook gallery in your Application Insights resource or through the availability tab by selecting **SLA Reports** at the top. |
14 |
| -:::image type="content" source="./media/sla-report/availability.png" alt-text="Screenshot of availability tab with SLA Reports highlighted." lightbox="./media/sla-report/availability.png"::: |
| 13 | +The SLA workbook template is accessible through the workbook gallery in your Application Insights resource. Or, in the left pane, select **Availability** and then select **SLA Report** at the top of the screen. |
| 14 | +:::image type="content" source="./media/sla-report/availability.png" alt-text="Screenshot that shows the Availability tab with SLA Report highlighted." lightbox="./media/sla-report/availability.png"::: |
15 | 15 |
|
16 |
| -:::image type="content" source="./media/sla-report/workbook-gallery.png" alt-text="Screenshot of the workbook gallery with downtime and outages workbook highlighted." lightbox ="./media/sla-report/workbook-gallery.png"::: |
| 16 | +:::image type="content" source="./media/sla-report/workbook-gallery.png" alt-text="Screenshot of the workbook gallery with the Downtime & Outages workbook highlighted." lightbox ="./media/sla-report/workbook-gallery.png"::: |
17 | 17 |
|
18 | 18 | ## Parameter flexibility
|
19 | 19 |
|
20 | 20 | The parameters set in the workbook influence the rest of your report.
|
21 | 21 |
|
22 |
| -:::image type="content" source="./media/sla-report/parameters.png" alt-text=" Screenshot of parameters." lightbox= "./media/sla-report/parameters.png"::: |
| 22 | +:::image type="content" source="./media/sla-report/parameters.png" alt-text=" Screenshot that shows parameters." lightbox= "./media/sla-report/parameters.png"::: |
23 | 23 |
|
24 |
| -`Subscriptions`, `App Insights Resources`, and `Web Test` parameters determine your high-level resource options. These parameters are based on Log Analytics queries and used in every report query. |
| 24 | +* `Subscriptions`, `App Insights Resources`, and `Web Test`: These parameters determine your high-level resource options. They're based on Log Analytics queries and are used in every report query. |
| 25 | +* `Failure Threshold` and `Outage Window`: You can use these parameters to determine your own criteria for a service outage. An example is the criteria for an App Insights Availability alert based on a failed location counter over a chosen period. The typical threshold is three locations over a five-minute window. |
| 26 | +* `Maintenance Period`: You can use this parameter to select your typical maintenance frequency. `Maintenance Window` is a datetime selector for an example maintenance period. All data that occurs during the identified period will be ignored in your results. |
| 27 | +* `Availability Target %`: This parameter specifies your target objective and takes custom values. |
25 | 28 |
|
26 |
| -`Failure Threshold` and `Outage Window` allow you to determine your own criteria for a service outage, for example, the criteria for App Insights Availability alert based upon failed location counter over a chosen period. The typical threshold is three locations over a five-minute window. |
27 |
| - |
28 |
| -`Maintenance Period` enables you to select your typical maintenance frequency and `Maintenance Window` is a datetime selector for an example maintenance period. All data that occurs during the identified period will be ignored in your results. |
| 29 | +## Overview page |
29 | 30 |
|
30 |
| -`Availability Target %` specifies your target objective & takes custom values. |
| 31 | +The overview page contains high-level information about your: |
31 | 32 |
|
32 |
| -## Overview page |
| 33 | +- Total SLA (excluding maintenance periods, if defined). |
| 34 | +- End-to-end outage instances. |
| 35 | +- Application downtime. |
33 | 36 |
|
34 |
| -The overview page contains high-level information about your total SLA (excluding maintenance periods if defined), end to end outage instances, and application downtime. Outage instances are defined by when a test starts to fail until it is successful based on your outage parameters. If a test starts failing at 8:00 am and succeeds again at 10:00 am, then that entire period of data is considered the same outage. |
| 37 | +Outage instances are defined by when a test starts to fail until it's successful, based on your outage parameters. If a test starts failing at 8:00 AM and succeeds again at 10:00 AM, that entire period of data is considered the same outage. |
35 | 38 |
|
36 |
| -:::image type="content" source="./media/sla-report/overview.gif" alt-text=" GIF of overview page showing the overview table by test." lightbox="./media/sla-report/overview.gif"::: |
| 39 | +:::image type="content" source="./media/sla-report/overview.gif" alt-text=" Screenshot that shows an overview page showing the Overview Table by Test." lightbox="./media/sla-report/overview.gif"::: |
37 | 40 |
|
38 |
| -You can also investigate your longest outage that occurred over your reporting period. |
| 41 | +You can also investigate the longest outage that occurred over your reporting period. |
39 | 42 |
|
40 |
| -Some tests are linkable back to their Application Insights resource for further investigation but that is only possible in the [Workspace-based Application Insights resource](create-workspace-resource.md). |
| 43 | +Some tests are linkable back to their Application Insights resource for further investigation. But that's only possible in the [workspace-based Application Insights resource](create-workspace-resource.md). |
41 | 44 |
|
42 | 45 | ## Downtime, outages, and failures
|
43 | 46 |
|
44 |
| -The **Outages and Downtime** tab has information on total outage instances and total down time broken down by test. The **Failures by Location** tab have a geo-map of failed testing locations to help identify potential problem connection areas. |
| 47 | +The **Outages & Downtime** tab has information on total outage instances and total downtime broken down by test. The **Failures by Location** tab has a geo-map of failed testing locations to help identify potential problem connection areas. |
45 | 48 |
|
46 |
| -:::image type="content" source="./media/sla-report/outages-failures.gif" alt-text=" GIF of Outages and Downtime tab and Failure by Location tab in the downtime and outages workbook." lightbox="./media/sla-report/outages-failures.gif"::: |
| 49 | +:::image type="content" source="./media/sla-report/outages-failures.gif" alt-text=" Screenshot that shows the Outages & Downtime tab and the Failure by Location tab in the downtime and outages workbook." lightbox="./media/sla-report/outages-failures.gif"::: |
47 | 50 |
|
48 | 51 | ## Edit the report
|
49 | 52 |
|
50 |
| -You can edit the report like any other [Azure Monitor Workbook](../visualize/workbooks-overview.md). You can customize the queries or visualizations based on your team's needs. |
| 53 | +You can edit the report like any other [Azure Monitor workbook](../visualize/workbooks-overview.md). You can customize the queries or visualizations based on your team's needs. |
51 | 54 |
|
52 |
| -:::image type="content" source="./media/sla-report/edit.gif" alt-text=" GIF of selecting the edit button to change the visualization to a pie chart." lightbox="./media/sla-report/edit.gif"::: |
| 55 | +:::image type="content" source="./media/sla-report/edit.gif" alt-text=" Screenshot that shows selecting the Edit button to change the visualization to a pie chart." lightbox="./media/sla-report/edit.gif"::: |
53 | 56 |
|
54 | 57 | ### Log Analytics
|
55 | 58 |
|
56 | 59 | The queries can all be run in [Log Analytics](../logs/log-analytics-overview.md) and used in other reports or dashboards. Remove the parameter restriction and reuse the core query.
|
57 | 60 |
|
58 |
| -:::image type="content" source="./media/sla-report/logs.gif" alt-text=" GIF of log query." lightbox="./media/sla-report/logs.gif"::: |
| 61 | +:::image type="content" source="./media/sla-report/logs.gif" alt-text=" Screenshot that shows a log query." lightbox="./media/sla-report/logs.gif"::: |
59 | 62 |
|
60 | 63 | ## Access and sharing
|
61 | 64 |
|
62 |
| -The report can be shared with your teams, leadership, or pinned to a dashboard for further use. The user needs to have read permission/access to the Applications Insights resource where the actual workbook is stored. |
| 65 | +The report can be shared with your teams and leadership or pinned to a dashboard for further use. The user needs to have read permission/access to the Application Insights resource where the actual workbook is stored. |
63 | 66 |
|
64 |
| -:::image type="content" source="./media/sla-report/share.png" alt-text=" Screenshot of share this template." lightbox= "./media/sla-report/share.png"::: |
| 67 | +:::image type="content" source="./media/sla-report/share.png" alt-text=" Screenshot that shows the Share Template pane." lightbox= "./media/sla-report/share.png"::: |
65 | 68 |
|
66 | 69 | ## Next steps
|
67 | 70 |
|
68 |
| -- [Log Analytics query optimization tips](../logs/query-optimization.md). |
| 71 | +- Learn some [Log Analytics query optimization tips](../logs/query-optimization.md). |
69 | 72 | - Learn how to [create a chart in workbooks](../visualize/workbooks-chart-visualizations.md).
|
70 | 73 | - Learn how to monitor your website with [availability tests](monitor-web-app-availability.md).
|
0 commit comments