Merge pull request #234004 from KarlErickson/spring-apps/refine

edit "Refine spring apps doc for correctness #233615"

Author: American-Dipper

articles/spring-apps/.openpublishing.redirection.spring-apps.json

@@ -19,6 +19,11 @@
             "source_path": "how-to-enterprise-deploy-non-java-apps.md",
             "redirect_url": "/azure/spring-apps/how-to-enterprise-deploy-polyglot-apps",
             "redirect_document_id": false
+        },
+        {
+            "source_path": "how-to-distributed-tracing.md",
+            "redirect_url": "/azure/spring-apps/how-to-application-insights",
+            "redirect_document_id": false
         }
     ]
 }

articles/spring-apps/faq.md

@@ -15,7 +15,7 @@ zone_pivot_groups: programming-languages-spring-apps
 > [!NOTE]
 > 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.
 
-**This article applies to:** ✔️ Basic/Standard tier ✔️ Enterprise tier
+**This article applies to:** ✔️ Basic/Standard ✔️ Enterprise
 
 This article answers frequently asked questions about Azure Spring Apps.
 
@@ -39,11 +39,11 @@ Security and privacy are among the top priorities for Azure and Azure Spring App
 
 Each service instance in Azure Spring Apps is backed by Azure Kubernetes Service with multiple worker nodes. Azure Spring Apps manages the underlying Kubernetes cluster for you, including high availability, scalability, Kubernetes version upgrade, and so on.
 
-Azure Spring Apps intelligently schedules your applications on the underlying Kubernetes worker nodes. To provide high availability, Azure Spring Apps distributes applications with 2 or more instances on different nodes.
+Azure Spring Apps intelligently schedules your applications on the underlying Kubernetes worker nodes. To provide high availability, Azure Spring Apps distributes applications with two or more instances on different nodes.
 
 ### In which regions is Azure Spring Apps Basic/Standard tier available?
 
-East US, East US 2, Central US, South Central US, North Central US, West US, West US 2, West US 3, West Europe, North Europe, UK South, Southeast Asia, Australia East, Canada Central, Canada East, UAE North, Central India, Korea Central, East Asia, Japan East, South Africa North, Brazil South, France Central, Germany West Central, Switzerland North, China East 2 (Mooncake), China North 2 (Mooncake), and China North 3 (Mooncake). [Learn More](https://azure.microsoft.com/global-infrastructure/services/?products=spring-cloud)
+East US, East US 2, Central US, South Central US, North Central US, West US, West US 2, West US 3, West Europe, North Europe, UK South, Southeast Asia, Australia East, Canada Central, Canada East, UAE North, Central India, Korea Central, East Asia, Japan East, South Africa North, Brazil South, France Central, Germany West Central, Switzerland North, China East 2, China North 2, and China North 3. [Learn More](https://azure.microsoft.com/global-infrastructure/services/?products=spring-cloud)
 
 ### In which regions is Azure Spring Apps Enterprise tier available?
 
@@ -57,9 +57,9 @@ Azure Spring Apps is a regional service. All customer data in Azure Spring Apps
 
 Azure Spring Apps has the following known limitations:
 
-* `spring.application.name` will be overridden by the application name that's used to create each application.
-* `server.port` defaults to port 1025. If any other value is applied, it will be overridden. Please also respect this setting and not specify server port in your code.
-* The Azure portal, Azure Resource Manager templates, and Terraform do not support uploading application packages. You can upload application packages by deploying the application using the Azure CLI, Azure DevOps, Maven Plugin for Azure Spring Apps, Azure Toolkit for IntelliJ, and the Visual Studio Code extension for Azure Spring Apps.
+* `spring.application.name` is overridden by the application name that's used to create each application.
+* `server.port` defaults to port 1025. If any other value is applied, it's overridden, so don't specify a server port in your code.
+* The Azure portal, Azure Resource Manager templates, and Terraform don't support uploading application packages. You can upload application packages by deploying the application using the Azure CLI, Azure DevOps, Maven Plugin for Azure Spring Apps, Azure Toolkit for IntelliJ, and the Visual Studio Code extension for Azure Spring Apps.
 
 ### What pricing tiers are available?
 
@@ -69,7 +69,7 @@ Which one should I use and what are the limits within each tier?
 
 ### What's the difference between Service Binding and Service Connector?
 
-We are not actively developing additional capabilities for Service Binding in favor of the new Azure-wise solution named [Service Connector](../service-connector/overview.md). On the one hand, the new solution brings you consistent integration experience across App hosting services on Azure like App Service. On the other hand, it covers your needs better by starting with supporting 10+ most used target Azure services including MySQL, SQL DB, Azure Cosmos DB, Postgres DB, Redis, Storage and more. Service Connector is currently in Public Preview, we invite you to try out the new experience.
+We're not actively developing more capabilities for Service Binding. Instead, there's a new Azure-wise solution named [Service Connector](../service-connector/overview.md). On the one hand, the new solution brings you consistent integration experience across App hosting services on Azure like App Service. On the other hand, it covers your needs better by starting with supporting 10+ most used target Azure services including MySQL, SQL DB, Azure Cosmos DB, Postgres DB, Redis, Storage and more. Service Connector is currently in Public Preview, we invite you to try out the new experience.
 
 ### How can I provide feedback and report issues?
 
@@ -80,17 +80,19 @@ If you encounter any issues with Azure Spring Apps, create an [Azure Support Req
 Enterprise tier has built-in VMware Spring Runtime Support, so you can open support tickets to [VMware](https://aka.ms/ascevsrsupport) if you think your issue is in the scope of VMware Spring Runtime Support. To better understand VMware Spring Runtime Support itself, see the [VMware Spring Runtime](https://tanzu.vmware.com/spring-runtime). To understand the details about how to register and use this support service, see the Support section in the [Enterprise tier FAQ from VMware](https://aka.ms/EnterpriseTierFAQ). For any other issues, open support tickets with Microsoft.
 
 > [!IMPORTANT]
-> After you create an Enterprise tier instance, your entitlement will be ready within ten business days. If you encounter any exceptions, raise a support ticket with Microsoft to get help with it.
+> After you create an Enterprise tier instance, your entitlement is ready within ten business days. If you encounter any exceptions, raise a support ticket with Microsoft to get help with it.
 
 ## Development
 
-### I am a Spring developer but new to Azure. What is the quickest way for me to learn how to develop an application in Azure Spring Apps?
+### I'm a Spring developer but new to Azure. What's the quickest way for me to learn how to develop an application in Azure Spring Apps?
 
 For the quickest way to get started with Azure Spring Apps, follow the instructions in [Quickstart: Launch an application in Azure Spring Apps by using the Azure portal](./quickstart.md).
 
 ::: zone pivot="programming-language-java"
+
 ### Is Spring Boot 2.4.x supported?
-We've identified an issue with Spring Boot 2.4 and are currently working with the Spring community to resolve it. In the meantime, please include these two dependencies to enable TLS authentication between your apps and Eureka.
+
+We've identified an issue with Spring Boot 2.4 and are currently working with the Spring community to resolve it. In the meantime, include these two dependencies to enable TLS authentication between your apps and Eureka.
 
 ```xml
 <dependency>
@@ -111,13 +113,14 @@ We've identified an issue with Spring Boot 2.4 and are currently working with th
 
 Find metrics in the App Overview tab and the [Azure Monitor](../azure-monitor/essentials/data-platform-metrics.md#metrics-explorer) tab.
 
-Azure Spring Apps supports exporting Spring application logs and metrics to Azure Storage, Event Hub, and [Log Analytics](../azure-monitor/logs/data-platform-logs.md). The table name in Log Analytics is *AppPlatformLogsforSpring*. To learn how to enable it, see [Diagnostic services](diagnostic-services.md).
+Azure Spring Apps supports exporting Spring application logs and metrics to Azure Storage, Event Hubs, and [Log Analytics](../azure-monitor/logs/data-platform-logs.md). The table name in Log Analytics is *AppPlatformLogsforSpring*. To learn how to enable it, see [Diagnostic services](diagnostic-services.md).
 
 ### Does Azure Spring Apps support distributed tracing?
 
-Yes. For more information, see [Tutorial: Use Distributed Tracing with Azure Spring Apps](./how-to-distributed-tracing.md).
+Yes. For more information, see [Use Application Insights Java In-Process Agent in Azure Spring Apps](./how-to-application-insights.md).
 
 ::: zone pivot="programming-language-java"
+
 ### What resource types does Service Binding support?
 
 Three services are currently supported:
@@ -145,9 +148,9 @@ The number of outbound public IP addresses may vary according to the tiers and o
 
 Yes, you can open a [support ticket](https://azure.microsoft.com/support/faq/)  to request for more outbound public IP addresses.
 
-### When I delete/move an Azure Spring Apps service instance, will its extension resources be deleted/moved as well?
+### When I delete/move an Azure Spring Apps service instance, are its extension resources deleted/moved as well?
 
-It depends on the logic of resource providers that own the extension resources. The extension resources of a `Microsoft.AppPlatform` instance do not belong to the same namespace, so the behavior varies by resource provider. For example, the delete/move operation won't cascade to the **diagnostics settings** resources. If a new Azure Spring Apps instance is provisioned with the same resource ID as the deleted one, or if the previous Azure Spring Apps instance is moved back, the previous **diagnostics settings** resources continue extending it.
+It depends on the logic of resource providers that own the extension resources. The extension resources of a `Microsoft.AppPlatform` instance don't belong to the same namespace, so the behavior varies by resource provider. For example, the delete/move operation won't cascade to the **diagnostics settings** resources. If a new Azure Spring Apps instance is provisioned with the same resource ID as the deleted one, or if the previous Azure Spring Apps instance is moved back, the previous **diagnostics settings** resources continue extending it.
 
 You can delete the Azure Spring Apps diagnostic settings by using Azure CLI:
 
@@ -156,22 +159,23 @@ You can delete the Azure Spring Apps diagnostic settings by using Azure CLI:
 ```
 
 ::: zone pivot="programming-language-java"
+
 ## Java runtime and OS versions
 
 ### Which versions of Java runtime are supported in Azure Spring Apps?
 
 Azure Spring Apps supports Java LTS versions with the most recent builds, currently Java 8, Java 11, and Java 17 are supported. 
 
-### For how long will Java 8, Java 11, and Java 17 LTS versions be supported?
+### How long are Java 8, Java 11, and Java 17 LTS versions supported?
 
 See [Java long-term support for Azure and Azure Stack](/azure/developer/java/fundamentals/java-support-on-azure).
 
 ### What is the retire policy for older Java runtimes?
 
-Public notice will be sent out at 12 months before any old runtime version is retired. You will have 12 months to migrate to a later version.
+Public notice is sent out at 12 months before any old runtime version is retired. You have 12 months to migrate to a later version.
 
-* Subscription admins will get email notification when we will retire a Java version.
-* The retire information will be published in the documentation.
+* Subscription admins get email notification when we retire a Java version.
+* The retirement information is published in the documentation.
 
 ### How can I get support for issues at the Java runtime level?
 
@@ -212,7 +216,7 @@ Azure Spring Apps continuously probes port 1025 for customer's applications. The
 >[!NOTE]
 > Because of these probes, you currently can't launch applications in Azure Spring Apps without exposing port 1025.
 
-### Whether and when will my application be restarted?
+### Whether and when is my application restarted?
 
 Yes. For more information, see [Monitor app lifecycle events using Azure Activity log and Azure Service Health](./monitor-app-lifecycle-events.md).
 
@@ -223,32 +227,29 @@ For more information, see [Migrate Spring applications to Azure Spring Apps](/az
 ::: zone-end
 
 ::: zone pivot="programming-language-csharp"
+
 ## .NET Core versions
 
 ### Which .NET Core versions are supported?
 
 .NET Core 3.1 and later versions.
 
-### How long will .NET Core 3.1 be supported?
+### How long is .NET Core 3.1 supported?
 
-Until Dec 3, 2022. See [.NET Core Support Policy](https://dotnet.microsoft.com/platform/support/policy/dotnet-core).
+Until December 3, 2022. See [.NET Core Support Policy](https://dotnet.microsoft.com/platform/support/policy/dotnet-core).
 ::: zone-end
 
 ## Troubleshooting
 
 ### What are the impacts of service registry rarely unavailable?
 
-In some rarely happened scenario, you may see some errors like the following one from your application logs:
+In some rare scenarios, you may see errors like the following from your application logs:
 
 ```output
 RetryableEurekaHttpClient: Request execution failure with status code 401; retrying on another server if available
 ```
 
-This issue is introduced by the Spring framework with very low rate due to network instability or other network issues.
-
-There should be no impacts to user experience, eureka client has both heartbeat and retry policy to take care of this. You could consider it as one transient error and skip it safely.
-
-We will enhance this part and avoid this error from users’ applications in short future.
+The Spring framework raises this issue at a low rate due to network instability or other network issues. There should be no impacts to the user experience. The Eureka client has both heartbeat and retry policy to take care of this problem. You can consider it a transient error and skip it safely.
 
 ## Next steps