Мониторинг состояния индексатора и результатов поиска ИИ Azure

Вы можете отслеживать процесс обработки индексатором на портале Azure или программно через вызовы REST или пакет SDK для Azure. Помимо состояния самого индексатора можно проверить время начала и окончания работы. Кроме того, можно ознакомиться с подробными сведениями об ошибках и предупреждениях определенного запуска.

Мониторинг с помощью портала Azure

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

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

Чтобы просмотреть подробные журналы для определенного запуска, выберите значение состояния выполнения (например, сбой), а затем нажмите кнопку "Скачать как CSV".

На диаграмме Сводка индексатора отображается диаграмма количества документов, обработанных в последних запусках.

В списке Подробности о выполнении отображается до 50 самых последних результатов выполнения. Выберите результат выполнения в списке, чтобы просмотреть особенности этого запуска. Здесь можно увидеть время начала и окончания, а также все возникшие ошибки и предупреждения.

Если во время выполнения возникли проблемы, связанные с документом, они перечислены в полях "Ошибки и предупреждения".

Предупреждения распространены в некоторых типах индексаторов и не всегда указывают на проблему. Например, индексаторы, использующие средства Foundry, могут сообщать предупреждения, когда файлы изображений или PDF-файлов не содержат текст для обработки.

Дополнительные сведения для изучении ошибок и предупреждений индексатора см. в статье Руководство по устранению проблем с индексатором.

Мониторинг с помощью метрик мониторинга Azure

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

Представления метрик можно отфильтровать или разделить по набору предопределенных измерений. Чтобы узнать о размерах, связанных с метриками количество обработанных документов и количество вызовов выполнения навыка, см. Размеры метрик.

На следующем снимка экрана показано количество документов, обработанных индексаторами в службе в течение часа, разделенных по имени индексатора.

Вы также можете настроить граф, чтобы просмотреть количество вызовов навыка в течение одного часа.

Мониторинг с помощью получения состояния индексатора (REST API)

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

GET https://[service name].search.windows.net/indexers/[indexer name]/status?api-version=2025-09-01
api-key: [Search service admin key]

Ответ содержит сведения об общем состоянии индексатора, последнем (или текущем) вызове индексатора, а также журнал последних вызовов индексатора.

{
    "status":"running",
    "lastResult": {
        "status":"success",
        "errorMessage":null,
        "startTime":"2018-11-26T03:37:18.853Z",
        "endTime":"2018-11-26T03:37:19.012Z",
        "errors":[],
        "itemsProcessed":11,
        "itemsFailed":0,
        "initialTrackingState":null,
        "finalTrackingState":null
     },
    "executionHistory":[ {
        "status":"success",
         "errorMessage":null,
        "startTime":"2018-11-26T03:37:18.853Z",
        "endTime":"2018-11-26T03:37:19.012Z",
        "errors":[],
        "itemsProcessed":11,
        "itemsFailed":0,
        "initialTrackingState":null,
        "finalTrackingState":null
    }]
}

Журнал выполнения содержит до 50 последних выполнений, которые сортируются в обратном хронологическом порядке (начиная с самых новых).

Обратите внимание, что существует два разных значения состояния. Состояние самого индексатора находится на высшем уровне. Состояние индексатора running означает, что индексатор настроен правильно и доступен для выполнения, но не активен в данный момент.

Каждое выполнение индексатора также имеет собственное состояние, которое указывает, запущено ли это конкретное выполнение (running) или уже завершено с состоянием success, transientFailure или persistentFailure.

Когда индексатор сбрасывается для обновления своего состояния отслеживания изменений, то добавляется отдельная запись журнала выполнения с состоянием Reset.

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

Мониторинг с помощью .NET

В следующем примере C# записывается информация о состоянии индексатора и результатах последнего запуска (или текущего) в консоль.

static void CheckIndexerStatus(SearchIndexerClient indexerClient, SearchIndexer indexer)
{
    try
    {
        string indexerName = "hotels-sql-idxr";
        SearchIndexerStatus execInfo = indexerClient.GetIndexerStatus(indexerName);

        Console.WriteLine("Indexer has run {0} times.", execInfo.ExecutionHistory.Count);
        Console.WriteLine("Indexer Status: " + execInfo.Status.ToString());

        IndexerExecutionResult result = execInfo.LastResult;

        Console.WriteLine("Latest run");
        Console.WriteLine("Run Status: {0}", result.Status.ToString());
        Console.WriteLine("Total Documents: {0}, Failed: {1}", result.ItemCount, result.FailedItemCount);

        TimeSpan elapsed = result.EndTime.Value - result.StartTime.Value;
        Console.WriteLine("StartTime: {0:T}, EndTime: {1:T}, Elapsed: {2:t}", result.StartTime.Value, result.EndTime.Value, elapsed);

        string errorMsg = (result.ErrorMessage == null) ? "none" : result.ErrorMessage;
        Console.WriteLine("ErrorMessage: {0}", errorMsg);
        Console.WriteLine(" Document Errors: {0}, Warnings: {1}\n", result.Errors.Count, result.Warnings.Count);
    }
    catch (Exception e)
    {
        // Handle exception
    }
}

Выходные данные в консоли выглядят примерно так:

Indexer has run 18 times.
Indexer Status: Running
Latest run
  Run Status: Success
  Total Documents: 7, Failed: 0
  StartTime: 11:29:31 PM, EndTime: 11:29:31 PM, Elapsed: 00:00:00.2560000
  ErrorMessage: none
  Document Errors: 0, Warnings: 0

Обратите внимание, что существует два разных значения состояния. Статус верхнего уровня - это состояние самого индексатора. Состояние индексатора выполнения означает, что индексатор настроен правильно и доступен для выполнения, но не выполняется в данный момент.

Каждое выполнение индексатора также имеет собственное состояние, определяющее, запущено ли это конкретное выполнение (Running) или уже завершено с состоянием Success или TransientError.

Когда индексатор перезагружается для обновления состояния отслеживания изменений, добавляется отдельная запись в журнал с состоянием Reset.

Дальнейшие шаги

Дополнительные сведения о кодах состояния и сведениях о мониторинге индексатора см. в следующем справочнике по API:

• Индексаторы — получение статуса (REST API)
• IndexerStatus
• IndexerExecutionStatus
• IndexerExecutionResult