Merge pull request #248160 from dominicbetts/central-audit-updates

IoT Central: Clarify audit log content

Author: prmerger-automator[bot]

articles/iot-central/core/howto-use-audit-logs.md

@@ -1,14 +1,14 @@
 ---
 title: Use Azure IoT Central audit logs
-description: Learn how to use audit logs in IoT Central to track changes made by users or programatically in an IoT Central application
+description: Learn how to use audit logs in IoT Central to track changes made by users or programmatically in an IoT Central application
 author: dominicbetts
 ms.author: dobett
-ms.date: 07/25/2022
+ms.date: 08/14/2023
 ms.topic: how-to
 ms.service: iot-central
 services: iot-central
 
-# Administrator
+# CustomerIntent: As an administrator, I want to be able to track changes made to my IoT Central application so that I can understand who made what changes at what time.
 ---
 
 # Use audit logs to track activity in your IoT Central application
@@ -21,9 +21,9 @@ This article describes how to use audit logs to track who made what changes at w
 - Manage access to the audit log.
 - Export the audit log records.
 
-The audit log records information about who made a change, information about the modified entity, the action that made change, and when the change was made. The log tracks changes made through the UI, programatically with the REST API, and through the CLI.
+The audit log records information about who made a change, information about the modified entity, the action that made change, and when the change was made. The log tracks changes made through the UI, programmatically with the REST API, and through the CLI.
 
-The log records changes to the following IoT Central entities:
+The log records changes made to the following IoT Central entities:
 
 - [Users](howto-manage-users-roles.md#add-users)
 - [Roles](howto-manage-users-roles.md#manage-roles)
@@ -35,6 +35,9 @@ The log records changes to the following IoT Central entities:
 - [Device templates](howto-set-up-template.md)
 - [Device lifecycle events](howto-export-to-blob-storage.md#device-lifecycle-changes-format)
 
+> [!NOTE]
+> The audit log doesn't record when users sign in or out of your IoT Central application.
+
 The log records changes made by the following types of user:
 
 - IoT Central user - the log shows the user's email.
@@ -48,6 +51,9 @@ The following screenshot shows the audit log view with the location of the sorti
 
 :::image type="content" source="media/howto-use-audit-logs/audit-log.png" alt-text="Screenshot that shows the audit log. The location of the sort and filter controls is highlighted." lightbox="media/howto-use-audit-logs/audit-log.png":::
 
+> [!TIP]
+> If you want to monitor the health of your connected devices, use Azure Monitor. To learn more, see [Monitor application health](howto-manage-iot-central-from-portal.md#monitor-application-health).
+
 ## Customize the log
 
 Select **Column options** to customize the audit log view. You can add and remove columns, reorder the columns, and change the column widths: