Azure AI Search'te dizin oluşturucu durumunu ve sonuçlarını izleme

Dizin oluşturucu işlemesini Azure portalında izleyebilir veya REST çağrıları veya Azure SDK aracılığıyla program aracılığıyla izleyebilirsiniz. Dizin oluşturucunun durumuyla ilgili duruma ek olarak, başlangıç ve bitiş saatlerini ve belirli bir çalıştırmadaki ayrıntılı hataları ve uyarıları gözden geçirebilirsiniz.

Azure portalını kullanarak izleme

Arama hizmeti genel bakış sayfanızda tüm dizin oluşturucularınızın geçerli durumunu görebilirsiniz. Portal sayfaları birkaç dakikada bir yenilenir, böylece yeni bir dizin oluşturucunun hemen çalıştığını gösteren bir kanıt görmezsiniz. En son görünümü hemen almak için sayfanın üst kısmındaki Yenile'yi seçin.

Dizin oluşturucunun geçerli ve son çalıştırmaları hakkında daha fazla ayrıntı görmek için listedeki bir dizin oluşturucuyu seçebilirsiniz.

Dizin Oluşturucu özet grafiği, en son çalıştırmalarında işlenen belge sayısının grafiğini görüntüler.

Yürütme ayrıntıları listesi en son yürütme sonuçlarından en fazla 50'sini gösterir. Bu çalıştırmayla ilgili ayrıntıları görmek için listeden bir yürütme sonucu seçin. Bu, başlangıç ve bitiş saatlerini ve oluşan hataları ve uyarıları içerir.

Çalıştırma sırasında belgeye özgü sorunlar varsa, bunlar Hatalar ve Uyarılar alanlarında listelenir.

Uyarılar bazı dizin oluşturucu türlerinde yaygındır ve her zaman bir sorun göstermez. Örneğin Azure AI hizmetlerini kullanan dizin oluşturucular, görüntü veya PDF dosyaları işlenmek üzere herhangi bir metin içermediğinde uyarı bildirebilir.

Dizin oluşturucu hatalarını ve uyarılarını araştırma hakkında daha fazla bilgi için bkz . Dizin oluşturucu sorun giderme kılavuzu.

Azure İzleme Ölçümleriyle İzleme

Azure AI Search, Azure İzleyici'de izlenen bir kaynaktır. Bu, dizin oluşturucu tarafından işlenen belge sayısı ve beceri çağrıları hakkındaki temel ölçümleri görmek için Ölçüm Gezgini'ni kullanabileceğiniz anlamına gelir. Bu ölçümler dizin oluşturucu ilerleme durumunu izlemek ve uyarıları ayarlamak için kullanılabilir.

Ölçüm görünümleri önceden tanımlanmış bir boyut kümesine göre filtrelenebilir veya bölünebilir.

Aşağıdaki ekran görüntüsünde dizin oluşturucuların bir saat içinde dizin oluşturucu adına göre ayrılmış olarak işlediği belge sayısı gösterilmektedir.

Grafiği, aynı saat aralığındaki beceri çağrılarının sayısını görmek için de yapılandırabilirsiniz.

Dizin Oluşturucu Durumunu Al (REST API) kullanarak izleme

Dizin Oluşturucu Durumunu Al komutunu kullanarak dizin oluşturucunun durumunu ve yürütme geçmişini alabilirsiniz:

GET https://[service name].search.windows.net/indexers/[indexer name]/status?api-version=2020-06-30
api-key: [Search service admin key]

Yanıt genel dizin oluşturucu durumunu, son (veya devam eden) dizin oluşturucu çağrısını ve son dizin oluşturucu çağrılarının geçmişini içerir.

{
    "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
    }]
}

Yürütme geçmişi, en son 50 çalıştırmayı içerir ve bunlar ters kronolojik düzende sıralanır (en son önce).

İki farklı durum değeri olduğuna dikkat edin. En üst düzey durum, dizin oluşturucunun kendisi içindir. Çalışan bir dizin oluşturucu durumu, dizin oluşturucunun doğru ayarlandığı ve çalıştırılmaya uygun olduğu, ancak şu anda çalışmadığı anlamına gelir.

Dizin oluşturucunun her çalıştırması, belirli bir yürütmenin devam ettiğini (çalıştığını) veya başarı, geçici Hata veya persistentFailure durumuyla zaten tamamlandığını gösteren kendi durumuna sahiptir.

Dizin oluşturucu değişiklik izleme durumunu yenilemek için sıfırlandığında, Sıfırlama durumuyla ayrı bir yürütme geçmişi girişi eklenir.

Durum kodları ve dizin oluşturucu izleme verileri hakkında daha fazla bilgi için bkz . Dizin Oluşturucu Durumunu Alma.

.NET kullanarak izleme

Aşağıdaki C# örneği, bir dizin oluşturucunun durumu ve en son (veya devam eden) çalıştırmasının sonuçları hakkındaki bilgileri konsola yazar.

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
    }
}

Konsoldaki çıkış şuna benzer olacaktır:

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

İki farklı durum değeri olduğuna dikkat edin. En üst düzey durum, dizin oluşturucunun kendisinin durumudur. Çalışıyor dizin oluşturucu durumu, dizin oluşturucunun doğru ayarlandığı ve yürütülmeye uygun olduğu, ancak şu anda yürütülmekte olmadığı anlamına gelir.

Dizin oluşturucunun her çalıştırması, belirli bir yürütmenin devam edip etmediği (Çalışıyor) veya Başarı veya TransientError durumuyla zaten tamamlanıp tamamlanmadığı konusunda da kendi durumuna sahiptir.

Dizin oluşturucu değişiklik izleme durumunu yenilemek için sıfırlandığında, Sıfırla durumuyla ayrı bir geçmiş girdisi eklenir.

Sonraki adımlar

Durum kodları ve dizin oluşturucu izleme bilgileri hakkında daha fazla bilgi için aşağıdaki API başvurusuna bakın:

• GetIndexerStatus (REST API)
• IndexerStatus
• IndexerExecutionStatus
• IndexerExecutionResult