Skip to content

Commit bee114c

Browse files
committed
fixed note placement; clarified chart-pinning instructions
1 parent b1bbaa5 commit bee114c

File tree

1 file changed

+27
-18
lines changed

1 file changed

+27
-18
lines changed

articles/spring-apps/includes/application-observability/application-observability-with-basic-standard-plan.md

Lines changed: 27 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ Spring Boot registers several metrics, such as JVM, web server, and logging-rela
4444
4545
#### Add custom metrics defined in application code
4646

47-
In the PetClinic's source code, the REST controllers are annotated with the micrometer `@Timed` annotation. This annotation collects metrics like the number of times a method is called or the execution time of a method.
47+
In the PetClinic source code, the REST controllers are annotated with the micrometer `@Timed` annotation. This annotation collects metrics like the number of times a method is called or the execution time of a method.
4848

4949
The following list shows the custom metrics details:
5050

@@ -90,13 +90,13 @@ A dashboard is a cognitive awareness and communication tool designed to help you
9090

9191
Use the following steps to create a custom dashboard and pin various quickstart panes and metrics charts to the dashboard. If you choose to use the built-in dashboard for Application Insights created by Azure Spring Apps, you can skip creating the dashboard and customizing the dashboard chart. For more information, see [Application Insights Overview dashboard](../../../azure-monitor/app/overview-dashboard.md).
9292

93+
> [!NOTE]
94+
> You can also choose a wizard based on Application Insights to quickly create a default dashboard.
95+
9396
1. From the Azure portal menu, select **Dashboard**. Your default view might already be set to dashboard.
9497

9598
1. Select **Create**, and then select **Custom** to create a custom dashboard.
9699

97-
> [!NOTE]
98-
> You can also choose a wizard based on Application Insights to quickly create a default dashboard.
99-
100100
1. Enter a name for the dashboard, and then select **Save**.
101101

102102
This action opens the **Tile Gallery** page, from which you can select the tiles, and an empty grid where you can arrange the tiles.
@@ -108,10 +108,12 @@ Use the following steps to create a custom dashboard and pin various quickstart
108108

109109
The most fundamental metrics for an application, especially a microservices application, are CPU usage, memory usage, liveness detection, and network traffic. These metrics provide an important basis for evaluating application scalability.
110110

111-
Use the following steps to pin the various charts to the dashboard.
111+
Use the following instructions to pin the various charts to the dashboard. These steps are similar for each chart. For some charts, additional instructions are provided.
112112

113113
##### Pin the "App CPU Usage" chart
114114

115+
To pin the "App CPU Usage" chart, use the following steps:
116+
115117
1. Go to the Azure Spring Apps instance overview page.
116118

117119
1. On the navigation menu, select **Metrics**, select the edit icon in the chart title, and then rename the chart title to *App CPU Usage*.
@@ -128,25 +130,28 @@ Use the following steps to pin the various charts to the dashboard.
128130

129131
##### Pin the "App Memory Usage" chart
130132

131-
For the **App Memory Usage** metric, save the **App Memory Usage** chart to the dashboard.
133+
To pin the **App Memory Usage** chart to the dashboard, use the steps in the previous section.
132134

133135
:::image type="content" source="../../media/application-observability/chart-app-memory-usage.png" alt-text="Screenshot of the Azure portal that shows the Azure Spring Apps Metrics page with the App Memory Usage chart." lightbox="../../media/application-observability/chart-app-memory-usage.png":::
134136

135137
##### Pin the "App Network In" chart
136138

137-
1. For the **App Network In** metric, provide the following information:
139+
To pin the "App Network In" chart, use the steps in the [Pin the "App CPU Usage" chart](#pin-the-app-cpu-usage-chart) section, but include the following steps:
140+
141+
1. On the **Metrics** page, select **Add filter**.
142+
143+
1. For **Property**, open the corresponding dropdown list and then select **App**.
138144

139-
- **Add filter**: Select this option.
140-
- **Property**: Open the corresponding dropdown list and select **App**.
141-
- **Operator**: Select **=**
142-
- **Values**: Select **admin-server** and **api-gateway**.
145+
1. For **Operator**, select **=**.
143146

144-
1. Save the **App Network In Usage** chart to the dashboard.
147+
1. For **Values**, select **admin-server** and **api-gateway**.
145148

146149
:::image type="content" source="../../media/application-observability/chart-app-network-in-usage.png" alt-text="Screenshot of the Azure portal that shows the Azure Spring Apps Metrics page with the App Network In chart." lightbox="../../media/application-observability/chart-app-network-in-usage.png":::
147150

148151
##### Pin the "Availability" chart
149152

153+
To pin the "Availability" chart, use the following steps:
154+
150155
1. Go to the Azure Spring Apps instance overview page.
151156

152157
1. On the navigation menu, select **Application Insights** to go to the Application Insights overview page.
@@ -167,25 +172,29 @@ The key data recorded in the process of the application serving users includes t
167172

168173
##### Pin the "Server exceptions and Dependency call failures" chart
169174

170-
For the **Server exception** and **Dependency call failures** metrics under the **Application Insights standard metrics** namespace, save the **Server exceptions and Dependency call failures** chart to the dashboard.
175+
To pin the "Server exceptions and Dependency call failures" chart, use the steps from the [Pin the "Availability" chart](#pin-the-availability-chart) section. The **Server exception** and **Dependency call failures** metrics are under the **Application Insights standard metrics** namespace.
171176

172177
:::image type="content" source="../../media/application-observability/chart-exceptions-and-failures.png" alt-text="Screenshot of the Azure portal that shows the Application Insights Metrics page with the Server exceptions and Dependency call failures chart." lightbox="../../media/application-observability/chart-exceptions-and-failures.png":::
173178

174179
##### Pin the "Failed requests" chart
175180

176-
For the **Failed requests** metric under the **Application Insights standard metrics** namespace, save the **Failed requests** chart to the dashboard.
181+
To pin the "Failed requests" chart, use the steps from the [Pin the "Availability" chart](#pin-the-availability-chart) section. The **Failed requests** metric is under the **Application Insights standard metrics** namespace.
177182

178183
:::image type="content" source="../../media/application-observability/chart-failed-requests.png" alt-text="Screenshot of the Azure portal that shows the Application Insights Metrics page with the Failed requests chart." lightbox="../../media/application-observability/chart-failed-requests.png":::
179184

180185
##### Pin the "Request count" chart
181186

182-
For the **Server requests** metric under the **Application Insights standard metrics** namespace, add a filter to filter the **Cloud role name** with **api-gateway** and **admin-server**, apply splitting for **Values** with **Cloud role name**, and then save the **Request count** chart to the dashboard.
187+
To pin the "Request count" chart, use the steps from the [Pin the "Availability" chart](#pin-the-availability-chart) section, but include the following steps. The **Server requests** metric is under the **Application Insights standard metrics** namespace.
188+
189+
1. Add a filter to filter the **Cloud role name** with **api-gateway** and **admin-server**.
190+
191+
1. Apply splitting for **Values** with **Cloud role name**.
183192

184193
:::image type="content" source="../../media/application-observability/chart-request-count.png" alt-text="Screenshot of the Azure portal that shows the Application Insights Metrics page with the Request count chart." lightbox="../../media/application-observability/chart-request-count.png":::
185194

186195
##### Pin the "Response time" chart
187196

188-
For the **Server response time** metric under the **Application Insights standard metrics** namespace, add a filter to filter the **Cloud role name** with **api-gateway**, and then save the **Response time** chart to the dashboard.
197+
To pin the "Response time" chart, use the steps from the [Pin the "Availability" chart](#pin-the-availability-chart) section, but add a filter to filter the **Cloud role name** with **api-gateway**. The **Server response time** metric is under the **Application Insights standard metrics** namespace.
189198

190199
:::image type="content" source="../../media/application-observability/chart-response-time.png" alt-text="Screenshot of the Azure portal that shows the Application Insights Metrics page with the Response time chart." lightbox="../../media/application-observability/chart-response-time.png":::
191200

@@ -195,13 +204,13 @@ Database performance is the cornerstone of normal service for all applications.
195204

196205
#### Pin the "Active MySQL connections" chart
197206

198-
For the **hikaricp_connection_active** metric under the **Log-based metrics** namespace, save the **Active MySQL connections** chart to the dashboard.
207+
To pin the "Active MySQL connections" chart, use the steps from the [Pin the "Availability" chart](#pin-the-availability-chart) section. The **hikaricp_connection_active** metric is under the **Log-based metrics** namespace.
199208

200209
:::image type="content" source="../../media/application-observability/chart-connection-active.png" alt-text="Screenshot of the Azure portal that shows the Application Insights Metrics page with the Active MySQL connections chart." lightbox="../../media/application-observability/chart-connection-active.png":::
201210

202211
#### Pin content from a resource page
203212

204-
Pin some commonly used links into the dashboard, which lets you quickly open the operation page on Azure or other resource pages, and improves efficiency.
213+
Pin some commonly used links into the dashboard. These links let you quickly open the operation page on Azure or other resource pages.
205214

206215
To pin common panes of the Azure portal to the dashboard, use the following steps:
207216

0 commit comments

Comments
 (0)