work in progress - more improvements

Author: cebundy

articles/container-apps/log-streaming.md

@@ -12,15 +12,20 @@ ms.author: v-bcatherine
 
 # View log streams in Azure Container Apps
 
-While developing and troubleshooting your container app, it's important to see a container's logs in real-time.  Container Apps lets you view a stream of your container app's [system logs](logging.md#system-logs) at the Container Apps environment level and at the app level. You can stream the [console logs](logging.md#container-console-logs) apps at the container level.  Log streams are accessible though the Azure portal or the Azure CLI.
+While developing and troubleshooting your container app, it's essential to see the [application logs](logging.md) for your container app in real time. Azure Container Apps lets you stream:
+
+- [system logs](logging.md#system-logs) from the Container Apps environment and your container app. 
+- container [console logs](logging.md#container-console-logs) from your container app.
+
+Log streams are accessible through the Azure portal or the Azure CLI.
 
 ## View log streams via the Azure portal
 
-You can view system logs and application logs in the Azure portal.  System logs are generated by the container app's runtime.  Application logs are generated by your container app's application.
+You can view system logs and console logs in the Azure portal. System logs are generated by the container app's runtime. Console logs are generated by your container app's application.
 
 ### Environment system log stream
 
-To troubleshoot issues with in your container app environment, you can view the system log stream from your environment page.  The log stream displays the system logs for the Container Apps service and the apps actively running in the environment:
+To troubleshoot issues in your container app environment, you can view the system log stream from your environment page. The log stream displays the system logs for the Container Apps service and the apps actively running in the environment:
 
 1. Go to your environment page in the Azure portal.
 1. Select **Log stream** under the *Monitoring* section on the sidebar menu.
@@ -29,36 +34,36 @@ To troubleshoot issues with in your container app environment, you can view the
 
 ### Container app log stream
 
-You can view a log stream of your container apps system or application logs from your container app page. 
+You can view a log stream of your container apps system or console logs from your container app page. 
 
 1. Go to your container app in the Azure portal.
 1. Select **Log stream** under the *Monitoring* section on the sidebar menu.
 1. To view the console log stream, select **Console**. 
-    1. If you have multiple revisions, replicas, or containers, you can select from the pull-down menus to choose a container.  If your app has only one container, you can skip this step.
+    1. If you have multiple revisions, replicas, or containers, you can select from the pull-down menus to choose a container. If your app has only one container, you can skip this step.
 
     :::image type="content" source="media/observability/screenshot-log-stream-console-app.png" alt-text="Screenshot of Container Apps console log stream from app page.":::
 
-1. To view the system log stream, select **System**.  The system log stream displays the system logs for all running containers in the environment.
+1. To view the system log stream, select **System**. The system log stream displays the system logs for all running containers in the environment.
 
 :::image type="content" source="media/observability/screenshot-log-stream-system-app.png" alt-text="Screenshot of Container Apps system log stream from app page.":::
 
 ## View log streams via the Azure CLI
 
-You can view your container app's log streams from the Azure CLI with the `az containerapp logs show` command or your container app's environment system log stream with the `az containerapp env logs show` command.  
+You can view your container app's log streams from the Azure CLI with the `az containerapp logs show` command or your container app's environment system log stream with the `az containerapp env logs show` command. 
 
 Control the log stream with the following arguments:
 
-- `--tail` (Default) - View the last n log entries. Values are 0-300 entries. The value is 20.
-- `--follow` - View a continuous live stream of the log entries.
+- `--tail` (Default) - View the last n log messages. Values are 0-300 messages. The default is 20.
+- `--follow` - View a continuous live stream of the log messages.
 
 ### Stream Container app logs
 
-You can stream the system or console logs for your container app.  To stream the container app system logs, use the `--type` argument with the value `system`.  To stream the container console logs, use the `--type` argument with the value `console`.  The default is `console`.
+You can stream the system or console logs for your container app. To stream the container app system logs, use the `--type` argument with the value `system`. To stream the container console logs, use the `--type` argument with the value `console`. The default is `console`.
 
 
 #### View container app system log stream
 
-This example displays the last 50 system log entries for the container app.
+This example uses the `--tail` argument to display the last 50 system log messages from the container app. Replace the \<placeholders\> with your container app's values.
 
 # [Bash](#tab/bash)
 
@@ -82,7 +87,7 @@ az containerapp logs show `
 
 ---
 
-This example displays a continuous live stream of system log entries for the container app.
+This example displays a continuous live stream of system log messages from the container app using the `--follow` argument. Replace the \<placeholders\> with your container app's values.
 
 # [Bash](#tab/bash)
 
@@ -114,11 +119,11 @@ To connect to a container's console log stream in a container app with multiple
 
 | Argument | Description |
 |----------|-------------|
-| `--revision` | The revision name of the container to connect to. |
-| `--replica` | The replica name of the container to connect to. |
-| `--container` | The container name of the container to connect to. |
+| `--revision` | The revision name. |
+| `--replica` | The replica name in the revision. |
+| `--container` | The container name to connect to. |
 
-You can get the revision names with the `az containerapp revision list` command.  Replace the \<placeholders\> with your container app's values.
+You can get the revision names with the `az containerapp revision list` command. Replace the \<placeholders\> with your container app's values.
 
 # [Bash](#tab/bash)
 
@@ -164,7 +169,7 @@ az containerapp replica list `
 
 ---
 
-Live stream the container console logs with the `az container app show` command. Replace the \<placeholders\> with your container app's values.
+Live stream the container console using the `az container app show` command with the `--follow` argument. Replace the \<placeholders\> with your container app's values.
 
 # [Bash](#tab/bash)
 
@@ -196,7 +201,7 @@ az containerapp logs show  `
 
 Use `Ctrl-C` or `Cmd-C` to stop the live stream.
 
-View the last 50 container console log entries with the `az containerapp logs show` command. Replace the \<placeholders\> with your container app's values.
+View the last 50 console log messages using the `az containerapp logs show` command with the `--tail` argument. Replace the \<placeholders\> with your container app's values.
 
 
 # [Bash](#tab/bash)
@@ -230,7 +235,7 @@ az containerapp logs show  `
 
 ### View environment system log stream
 
-Use the following command to view the live system log stream from the Container Apps service. 
+Use the following command with the `--follow` argument to view the live system log stream from the Container Apps environment. Replace the \<placeholders\> with your environment values.
 
 # [Bash](#tab/bash)
 
@@ -255,7 +260,7 @@ az containerapp env logs show  `
 Use `Ctrl-C` or `Cmd-C` to stop the live stream.
 
 
-This example displays the last 50 environment system log entries.
+This example uses the `--tail` argument to display the last 50 environment system log messages. Replace the \<placeholders\> with your environment values.
 
 # [Bash](#tab/bash)
 
@@ -278,4 +283,4 @@ az containerapp env logs show `
 ---
 
 > [!div class="nextstepaction"]
-> [View log streams from the Azure portal](log-streaming.md)
+> [Log storage and monitoring options in Azure Container Apps](log-monitoring.md)