你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
注释
Azure AI 搜索可通过Azure门户、REST API 和Azure SDK获取。 它也是 Foundry IQ 的基础；Foundry IQ 是一个托管式知识层，可将企业内容转化为供 Microsoft Foundry 门户中的智能体使用的、可复用且具备权限感知能力的知识库。
本文包含本服务的所有监测参考信息。
请参阅 Monitor Azure AI 搜索，了解有关可收集的 Azure AI 搜索 数据及其使用方法的详细信息。
指标
本节列出了该服务所有自动收集的平台指标。 这些指标也是Azure Monitor支持的全球
有关度量保留的信息，请参见 Azure Monitor 度量概览。
Microsoft.Search/searchServices 支持的指标
下表列出了适用于 Microsoft.Search/searchServices 资源类型的指标。
- 并非所有列都存在于每个表格中。
- 有些列可能超出页面的视野范围。 选择 “展开表格 ”以查看所有可用列。
表标题
- 类别 ——指标组或分类。
- 指标 - 在 Azure 门户中显示的指标显示名称。
- REST API 中的名称 ——REST API 中引用的度量名称。
- 单位——计量单位。
- 聚合 ——默认聚 合 类型。 有效数值：平均值（平均）、最小值（最小值）、最大值（最大值）、总值（总和）、计数。
- 维度 - 该度量的可用维度。
-
时间粒度 - 度量的采样区间。 例如，
PT1M表示指标每分钟采样一次，PT30M表示每30分钟采样一次，PT1H表示每小时采样一次，依此类推。 - DS 导出 - 指标是否可以通过诊断设置导出到 Azure Monitor 日志。 有关指标导出的信息，请参见在Azure Monitor创建诊断设置。
| 指标 | REST API 中的名称 | 高级平台指标 | 单位 | 聚合 | 尺寸 | 时间粒度 | DS 导出 |
|---|---|---|---|---|---|---|---|
|
索引器处理的文件（字节） 基于文件的数据源（例如 Blob、ADLS Gen2、文件、SharePoint、OneLake）中索引器处理的源数据的总字节数 |
DocumentsProcessedBytes |
不 | Bytes | 总计（总和）、平均值 |
DataSourceName、IndexerName、IndexName |
PT1M | 是的 |
|
已处理的文档计数 处理的文档数 |
DocumentsProcessedCount |
不 | 计数 | 总计（总和），计数 |
DataSourceName， Failed， IndexerName， IndexName， SkillsetName |
PT1M | 是的 |
|
存储使用情况 按索引对搜索服务的存储使用情况（文本 + 向量） |
IndexStorageUsage |
不 | Bytes | 平均值、最大值、最小值 | IndexName |
PT1M | 是的 |
|
矢量存储使用情况 按索引对搜索服务的矢量存储使用情况 |
IndexVectorUsage |
不 | Bytes | 平均值、最大值、最小值 | IndexName |
PT1M | 是的 |
|
使用的计算单位 搜索服务操作和索引预热窗口消耗的计算单位，以微 CU 小时为单位（将总数除以 1,000,000 即可得到 CU 小时）。 状态筛选器已弃用。 |
PerRequestComputeConsumption |
不 | 计数 | 总计（总和）、平均值 |
Status、IndexName、ResourceKind、EventType |
PT1M | 是的 |
|
搜索延迟 搜索服务的平均搜索延迟 |
SearchLatency |
不 | 秒 | 平均 | <没有> | PT1M | 是的 |
|
每秒搜索查询数 搜索服务的每秒搜索查询数 |
SearchQueriesPerSecond |
不 | 每秒计数 | 平均 | <没有> | PT1M | 是的 |
|
技能调用计数 技能执行次数 |
SkillExecutionCount |
不 | 计数 | 总计（总和），计数 |
DataSourceName， Failed， IndexerName， SkillName， SkillsetName， SkillType |
PT1M | 是的 |
|
受限制的搜索查询百分比 为搜索服务限制的搜索查询百分比 |
ThrottledSearchQueriesPercentage |
不 | 百分比 | 平均 | <没有> | PT1M | 是的 |
每秒搜索查询数
此指标显示搜索服务的每秒搜索查询（QPS）的平均值。 查询通常以毫秒为单位执行，因此只有以秒为单位的查询才会出现在 QPS 等指标中。 最小值是在该分钟内记录的每秒搜索查询的最低值。 最大值是一个集合中可能达到的最高值。 平均值是一分钟内的聚合值。
| 聚合类型 | 描述 |
|---|---|
| 平均 | 执行查询的一分钟内的平均秒数。 |
| 计数 | 在一分钟间隔内发送到日志的指标数。 |
| 最大 | 每分钟内记录的每秒搜索查询次数最多。 |
| 最低 | 在一分钟内每秒注册的最小搜索查询数。 |
| 求和 | 分钟内执行的所有查询的总和。 |
例如，在一分钟内，可能有如下所示的模式：一秒的高负载是 SearchQueriesPerSecond 的最大负载，后跟 58 秒的平均负载，最后一秒只有一个查询，这是最小值。
另一个示例：如果节点发出 100 个指标，其中每个指标的值为 40，则“Count”为 100，“Sum”为 4000，“Average”为 40，“Max”为 40。
搜索延迟
搜索延迟表示查询需要多长时间才能完成。
| 聚合类型 | 延迟 |
|---|---|
| 平均 | 平均查询持续时间（以毫秒为单位）。 |
| 计数 | 在一分钟间隔内发送到日志的指标数。 |
| 最大 | 示例中运行时间最长的查询。 |
| 最低 | 示例中运行时间最短的查询。 |
| 总 | 示例中所有查询的总执行时间，在间隔（一分钟）内执行。 |
受限制的搜索查询百分比
此指标是指删除而不是处理的查询。 当执行的请求数量超过容量时，就会发生限制。 排除某个副本的轮换或者在编制索引期间，可能会看到受限制请求的数量增多。 查询和索引请求都由同一组资源处理。
该服务根据资源消耗确定是否删除请求。 内存、CPU 和磁盘 IO 消耗的资源百分比在一段时间内平均。 如果此百分比超过阈值，则会限制对索引的所有请求，直到请求量减少。
根据所用的客户端，可通过以下方式指示受限制的请求：
- 服务返回错误
"You are sending too many requests. Please try again later." - 服务返回一个 503 错误代码，指示该服务当前不可用。
- 如果使用 Azure 门户（例如搜索资源管理器），则查询将静默删除，需要再次选择 Search。
若要确认受限制的查询，请使用 “限制”搜索查询 指标。 可以浏览Azure门户中的指标，或创建警报指标，如本文所述。 对于在采样间隔内删除的查询，请使用 Total 获取未执行的查询百分比。
| 聚合类型 | 节流 |
|---|---|
| 平均 | 间隔内丢弃的查询百分比。 |
| 计数 | 在一分钟间隔内发送到日志的指标数。 |
| 最大 | 间隔内丢弃的查询百分比。 |
| 最低 | 间隔内丢弃的查询百分比。 |
| 总 | 间隔内丢弃的查询百分比。 |
对于 限流搜索查询百分比、最小值、最大值、平均值和总计，所有这些数值均相同：即在一分钟内总搜索查询中被限流的查询所占的百分比。
计算单元使用情况
此指标度量Azure AI 搜索服务使用的计算、内存和 I/O 资源，以米数计算单位（mCPU）表示。 它可作为不同操作类型处理成本的衡量指标。 使用情况可能会随时间而变化，具体取决于正在执行的操作。
可以在两个级别查看此指标：
- 搜索服务级别：整个服务的聚合计算消耗量。
- 索引级别：范围限定为特定索引的消耗量，可用于确定哪些索引驱动资源使用率最高。
| 聚合类型 | 描述 |
|---|---|
| 总和 | 所选时间间隔内消耗的总 mCPU 数。 有助于了解一段时间内的总体计算成本。 |
| 平均值 | 所选时间间隔内消耗的平均 mCPU。 |
此指标支持以下筛选器：
索引名称：将指标筛选为特定索引。 如果未应用筛选器，则指标反映服务中所有索引的总消耗量。
操作名称：按导致计算消耗的操作筛选指标。 如果未应用筛选器，则指标反映所有操作类型的总消耗量。 有关支持的值，请参阅 “监视数据参考”。
指标维度
关于度量维度的信息，请参见 多维度量。
Azure AI 搜索具有以下指标相关的维度，这些指标捕获已执行的文档或技能的数量。
| 指标名称 | 描述 | 尺寸 | 示例用例 |
|---|---|---|---|
| 已处理的文档计数 | 显示索引器处理的文档数。 | 数据源名称， 失败， 索引名称， 索引器名称， 技能集名称 | 可以引用为吞吐量的粗略度量值（索引器随时间推移处理的文档数） - 设定系统以对失败的文档发出警报 |
| 技能调用计数 | 显示技能调用的数量。 | 数据源名称， 失败， 索引名称， 索引器名称， 技能名称， 技能类型， 技能集名称 | 通过比较技能之间的相对调用次数，以及技能调用次数与文档数量来确保按预期调用技能。 - 针对失败的技能调用设置警报 |
| 计算单位使用情况 | 显示搜索服务上的操作所消耗的 mCU | 索引名称，操作 | 评估哪个操作消耗了最多的计算。 -设置警报，以便在针对给定作业类型的渣土消耗超出预期阈值时发出警报 |
| 维度名称 | 描述 |
|---|---|
| DataSourceName | 索引器执行期间使用的命名数据源连接。 有效值是 受支持的数据源类型之一。 |
| 失败 | 指示实例是否失败。 |
| IndexerName | 索引器的名称。 |
| 索引名称 IndexName | 索引的名称。 |
| SkillsetName | 索引器执行期间使用的技能集的名称。 |
| SkillName | 属于技能组的某个技能的名称。 |
| SkillType | 技能的 @odata.type。 |
资源日志
本节列出了您可以为该服务收集的资源日志类型。 本部分拉取自 Azure Monitor 支持的所有资源日志类别类型列表。
Microsoft.Search/searchServices支持的资源日志
| 类别 | 出口成本 | 日志表 | 支持基本的日志规划 | 支持引入时转换 | 示例查询 |
|---|---|---|---|---|---|
| OperationLogs | 不 |
AzureDiagnostics 来自多个 Azure 资源的日志。 |
不 | 不 |
Azure Monitor 日志表
本节列出了与该服务相关的 Azure Monitor 日志表，这些表可通过 Log Analytics 使用 Kusto 查询进行查询。 这些表包含资源日志数据，根据收集和路由给它们的数据，可能还会包括更多内容。
搜索服务
Microsoft.Search/searchServices
| 表 | 描述 |
|---|---|
| AzureActivity | Azure 活动日志中的条目，提供有关控制平面操作方面的见解。 在控制平面上调用的任务（例如添加或删除副本和分区）通过“获取管理密钥”活动表示。 |
| AzureDiagnostics | 记录的查询和索引操作。 Log Analytics中针对 AzureDiagnostics 表的查询可以包括通用属性、特定于 search 的属性，以及架构引用部分中列出的特定于 search 的操作。 |
| AzureMetrics | Azure AI 搜索发出的指标数据，用于衡量运行状况和性能。 |
资源日志表
下表列出了Azure AI 搜索中资源日志的属性。 资源日志将收集到Azure Monitor日志或Azure 存储中。 在 Azure Monitor 中，将日志收集到 Microsoft.Search 资源提供程序下的 AzureDiagnostics 表中。
| Azure 存储字段或属性 | Azure Monitor Logs 属性 | 描述 |
|---|---|---|
| 时间 | 时间戳 | 操作发生的日期和时间（UTC）。 |
| resourceId | Concat（“/”， “/subscriptions”， SubscriptionId， “resourceGroups”， ResourceGroupName， “providers/Microsoft.Search/searchServices”， ServiceName） | 为其启用了日志的 Azure AI 搜索资源。 |
| 分类 | “OperationLogs” | 日志类别包括Audit、Operational和 ExecutionRequest。 |
| 操作名称 | 名字 | 操作的名称。 操作名称可以是Indexes.ListIndexStatsSummaries、、、Indexes.Get、Indexes.StatsIndexers.ListQuery.SearchQuery.SuggestQuery.LookupQuery.Autocomplete、CORS.Preflight、Indexes.Update、Indexes.Prototype、、 。 ServiceStatsDataSources.ListIndexers.Warmup |
| durationMS | 持续时间毫秒数 | 操作的持续时间（以毫秒为单位）。 |
| operationVersion | ApiVersion | 请求中使用的 API 版本。 |
| 结果类型 | （失败） ？ “失败”：“成功” | 响应的类型。 |
| resultSignature | 地位 | 操作的 HTTP 响应状态。 |
| 性能 | 属性 | 与此类别事件相关的任何扩展属性。 |
活动日志
链表列出了该服务活动日志中可记录的操作。 这些操作是 活动日志中所有可能的资源提供者操作的一个子集。
有关活动日志条目的模式的更多信息，请参见 活动日志模式。
下表列出了与可能记录在活动日志中的Azure AI 搜索相关的常见操作。 有关 Microsoft.Search 操作的完整列表，请参阅 Microsoft.Search 资源提供者操作。
| 操作 | 描述 |
|---|---|
| 获取管理密钥 | 需要管理权限的任何操作都记录为“获取管理密钥”操作。 |
| 获取查询密钥 | 对一个索引的文档集合进行的任何只读操作。 |
| 重新生成管理密钥 | 重新生成主管理员 API 密钥或辅助管理 API 密钥的请求。 |
常见条目包括对 API 密钥的引用 - 常规信息性通知，如 “获取管理密钥 ”和 “获取查询密钥”。 这些活动表示使用管理密钥（创建或删除对象）或查询密钥发出的请求，但不显示请求本身。 如需这种粒度的信息，必须配置资源日志记录。
或者，可以通过更改历史记录获得一些见解。 在Azure门户中，选择活动以打开详细信息页，然后选择“更改历史记录”以获取有关基础操作的信息。
其他架构
以下架构用于此服务。
如果要生成查询或自定义报表，则包含Azure AI 搜索资源日志的数据结构符合以下架构。
对于发送到 Blob 存储的资源日志，每个 Blob 都有一个名为 记录 的根对象，其中包含一组日志对象。 每个 Blob 都包含同一小时内发生的所有操作的记录。
资源日志架构
通过 Azure Monitor 提供的所有资源日志共享一个共同的顶级架构。 Azure AI 搜索补充了搜索服务独有的其他属性和操作。
以下示例演示了一个资源日志，其中包括通用属性（TimeGenerated、Resource、Category 等）和搜索特定的属性（OperationName 和 OperationVersion）。
| 名字 | 类型 | 说明和示例 |
|---|---|---|
| TimeGenerated | 日期时间 | 操作的时间戳。 例如： 2021-12-07T00:00:43.6872559Z |
| 资源 | 字符串 | 资源标识符。 例如： /subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group-name>/providers/Microsoft.Search/searchServices/<your-search-service-name> |
| 类别 | 字符串 | “OperationLogs”。 此值是常量。 OperationLogs 是用于资源日志的唯一类别。 |
| 操作名称 | 字符串 | 操作的名称（请参阅 操作的完整列表）。 例如 Query.Search |
| 操作版本 | 字符串 | 请求中使用的 API 版本。 例如： 2026-04-01 |
| 结果类型 | 字符串 | “成功”。 其他可能的值：成功或失败 |
| ResultSignature | Int | HTTP 结果代码。 例如： 200 |
| DurationMS | Int | 操作的持续时间（以毫秒为单位）。 |
| 属性 | 对象 | 包含特定于操作的数据的对象。 请参阅以下属性架构表。 |
属性架构
以下属性特定于Azure AI 搜索。
| 名字 | 类型 | 说明和示例 |
|---|---|---|
| Description_s | 字符串 | 操作的终结点。 例如： GET /indexes('content')/docs |
| Documents_d | Int | 处理的文档数。 |
| IndexName_s | 字符串 | 与操作关联的索引的名称。 |
| Query_s | 字符串 | 请求中使用的查询参数。 例如： ?search=beach access&$count=true&api-version=2026-04-01 |
OperationName 值（记录的操作）
以下操作可以出现在资源日志中。
| 操作名称 | 描述 |
|---|---|
| DataSources.* | 适用于索引器数据源。 可以是创建、删除、获取、列出。 |
| DebugSessions.* | 适用于调试会话。 可以是 Create、Delete、Get、List、Start 和 Status。 |
| DebugSessions.DocumentStructure | 扩充的文档将加载到调试会话中。 |
| DebugSessions.RetrieveIndexerExecutionHistoricalData | 针对索引器执行详细信息的请求。 |
| 调试会话.检索索引器执行历史数据 | 投影到知识存储用于扩充的执行历史记录。 |
| 索引器。 | 适用于索引器。 可以是创建、删除、获取、列表和状态。 |
| 索引。* | 适用于搜索索引。 可以是创建、删除、获取、列出。 |
| 索引.原型 | 索引元数据由 导入数据 向导基于数据输入定义。 |
| Indexing.Index | 此操作是对 索引文档的调用。 |
| Metadata.GetMetadata | 请求搜索服务系统的数据。 |
| Query.自动完成 | 针对索引的自动完成查询。 请参阅 查询类型和组合。 |
| Query.Lookup | 针对索引的查找查询。 请参阅 查询类型和组合。 |
| 查询.搜索 | 针对索引的全文搜索请求。 请参阅 查询类型和组合。 |
| Query.Suggest | 针对索引的预先键入查询。 请参阅 查询类型和组合。 |
| ServiceStats | 此操作是对 获取服务统计信息的例程调用，直接调用或隐式调用，以便在加载或刷新门户概述页时填充它。 |
| Skillsets.* | 对适用于技能组。 可以是创建、删除、获取、列出。 |
相关内容
- 有关监视Azure AI 搜索的说明，请参阅 Monitor Azure AI 搜索。
- 有关如何使用 Azure Monitor 监视 Azure 资源的详细信息，请参见 使用 Azure Monitor 监控 Azure 资源。