Справочник по данным мониторинга поиска ИИ Azure

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

Дополнительные сведения о данных, собранных для поиска ИИ Azure, см. в разделе "Мониторинг поиска ИИ Azure" и его использовании.

Метрики

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

Сведения о хранении метрик см. в обзоре метрик Azure Monitor.

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

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

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

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

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

Метрика	Имя в REST API	Единица измерения	Агрегат	Измерения	Интервалы времени	Экспорт DS
Количество обработанных документов Количество обработанных документов	DocumentsProcessedCount	Count	Total (Sum), Count	DataSourceName, , FailedIndexerName, IndexNameSkillsetName	PT1M	Да
Задержка поиска Среднее время задержки поиска для службы поиска.	SearchLatency	сек.	По средней	<none>	PT1M	Да
Поисковые запросы в секунду Число поисковых запросов в секунду для службы поиска.	SearchQueriesPerSecond	Число/с	По средней	<none>	PT1M	Да
Число вызовов выполнения навыка Число выполнений навыков	SkillExecutionCount	Count	Total (Sum), Count	DataSourceName, , FailedSkillNameIndexerNameSkillsetName,SkillType	PT1M	Да
Процент регулируемых поисковых запросов Процент отрегулированных поисковых запросов для службы поиска.	ThrottledSearchQueriesPercentage	Процент	По средней	<none>	PT1M	Да

Запросов поиска в секунду

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

Тип агрегирования	Description
По средней	Среднее число секунд за минуту, в течение которых выполнялся запрос.
Count	Количество метрик, переданных в журнал в течение интервала времени длительностью одна минута.
Максимум	Максимальное число поисковых запросов в секунду, зарегистрированное в течение минуты.
Минимум	Минимальное число поисковых запросов в секунду, зарегистрированное в течение минуты.
Sum	Сумма метрик для всех запросов, выполненных в течение минуты.

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

Еще один пример: если узел порождает 100 метрик и значение каждой метрики равно 40, то Count равно 100, Sum — 4000, Average — 40, а Max — 40.

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

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

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

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

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

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

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

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

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

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

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

Измерения метрик

Дополнительные сведения о измерениях метрик см. в разделе "Многомерные метрики".

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

Имя метрики	Description	Измерения	Примеры вариантов использования
Количество обработанных документов	Показывает количество обработанных документов индексатора.	Имя источника данных, сбой, имя индекса, имя индексатора, имя набора навыков	Можно ссылаться в качестве грубой меры пропускной способности (количество документов, обрабатываемых индексатором с течением времени) — настройка оповещения о неудачных документах
Число вызовов выполнения навыка	Показывает количество вызовов навыка.	Имя источника данных, сбой, имя индекса, имя индексатора, имя навыка, тип навыка, имя набора навыков	Ссылка на обеспечение того, чтобы навыки вызывались должным образом, сравнивая относительные числа вызовов между навыками и числом вызовов навыков с числом документов. — настройка оповещений о неудачных вызовах навыков

Имя измерения	Description
DataSourceName	Именованное подключение к источнику данных, используемое во время выполнения индексатора. Допустимые значения являются одним из поддерживаемых типов источников данных.
Неудачно	Указывает, произошел ли сбой экземпляра.
IndexerName	Имя индексатора.
IndexName	Имя индекса.
SkillsetName	Имя набора навыков, используемого во время выполнения индексатора.
SkillName	Имя навыка в наборе навыков.
SkillType	Навык @odata.type .

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

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

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

Категория	Отображаемое имя категории	Таблица журналов	Поддерживает базовый план журнала	Поддерживает преобразование времени приема	Примеры запросов	Затраты на экспорт
OperationLogs	Журналы операций	AzureDiagnostics Журналы из нескольких ресурсов Azure.	No	No		No

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

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

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

Microsoft.Search/searchServices

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

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

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

Поле или свойство службы хранилища Azure	Свойство журналов Azure Monitor	Description
Время	TIMESTAMP	Дата и время (UTC) выполнения операции.
resourceId	Concat("/", "/subscriptions", SubscriptionId, "resourceGroups", ResourceGroupName, "providers/Microsoft.Search/searchServices", ServiceName)	Ресурс поиска ИИ Azure, для которого включены журналы.
Категория	"OperationLogs"	Категории журналов включают Audit, и ExecutionOperationalRequest.
operationName	Имя.	Имя операции. Имя операции может быть Indexes.ListIndexStatsSummaries, Indexes.StatsIndexers.ListQuery.SearchQuery.LookupCORS.PreflightQuery.AutocompleteIndexes.GetQuery.SuggestIndexes.PrototypeIndexes.Update, . Indexers.WarmupServiceStatsDataSources.List
durationMS	DurationMilliseconds	Время выполнения операции в миллисекундах.
operationVersion	ApiVersion	Версия API, используемая в запросе.
resultType	(Не удалось) ? "Сбой" : "Успех"	Тип ответа.
resultSignature	Состояние	Состояние ответа HTTP операции.
свойства	Свойства	Любые расширенные свойства, связанные с этой категорией событий.

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

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

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

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

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

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

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

Другие схемы

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

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

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

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

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

В следующем примере показан журнал ресурсов, включающий общие свойства (TimeGenerated, Resource, Category и т. д.) и свойства для поиска (OperationName и OperationVersion).

Имя.	Тип	Описание и пример
TimeGenerated	Datetime	Метка времени операции. Например: 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 — единственная категория, используемая для журналов ресурсов.
OperationName	Строка	Имя операции (см . полный список операций). Пример: Query.Search.
OperationVersion	Строка	Версия API, используемая в запросе. Например: 2024-07-01
ResultType	Строка	"Успех". Другие возможные значения: успех или сбой
ResultSignature	Int	Код результата HTTP. Например: 200
DurationMS	Int	Длительность операции в секундах.
Свойства	Object	Объект, содержащий данные, относящиеся к операции. См. следующую таблицу свойств схемы.

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

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

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

Значения OperationName (операции с журналом)

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

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

Связанный контент

• Ознакомьтесь с описанием мониторинга поиска ИИ Azure.
• Дополнительные сведения о мониторинге ресурсов Azure см. в статье "Мониторинг ресурсов Azure" с помощью Azure Monitor .