Skip to content

Commit ecf1f0b

Browse files
author
Eric Wang (DEVDIV)
committed
Add notes regarding to the behaviors of diagnostics settings when its parent resource is deleted/moved.
1 parent 609cdaf commit ecf1f0b

File tree

2 files changed

+18
-14
lines changed

2 files changed

+18
-14
lines changed

articles/spring-cloud/diagnostic-services.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -22,19 +22,19 @@ Choose the log category and metric category you want to monitor.
2222

2323
|Log | Description |
2424
|----|----|
25-
| **ApplicationConsole** | Console log of all customer applications. |
25+
| **ApplicationConsole** | Console log of all customer applications. |
2626
| **SystemLogs** | Currently, only [Spring Cloud Config Server](https://cloud.spring.io/spring-cloud-config/reference/html/#_spring_cloud_config_server) logs in this category. |
2727

2828
## Metrics
2929

3030
For a complete list of metrics, see [Spring Cloud Metrics](https://docs.microsoft.com/azure/spring-cloud/spring-cloud-concept-metrics#user-metrics-options).
3131

32-
To get started, enable one of these services to receive the data. To learn about configuring Log Analytics, see [Get started with Log Analytics in Azure Monitor](../azure-monitor/log-query/get-started-portal.md).
32+
To get started, enable one of these services to receive the data. To learn about configuring Log Analytics, see [Get started with Log Analytics in Azure Monitor](../azure-monitor/log-query/get-started-portal.md).
3333

3434
## Configure diagnostics settings
3535

3636
1. In the Azure portal, go to your Azure Spring Cloud instance.
37-
1. Select the **Diagnostics settings** option, and then select **Add Diagnostics setting**.
37+
1. Select **diagnostics settings** option, and then select **Add diagnostics setting**.
3838
1. Enter a name for the setting, and then choose where you want to send the logs. You can select any combination of the following three options:
3939
* **Archive to a storage account**
4040
* **Stream to an event hub**
@@ -44,16 +44,17 @@ To get started, enable one of these services to receive the data. To learn about
4444
1. Select **Save**.
4545

4646
> [!NOTE]
47-
> There might be a gap of up to 15 minutes between when logs or metrics are emitted and when they appear in your storage account, your event hub, or Log Analytics.
47+
> 1. There might be a gap of up to 15 minutes between when logs or metrics are emitted and when they appear in your storage account, your event hub, or Log Analytics.
48+
> 1. If the Azure Spring Cloud instance is deleted or moved, the operation will not cascade to the **diagnostics settings** resources. The **diagnostics settings** resources have to be deleted manually before the operation against its parent, i.e. the Azure Spring Cloud instance. Otherwise, if a new Azure Spring Cloud instance is provisioned with the same resource ID as the deleted one, or if the Azure Spring Cloud instance is moved back, the previous **diagnostics settings** resources continue extending it.
4849
4950
## View the logs and metrics
5051
There are various methods to view logs and metrics as described under the following headings.
5152

52-
### Use Logs blade
53+
### Use the Logs blade
5354

5455
1. In the Azure portal, go to your Azure Spring Cloud instance.
5556
1. To open the **Log Search** pane, select **Logs**.
56-
1. In the **Log** search box
57+
1. In the **Tables** search box
5758
* To view logs, enter a simple query such as:
5859

5960
```sql
@@ -73,7 +74,7 @@ There are various methods to view logs and metrics as described under the follow
7374
1. In the Azure portal, in the left pane, select **Log Analytics**.
7475
1. Select the Log Analytics workspace that you chose when you added your diagnostics settings.
7576
1. To open the **Log Search** pane, select **Logs**.
76-
1. In the **Log** search box,
77+
1. In the **Tables** search box,
7778
* to view logs, enter a simple query such as:
7879

7980
```sql
@@ -95,15 +96,14 @@ There are various methods to view logs and metrics as described under the follow
9596
| where ServiceName == "YourServiceName" and AppName == "YourAppName" and InstanceName == "YourInstanceName"
9697
| limit 50
9798
```
98-
> [!NOTE]
99+
> [!NOTE]
99100
> `==` is case sensitive, but `=~` is not.
100101

101102
To learn more about the query language that's used in Log Analytics, see [Azure Monitor log queries](../azure-monitor/log-query/query-language.md).
102103
103-
### Use your storage account
104-
105-
1. In the Azure portal, in the left pane, select **Storage accounts**.
104+
### Use your storage account
106105
106+
1. In the Azure portal, find **Storage accounts** in left navigation panel or search box.
107107
1. Select the storage account that you chose when you added your diagnostics settings.
108108
1. To open the **Blob Container** pane, select **Blobs**.
109109
1. To review application logs, search for a container called **insights-logs-applicationconsole**.
@@ -113,7 +113,7 @@ To learn more about sending diagnostics information to a storage account, see [S
113113
114114
### Use your event hub
115115
116-
1. In the Azure portal, in the left pane, select **Event Hubs**.
116+
1. In the Azure portal, find **Event Hubs** in left navigation panel or search box.
117117
118118
1. Search for and select the event hub that you chose when you added your diagnostics settings.
119119
1. To open the **Event Hub List** pane, select **Event Hubs**.
@@ -148,7 +148,7 @@ AppPlatformLogsforSpring
148148
| where Log contains "error" or Log contains "exception"
149149
```
150150
151-
Use this query to find errors, or modify the query terms to find specific error codes or exceptions.
151+
Use this query to find errors, or modify the query terms to find specific error codes or exceptions.
152152
153153
### Show the number of errors and exceptions reported by your application over the last hour
154154

articles/spring-cloud/spring-cloud-faq.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ ms.author: brendm
1111

1212
# Azure Spring Cloud FAQ
1313

14-
This article answers frequently asked questions about Azure Spring Cloud.
14+
This article answers frequently asked questions about Azure Spring Cloud.
1515

1616
## General
1717

@@ -89,6 +89,10 @@ Three services are currently supported: Azure Cosmos DB, Azure Database for MySQ
8989

9090
Yes.
9191

92+
### When I delete/move an Azure Spring Cloud service instance, will its extension resources be deleted/moved as well?
93+
94+
It depends on the logics of resource providers where the extension resources belong to. The extension resources of a `Microsoft.AppPlatform` instance do not belong to the same namespace, so the behaviors vary according to different resource providers. For example, the delete/move operation will not cascade to the **diagnostics settings** resources. If a new Azure Spring Cloud instance is provisioned with the same resource ID as the deleted one, or if the previous Azure Spring Cloud instance is moved back, the previous **diagnostics settings** resources continue extending it.
95+
9296
## Deployment
9397

9498
### Does Azure Spring Cloud support blue-green deployment?

0 commit comments

Comments
 (0)