访问 Microsoft Graph 活动日志

Microsoft Graph 活动日志 提供 Microsoft Graph 服务为租户接收和处理的所有 HTTP 请求的审核线索。 租户管理员可以使用 Azure Monitor 中的诊断设置启用日志收集并设置下游目标。 日志将转到 Log Analytics 进行分析。 可以将它们导出到 Azure 存储进行长期存储,或使用 Azure 事件中心将其流式传输到外部 SIEM 工具以进行警报、分析或存档。

你将获取来自业务线应用、API 客户端、SDK、查询适用于 企业的 Microsoft MCP 服务器的 AI 客户端以及 Outlook、Microsoft Teams 或 Microsoft 管理门户等Microsoft应用的 API 请求日志。

此服务在这些 国家/地区云部署中可用。

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国
✅ ✅ ✅ ✅

先决条件

若要使用 Microsoft Graph 活动日志,需要以下权限。

  • Microsoft Entra ID P1 或 P2 租户许可证。
  • 具有受支持的 Microsoft Entra 管理员角色的管理员。 安全管理员 是设置诊断设置时唯一支持的最小特权管理员角色。
  • 设置了以下日志目标之一的 Azure 订阅,以及使用相应日志目标中数据的权限。
    • 用于将日志发送到 Azure Monitor 的 Azure Log Analytics 工作区
    • 具有“列出密钥”权限的 Azure 存储帐户
    • 用于与第三方解决方案连接的 Azure 事件中心命名空间

Microsoft Graph 活动日志中可用的数据

本文展示了有关 Log Analytics 接口中可用于 Microsoft Graph 活动日志的 API 请求的数据。

提示

对 Microsoft MCP 服务器企业版 的请求具有一个 RequestUri ,其中包括 /enterprise。

警告

请勿将机密或其他敏感信息(例如密码、凭据、访问或刷新令牌或连接字符串)存储在目录对象属性或 Microsoft Graph 公开的任何其他可审核资源中。 Microsoft Graph 活动日志以及其他审核和登录日志捕获有关 API 请求的详细信息,包括请求 URI。 在请求中传递或存储在此类资源上的任何敏感值都可以记录在这些日志中,租户管理员和日志导出到的任何下游 Log Analytics 工作区、Azure 存储帐户或 SIEM 系统都可读取。 目录对象属性不是机密的安全存储;请改用专用机密存储,如 Azure 密钥保管库。

列 类型 说明
AadTenantId string Azure AD 租户 ID。
ApiVersion string 事件的 API 版本。
AppId string 应用程序的标识符。
ATContent string 保留供以后使用。
ATContentH string 保留供以后使用。
ATContentP string 保留供以后使用。
_BilledSize 实数 记录大小(以字节为单位)
ClientAuthMethod int 指示如何对客户端进行身份验证。 对于公共客户端,此值为 0。 如果使用客户端 ID 和客户端密码,则值为 1。 如果使用客户端证书进行身份验证,则值为 2。
ClientRequestId string 可选。 发送时的客户端请求标识符。 如果未发送任何客户端请求标识符,则该值将等于操作标识符。
ConditionalAccessStatus string Microsoft Graph 为请求记录的条件访问状态。 未记录任何状态时为空。
DeviceId string 发起身份验证请求的设备标识符。
DurationMs int 请求的持续时间(以毫秒为单位)。
IdentityProvider string 对令牌使用者进行身份验证的标识提供程序。
IPAddress string 发出请求的客户端 IP 地址。
_IsBillable string 指定是否可计费引入数据。 _IsBillablefalse时,引入不会向 Azure 帐户计费
位置 string 处理请求的区域的名称。
OperationId string 批次的标识符。 对于非批处理请求,每个请求都是唯一的。 对于批处理请求,这对于批处理中的所有请求都是相同的。
请求 ID string 表示请求的标识符。
RequestMethod string 事件的 HTTP 方法。
RequestUri string 请求的 URI。
ResponseSizeBytes int 响应的大小(以字节为单位)。
ResponseStatusCode int 事件的 HTTP 响应状态代码。
角色 string 令牌声明中的角色。
Scopes string 令牌声明中的范围。
ServicePrincipalId string 发出请求的服务主体的标识符。
SessionId string 身份验证会话的唯一标识符。
SignInActivityId string 表示登录活动的标识符。
SourceSystem string 收集事件的代理类型。 例如,OpsManager对于 Windows 代理、直接连接或 Operations ManagerLinux、所有 Linux 代理或 Azure Azure 诊断
TenantId string Log Analytics 工作区 ID
TimeGenerated datetime 收到请求的日期和时间。
TokenIssuedAt datetime 颁发令牌的时间戳。
类型 string 表的名称
UniqueTokenId string 用于进行已审核更改的 API 调用的唯一令牌标识符。
UserAgent string 与请求相关的用户代理信息。
UserID string 发出请求的用户的标识符。
Wids string 表示分配给此用户的租户范围的角色。

Microsoft Graph 活动日志的常见用例

  • 查看租户中已同意的应用程序和其他 API 客户端进行的所有事务。
  • 查找被盗用的用户帐户在租户中执行的活动。
  • 构建检测和行为分析,以发现可疑或异常的 Microsoft Graph API 使用。
  • 调查应用程序权限的意外或可疑特权分配。
  • 发现客户端应用程序的问题或意外行为,例如极端呼叫量。
  • 监视 AI 客户端与 Microsoft Graph API 的交互,包括来自 AI 应用程序和 Microsoft MCP 服务器企业版的请求。
  • 将用户或应用发出的 Microsoft Graph 请求与登录信息相关联。

设置 Microsoft Graph 活动日志

通过Azure 门户中的诊断设置或使用 Azure 资源管理器 API Stream日志。 有关详细信息,请参阅以下文章:

请参阅以下文章设置存储目标:

成本规划估算

如果已有 Microsoft Entra ID P1 许可证,则需要 Azure 订阅来设置 Log Analytics 工作区、存储帐户或事件中心。 你可免费获取 Azure 订阅,但付费才能使用 Azure 资源。

记录的数据量和产生的成本可能会因租户大小以及租户中与 Microsoft Graph API 交互的应用程序而有很大差异。 下表给出了日志数据大小的估计值,以帮助您计算定价。 仅将这些估计用于一般考虑。

租户中的用户 每月存储 (GiB) 事件中心消息每月 () Azure 监视器日志 每月 (GiB)
1,000 14 62,000 15
100,000 1,000 4,800,000 1,200

请参阅每项服务的以下定价详细信息:

降低 Log Analytics 成本

如果将日志引入 Log Analytics 工作区,但只对按条件筛选的日志感兴趣(例如省略某些列或行),则可以通过在 Microsoft Graph 活动日志表上应用工作区转换来部分降低成本。 若要详细了解工作区转换、它如何影响引入成本以及如何将转换应用于 Microsoft Graph 活动日志,请参阅 Azure Monitor 中的数据收集转换。

降低 Log Analytics 成本的另一种方法是切换到基本日志数据计划,这通过提供减少的功能来降低账单。 更多信息,请参见 将表的日志数据计划设置为基础或分析。

Azure Monitor 日志查询示例

如果将 Microsoft Graph 活动日志发送到 Log Analytics 工作区,则可以使用Kusto 查询语言 (KQL) 查询日志。 有关 Log Analytics 工作区中查询的详细信息,请参阅使用 Log Analytics 分析 Microsoft Entra 活动日志。 可以使用这些查询进行数据浏览、生成警报规则、生成 Azure 仪表板,或使用 Azure Monitor 日志 API 或查询 SDK 集成到自定义应用程序中。

以下 Kusto 查询标识了向组资源发出请求的前 20 个实体,这些资源由于授权而失败:

MicrosoftGraphActivityLogs
| where TimeGenerated >= ago(3d)
| where ResponseStatusCode == 401 or ResponseStatusCode == 403 
| where RequestUri contains "/groups"
| summarize UniqueRequests=count_distinct(RequestId) by AppId, ServicePrincipalId, UserId
| sort by UniqueRequests desc
| limit 20

以下 Kusto 查询标识了潜在风险用户查询或修改的资源:

MicrosoftGraphActivityLogs
| where TimeGenerated > ago(30d)
| join AADRiskyUsers on $left.UserId == $right.Id
| extend resourcePath = replace_string(replace_string(replace_regex(tostring(parse_url(RequestUri).Path), @'(\/)+','/'),'v1.0/',''),'beta/','')
| summarize RequestCount=dcount(RequestId) by UserId, RiskState, resourcePath, RequestMethod, ResponseStatusCode

以下 Kusto 查询允许关联 Microsoft Graph 活动日志和登录日志。 来自 Microsoft 应用程序的活动日志可能并非全部具有匹配的登录日志条目。 有关详细信息,请参阅 登录日志已知限制。

MicrosoftGraphActivityLogs
| where TimeGenerated > ago(7d)
| join kind=leftouter (union SigninLogs, AADNonInteractiveUserSignInLogs, AADServicePrincipalSignInLogs, AADManagedIdentitySignInLogs, ADFSSignInLogs
    | where TimeGenerated > ago(7d))
    on $left.SignInActivityId == $right.UniqueTokenIdentifier

以下 Kusto 查询标识受到限制的应用:

MicrosoftGraphActivityLogs 
| where TimeGenerated > ago(3d) 
| where ResponseStatusCode == 429 
| extend path = replace_string(replace_string(replace_regex(tostring(parse_url(RequestUri).Path), @'(\/)+','//'),'v1.0/',''),'beta/','') 
| extend UriSegments =  extract_all(@'\/([A-z2]+|\$batch)($|\/|\(|\$)',dynamic([1]),tolower(path)) 
| extend OperationResource = strcat_array(UriSegments,'/')| summarize RateLimitedCount=count() by AppId, OperationResource, RequestMethod 
| sort by RateLimitedCount desc 
| limit 100 

以下查询可用于呈现时序图:

MicrosoftGraphActivityLogs 
| where TimeGenerated  between (ago(3d) .. ago(1h))  
| summarize EventCount = count() by bin(TimeGenerated, 10m) 
| render timechart 
    with ( 
    title="Recent traffic patterns", 
    xtitle="Time", 
    ytitle="Requests", 
    legend=hidden 
    )

限制

  • Microsoft Graph 活动日志功能允许租户管理员收集资源租户的日志。 此功能不允许查看另一个租户中多租户应用程序的活动。
  • 无法通过 Azure Monitor 中的诊断设置筛选 Microsoft Graph 活动日志。 但是,Azure Log Analytics 工作区中提供了一些选项来降低成本。 有关详细信息,请参阅 工作区转换。
  • 在大多数区域中,事件可用并在 30 分钟内传递到配置目标。 在不太常见的情况下,某些事件可能需要长达 2 小时才能传送到目标。