Merge pull request #97514 from BobbySchmidt2/spring-cloud

Edit pass: Spring cloud

Author: ShawnJackson

articles/spring-cloud/spring-cloud-concept-metrics.md

@@ -1,6 +1,6 @@
 ---
 title: Understanding metrics for Azure Spring Cloud
-description: Learn how to review metrics in the Azure Spring Cloud
+description: Learn how to review metrics in Azure Spring Cloud
 author: jpconnock
 ms.service: spring-cloud
 ms.topic: conceptual
@@ -9,46 +9,47 @@ ms.author: jeconnoc
 
 ---
 
-# Metrics for Azure Spring Cloud
+# Understand metrics for Azure Spring Cloud
 
-Azure Monitor Metrics explorer is a component of the Microsoft Azure portal that allows plotting charts, visually correlating trends, and investigating spikes and dips in metrics. Use the metrics explorer to investigate the health and utilization of your resources. In Azure Spring Cloud, we offer two options for viewing metrics: charts in the **Application Overview** page and the service level Metrics page.
+Azure Monitor metrics explorer is a component of the Azure portal. It features chart plots, visually correlated trends, and investigation of spikes and dips in metrics. Use the metrics explorer to investigate the health and utilization of your resources. Azure Spring Cloud offers two options for viewing metrics: charts on the **Application Overview** page and the service-level **Metrics** page.
 
 ## Application Overview page
 
-Each application's **Application Overview** page presents a metrics chart that allows you to perform a quick status check of your application.  Go to your Azure Spring Cloud service page and select **Application Dashboard**, then select an application from the list.  
+Each application's **Application Overview** page presents a metrics chart. With that chart, you can quickly check an application's status.  To see the metrics chart, go to your Azure Spring Cloud service page, select **Application Dashboard**, then select an application from the list.  
 
-We provide 5 charts with metrics updated every minute for the following:
+Azure Spring Cloud provides these five charts with metrics that are updated every minute:
 
-* **Http Server Errors**: Error count for HTTP requests to your app.
-* **Data In**: Bytes received by your app.
-* **Data Out**: Bytes sent to your app.
-* **Requests**: Requests received by your app.
-* **Average Response Time**: Average response time from your app.
+* **Http Server Errors**: Error count for HTTP requests to your app
+* **Data In**: Bytes received by your app
+* **Data Out**: Bytes sent by your app
+* **Requests**: Requests received by your app
+* **Average Response Time**: Average response time from your app
 
-You can select a time range for the chart between 1 hour up to 7 Days.
+For the chart, you can select a time range from one hour to seven days.
 
 ## Service-level metric queries
 
-Azure Spring Cloud allows you to monitor a variety of application metrics. Review the [guide to getting started](https://docs.microsoft.com/azure/azure-monitor/platform/metrics-getting-started) with Azure Monitor Metrics to learn more about this service.
+With Azure Spring Cloud, you can monitor different kinds of application metrics. Review the [guide to getting started](https://docs.microsoft.com/azure/azure-monitor/platform/metrics-getting-started) with Azure Monitor metrics to learn more about this service.
 
-To review metric data, you will select your metric, your **Aggregation**, and your time range.  These concepts are explained below.
+To review metric data, select your metric, your **Aggregation** value, and your time range. These concepts are explained in the following sections.
 
-### Aggregation 
+### Aggregation
 
 Azure polls and updates metrics every minute. Azure provides three ways to aggregate data for a chosen time period:
 
 * **Total**: Sum all metrics as target output.
-* **Average**: Use the Average value in the period as target output.
-* **Max/Min**: Use the Max/Min value in the period as target output.
+* **Average**: Use the average value of the period as target output.
+* **Max/Min**: Use the maximum and minimum values of the period as target output.
 
 ### Time range
 
-Select a default time range or define your own.
+Either select a default time range or define your own.
 
 ### Modifying the granularity of your metric query
 
-By default, Azure aggregates metrics for all of an Azure Spring Cloud service's applications. To review metrics at the application or instance level, use the filter function.  
-Select **Add filter**, set the property to **App** and select the target application you want to monitor. Optionally, use the **Apply splitting** option to draw separate lines for each app in the chart.
+By default, Azure aggregates metrics for all applications of an Azure Spring Cloud service. To review metrics at the application or instance level, use the filter function.
+
+To use this function, select **Add filter**, set the property to **App**, and select the target application you want to monitor. Optionally, use the **Apply splitting** option to draw separate lines in the chart for each app.
 
 >[!TIP]
-> You can build your own charts in metrics page and pin them to your **Dashboard**. Start by naming your chart.  Next, select **Pin to dashboard in the top right corner**. You can now check on your application at your Portal **Dashboard**.
+> You can build your own charts on the metrics page and pin them to your dashboard. Start by naming your chart. Next, select **Pin to dashboard** in the upper-right corner. You can now check your application on your dashboard.

articles/spring-cloud/spring-cloud-howto-persistent-storage.md

@@ -9,41 +9,43 @@ ms.author: jeconnoc
 
 ---
 
-# How to use persistent storage in Azure Spring Cloud
+# Use persistent storage in Azure Spring Cloud
 
-Azure Spring Cloud provides two types of storage for your application:  persistent and temporary.  Azure Spring Cloud enables temporary storage by default for each application instance. Temporary storage is limited to 5GB with a default mount path: `/tmp`.
+Azure Spring Cloud provides two types of storage for your application: persistent and temporary.
+
+By default, Azure Spring Cloud provides temporary storage for each application instance. Temporary storage is limited to 5 GB per instance with the default mount path /tmp.
 
 > [!WARNING]
-> Restarting an application instance will permanently delete its associated temporary storage..
+> If you restart an application instance, the associated temporary storage is permanently deleted.
 
-Persistent storage is a file share container managed by Azure allocated per application. Data stored in persistent storage is shared across all of the application's instances. An Azure Spring Cloud service instance can have a maximum of 10 applications with persistent disk enabled. Each application receives 50GB of persistent storage. The default mount path for persistent storage is `/persistent`.
+Persistent storage is a file-share container managed by Azure and allocated per application. Data stored in persistent storage is shared by all instances of an application. An Azure Spring Cloud instance can have a maximum of 10 applications with persistent storage enabled. Each application is allocated 50 GB of persistent storage. The default mount path for persistent storage is /persistent.
 
 > [!WARNING]
-> *Disabling* persistent storage will deallocate the storage for that application.  All data in that storage account will be lost. 
+> If you disable an applications's persistent storage, all of that storage is deallocated and all of the stored data is lost.
 
-## Enable persistent storage using the Azure portal
+## Use the Azure portal to enable persistent storage
 
-1. From the Home screen of your Azure portal, select **All Resources**.
+1. From the **Home** page of your Azure portal, select **All Resources**.
 
-     >![Locate the All Resources icon](media/portal-all-resources.jpg)
+    >![Locate the All Resources icon](media/portal-all-resources.jpg)
 
-1. Find and select the Azure Spring Cloud resource that needs persistent storage.  In this example, the application is called *jpspring*.
+1. Select the Azure Spring Cloud resource that needs persistent storage. In this example, the selected application is called **upspring**.
 
-    > ![Locate your applicationb](media/select-service.jpg)
+    > ![Select your application](media/select-service.jpg)
 
 1. Under the **Settings** heading, select **Apps**.
 
-1. Your Spring Cloud services will appear in table.  Select the service to which you want to add persistent storage.  In this example, we will select our **gateway** service.
+1. Your Azure Spring Cloud services appear in a table.  Select the service to which you want to add persistent storage. In this example, the **gateway** service is selected.
 
     > ![Select your service](media/select-gateway.jpg)
 
-1. From the service's configuration blade, select **Configuration**
+1. From the service's configuration page, select **Configuration**
 
-1. Select the **Persistent Storage** tab and enable persistent storage.
+1. Select the **Persistent Storage** tab and select **Enable**.
 
     > ![Enable persistent storage](media/enable-persistent-storage.jpg)
 
-When persistent storage is enabled, its size and path are shown both on this page.
+After persistent storage is enabled, its size and path are shown on the configuration page.
 
 ## Use the Azure CLI to modify persistent storage
 
@@ -52,28 +54,30 @@ If necessary, install the Spring Cloud extension for the Azure CLI:
 ```azurecli
 az extension add --name spring-cloud
 ```
+Other operations:
 
-Create an app with persistent disk enabled:
- 
-```azurecli
-az spring-cloud app create -n <app> -g <resource-group> -s <service-name> --enable-persistent-storage true
-```
+* To create an app with persistent storage enabled:
 
-Enable persistent storage in an existing app:
+    ```azurecli
+    az spring-cloud app create -n <app> -g <resource-group> -s <service-name> --enable-persistent-storage true
+    ```
 
-```azurecli
-az spring-cloud app update -n <app> -g <resource-group> -s <service-name> --enable-persistent-storage true
-``` 
+* To enable persistent storage for an existing app:
 
-Disable persistent storage in an existing app:
+    ```azurecli
+    az spring-cloud app update -n <app> -g <resource-group> -s <service-name> --enable-persistent-storage true
+    ```
 
-> [!WARNING]
-> Disabling persistent storage will deallocate the storage for that application, permanently losing any data that was stored there. 
+* To disable persistent storage in an existing app:
 
-```azurecli
-az spring-cloud app update -n <app> -g <resource-group> -s <service-name> --enable-persistent-storage false
-```
+    ```azurecli
+    az spring-cloud app update -n <app> -g <resource-group> -s <service-name> --enable-persistent-storage false
+    ```
+
+    > [!WARNING]
+    > If you disable an applications's persistent storage, all of that storage is deallocated and all of the stored data is permanently lost.
 
 ## Next steps
 
-Learn about [application and service quotas](spring-cloud-quotas.md), or learn how to [manually scale your application](spring-cloud-tutorial-scale-manual.md).
+* Learn about [application and service quotas](spring-cloud-quotas.md).
+* Learn how to [manually scale your application](spring-cloud-tutorial-scale-manual.md).

articles/spring-cloud/spring-cloud-howto-start-stop-delete.md

@@ -1,5 +1,5 @@
 ---
-title: How to start, stop, and delete your Azure Spring Cloud application | Microsoft Docs
+title: Start, stop, and delete your Azure Spring Cloud application | Microsoft Docs
 description:  How to start, stop, and delete your Azure Spring Cloud application
 author: jpconnock
 ms.service: spring-cloud
@@ -8,46 +8,52 @@ ms.date: 10/31/2019
 ms.author: jeconnoc
 
 ---
-# How to start, stop, and delete your Azure Spring Cloud application
+# Start, stop, and delete your Azure Spring Cloud application
 
-This guide explains how to change the state of an application in Azure Spring Cloud using either the Azure portal or CLI.
+This guide explains how to change an application's state in Azure Spring Cloud by using either the Azure portal or the Azure CLI.
 
 ## Using the Azure portal
 
-Once you have an application deployed, you can **Start**, **Stop**, and **Delete** it using the Azure portal.
+After you deploy an application, you can start, stop, and delete it by using the Azure portal.
 
 1. Go to your Azure Spring Cloud service instance in the Azure portal.
 1. Select the **Application Dashboard** tab.
 1. Select the application whose state you want to change.
-2. In the **Overview** page for that application, find buttons to **Start/Stop**, **Restart**, and **Delete** the application.
+1. On the **Overview** page for that application, select **Start/Stop**, **Restart**, or **Delete**.
 
 ## Using the Azure CLI
 
 > [!NOTE]
-> You can use optional parameters and configure defaults with the Azure CLI. Learn more about by reading our [reference documentation](spring-cloud-cli-reference.md).  
+> You can use optional parameters and configure defaults with the Azure CLI. Learn more about the Azure CLI by reading [our reference documentation](spring-cloud-cli-reference.md).  
 
-Install the Spring Cloud extension for the Azure CLI:
+First, install the Azure Spring Cloud extension for the Azure CLI as follows:
 
 ```azurecli
 az extension add --name spring-cloud
 ```
 
+Next, select any of these Azure CLI operations:
+
 * To start your application:
+
     ```azurecli
     az spring-cloud app start -n <application name> -g <resource group> -s <Azure Spring Cloud name>
     ```
 
 * To stop your application:
+
     ```azurecli
     az spring-cloud app stop -n <application name> -g <resource group> -s <Azure Spring Cloud name>
     ```
 
 * To restart your application:
+
     ```azurecli
     az spring-cloud app restart -n <application name> -g <resource group> -s <Azure Spring Cloud name>
     ```
 
 * To delete your application:
+
     ```azurecli
     az spring-cloud app delete -n <application name> -g <resource group> -s <Azure Spring Cloud name>
     ```