Azure AI 검색에서 인덱서 상태 및 결과 모니터링

아티클
09/03/2024

Azure Portal에서 또는 REST 호출 또는 Azure SDK를 통해 프로그래밍 방식으로 인덱서 처리를 모니터링할 수 있습니다. 인덱서 자체에 대한 상태 외에도 특정 실행의 시작 및 종료 시간, 자세한 오류 및 경고를 검토할 수 있습니다.

Azure Portal을 사용한 모니터링

검색 서비스 개요 페이지에서 모든 인덱서의 현재 상태를 볼 수 있습니다. 포털 페이지는 몇 분 마다 새로 고침되어 새 인덱서 실행에 대한 증거가 바로 표시되지 않습니다. 페이지 맨 위에서 새로 고침을 선택하여 가장 최근 보기를 즉시 검색합니다.

Status	설명
진행 중	활성 실행을 나타냅니다. 포털에서 부분적인 정보를 보고합니다. 인덱싱이 진행됨에 따라 응답으로 문서 성공 값이 증가하는 것을 볼 수 있습니다. 대량의 데이터를 처리하는 인덱서는 실행하는 데 시간이 오래 걸릴 수 있습니다. 예를 들어 수백만 개의 원본 문서를 처리하는 인덱서는 24시간 동안 실행된 다음, 거의 즉시 다시 시작하여 중단된 부분부터 다시 시작할 수 있습니다. 따라서 대용량 인덱서의 상태는 포털에서 항상 진행 중이라고 표시될 수 있습니다. 인덱서를 실행하는 경우에도 진행 중인 진행률과 이전 실행에 대한 세부 정보를 확인할 수 있습니다.
성공	실행이 성공했음을 나타냅니다. 오류 수가 인덱서의 최대 실패 항목 설정보다 적으면 개별 문서에 오류가 있어도 인덱서 실행이 성공할 수 있습니다.
실패함	오류 수가 최대 실패 항목을 초과하여 인덱싱이 중지되었습니다.
재설정	인덱서의 내부 변경 내용 추적 상태가 다시 설정되었습니다. 인덱서는 전체적으로 실행되어 최신 타임스탬프가 있는 문서만이 아니라 모든 문서를 새로 고칩니다.

목록에서 인덱서를 선택하면 인덱서의 현재 실행 및 최근 실행에 대한 자세한 정보를 볼 수 있습니다.

인덱서 요약 차트는 가장 최근 실행에서 처리된 문서 수의 그래프를 표시합니다.

실행 정보 목록에는 가장 최근 실행 결과가 최대 50개까지 표시됩니다. 해당 실행에 대한 관련 사항을 확인하려면 목록에서 실행 결과를 선택합니다. 여기에는 시작 시간 및 종료 시간, 발생한 오류 및 경고가 포함됩니다.

실행 중에 문서 관련 문제가 발생하는 경우 오류 및 경고 필드에 나열됩니다.

경고는 일부 인덱서 유형에서 일반적이며, 항상 문제를 나타내는 것은 아닙니다. 예를 들어 Azure AI 서비스를 사용하는 인덱서는 이미지 또는 PDF 파일에 처리할 텍스트가 포함되지 않은 경우 경고를 보고할 수 있습니다.

인덱서 오류 및 경고를 조사하는 방법에 대한 자세한 내용은 인덱서 문제 해결 가이드를 참조하세요.

Azure 모니터링 메트릭을 사용하여 모니터링

Azure AI 검색은 Azure Monitor에서 모니터링되는 리소스입니다. 즉 메트릭 탐색기를 사용하여 인덱서 처리 문서 수 및 기술 호출 수에 대한 기본 메트릭을 볼 수 있습니다. 이러한 메트릭을 사용하여 인덱서 진행률을 모니터링하고 경고를 설정할 수 있습니다.

메트릭 뷰는 미리 정의된 차원 세트로 필터링하거나 분할할 수 있습니다. 메트릭 문서 처리 횟수 및 기술 실행 호출 횟수와 관련된 차원에 대해 알아보려면 메트릭 차원을 참조하세요.

다음 스크린샷은 인덱서 이름으로 분할된 1시간 동안 서비스 내에서 인덱서가 처리한 문서 수를 보여 줍니다.

그래프를 구성하여 동일한 시간 간격 동안 기술 호출 수를 확인할 수도 있습니다.

인덱서 상태 가져오기를 사용하여 모니터링(REST API)

인덱서 상태 가져오기 명령을 사용하여 인덱서의 상태 및 실행 기록을 검색할 수 있습니다.

GET https://[service name].search.windows.net/indexers/[indexer name]/status?api-version=2024-07-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개의 최근 실행이 포함되며, 역순(가장 최근 항목 먼저)으로 정렬됩니다.

두 가지 상태 값이 있습니다. 최상위 수준 상태는 인덱서 자체에 대한 것입니다. 실행 중 인덱서 상태는 인덱서가 올바르게 설정되어 실행 가능하다는 의미이지만 현재 실행 중이라는 의미는 아닙니다.

인덱서의 각 실행에는 특정 실행이 진행 중(실행 중)인지 또는 이미 성공, transientFailure 또는 persistentFailure 상태로 완료되었는지 여부를 나타내는 자체 상태도 있습니다.

인덱서가 변경 내용 추적 상태를 새로 고치도록 다시 설정되면 다시 설정 상태로 별도의 실행 기록 항목이 추가됩니다.

상태 코드 및 인덱서 모니터링 데이터에 대한 자세한 내용은 인덱서 상태 가져오기를 참조하세요.

.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

두 가지 상태 값이 있습니다. 최상위 상태는 인덱서 자체의 상태입니다. 실행 중 인덱서 상태는 인덱서가 올바르게 설정되어 실행 가능하다는 의미이지만 현재 실행 중이라는 의미는 아닙니다.

인덱서의 각 실행에는 특정 실행이 진행 중(실행 중)인지 또는 이미 성공 또는 TransientError 상태로 완료되었는지에 대한 자체 상태도 있습니다.

인덱서가 변경 내용 추적 상태를 새로 고치도록 다시 설정되면 다시 설정 상태로 별도의 기록 항목이 추가됩니다.

다음 단계

상태 코드 및 인덱서 모니터링 정보에 대한 자세한 내용은 다음 API 참조를 참조하세요.

다음을 통해 공유