Kaynak günlüklerini kullanarak Azure Stream Analytics sorunlarını giderme

Bazen, Azure Stream Analytics işi çalışmayı beklenmedik bir şekilde durdurur. Bu tür bir olayın sorunlarını giderebilmek önemlidir. Hatalara beklenmedik bir sorgu sonucu, cihazların bağlantısı veya beklemedik bir hizmet kesintisi neden olmuş olabilir. Stream Analytics kaynak günlükleri, oluşabilecek sorunları belirlemenize ve kurtarma süresini azaltmanıza yardımcı olabilir.

Bu, hata ayıklama ve izleme konusunda önemli ölçüde yardımcı olacağı için tüm işler için kaynak günlüklerinin etkinleştirilmesi önemle önerilir.

Günlük türleri

Stream Analytics iki tür günlük sunar:

• İşler üzerinde gerçekleştirilen işlemlere Öngörüler veren etkinlik günlükleri (Always on).

• İş ile gerçekleşen her şeye daha zengin Öngörüler sağlayan kaynak günlükleri (yapılandırılabilir). Kaynak günlükleri iş oluşturulduğunda başlar ve iş silindiğinde biter. Bunlar iş güncelleştirilirken ve çalışırken olayları kapsar.

Etkinlik günlüklerini kullanarak hata ayıklama

Etkinlik günlükleri varsayılan olarak açık ve Stream Analytics işiniz tarafından gerçekleştirilen işlemlere yüksek düzeyde öngörüler sağlar. Etkinlik günlüklerinde bulunan bilgiler, işinizi etkileyen sorunların temel nedenini bulmanıza yardımcı olabilir. Stream Analytics 'de etkinlik günlüklerini kullanmak için aşağıdaki adımları uygulayın:

1. Azure portal oturum açın ve genel bakış altında etkinlik günlüğü ' nü seçin.

   

2. Gerçekleştirilmiş işlemlerin bir listesini görebilirsiniz. İşinizin başarısız olmasına neden olan herhangi bir işlemin kırmızı bir bilgi balonu vardır.

3. Özet görünümünü görmek için bir işleme tıklayın. Buradaki bilgiler genellikle sınırlıdır. İşlem hakkında daha fazla bilgi edinmek için JSON' a tıklayın.

   

4. JSON 'ın Özellikler bölümüne ilerleyin ve bu, başarısız olan işleme neden olan hatanın ayrıntılarını sağlar. Bu örnekte hata, bağlı Enlem değerlerinin dışında bir çalışma zamanı hatası nedeniyle oluştu. Bir Stream Analytics işi tarafından işlenen verilerde tutarsızlık bir veri hatasına neden olur. Farklı giriş ve çıkış verileri hataları ve neden gerçekleştiklerihakkında bilgi edinebilirsiniz.

   

5. JSON 'daki hata iletisine göre düzeltici eylemler gerçekleştirebilirsiniz. Bu örnekte, enlem değerinin ila 90 derece arasında olduğundan emin olup, sorguya 90 derece eklenmelidir.

6. Etkinlik günlüklerindeki hata iletisi, kök nedeni belirlemek için yararlı değilse, kaynak günlüklerini etkinleştirin ve Azure Izleyici günlüklerini kullanın.

Azure Izleyici günlüklerine tanılama gönder

Kaynak günlüklerini açıp Azure Izleyici günlüklerine göndermek, önemle önerilir. Varsayılan olarak kapalıdır . Bunları açmak için şu adımları izleyin:

1. Henüz bir tane yoksa Log Analytics çalışma alanı oluşturun. Log Analytics çalışma alanınızın Stream Analytics işiniz ile aynı bölgede olması önerilir.

2. Azure portal oturum açın ve Stream Analytics işinize gidin. İzleme altında tanılama günlükleri' ni seçin. Sonra tanılamayı aç ' ı seçin.

   

3. Tanılama Ayarları adında bir ad girin ve günlük altında yürütme ve yazma kutularını işaretleyin ve ölçüm bölümündeki allölçümler ' i inceleyin. Sonra Log Analytics gönder ' i seçin ve çalışma alanınızı seçin. Kaydet’e tıklayın.

   

4. Stream Analytics işiniz başlatıldığında, kaynak günlükleri Log Analytics çalışma alanınıza yönlendirilir. İşinizin kaynak günlüklerini görüntülemek için izleme bölümünün altındaki Günlükler ' i seçin.

   

5. Stream Analytics, ilgilendiğiniz günlüklere kolayca arama yapmanıza olanak tanıyan önceden tanımlanmış sorgular sağlar. Sol bölmede önceden tanımlanmış herhangi bir sorguyu seçip Çalıştır' ı seçebilirsiniz. Sorgunun sonuçlarını alt bölmede görürsünüz.

   

Kaynak günlüğü kategorileri

Azure Stream Analytics, kaynak günlüklerinin iki kategorisini yakalar:

• Yazma: iş oluşturma, giriş ve çıkışları ekleme ve silme, sorguyu ekleme ve güncelleştirme ve işi başlatma veya durdurma gibi iş yazma işlemleriyle ilgili günlük olaylarını yakalar.

• Yürütme: iş yürütme sırasında oluşan olayları yakalar.

  • Bağlantı hataları
  • Aşağıdakiler dahil olmak üzere veri işleme hataları:
    • Sorgu tanımına uymayan Olaylar (eşleşmeyen alan türleri ve değerleri, eksik alanlar vb.)
    • İfade değerlendirme hataları
  • Diğer olaylar ve hatalar

Kaynak günlükleri şeması

Tüm Günlükler JSON biçiminde depolanır. Her giriş aşağıdaki ortak dize alanlarına sahiptir:

Yürütme günlüğü özellikleri şeması

Yürütme günlükleri Stream Analytics işi yürütme sırasında gerçekleşen olaylar hakkında bilgi sahibi olabilir. Özelliklerin şeması, olayın bir veri hatası veya genel bir olay olmasına bağlı olarak değişir.

Veri hataları

İş işlenirken oluşan herhangi bir hata, bu Günlükler kategorisindedir. Bu Günlükler genellikle veri okuma, serileştirme ve yazma işlemleri sırasında oluşturulur. Bu Günlükler bağlantı hatalarını içermez. Bağlantı hataları genel olaylar olarak değerlendirilir. Çeşitli farklı giriş ve çıkış verileri hatalarınınnedeni hakkında daha fazla bilgi edinebilirsiniz.

OperationName değerine bağlı olarak, veri hataları aşağıdaki şemaya sahiptir:

• Olay okuma işlemleri sırasında serileştirme olayları oluşur. Bu nedenlerden biri, girişte bulunan veriler sorgu şemasını karşılamadığı zaman oluşur:

  • Olay (de) serileştirme sırasında tür uyuşmazlığı: hataya neden olan alanı tanımlar.

  • Bir olay okunamıyor, geçersiz seri hale getirme: Hatanın gerçekleştiği giriş verilerinde yer hakkındaki bilgileri listeler. Blob girişi, kayması ve verilerin bir örneği için blob adı içerir.

• Yazma işlemleri sırasında gönderme olayları oluşur. Hataya neden olan akış olayını belirler.

Genel olaylar

Genel olaylar diğer her şeyi kapsar.

Sonraki adımlar

• Stream Analytics veri hataları
• Stream Analytics sorgu dili başvurusu