Azure Yapay Zeka Arama'te dizin oluşturucu durumunu ve sonuçlarını izleme

Not

Azure Yapay Zeka Arama Azure portalı, REST API'leri ve Azure SDK’ları aracılığıyla kullanılabilir. Ayrıca kuruluş içeriğini Microsoft Foundry portalındaki aracılar için yeniden kullanılabilir, izin kullanan bilgi bankalarına dönüştüren yönetilen bilgi katmanı Foundry IQ'yu temel alır.

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 portalı sayfanızda tüm dizin oluşturucularınızın geçerli durumunu görebilirsiniz. Azure portal sayfaları birkaç dakikada bir yenilendiğinden, hemen çalıştırılacak yeni bir dizin oluşturucu 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şturucular listesi

Statü Açıklama
Devam Ediyor Etkin yürütmeyi gösterir. Azure portalı kısmi bilgileri raporlar. Yanıt olarak, dizin oluşturma ilerledikçe Docs Başarılı değerinin büyümesini izleyebilirsiniz. Büyük hacimli verileri işleyen dizin oluşturucuların çalışması uzun sürebilir. Örneğin, milyonlarca kaynak belgeyi işleyen dizin oluşturucular 24 saat boyunca çalışabilir ve kaldığı yerden devam etmek için hemen yeniden başlatılabilir. Bu nedenle, yüksek hacimli dizin oluşturucuların durumu her zaman Azure portalında İlerliyor diyebilir. Dizin oluşturucu çalışırken bile devam eden ilerleme ve önceki çalıştırmalarla ilgili ayrıntılar sağlanır.
Başarı Çalıştırmanın başarılı olduğunu gösterir. Tek tek belgelerde hata olsa bile, hata sayısı dizin oluşturucunun En fazla başarısız öğe ayarından küçükse dizin oluşturucu çalıştırması başarılı olabilir.
Başarısız oldu Hata sayısı En fazla başarısız öğe sayısını aştı ve dizin oluşturma durduruldu.
Sıfırla Dizin oluşturucunun iç değişiklik izleme durumu sıfırlandı. Dizin oluşturucu, yalnızca daha yeni zaman damgaları olan belgeleri değil tüm belgeleri yenileyerek tam olarak çalışır.

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

Belirli bir çalıştırmanın ayrıntılı günlüklerini görmek için çalıştırmanın Durum değerini (örneğin, Başarısız) ve ardından "CSV olarak indir" seçeneğini belirleyin.

Dizin oluşturucu özeti ve yürütme geçmişi

Dizinleyici özet grafiği, en son çalıştırmalarında işlenen belge sayısının grafiğini gösterir.

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.

Dizinleyici çalıştırma ayrıntıları

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

Hatalı dizin oluşturucu ayrıntıları

Uyarılar bazı dizin oluşturucu türlerinde yaygındır ve her zaman bir sorun göstermez. Örneğin, Döküm Araçları'nı kullanan dizin oluşturucular, görüntü veya PDF dosyaları işlenmek üzere herhangi bir metin içermediğinde uyarıları 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 Yapay Zeka Arama, 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. Belge işlenen sayısı ve Beceri yürütme çağırma sayısı ölçümleriyle ilişkili boyutlar hakkında bilgi edinmek için bkz. Ölçüm boyutları.

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.

İndeksleyici belgeleri işlenen metrik

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 becerileri çağrılan ölçüm

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=2026-04-01
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ışıyor olarak gösterilen bir dizin oluşturucu durumu, dizin oluşturucunun doğru şekilde ayarlandığını ve çalıştırılabilir durumda olduğunu, ancak şu anda çalışmadığını ifade eder.

Dizin oluşturucunun her çalıştırmasının, belirli bir yürütmenin devam ettiğini (çalışıyor) veya başarıyla, geçici bir hatayla ya da kalıcı bir hatayla zaten tamamlandığını gösteren kendi durumu vardır.

Dizin oluşturucu, değişiklik izleme durumunu yenilemek için sıfırlandığında, ayrı bir Sıfırlama durumu ile çalıştırma 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:

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. Dizin oluşturucu durumu 'Çalışıyor' ise, dizin oluşturucunun doğru bir şekilde ayarlandığı ve çalıştırılmaya uygun olduğu, ancak şu anda çalışmadığı anlamına gelir.

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

Dizinleyici, değişiklik izleme durumunu yenilemek amacıyla 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:

  • Last updated on