Azure Logic Apps'teki iş akışlarından Log Analytics veya Application Insights'a bağlanma

Şunlar için geçerlidir: Azure Logic Apps (Tüketim + Standart)

Not

Azure İzleyici Günlükleri bağlayıcısı, Azure Log Analytics bağlayıcısı ve Azure Application Insights bağlayıcısının yerini alır. Bu bağlayıcı diğer bağlayıcılarla aynı işlevselliği sağlar ve Log Analytics çalışma alanında veya Application Insights kaynağında sorgu çalıştırmak için tercih edilen yöntemdir. Örneğin, Application Insights kaynağınıza bağlandığınızda bir uygulama kimliği ve API anahtarı oluşturmanız veya sağlamanız gerekmez. Kimlik doğrulaması Microsoft Entra Id ile tümleşiktir.

Azure Logic Apps'te Log Analytics çalışma alanından veya Azure İzleyici'deki Application Insights kaynağından veri alan iş akışları oluşturmak için Azure İzleyici Günlükleri bağlayıcısını kullanabilirsiniz.

Örneğin, Office 365 Outlook hesabınızdan bir e-posta iletisinde Azure İzleyici günlük verilerini gönderen bir mantıksal uygulama iş akışı oluşturabilir, Azure DevOps'ta bir hata oluşturabilir veya Slack iletisi gönderebilirsiniz. Bu bağlayıcı yalnızca eylemler sağlar, bu nedenle bir iş akışı başlatmak için basit bir zamanlama veya başka bir hizmetten herhangi bir tetikleyici belirtmek için Yinelenme tetikleyicisi kullanabilirsiniz.

Bu kılavuzda, Azure İzleyici günlük sorgusunun sonuçlarını e-postayla gönderen bir mantıksal uygulama iş akışının nasıl derleneceği açıklanır.

Bağlayıcı teknik referans

Bu bağlayıcının işlemleri hakkında teknik bilgi için bağlayıcının başvuru belgelerine bakın.

Aşağıdaki eylemlerin her ikisi de Log Analytics çalışma alanında veya Application Insights kaynağında bir günlük sorgusu çalıştırabilir. Verilerin geri döndürülme biçiminde bir fark vardır.

Eylem	Açıklama
Sorgu ve liste sonuçlarını çalıştırma	Her satır, bir nesne olarak döndürülür. İş akışının geri kalanında her satırla ayrı ayrı çalışmak istediğinizde bu eylemi kullanın. Eylemin ardından genellikle bir Her eylem için ifadesi gelir.
Sorgu çalıştırma ve sonuçları görselleştirme	Sorgu sonuç kümesini gösteren bir JPG dosyası döndürür. Bu eylem, sonuçları e-postayla göndererek iş akışının geri kalanında sonuç kümesini kullanmanıza olanak tanır. Eylem yalnızca sorgu sonuçları döndürüyorsa bir JPG dosyası döndürür.

Sınırlamalar

• Günlükler sayfasındaki ve bağlayıcıdaki görselleştirmeler farklı grafik kitaplıkları kullanır. Bu nedenle bağlayıcı şu anda bazı işlevler içermiyor.

• Temel ve Yardımcı planlardaki sorgu verileri Azure İzleyici Günlükleri bağlayıcısı tarafından desteklenmez.

• Bağlayıcı aşağıdaki sorgu sınırlarına sahiptir. Sınırlardan kaçınmak için, sonuçların sayısını veya hacmini azaltmak için verileri toplamayı veya iş akışı yinelemesini daha küçük bir zaman aralığında daha sık çalışacak şekilde ayarlamayı deneyin.

  Sınır	Değer	Notlar
  Maksimum sorgu yanıt boyutu	Yaklaşık 16,7 MB veya 16 MiB	Bağlayıcı altyapısı, boyut sınırının sorgu API'sinin sınırından daha düşük olarak ayarlandığını belirler.
  En fazla kayıt sayısı	500.000 kayıt
  Maksimum bağlantı zaman aşımı	110 saniye
  Maksimum sorgu zaman aşımı	100 saniye

Önkoşullar

• Bir Azure hesabı ve aboneliği Azure aboneliğiniz yoksa ücretsiz bir Azure hesabı için kaydolun.

• Bağlanmak istediğiniz Log Analytics çalışma alanı veya Application Insights kaynağı.

• Log Analytics çalışma alanınıza veya Application Insights kaynağınıza erişmek istediğiniz Standart veya Tüketim mantıksal uygulaması iş akışı. Azure İzleyici Günlükleri eylemini kullanmak için herhangi bir tetikleyiciyle iş akışınızı başlatın. Bu kılavuzda Yinelenme tetikleyicisi kullanılır.

• Bu kılavuzdaki örneği tamamlamak için bir Office 365 Outlook hesabı. Aksi takdirde, Azure Logic Apps'te kullanılabilir bağlayıcısı olan herhangi bir e-posta sağlayıcısını kullanabilirsiniz.

Azure İzleyici Günlükleri eylemi ekleme

Standart

1. Azure portalında Standart mantıksal uygulamanızı ve iş akışınızı tasarımcıda açın.

2. Azure İzleyici Günlükleri eylemini eklemek istediğiniz iş akışınızda, Azure İzleyici Günlükleri eylemi eklemek için bu genel adımları izleyin.

   Bu örnek Sorguyu çalıştır ve sonuçları görselleştir adlı eylemle devam eder.

3. Bağlantı bilgileri bölmesinde aşağıdaki bilgileri sağlayın:

   Mülk	Açıklama
   Bağlantı Adı	Bağlantı için bir ad
   Kimlik Doğrulaması Türü	Bağlantı için kullanılacak kimlik doğrulama türü. Daha fazla bilgi için bkz . Giden çağrılara kimlik doğrulaması ekleme.
   Kiracı Kimliği	Microsoft Entra kiracınız. Not: Geçerli bağlantıyla ilişkili hesap daha sonra e-postayı göndermek için kullanılır.

4. İşiniz bittiğinde, seçili kimlik doğrulama türüne göre Oturum aç'ı veya Yeni Oluştur'u seçin.

5. Sorguyu çalıştır ve sonuçları görselleştir eylem kutusunda aşağıdaki bilgileri sağlayın:

   Mülk	Zorunlu	Değer	Açıklama
   Abonelik	Evet	< Azure aboneliği>	Log Analytics çalışma alanınız veya Application Insights uygulamanız için Azure aboneliği.
   Kaynak Grubu	Evet	< Azure-resource-group>	Log Analytics çalışma alanınız veya Application Insights uygulamanız için Azure kaynak grubu.
   Kaynak Türü	Evet	Log Analytics Çalışma Alanı veya Application Insights	İş akışınızdan bağlanacak kaynak türü. Bu örnek, Log Analytics Çalışma Alanı'nın seçilmesiyle devam eder.
   Kaynak Adı	Evet	< Azure-resource-name>	Log Analytics çalışma alanınızın veya Application Insights kaynağınızın adı.

6. Sorgu kutusuna aşağıdaki Kusto sorgusunu girerek aşağıdaki kaynaklardan belirtilen günlük verilerini alın:

   Not

   Kendi sorgularınızı oluştururken, Bunları Azure İzleyici Günlükleri eyleminize eklemeden önce Log Analytics'te düzgün çalıştıklarından emin olun.

   • Log Analytics çalışma alanı

     Aşağıdaki örnek sorgu, son gün içinde oluşan hataları seçer, toplam sayılarını bildirir ve artan düzende sıralar.

     Event
     | where EventLevelName == "Error" 
     | where TimeGenerated > ago(1day)
     | summarize TotalErrors=count() by Computer
     | sort by Computer asc
     

   • Application Insights kaynağı

     Aşağıdaki örnek sorgu, son gün içinde başarısız olan istekleri seçer ve tanımlayıcıya göre operation_Id işlemin bir parçası olarak oluşan özel durumlarla ilişkilendirmektedir. Sorgu daha sonra algoritmayı kullanarak sonuçları segmentlere ayırır autocluster() .

     requests
     | where timestamp > ago(1d)
     | where success == "False"
     | project name, operation_Id
     | join ( exceptions
         | project problemId, outerMessage, operation_Id
     ) on operation_Id
     | evaluate autocluster()
     

7. Zaman Aralığı için Sorguda ayarla'yı seçin.

   Aşağıdaki tabloda Zaman Aralığı seçenekleri açıklanmaktadır:

   Zaman Aralığı	Açıklama
   Kesin	Başlangıç saatini ve bitiş saatini dinamik olarak sağlayın.
   Akraba	Son saat, son 12 saat gibi göreli değerleri ayarlayın.
   Sorguya ekle	TimeGenerated filtresi sorguya eklendiğinde uygulanır.

8. Grafik Türü için Html Tablosu'nu seçin.

9. İş akışınızı kaydedin. Tasarımcı araç çubuğunda Kaydet'i seçin.

Tüketim

1. Azure portalında Tüketim mantığı uygulamanızı ve iş akışınızı tasarımcıda açın.

2. Azure İzleyici Günlükleri eylemini eklemek istediğiniz iş akışınızda, Azure İzleyici Günlükleri eylemi eklemek için bu genel adımları izleyin.

   Bu örnek Sorguyu çalıştır ve sonuçları görselleştir adlı eylemle devam eder.

3. Bağlantı bilgileri bölmesinde aşağıdaki bilgileri sağlayın:

   Mülk	Açıklama
   Bağlantı Adı	Bağlantı için bir ad
   Kimlik Doğrulaması Türü	Bağlantı için kullanılacak kimlik doğrulama türü. Daha fazla bilgi için bkz . Giden çağrılara kimlik doğrulaması ekleme.
   Kiracı Kimliği	Microsoft Entra kiracınız. Not: Geçerli bağlantıyla ilişkili hesap daha sonra e-postayı göndermek için kullanılır. Farklı bir hesap kullanmak için Azure İzleyici Günlükleri eylemi göründükten sonra Bağlantıyı değiştir'i seçin.

4. İşiniz bittiğinde, seçili kimlik doğrulama türüne göre Oturum aç veya Oluştur'u seçin.

5. Sorguyu çalıştır ve sonuçları görselleştir eylem kutusunda aşağıdaki bilgileri sağlayın:

   Mülk	Zorunlu	Değer	Açıklama
   Abonelik	Evet	< Azure aboneliği>	Log Analytics çalışma alanınız veya Application Insights uygulamanız için Azure aboneliği.
   Kaynak Grubu	Evet	< Azure-resource-group>	Log Analytics çalışma alanınız veya Application Insights uygulamanız için Azure kaynak grubu.
   Kaynak Türü	Evet	Log Analytics Çalışma Alanı veya Application Insights	İş akışınızdan bağlanacak kaynak türü. Bu örnek, Log Analytics Çalışma Alanı'nın seçilmesiyle devam eder.
   Kaynak Adı	Evet	< Azure-resource-name>	Log Analytics çalışma alanınızın veya Application Insights kaynağınızın adı.

6. Sorgu kutusuna aşağıdaki Kusto sorgusunu girerek aşağıdaki kaynaklardan belirtilen günlük verilerini alın:

   Not

   Kendi sorgularınızı oluştururken, Bunları Azure İzleyici Günlükleri eyleminize eklemeden önce Log Analytics'te düzgün çalıştıklarından emin olun.

   • Log Analytics çalışma alanı

     Aşağıdaki örnek sorgu, son gün içinde oluşan hataları seçer, toplam sayılarını bildirir ve artan düzende sıralar.

     Event
     | where EventLevelName == "Error" 
     | where TimeGenerated > ago(1day)
     | summarize TotalErrors=count() by Computer
     | sort by Computer asc
     

   • Application Insights kaynağı

     Aşağıdaki örnek sorgu, son gün içinde başarısız olan istekleri seçer ve tanımlayıcıya göre operation_Id işlemin bir parçası olarak oluşan özel durumlarla ilişkilendirmektedir. Sorgu daha sonra algoritmayı kullanarak sonuçları segmentlere ayırır autocluster() .

     requests
     | where timestamp > ago(1d)
     | where success == "False"
     | project name, operation_Id
     | join ( exceptions
         | project problemId, outerMessage, operation_Id
     ) on operation_Id
     | evaluate autocluster()
     

7. Zaman Aralığı için Sorguda ayarla'yı seçin.

   Aşağıdaki tabloda Zaman Aralığı seçenekleri açıklanmaktadır:

   Zaman Aralığı	Açıklama
   Kesin	Başlangıç saatini ve bitiş saatini dinamik olarak sağlayın.
   Akraba	Son saat, son 12 saat gibi göreli değerleri ayarlayın.
   Sorguya ekle	TimeGenerated filtresi sorguya eklendiğinde uygulanır.

8. Grafik Türü için Html Tablosu'nu seçin.

9. İş akışınızı kaydedin. Tasarımcı araç çubuğunda Kaydet'i seçin.

E-posta eylemi ekleme

Standart

1. Office 365 Outlook eylemini eklemek istediğiniz iş akışınızda, e-posta gönder (V2) adlı Office 365 Outlook eylemini eklemek için bu genel adımları izleyin

2. Alıcı kutusuna alıcının e-posta adresini girin. Bu örnek için kendi e-posta adresinizi kullanın.

3. Konu kutusuna e-posta için en önemli günlük hatalar veya hatalar gibi bir konu girin.

4. Gövde kutusunun içini seçin ve ardından dinamik içerik seçeneğini (şimşek simgesi) seçerek iş akışındaki önceki adımlardan çıkışları seçebilirsiniz.

5. Dinamik içerik listesinde, Sorguyu çalıştır ve sonuçları görselleştir'in altında, Daha önce Log Analytics eylemine girdiğiniz sorgunun sonuçlarını temsil eden Gövde'yi seçin.

6. Gelişmiş parametreler listesinden Ekler'i seçin.

   E-posta gönder eylemi artık Ek adı ve Ek içerik özelliklerine sahip Ekler bölümünü içerir.

7. Eklenen özellikler için şu adımları izleyin:

   1. Ek adı kutusunda dinamik içerik listesini açın. Sorguyu çalıştır ve sonuçları görselleştir altında, Ek Adı'nı seçin.

   2. Ek içeriği kutusunda dinamik içerik listesini açın. Sorguyu çalıştır ve sonuçları görselleştir'in altında Ek İçeriği'ne tıklayın.

8. İş akışınızı kaydedin. Tasarımcı araç çubuğunda Kaydet'i seçin.

Tüketim

1. Office 365 Outlook eylemini eklemek istediğiniz iş akışınızda, e-posta gönder (V2) adlı Office 365 Outlook eylemini eklemek için bu genel adımları izleyin

2. Alıcı kutusuna alıcının e-posta adresini girin. Bu örnek için kendi e-posta adresinizi kullanın.

3. Konu kutusuna e-posta için en önemli günlük hatalar veya hatalar gibi bir konu girin.

4. Gövde kutusuna tıklayarak iş akışının önceki adımlarından gelen çıkışları gösteren Dinamik içerik listesini açın.

   1. Dinamik içerik listesinde, Sorguyu çalıştır ve sonuçları görselleştir bölümü adının yanındaki Daha fazla bilgi'yi seçin.

   2. Çıkışlar listesinden, Log Analytics eylemine daha önce girdiğiniz sorgunun sonuçlarını temsil eden Gövde'yi seçin.

5. Yeni parametre ekle listesinde Ekler'i seçin.

   E-posta gönder eylemi artık Ekler Adı ve Ekler İçerik özelliklerini içerir.

6. Eklenen özellikler için şu adımları izleyin:

   1. Ek Adı kutusunun içini seçin ve ardından şimşek simgesini seçerek dinamik içerik listesini açın. Sorguyu çalıştır ve sonuçları görselleştir altında, Ek Adı'nı seçin.

   2. Ek İçeriği kutusunun içini seçin ve ardından dinamik içerik listesini açmak için şimşek simgesini seçin. Sorguyu çalıştır ve sonuçları görselleştir'in altında Ek İçeriği'ne tıklayın.

7. İş akışınızı kaydedin. Tasarımcı araç çubuğunda Kaydet'i seçin.

İş akışınızı test etme

Standart

1. İş akışı tasarımcısı araç çubuğunda Çalıştır'ı> seçin.

2. İş akışı tamamlandığında e-postanızı denetleyin.

   Not

   İş akışı, sorgu sonuç kümesini gösteren bir JPG dosyası içeren bir e-posta oluşturur. Sorgunuz herhangi bir sonuç döndürmezse iş akışı jpg dosyası oluşturmaz.

   Log Analytics çalışma alanı örneği için, aldığınız e-posta aşağıdaki örneğe benzer bir gövdeye sahiptir:

   

   Application Insights kaynağı için, aldığınız e-posta aşağıdaki örneğe benzer bir gövdeye sahiptir:

   

Tüketim

1. İş akışı tasarımcısı araç çubuğunda Çalıştır'ı> seçin.

2. İş akışı tamamlandığında e-postanızı denetleyin.

   Not

   İş akışı, sorgu sonuç kümesini gösteren bir JPG dosyası içeren bir e-posta oluşturur. Sorgunuz herhangi bir sonuç döndürmezse iş akışı jpg dosyası oluşturmaz.

   Log Analytics çalışma alanı örneği için, aldığınız e-posta aşağıdaki örneğe benzer bir gövdeye sahiptir:

   

   Application Insights kaynağı için, aldığınız e-posta aşağıdaki örneğe benzer bir gövdeye sahiptir:

   

İlgili içerik

• Azure İzleyici'de sorgu günlükleri
• Log Analytics sorguları