使用 Azure Monitor REST API 检索活动日志数据

项目
04/09/2024

Azure 活动日志是一种日志，方便用户了解对订阅中的资源执行的操作。操作包括对资源执行的创建、更新、删除和其他操作。活动日志是平台范围的日志，不限于特定服务。本文介绍如何使用 Azure Monitor REST API 检索活动日志数据。有关活动日志的详细信息，请参阅 Azure 活动日志事件架构。

身份验证

若要检索资源日志，必须使用 Microsoft Entra 进行身份验证。有关详细信息，请参阅 Azure 监视 REST API 演练。

检索活动日志数据

使用 Azure Monitor REST API 查询活动日志数据。

以下请求格式用于请求活动日志数据。

GET /subscriptions/<subscriptionId>/providers/Microsoft.Insights/eventtypes/management/values \
?api-version=2015-04-01 \
&$filter=<filter> \
&$select=<select>
host: management.chinacloudapi.cn
authorization: Bearer <token>

$filter

$filter 可减少收集的数据集。此参数是必需的，它还至少需要开始日期/时间。 $filter 参数接受以下模式：

列出资源组的事件：$filter=eventTimestamp ge '2014-07-16T04:36:37.6407898Z' and eventTimestamp le '2014-07-20T04:36:37.6407898Z' and resourceGroupName eq <resourceGroupName>。
列出特定资源的事件：$filter=eventTimestamp ge '2014-07-16T04:36:37.6407898Z' and eventTimestamp le '2014-07-20T04:36:37.6407898Z' and resourceUri eq <resourceURI>。
列出时间范围内订阅的事件：$filter=eventTimestamp ge '2014-07-16T04:36:37.6407898Z' and eventTimestamp le '2014-07-20T04:36:37.6407898Z'。
列出资源提供程序的事件：$filter=eventTimestamp ge '2014-07-16T04:36:37.6407898Z' and eventTimestamp le '2014-07-20T04:36:37.6407898Z' and resourceProvider eq <resourceProviderName>。
列出相关 ID 的事件： $filter=eventTimestamp ge '2014-07-16T04:36:37.6407898Z' and eventTimestamp le '2014-07-20T04:36:37.6407898Z' and correlationId eq '<correlationID>。

$select

$select 用于为返回的事件提取指定的属性列表。 $select 参数是要返回的属性名称的逗号分隔列表。有效值为：authorization、claims、correlationId、description、eventDataId、eventName、eventTimestamp、httpRequest、level、operationId、operationName、properties、resourceGroupName、resourceProviderName、resourceId、status、submissionTimestamp、subStatus 和 subscriptionId。

以下示例请求使用 Azure Monitor REST API 查询活动日志。

使用 filter 命令获取活动日志：

以下示例获取日期 2023-03-21T20:00:00Z 到 2023-03-24T20:00:00Z 之间的资源组 MSSupportGroup 的活动日志

GET https://management.chinacloudapi.cn/subscriptions/12345678-abcd-98765432-abcdef012345/providers/microsoft.insights/eventtypes/management/values?api-version=2015-04-01&$filter=eventTimestamp ge '2023-03-21T20:00:00Z' and eventTimestamp le '2023-03-24T20:00:00Z' and resourceGroupName eq 'MSSupportGroup'

使用 filter 和 select 命令获取活动日志：

以下示例获取日期 2023-03-21T20:00:00Z 和 2023-03-24T20:00:00Z 之间的 MSSupportGroup 资源组的活动日志，并返回 eventName、operationName、status、eventTimestamp、correlationId、submissionTimestamp 和 level 元素。

GET https://management.chinacloudapi.cn/subscriptions/12345678-abcd-98765432-abcdef012345/providers/microsoft.insights/eventtypes/management/values?api-version=2015-04-01&$filter=eventTimestamp ge '2023-03-21T20:00:00Z' and eventTimestamp le '2023-03-24T20:00:00Z'and resourceGroupName eq 'MSSupportGroup'&$select=eventName,operationName,status,eventTimestamp,correlationId,submissionTimestamp,level

后续步骤

流式传输 Azure Monitor 活动日志数据。 Azure 活动日志事件架构。

通过