Skip to content

Commit a07f0de

Browse files
Merge pull request #207108 from SteveSaunders1952/v-ssaunders-quickstart-logs-metrics-tracing
quickstart-logs-metrics-tracing screenshot update
2 parents d3e7643 + 4861ccb commit a07f0de

File tree

3 files changed

+38
-34
lines changed

3 files changed

+38
-34
lines changed
-256 KB
Loading

articles/spring-apps/quickstart-logs-metrics-tracing.md

Lines changed: 33 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -18,18 +18,19 @@ zone_pivot_groups: programming-languages-spring-apps
1818
**This article applies to:** ✔️ Basic/Standard tier ❌ Enterprise tier
1919

2020
::: zone pivot="programming-language-csharp"
21+
2122
With the built-in monitoring capability in Azure Spring Apps, you can debug and monitor complex issues. Azure Spring Apps integrates Steeltoe [distributed tracing](https://docs.steeltoe.io/api/v3/tracing/) with Azure's [Application Insights](../azure-monitor/app/app-insights-overview.md). This integration provides powerful logs, metrics, and distributed tracing capability from the Azure portal.
2223

2324
The following procedures explain how to use Log Streaming, Log Analytics, Metrics, and Distributed Tracing with the sample app that you deployed in the preceding quickstarts.
2425

2526
## Prerequisites
2627

27-
* Complete the previous quickstarts in this series:
28+
- Complete the previous quickstarts in this series:
2829

29-
* [Provision Azure Spring Apps service](./quickstart-provision-service-instance.md).
30-
* [Set up Azure Spring Apps configuration server](./quickstart-setup-config-server.md).
31-
* [Build and deploy apps](./quickstart-deploy-apps.md).
32-
* [Set up Log Analytics workspace](./quickstart-setup-log-analytics.md).
30+
- [Provision an Azure Spring Apps service instance](./quickstart-provision-service-instance.md).
31+
- [Quickstart: Set up Spring Cloud Config Server for Azure Spring Apps](./quickstart-setup-config-server.md).
32+
- [Build and deploy apps to Azure Spring Apps](./quickstart-deploy-apps.md).
33+
- [Set up a Log Analytics workspace](./quickstart-setup-log-analytics.md).
3334

3435
## Logs
3536

@@ -43,7 +44,7 @@ You can use log streaming in the Azure CLI with the following command.
4344
az spring app logs -n solar-system-weather -f
4445
```
4546

46-
You will see output similar to the following example:
47+
You'll see output similar to the following example:
4748

4849
```output
4950
=> ConnectionId:0HM2HOMHT82UK => RequestPath:/weatherforecast RequestId:0HM2HOMHT82UK:00000003, SpanId:|e8c1682e-46518cc0202c5fd9., TraceId:e8c1682e-46518cc0202c5fd9, ParentId: => Microsoft.Azure.SpringCloud.Sample.SolarSystemWeather.Controllers.WeatherForecastController.Get (Microsoft.Azure.SpringCloud.Sample.SolarSystemWeather)
@@ -70,7 +71,7 @@ Executing ObjectResult, writing value of type 'System.Collections.Generic.KeyVal
7071

7172
1. Edit the query to remove the Where clauses that limit the display to warning and error logs.
7273

73-
1. Then select `Run`, and you will see logs. See [Azure Log Analytics docs](../azure-monitor/logs/get-started-queries.md) for more guidance on writing queries.
74+
1. Then select **Run**, and you'll see logs. For more information, see [Get started with log queries in Azure Monitor](../azure-monitor/logs/get-started-queries.md).
7475

7576
:::image type="content" source="media/quickstart-logs-metrics-tracing/logs-query-steeltoe.png" alt-text="Screenshot of a Logs Analytics query." lightbox="media/quickstart-logs-metrics-tracing/logs-query-steeltoe.png":::
7677

@@ -100,26 +101,28 @@ Executing ObjectResult, writing value of type 'System.Collections.Generic.KeyVal
100101

101102
:::image type="content" source="media/quickstart-logs-metrics-tracing/tracing-overview-steeltoe.png" alt-text="Screenshot of the Application map page." lightbox="media/quickstart-logs-metrics-tracing/tracing-overview-steeltoe.png":::
102103

103-
1. Select the link between **solar-system-weather** and **planet-weather-provider** to see more details like slowest calls by HTTP methods.
104+
1. Select the link between **solar-system-weather** and **planet-weather-provider** to see more details such as the slowest calls by HTTP methods.
104105

105106
:::image type="content" source="media/quickstart-logs-metrics-tracing/tracing-call-steeltoe.png" alt-text="Screenshot of Application map details." lightbox="media/quickstart-logs-metrics-tracing/tracing-call-steeltoe.png":::
106107

107108
1. Finally, select **Investigate Performance** to explore more powerful built-in performance analysis.
108109

109110
:::image type="content" source="media/quickstart-logs-metrics-tracing/tracing-performance-steeltoe.png" alt-text="Screenshot of Performance page." lightbox="media/quickstart-logs-metrics-tracing/tracing-performance-steeltoe.png":::
111+
110112
::: zone-end
111113

112114
::: zone pivot="programming-language-java"
115+
113116
With the built-in monitoring capability in Azure Spring Apps, you can debug and monitor complex issues. Azure Spring Apps integrates [Spring Cloud Sleuth](https://spring.io/projects/spring-cloud-sleuth) with Azure's [Application Insights](../azure-monitor/app/app-insights-overview.md). This integration provides powerful logs, metrics, and distributed tracing capability from the Azure portal. The following procedures explain how to use Log Streaming, Log Analytics, Metrics, and Distributed tracing with deployed PetClinic apps.
114117

115118
## Prerequisites
116119

117-
Complete previous steps:
120+
- Complete the previous quickstarts in this series:
118121

119-
* [Provision an instance of Azure Spring Apps](./quickstart-provision-service-instance.md)
120-
* [Set up the config server](./quickstart-setup-config-server.md). For enterprise tier, please follow [set up Application Configuration Service](./how-to-enterprise-application-configuration-service.md).
121-
* [Build and deploy apps](./quickstart-deploy-apps.md).
122-
* [Set up Log Analytics workspace](./quickstart-setup-log-analytics.md).
122+
- [Provision an Azure Spring Apps service instance](./quickstart-provision-service-instance.md).
123+
- [Quickstart: Set up Spring Cloud Config Server for Azure Spring Apps](./quickstart-setup-config-server.md).
124+
- [Build and deploy apps to Azure Spring Apps](./quickstart-deploy-apps.md).
125+
- [Set up a Log Analytics workspace](./quickstart-setup-log-analytics.md).
123126

124127
## Logs
125128

@@ -135,7 +138,7 @@ You can use log streaming in the Azure CLI with the following command.
135138
az spring app logs -s <service instance name> -g <resource group name> -n gateway -f
136139
```
137140

138-
You will see logs like this:
141+
You'll see logs like this:
139142

140143
:::image type="content" source="media/quickstart-logs-metrics-tracing/logs-streaming-cli.png" alt-text="Screenshot of CLI log output." lightbox="media/quickstart-logs-metrics-tracing/logs-streaming-cli.png":::
141144

@@ -174,35 +177,34 @@ To get the logs using Azure Toolkit for IntelliJ:
174177

175178
:::image type="content" source="media/quickstart-logs-metrics-tracing/logs-entry.png" alt-text="Screenshot of the Logs opening page." lightbox="media/quickstart-logs-metrics-tracing/logs-entry.png":::
176179

177-
1. Then you will see filtered logs. See [Azure Log Analytics docs](../azure-monitor/logs/get-started-queries.md) for more guidance on writing queries.
180+
1. Then you'll see filtered logs. For more information, see [Get started with log queries in Azure Monitor](../azure-monitor/logs/get-started-queries.md).
178181

179182
:::image type="content" source="media/quickstart-logs-metrics-tracing/logs-query.png" alt-text="Screenshot of filtered logs." lightbox="media/quickstart-logs-metrics-tracing/logs-query.png":::
180183

181184
## Metrics
182185

183-
Navigate to the `Application insights` blade. Then, navigate to the `Metrics` blade - you can see metrics contributed by Spring Boot apps, Spring modules, and dependencies.
186+
Navigate to the `Application insights` blade, and then navigate to the `Metrics` blade. You can see metrics contributed by Spring Boot apps, Spring modules, and dependencies.
184187

185-
The following chart shows `gateway-requests` (Spring Cloud Gateway), `hikaricp_connections`
186-
(JDBC Connections) and `http_client_requests`.
188+
The following chart shows `gateway-requests` (Spring Cloud Gateway), `hikaricp_connections` (JDBC Connections), and `http_client_requests`.
187189

188190
:::image type="content" source="media/quickstart-logs-metrics-tracing/petclinic-microservices-metrics.jpg" alt-text="Screenshot of gateway requests." lightbox="media/quickstart-logs-metrics-tracing/petclinic-microservices-metrics.jpg":::
189191

190-
Spring Boot registers a lot number of core metrics: JVM, CPU, Tomcat, Logback...
191-
The Spring Boot auto-configuration enables the instrumentation of requests handled by Spring MVC.
192-
All those three REST controllers `OwnerResource`, `PetResource` and `VisitResource` have been instrumented by the `@Timed` Micrometer annotation at class level.
192+
Spring Boot registers several core metrics, including JVM, CPU, Tomcat, and Logback. The Spring Boot auto-configuration enables the instrumentation of requests handled by Spring MVC. All three REST controllers (`OwnerResource`, `PetResource`, and `VisitResource`) have been instrumented by the `@Timed` Micrometer annotation at the class level.
193+
194+
The `customers-service` application has the following custom metrics enabled:
195+
196+
- @Timed: `petclinic.owner`
197+
- @Timed: `petclinic.pet`
198+
199+
The `visits-service` application has the following custom metrics enabled:
193200

194-
* `customers-service` application has the following custom metrics enabled:
195-
* @Timed: `petclinic.owner`
196-
* @Timed: `petclinic.pet`
197-
* `visits-service` application has the following custom metrics enabled:
198-
* @Timed: `petclinic.visit`
201+
- @Timed: `petclinic.visit`
199202

200203
You can see these custom metrics in the `Metrics` blade:
201204

202205
:::image type="content" source="media/quickstart-logs-metrics-tracing/petclinic-microservices-custom-metrics.jpg" alt-text="Screenshot of the Metrics blade with custom metrics." lightbox="media/quickstart-logs-metrics-tracing/petclinic-microservices-custom-metrics.jpg":::
203206

204-
You can use the Availability Test feature in Application Insights and monitor
205-
the availability of applications:
207+
You can use the Availability Test feature in Application Insights and monitor the availability of applications:
206208

207209
:::image type="content" source="media/quickstart-logs-metrics-tracing/petclinic-microservices-availability.jpg" alt-text="Screenshot of the Availability Test feature." lightbox="media/quickstart-logs-metrics-tracing/petclinic-microservices-availability.jpg":::
208210

@@ -262,5 +264,7 @@ az config set defaults.group=
262264
To explore more monitoring capabilities of Azure Spring Apps, see:
263265

264266
> [!div class="nextstepaction"]
265-
> [Analyze logs and metrics with diagnostics settings](diagnostic-services.md)>
267+
>
268+
> [Analyze logs and metrics with diagnostics settings](diagnostic-services.md)
269+
>
266270
> [Stream Azure Spring Apps app logs in real-time](./how-to-log-streaming.md)

articles/spring-apps/quickstart-setup-config-server.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: "Quickstart - Set up Azure Spring Apps Config Server"
2+
title: "Quickstart: Set up Spring Cloud Config Server for Azure Spring Apps"
33
description: Describes the setup of Azure Spring Apps Config Server for app deployment.
44
author: karlerickson
55
ms.author: karler
@@ -10,14 +10,14 @@ ms.custom: devx-track-java, fasttrack-edit, mode-other, event-tier1-build-2022
1010
zone_pivot_groups: programming-languages-spring-apps
1111
---
1212

13-
# Quickstart: Set up Azure Spring Apps Config Server
13+
# Quickstart: Set up Spring Cloud Config Server for Azure Spring Apps
1414

1515
> [!NOTE]
1616
> Azure Spring Apps is the new name for the Azure Spring Cloud service. Although the service has a new name, you'll see the old name in some places for a while as we work to update assets such as screenshots, videos, and diagrams.
1717
1818
**This article applies to:** ✔️ Basic/Standard tier ❌ Enterprise tier
1919

20-
Azure Spring Apps Config Server is a centralized configuration service for distributed systems. It uses a pluggable repository layer that currently supports local storage, Git, and Subversion. In this quickstart, you set up the Config Server to get data from a Git repository.
20+
Config Server is a centralized configuration service for distributed systems. It uses a pluggable repository layer that currently supports local storage, Git, and Subversion. In this quickstart, you set up the Config Server to get data from a Git repository.
2121

2222
::: zone pivot="programming-language-csharp"
2323

@@ -26,7 +26,7 @@ Azure Spring Apps Config Server is a centralized configuration service for distr
2626
- Completion of the previous quickstart in this series: [Provision Azure Spring Apps service](./quickstart-provision-service-instance.md).
2727
- Azure Spring Apps Config Server is only applicable to basic or standard tier.
2828

29-
## Azure Spring Apps Config Server procedures
29+
## Config Server procedures
3030

3131
Set up your Config Server with the location of the git repository for the project by running the following command. Replace *\<service instance name>* with the name of the service you created earlier. The default value for service instance name that you set in the preceding quickstart doesn't work with this command.
3232

@@ -47,7 +47,7 @@ This command tells Config Server to find the configuration data in the [steeltoe
4747
- Optionally, [Azure CLI version 2.0.67 or higher](/cli/azure/install-azure-cli). Install the Azure Spring Apps extension with the following command: `az extension add --name spring`
4848
- Optionally, [the Azure Toolkit for IntelliJ](https://plugins.jetbrains.com/plugin/8053-azure-toolkit-for-intellij/).
4949

50-
## Azure Spring Apps Config Server procedures
50+
## Config Server procedures
5151

5252
#### [Portal](#tab/Azure-portal)
5353

0 commit comments

Comments
 (0)