work in progress

Author: cebundy

articles/container-apps/log-streaming.md

@@ -12,17 +12,17 @@ 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's `stdout` and `stderr` log messages through the Azure portal or the Azure CLI.
+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.
 
-## Azure portal
+## 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.
 
 ### 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:
 
-1. Go your environment page in the Azure portal.
+1. Go to your environment page in the Azure portal.
 1. Select **Log stream** under the *Monitoring* section on the sidebar menu.
 
 :::image type="content" source="media/observability/system-log-streaming-env.png" alt-text="Screenshot of Container Apps environment system log stream page.":::
@@ -42,22 +42,21 @@ You can view a log stream of your container apps system or application logs from
 
 :::image type="content" source="media/observability/screenshot-log-stream-system-app.png" alt-text="Screenshot of Container Apps system log stream from app page.":::
 
-## Azure CLI
+## View log streams via the Azure CLI
 
-You can view an active container's log stream 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.  The environment system log stream displays the system logs for the Container Apps service and the apps running in the environment.  
+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 use these arguments to:
+Control the log stream with the following arguments:
 
-- View previous log entries with the  `--tail` argument. (Values: 0-300)
-- View a live stream with the `--follow`argument. 
+- `--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.
 
-Use `Ctrl/Cmd-C` to stop the live stream.
+### Stream Container app logs
 
-For example, you can list the last 50 container log entries in a container app with a single container using the following command.
+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 log stream from the CLI
 
-Use the `--type` argument to specify the log type.  Valid values are `console` and `system`.  The default is `console`.
+#### View container app system log stream
 
 This example displays the last 50 system log entries for the container app.
 
@@ -83,7 +82,35 @@ az containerapp logs show `
 
 ---
 
-To connect to a container live console log stream in a container app with multiple revisions, replicas, and containers include the  following parameters in the `az containerapp logs show` command.
+This example displays a continuous live stream of system log entries for the container app.
+
+# [Bash](#tab/bash)
+
+```azurecli
+az containerapp logs show \
+  --name <ContainerAppName> \
+  --resource-group <ResourceGroup> \
+  --type system \
+  --follow
+```
+
+# [PowerShell](#tab/powershell)
+
+```azurecli
+az containerapp logs show `
+  --name <ContainerAppName> `
+  --resource-group <ResourceGroup> `
+  --type system `
+  --follow
+```
+
+---
+
+Use `Ctrl-C` or `Cmd-C` to stop the live stream.
+
+### View container console log stream
+
+To connect to a container's console log stream in a container app with multiple revisions, replicas, and containers include the following parameters in the `az containerapp logs show` command.
 
 | Argument | Description |
 |----------|-------------|
@@ -137,7 +164,7 @@ az containerapp replica list `
 
 ---
 
-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 logs with the `az container app show` command. Replace the \<placeholders\> with your container app's values.
 
 # [Bash](#tab/bash)
 
@@ -167,14 +194,43 @@ az containerapp logs show  `
 
 ---
 
-Enter **Ctrl-C** to stop the log stream.
+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.
+
+
+# [Bash](#tab/bash)
+
+```azurecli
+az containerapp logs show \
+  --name <ContainerAppName> \
+  --resource-group <ResourceGroup> \
+  --revision <RevisionName> \
+  --replica <ReplicaName> \
+  --container <ContainerName> \
+  --type console \
+  --tail 50
+```
 
-### View environment system log stream from the CLI
+# [PowerShell](#tab/powershell)
 
-Using the following command, you can view the system log stream for the Container Apps service and the apps running in the environment.
+```azurecli
+az containerapp logs show  `
+  --name <ContainerAppName> `
+  --resource-group <ResourceGroup> `
+  --revision <RevisionName> `
+  --replica <ReplicaName> `
+  --container <ContainerName> `
+  --type console `
+  --tail 50
+```
+
+---
 
-Stream the container logs with the `az container app env logs show` command. Replace the \<placeholders\> with your container app's values.
 
+### View environment system log stream
+
+Use the following command to view the live system log stream from the Container Apps service. 
 
 # [Bash](#tab/bash)
 
@@ -196,14 +252,15 @@ az containerapp env logs show  `
 
 ---
 
-Enter **Ctrl-C** to stop the log stream.
+Use `Ctrl-C` or `Cmd-C` to stop the live stream.
+
 
 This example displays the last 50 environment system log entries.
 
 # [Bash](#tab/bash)
 
 ```azurecli
-az containerapp logs show \
+az containerapp env logs show \
   --name <ContainerAppName> \
   --resource-group <ResourceGroup> \
   --tail 50
@@ -212,7 +269,7 @@ az containerapp logs show \
 # [PowerShell](#tab/powershell)
 
 ```azurecli
-az containerapp logs show `
+az containerapp env logs show `
   --name <ContainerAppName> `
   --resource-group <ResourceGroup> `
   --tail 50

articles/container-apps/logging.md

@@ -22,11 +22,11 @@ Azure Container Apps provides two types of application logging categories:
 
 Container console logs are written by your application to the `stdout` and `stderr` output streams of the application's container. By implementing detailed logging in your application, you'll be able to troubleshoot issues and monitor the health of your application. 
 
-You can view your container console logs through [Logs streaming](log-streaming.md).  For other options to store and monitoring your log data, see [Logging options](log-options.md).
+You can view your container console logs through [Logs streaming](log-streaming.md).  For other options to store and monitor your log data, see [Logging options](log-options.md).
 
 ## System logs
 
-System logs are generated by the Azure Container Apps to inform you for the status of service level events.  Log messages include the following information:
+System logs are generated by the Azure Container Apps to inform you of the status of service level events.  Log messages include the following information:
 
 - Successfully created dapr component
 - Successfully updated dapr component
@@ -42,7 +42,7 @@ System logs are generated by the Azure Container Apps to inform you for the stat
 - Deactivating Old revisions
 - Error provisioning revision
 
-The system log data can be stored and monitored through the Container Apps logging options.  For more information, see [Logging options](log-options.md).
+The system log data can be stored and monitored through the Container Apps logging options or streamed through the Azure portal or CLI.  For more information, see [Logging options](log-options.md) and [Log streams](log-streaming.md).
 
 ## Next steps