Справочник по данным мониторинга Поиск с использованием ИИ Azure

Note

Поиск с использованием ИИ Azure доступна через портал Azure, REST API и Azure SDKs. Он также лежит в основе Foundry IQ — управляемого слоя знаний, который преобразует корпоративный контент в многократно используемые базы знаний с учетом разрешений доступа для агентов на портале Microsoft Foundry.

В этой статье содержится вся справочная информация по мониторингу данного сервиса.

См. Monitor Поиск с использованием ИИ Azure для получения сведений о данных, которые можно собирать для Поиск с использованием ИИ Azure, и их использовании.

Метрики

В этом разделе перечислены все автоматически собираемые метрики платформы для данного сервиса. Эти метрики также входят в глобальный список все метрики платформы, поддерживаемых в Azure Monitor.

Информацию о сохранении метрик см. в разделе Обзор метрик Azure Monitor.

Поддерживаемые метрики для Microsoft.Search/searchServices

В следующей таблице перечислены метрики, доступные для типа ресурса Microsoft.Search/searchServices.

  • Все столбцы могут быть не в каждой таблице.
  • Некоторые колонки могут находиться за пределами зоны обзора страницы. Выберите «Развернуть таблицу », чтобы просмотреть все доступные столбцы.

Заголовки таблиц

  • Категория — группа метрик или классификация.
  • Metric — Отображённое название метрики, как оно отображается в портале Azure.
  • Имя в REST API — название метрики, указанное в REST API.
  • Единица — единица меры.
  • Агрегация— тип агрегации по умолчанию. Допустимые значения: среднее (среднее), минимальное (минимум), максимум (максимум), общее количество (сумма), подсчет.
  • Размеры - Размеры доступны для метрики.
  • Шаги времени - Интервалы, с которыми измеряется метрика. Например, PT1M означает, что метрика дискретируется каждую минуту, PT30M каждые 30 минут, PT1H каждый час и так далее.
  • DS Export — Можно ли экспортировать метрику в Azure Monitor Logs через диагностические настройки. Для информации об экспорте метрик см. Создать диагностические настройки в Azure Monitor.
Метрика Имя в REST API Дополнительные метрики платформы Единицы Агрегация Размеры Временные единицы Экспорт DS
Обработанные файлы индексатора (байты)

Общий объём байтов исходных данных, обработанных индексаторами из файловых источников данных (например: Blob, ADLS Gen2, File, SharePoint, OneLake)
DocumentsProcessedBytes Нет Bytes Общий (Сумма), Средний DataSourceName, IndexerName, IndexName PT1M Да
Количество обработанных документов

Количество обработанных документов
DocumentsProcessedCount Нет Счётчик Итого (Сумма), Количество DataSourceName, , FailedIndexerName, IndexNameSkillsetName PT1M Да
Использование хранилища

Использование хранилища (текст и вектор) для службы поиска по индексу
IndexStorageUsage Нет Bytes Среднее, максимальное, минимальное IndexName PT1M Да
Использование векторного хранилища

Использование векторного хранилища для службы поиска по индексу
IndexVectorUsage Нет Bytes Среднее, максимальное, минимальное IndexName PT1M Да
Используемые вычислительные единицы

Количество вычислительных единиц, потребляемых операциями службы поиска и периодами прогрева индекса, в микро-CU-часах (разделите общее значение на 1 000 000, чтобы получить CU-часы). Фильтр состояния устарел.
PerRequestComputeConsumption Нет Счётчик Общий (Сумма), Средний Status, IndexName, ResourceKind, EventType PT1M Да
Задержка поиска

Средняя задержка поиска для службы поиска
SearchLatency Нет Секунд Средняя <нет> PT1M Да
Поисковые запросы в секунду

Запросы поиска в секунду для службы поиска
SearchQueriesPerSecond Нет CountPerSecond Средняя <нет> PT1M Да
Число вызовов исполнения навыка

Количество использований навыков
SkillExecutionCount Нет Счётчик Итого (Сумма), Количество DataSourceName, Failed, IndexerName, SkillName, SkillsetName, SkillType PT1M Да
Процент регулируемых поисковых запросов

Процент поисковых запросов, которые были ограничены для службы поиска
ThrottledSearchQueriesPercentage Нет Процент Средняя <нет> PT1M Да

Поисковые запросы в секунду

Эта метрика показывает среднее значение запросов поиска в секунду (QPS) для службы поиска. Обычно запросы выполняются в миллисекундах, поэтому только запросы, которые измеряют как секунды, отображаются в метрике, например QPS. Минимальное значение — это наименьшее значение для поисковых запросов в секунду, зарегистрированных в течение этой минуты. Максимум — это наибольшее значение. Среднее значение вычисляется за всю минуту.

Тип агрегирования Описание
Средняя Среднее количество секунд в течение минуты, в течение которого произошло выполнение запроса.
Счётчик Количество метрик, выдаваемых журналу в течение одной минуты.
Максимум Наибольшее количество запросов поиска в секунду зарегистрировано в течение минуты.
Минимальный Наименьшее количество поисковых запросов в секунду, зарегистрированное в минуту.
Сумма Сумма всех запросов, выполняемых в течение минуты.

Например, в течение одной минуты у вас может быть шаблон: одна секунда высокой нагрузки, которая является максимальной для SearchQueriesPerSecond, за которой следует 58 секунд средней нагрузки, и, наконец, одна секунда только с одним запросом, который является минимальным.

Другой пример: если узел выдает 100 метрик, где значение каждой метрики равно 40, то значение count равно 100, "Sum" равно 4000, "Среднее" равно 40, а "Max" — 40.

Задержка поиска

Задержка поиска указывает, сколько времени занимает запрос.

Тип агрегирования Задержки
Средняя Средняя длительность запроса в миллисекундах.
Счётчик Количество метрик, выдаваемых журналу в течение одной минуты.
Максимум Самый длительный запрос в примере.
Минимальный Самый короткий запуск запроса в примере.
Всего Общее время выполнения всех запросов в примере, выполняющееся в течение интервала (одна минута).

Процент ограниченных поисковых запросов

Эта метрика ссылается на запросы, которые удаляются вместо обработки. Ограничение возникает, когда число запросов в процессе выполнения превышает пропускную способность. Когда реплика выводится из обращения или во время индексирования может увеличиться количество ограниченных запросов. Как запросы, так и запросы на индексирование обрабатываются одним и тем же набором ресурсов.

Служба определяет, следует ли удалять запросы на основе потребления ресурсов. Средний процент использования ресурсов в оперативной памяти, центральном процессоре и операции ввода-вывода диска рассчитывается за определенный период времени. Если этот процент превышает пороговое значение, все запросы к индексу ограничены, пока объем запросов не уменьшится.

В зависимости от клиента, ограниченный запрос может отмечаться следующим образом:

  • Служба возвращает ошибку "You are sending too many requests. Please try again later."
  • Служба возвращает код ошибки 503, указывающий, что служба в настоящее время недоступна.
  • Если вы используете портал Azure (например, обозреватель поиска), запрос удаляется автоматически, и необходимо снова выбрать Search.

Чтобы подтвердить регулирование запросов, используйте метрику запросов с ограничением. Вы можете просматривать метрики на портале Azure или создавать метрики оповещений, как описано в этой статье. Для запросов, которые были удалены в пределах интервала выборки, используйте Total , чтобы получить процент запросов, которые не выполнялись.

Тип агрегирования Дросселирование
Средняя Процент запросов, отброшенных в пределах интервала.
Счётчик Количество метрик, выдаваемых журналу в течение одной минуты.
Максимум Процент запросов, отброшенных в пределах интервала.
Минимальный Процент запросов, отброшенных в пределах интервала.
Всего Процент запросов, отброшенных в пределах интервала.

Для процента ограниченных запросов поиска минимальное, максимальное, среднее и общее значения — все имеют одинаковое значение: процент запросов поиска, которые были ограничены, от общего числа поисковых запросов в течение одной минуты.

Использование единиц вычислений

Эта метрика измеряет ресурсы вычислений, памяти и операций ввода-вывода, потребляемые службой Поиск с использованием ИИ Azure, выраженные в милли единиц вычислений (mCUS). Он служит показателем вычислительных затрат для различных типов операций. Использование может меняться в зависимости от выполняемых операций.

Эту метрику можно просмотреть на двух уровнях:

  • Уровень службы поиска: агрегированное потребление вычислительных ресурсов во всей службе.
  • Уровень индекса: область потребления, ограниченная определенным индексом, полезная для определения того, какие индексы являются самыми потребляющими ресурсы.
Тип агрегирования Описание
Сумма Общее количество mCU, израсходованных за выбранный интервал времени. Полезно для понимания общей стоимости вычислений с течением времени.
Среднее значение Среднее количество потребленных единиц mCU за выбранный интервал времени.

Эта метрика поддерживает следующие фильтры:

  • Имя индекса: фильтрует метрику по определенному индексу. Если фильтр не применяется, метрика отражает общее потребление всех индексов в службе.

  • Имя операции: фильтрует метрику по операции, что способствует потреблению вычислительных ресурсов. Если фильтр не применяется, метрика отражает объединенное потребление во всех типах операций. Сведения о поддерживаемых значениях см. в справочнике по данным мониторинга.

Метрические размеры

Для информации о том, что такое метрические размерности, см. раздел «Многомерные метрики».

Поиск с использованием ИИ Azure имеет измерения, связанные со следующими метриками, которые фиксируют количество обработанных документов или выполненных функций.

Имя метрики Описание Размеры Примеры вариантов использования
Количество обработанных документов Показывает количество обработанных документов индексатора. Имя источника данных, сбой, имя индекса, имя индексатора, имя набора навыков Можно ссылаться в качестве грубой оценки пропускной способности (количество документов, которые индексатор обрабатывает за единицу времени)
— настроить оповещение об ошибочных документах
Число вызовов исполнения навыка Показывает количество вызовов навыка. Имя источника данных, сбой, имя индекса, имя индексатора, имя навыка, тип навыка, имя набора навыков Убедиться в правильности вызова навыков, сравнивая относительное количество вызовов между самими навыками и сравнивая количество вызовов навыков с количеством документов.
— настройка оповещений о неудачных вызовах навыков
Использование единиц вычислений Показывает количество mCU, потребляемых при операциях в службе поиска Имя индекса, Операция Оцените, какая операция потребляла больше всего вычислительных ресурсов.
-Настройка оповещений, когда потребление muck превышает ожидаемые пороговые значения для заданного типа операции
Имя измерения Описание
DataSourceName Именованное подключение к источнику данных, используемое во время выполнения индексатора. Допустимые значения являются одним из поддерживаемых типов источников данных.
Не удалось Указывает, произошел ли сбой экземпляра.
IndexerName Имя индексатора.
IndexName Имя индекса.
SkillsetName Имя набора навыков, используемого во время выполнения индексатора.
SkillName Имя навыка в наборе навыков.
SkillType Функция навыка @odata.type .

Журналы ресурсов

В этом разделе перечислены типы журналов ресурсов, которые вы можете собирать для этой услуги. Раздел содержит информацию из списка всех типов категорий журналов ресурсов, поддерживаемых в Azure Monitor.

Поддерживаемые журналы ресурсов для Microsoft.Search/SearchServices

Категории Затраты на экспорт Таблица журналов Поддерживает базовый план логов Поддерживает преобразование во время загрузки Примеры запросов
OperationLogs Нет AzureDiagnostics

Логи из нескольких ресурсов Azure.

Нет Нет

Таблицы журналов Azure Monitor

В этом разделе перечислены таблицы Azure Monitor Logs, относящиеся к данному сервису, которые доступны для запроса Log Analytics с помощью запросов Kusto. Таблицы содержат данные журнала ресурсов и, возможно, больше, в зависимости от того, что собирается и направляется к ним.

Службы поиска

Microsoft.Search/searchServices

Таблица Описание
AzureActivity Записи из журнала действий Azure предоставляют аналитические сведения об операциях плоскости управления. Задачи, вызываемые на уровне управления, например добавление или удаление реплик и секций, представлены с помощью действия "Получить ключ администратора".
AzureDiagnostics Регистрированные операции запроса и индексирования. Запросы к таблице AzureDiagnostics в Log Analytics могут включать общие свойства, поисковые свойства и поисковые операции, перечисленные в разделе справочника по схеме.
AzureMetrics Данные метрик, создаваемые Поиск с использованием ИИ Azure, которые измеряют работоспособность и производительность.

Таблицы журнала ресурсов

В следующей таблице перечислены свойства журналов ресурсов в Поиск с использованием ИИ Azure. Журналы ресурсов собираются в Azure Monitor Logs или служба хранилища Azure. В Azure Monitor журналы собираются в таблице AzureDiagnostics под именем поставщика ресурсов Microsoft.Search.

служба хранилища Azure поле или свойство свойство журнала Azure Monitor Описание
Время TIMESTAMP Дата и время (UTC) при выполнении операции.
resourceId Concat("/", "/subscriptions", SubscriptionId, "resourceGroups", ResourceGroupName, "providers/Microsoft/Search/searchServices", ServiceName) Ресурс Поиск с использованием ИИ Azure, для которого включены журналы.
категория OperationLogs Категории журналов включают Audit, Operational, Execution и Request.
имя операции Имя Имя операции. Имя операции может быть Indexes.ListIndexStatsSummaries, Indexes.GetIndexes.StatsIndexers.ListQuery.SearchQuery.SuggestQuery.LookupQuery.AutocompleteCORS.PreflightIndexes.UpdateIndexes.Prototype, . ServiceStatsDataSources.ListIndexers.Warmup
длительность в мс Продолжительность в миллисекундах Длительность операции в миллисекундах.
версия операции ApiVersion Версия API, используемая в запросе.
типРезультата (Не удалось) ? "Ошибка" : "Успех" Тип ответа.
подпись результата Статус Состояние ответа HTTP операции.
свойства Свойства Любые расширенные свойства, связанные с этой категорией событий.

Журнал действий

В связанной таблице перечислены операции, которые можно записать в журнал активности этого сервиса. Эти операции являются подмножеством всех возможных операций поставщика ресурсов в журнале активности.

Для получения дополнительной информации о схеме записей журнала активности см. схему журнала активности.

В следующей таблице перечислены распространенные операции, связанные с Поиск с использованием ИИ Azure, которые могут быть записаны в журнале действий. Полный список всех операций Microsoft.Search см. в разделе Операции поставщика ресурсов Microsoft.Search.

Операции Описание
Получение ключа администратора Любая операция, требующая прав администратора, регистрируется как операция "Получить ключ администратора".
Получение ключа запроса Любая операция чтения с коллекцией индекса документов.
Повторное создание ключа администратора Запрос на повторное создание первичного или дополнительного ключа API администратора.

Распространенные записи включают ссылки на ключи API — универсальные информационные уведомления, такие как получение ключа администратора и получение ключей запросов. Эти действия указывают на запросы, которые были сделаны с помощью ключа администратора (создание или удаление объектов) или ключа запроса, но не отображают сам запрос. Для получения сведений об этом зерне необходимо настроить ведение журнала ресурсов.

Или вы можете получить некоторое представление из истории изменений. На портале Azure выберите действие, чтобы открыть страницу сведений, а затем выберите "Журнал изменений" для получения сведений о базовой операции.

Другие схемы

Для этой службы используются следующие схемы.

Если вы создаете запросы или пользовательские отчеты, структуры данных, содержащие Поиск с использованием ИИ Azure журналы ресурсов, соответствуют следующим схемам.

Для журналов ресурсов, отправленных в хранилище блобов, каждый блоб имеет один корневой элемент, называемый записями, содержащий массив объектов журналов. Каждый объект типа BLOB содержит записи для всех операций, произошедших в течение одного часа.

Схема журнала ресурсов

Все журналы ресурсов, доступные через Azure Monitor, используют общую схему верхнего уровня. Поиск с использованием ИИ Azure дополняет дополнительными свойствами и операциями, которые уникальны для службы поиска.

В следующем примере показан журнал ресурсов, включающий общие свойства (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
ТипРезультата Строка "Успех". Другие возможные значения: успех или сбой
ПодписьРезультата Int Код результата HTTP. Например: 200
Длительность в миллисекундах Int Длительность операции в миллисекундах.
Свойства Объект Объект, содержащий данные, относящиеся к операции. См. следующую таблицу свойств схемы.

Схема свойств

Следующие свойства относятся к Поиск с использованием ИИ Azure.

Имя Тип Описание и пример
Описание_s Строка Конечная точка операции. Например: GET /indexes('content')/docs
Документы_d Int Количество обработанных документов.
IndexName_s Строка Имя индекса, связанного с операцией.
Query_s Строка Параметры запроса, используемые в запросе. Например: ?search=beach access&$count=true&api-version=2026-04-01

Значения OperationName (зарегистрированные операции)

Следующие операции могут отображаться в журнале ресурсов.

ИмяОперации Описание
DataSources.* Применяется к источникам данных индексатора. Можно создавать, удалять, получать, перечислять.
DebugSessions.* Применяется к сеансу отладки. Можно создавать, удалять, получать, список, запускать и показать состояние.
DebugSessions.DocumentStructure Обогащенный документ загружается в сеанс отладки.
DebugSessions.RetrieveIndexerExecutionHistoricalData Запрос деталей выполнения индексатора.
DebugSessions.ИзвлекатьПроектируемыеИндексацииИсторическиеДанныеЭффективности История выполнения для данных обогащения, проецируемых в хранилище знаний.
Индексаторы.* Применяется к индексатору. Можно создавать, удалять, получать, выводить список и состояние.
Индексы.* Применяется к индексу поиска. Можно создавать, удалять, получать, перечислять.
Индексы.Прототип Метаданные индекса определяются мастером импорта данных на основе входных данных.
Indexing.Index Эта операция вызывает индексные документы.
Metadata.GetMetadata Запрос системных данных службы поиска.
Запрос.Автозаполнение Запрос автозаполнения по индексу. См. типы запросов и композиции.
Query.Lookup Поисковый запрос по индексу. См. типы запросов и композиции.
Query.Search Запрос полнотекстового поиска по индексу. См. типы запросов и композиции.
Запрос.Предложение Введите вперед запрос к индексу. См. типы запросов и композиции.
ServiceStats Эта операция — это обычный вызов get Service Statistics, вызываемый напрямую или неявно для заполнения страницы обзора портала при загрузке или обновлении.
Наборы компетенций.* Применяется к набору умений и навыков. Можно создавать, удалять, получать, перечислять.