Skip to content

Commit 35cda7c

Browse files
authored
Update overview-diagnostics.md
1 parent fa9f424 commit 35cda7c

File tree

1 file changed

+59
-19
lines changed

1 file changed

+59
-19
lines changed

articles/app-service/overview-diagnostics.md

Lines changed: 59 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -30,38 +30,78 @@ In the App Service diagnostics homepage, you can choose the category that best d
3030
> If your app is down or performing slow, you can [collect a profiling trace](https://azure.github.io/AppService/2018/06/06/App-Service-Diagnostics-Profiling-an-ASP.NET-Web-App-on-Azure-App-Service.html) to identify the root cause of the issue. Profiling is light weight and is designed for production scenarios.
3131
>
3232
33-
## Interactive interface
33+
## Diagnostic Interface
3434

35-
Once you select a homepage category that best aligns with your app's problem, App Service diagnostics' interactive interface, Genie, can guide you through diagnosing and solving problem with your app. You can use the tile shortcuts provided by Genie to view the full diagnostic report of the problem category that you are interested. The tile shortcuts provide you a direct way of accessing your diagnostic metrics.
35+
The homepage for App Service diagnostics offers streamlined diagnostics access using four sections:
3636

37-
![Tile shortcuts](./media/app-service-diagnostics/tile-shortcuts-2.png)
37+
- Ask Genie search box
38+
- Risk Alerts
39+
- Troubleshooting categories
40+
- Popular troubleshooting tools
3841

39-
After clicking on these tiles, you can see a list of topics related to the issue described in the tile. These topics provide snippets of notable information from the full report. You can click on any of these topics to investigate the issues further. Also, you can click on **View Full Report** to explore all the topics on a single page.
42+
## Ask Genie search box
4043

41-
![Topics](./media/app-service-diagnostics/application-logs-insights-3.png)
44+
The Genie search box is a quick way to find a diagnostic. The same diagnostic can be found through Troubleshooting categories.
4245

43-
![View Full Report](./media/app-service-diagnostics/view-full-report-4.png)
46+
![Genie Search ](./media/app-service-diagnostics/app-service-diagnostics-genie-alerts-search-1.png)
4447

45-
## Diagnostic report
4648

47-
After you choose to investigate the issue further by clicking on a topic, you can view more details about the topic often supplemented with graphs and markdowns. Diagnostic report can be a powerful tool for pinpointing the problem with your app.
49+
## Risk Alerts
50+
51+
The App Service diagnostics homepage performs a series of configuration checks and offers recommendations based on your unique application's configuration.
52+
53+
![Risk Alerts](./media/app-service-diagnostics/app-service-diagnostics-risk-alerts-1.png)
54+
55+
Recommendations and checks performed can be reviewed by clicking "View more details" link.
56+
57+
![RiskAlertsDetails](./media/app-service-diagnostics/app-service-diagnostics-risk-alerts-details-1.png)
58+
59+
## Troubleshooting categories
60+
61+
Troubleshooting categories group diagnostics for ease of discovery. The following are available:
62+
63+
- Availability and Performance
64+
- Configuration and Management
65+
- SSL and Domains
66+
- Risk Assessments
67+
- Navigator (Preview)
68+
- Diagnostic Tools
4869

49-
![Diagnostic report](./media/app-service-diagnostics/full-diagnostic-report-5.png)
5070

51-
## Health checkup
71+
![Diagnostic troubleshooting list](./media/app-service-diagnostics/app-service-diagnostics-troubleshooting-categories-1.png)
5272

53-
If you don't know what’s wrong with your app or don’t know where to start troubleshooting your issues, the health checkup is a good place to start. The health checkup analyzes your applications to give you a quick, interactive overview that points out what’s healthy and what’s wrong, telling you where to look to investigate the issue. Its intelligent and interactive interface provides you with guidance through the troubleshooting process. Health checkup is integrated with the Genie experience for Windows apps and web app down diagnostic report for Linux apps.
5473

55-
### Health checkup graphs
74+
The tiles or the Troubleshoot link show the available diagnostics for the category. If you were interested in investigating Availability and performance the following diagnostics are offered:
75+
76+
- Overview
77+
- Web App Down
78+
- Web App Slow
79+
- High CPU Analysis
80+
- Memory Analysis
81+
- Web App Restarted
82+
- Application Change (Preview)
83+
- Application Crashes
84+
- HTTP 4xx Errors
85+
- SNAT Failed Connection Endpoints
86+
- SWAP Effects on Availability
87+
- TCP Connections
88+
- Testing in Production
89+
- WebJob Details
90+
91+
92+
![Availability and Performance list](./media/app-service-diagnostics/app-service-diagnostics-availability-and-performance-1.png)
93+
94+
## Diagnostic report
95+
96+
After you choose to investigate the issue further by clicking on a topic, you can view more details about the topic often supplemented with graphs and markdowns. Diagnostic report can be a powerful tool for pinpointing the problem with your app. The following is the Overview for Availability and Performance:
97+
98+
![Diagnostic report](./media/app-service-diagnostics/full-diagnostic-report-5.png)
5699

57-
There are four different graphs in the health checkup.
100+
## Resiliency Score
58101

59-
- **requests and errors:** A graph that shows the number of requests made over the last 24 hours along with HTTP server errors.
60-
- **app performance:** A graph that shows response time over the last 24 hours for various percentile groups.
61-
- **CPU usage:** A graph that shows the overall percent CPU usage per instance over the last 24 hours.
62-
- **memory usage:** A graph that shows the overall percent physical memory usage per instance over the last 24 hours.
102+
If you don't know what’s wrong with your app or don’t know where to start troubleshooting your issues, the Get Resiliency Score report is a good place to start. Once a Troubleshooting category has been selected the Get Resilience Score report link is available and clicking it produces a PDF document with actionable insights.
63103

64-
![Health checkup](./media/app-service-diagnostics/health-checkup-6.png)
104+
![Resiliency Score report](./media/app-service-diagnostics/app-service-diagnostics-resiliency-report-1.png)
65105

66106
### Investigate application code issues (only for Windows app)
67107

@@ -71,7 +111,7 @@ Because many app issues are related to issues in your application code, App Serv
71111

72112
To view Application Insights exceptions and dependencies, select the **web app down** or **web app slow** tile shortcuts.
73113

74-
### Troubleshooting steps (only for Windows app)
114+
### Troubleshooting steps
75115

76116
If an issue is detected with a specific problem category within the last 24 hours, you can view the full diagnostic report, and App Service diagnostics may prompt you to view more troubleshooting advice and next steps for a more guided experience.
77117

0 commit comments

Comments
 (0)