Azure Otomasyonu tanılama günlüklerini Azure İzleyici'ye iletme

Azure Otomasyonu Log Analytics çalışma alanınıza runbook iş durumu ve iş akışları gönderebilir. Bu işlem çalışma alanı bağlamayı içermez ve tamamen bağımsızdır ve basit araştırmalar yapmanıza olanak tanır. İş günlükleri ve iş akışları Azure portalında veya tek tek işler için PowerShell ile görünür. Otomasyon hesabınızın Azure İzleyici günlükleriyle şunları yapabilirsiniz:

• Otomasyon işlerinizin durumu hakkında içgörüler edinin.
• Runbook iş durumunuz temelinde bir e-posta veya uyarı tetikleyin (örneğin, başarısız veya askıya alındı).
• İş akışlarınızda gelişmiş sorgular yazın.
• Farklı Otomasyon hesaplarındaki işleri bağıntılandırın.
• Azure panosu aracılığıyla runbook sonuçlarınızı, runbook iş durumunuzu ve diğer ilgili ana göstergeleri veya ölçümleri görselleştirmek için özelleştirilmiş görünümleri ve arama sorgularını kullanın.
• Otomasyon hesapları, runbook'lar ve diğer varlık oluşturma, değiştirme ve silme işlemleriyle ilgili denetim günlüklerini alın.

Azure İzleyici günlüklerini kullanarak, toplanan verileri hızla almak, birleştirmek ve analiz etmek için sorgularla analiz edilebileceği aynı çalışma alanında farklı kaynaklardan günlükleri birleştirebilirsiniz. Azure portalında Log Analytics'i kullanarak sorgu oluşturup test edebilir ve ardından bu araçları kullanarak verileri doğrudan analiz edebilir veya görselleştirme veya uyarı kurallarıyla kullanmak üzere sorguları kaydedebilirsiniz.

Azure İzleyici, Azure Veri Gezgini tarafından kullanılan kusto sorgu dilinin (KQL) basit günlük sorguları için uygun bir sürümünü kullanır. Ayrıca toplamalar, birleştirmeler ve akıllı analiz gibi gelişmiş işlevleri de içerir. Birden çok ders kullanarak sorgu dilini hızla öğrenebilirsiniz.

tanılama ayarlarını Azure Otomasyonu

Otomasyon tanılama ayarları desteğini kullanarak aşağıdaki platform günlüklerini ve ölçüm verilerini iletebilirsiniz:

Azure portalında tanılama ayarlarını yapılandırma

Tanılama ayarlarını Azure portalında Otomasyon hesabı kaynağının menüsünden yapılandırabilirsiniz.

1. Otomasyon hesabı menüsünde, İzleme'nin altında Tanılama ayarları'nı seçin.

   

2. Tanılama ayarı ekle'ye tıklayın.

   

3. Zaten yoksa Tanılama ayarı adına bir ayar adı girin.

   Günlüklerin ve ölçümlerin tüm kategorilerini de görüntüleyebilirsiniz.

   

   • Yönlendirilecek günlükler ve ölçümler: Günlükler için bir kategori grubu seçin veya belirtilen hedeflere göndermek istediğiniz her veri kategorisi için tek tek onay kutularını seçin. Ölçümleri Azure İzleyici günlüklerinde depolamak istiyorsanız AllMetrics'i seçin.

   • Hedef ayrıntıları : Her hedef için onay kutusunu seçin. Her kutunun seçimine göre, ek bilgi eklemenize olanak sağlayan seçenekler görüntülenir.

     

     • Log Analytics : Abonelik Kimliğini ve çalışma alanı adını girin. Çalışma alanınız yoksa devam etmeden önce bir çalışma alanı oluşturmanız gerekir.

     • Event Hubs: Aşağıdaki ölçütleri belirtin:

       • Abonelik: Olay Hub'ının aboneliğiyle aynı abonelik.
       • Olay Hub'ı ad alanı: Henüz bir olay hub'ına sahip değilseniz Olay Hub'ı oluşturun.
       • Olay Hub'ı adı (isteğe bağlı): Bir ad belirtmezseniz, her günlük kategorisi için bir olay hub'ı oluşturulur. Birden çok kategori gönderiyorsanız, oluşturulan Event Hubs sayısını sınırlamak için bir ad belirtin. Ayrıntılar için bkz . Azure Event Hubs kotaları ve sınırları .
       • Olay Hub'ı ilkesi (isteğe bağlı): İlke, akış mekanizmasının sahip olduğu izinleri tanımlar. Bkz. Event Hubs özelliği.

     • Depolama: Abonelik, depolama hesabı ve bekletme ilkesini seçin.

     • İş ortağı tümleştirmesi: Önce aboneliğinize bir iş ortağı tümleştirmesi yüklemeniz gerekir. Yapılandırma seçenekleri iş ortağına göre değişir. Daha fazla bilgi için bkz . Azure İzleyici tümleştirmesi.

4. Kaydet'e tıklayın.

Birkaç dakika sonra bu kaynak için ayarlar listenizde yeni ayar görünür ve yeni olay verileri oluşturulduktan sonra günlükler belirtilen hedeflere akışla aktarılır. Ortaya çıkan olayla Log Analytics çalışma alanındaki görünümü arasında 15 dakika zaman farkı olabilir.

Günlükleri sorgulama

Oluşturulan günlükleri sorgulamak için:

1. Otomasyon hesabınızdaki İzleme'nin altında Günlükler'i seçin.

2. Tüm Sorgular'ın altında Otomasyon İşleri'ne tıklayın.

   

3. Yürütmek istediğiniz sorgulardan birini seçin ve Çalıştır'a tıklayın.

4. Özel sorgu yürütmek için Sorgular penceresini kapatın ve özel sorgunuzu yeni sorgu penceresine yapıştırın ve Çalıştır'a tıklayın.

   Sorgunun çıktısı Sonuçlar bölmesinde görüntülenir.

5. Bu sorgu için bir Azure İzleyici uyarısı yapılandırmak için Yeni uyarı kuralı'na tıklayın.

   

Azure İzleyici günlük kayıtları

Azure Otomasyonu tanılama, Azure İzleyici günlüklerinde olarak AzureDiagnosticsetiketlenmiş aşağıdaki kayıt türlerini oluşturur. Aşağıdaki bölümlerde yer alan tablolar, Azure Otomasyonu oluşturulan kayıtların ve günlük arama sonuçlarında görünen veri türlerinin örnekleridir.

İş günlükleri

İş akışları

Denetim olayları

Azure İzleyici günlüklerinde Otomasyon günlüklerini görüntüleme

Otomasyon iş akışlarınızı ve günlüklerinizi Azure İzleyici günlüklerine göndermeye başladığınıza göre şimdi Azure İzleyici günlükleri içinde bu günlüklerle neler yapabileceğinizi görelim.

Günlükleri görmek için aşağıdaki sorguyu çalıştırın: kusto AzureDiagnostics | where ResourceProvider == "MICROSOFT.AUTOMATION"

İş günlükleri ve iş akışları için örnek sorgular

Hatayla tamamlanan tüm işleri bulma

Hatalarla ilgili uyarı verme gibi senaryolara ek olarak, bir runbook işinde sonlandırılmayan bir hata olduğunda da bulabilirsiniz. Böyle durumlarda PowerShell bir hata akışı oluşturur, ancak sonlandırılmayan hatalar işinizin askıya alınmasına veya başarısız olmasına neden olmaz.

1. Log Analytics çalışma alanınızda Günlükler'e tıklayın.
2. Sorgu alanına şunu yazın:

   AzureDiagnostics | where ResourceProvider == "MICROSOFT.AUTOMATION" and Category == "JobStreams" and StreamType_s == "Error" | summarize AggregatedValue = count () by JobId_g. 
   

3. Ara'ya tıklayın.

bir işin iş akışlarını görüntüleme

Bir işte hata ayıklarken, iş akışlarını da incelemek isteyebilirsiniz. Aşağıdaki sorgu, GUID 2ebd22ea-e05e-4eb9-9d76-d73cbd4356e0ile tek bir işin tüm akışlarını gösterir:

AzureDiagnostics
| where ResourceProvider == "MICROSOFT.AUTOMATION" and Category == "JobStreams" and JobId_g == "2ebd22ea-e05e-4eb9-9d76-d73cbd4356e0"
| sort by TimeGenerated asc
| project ResultDescription

Geçmiş iş durumunu görüntüleme

Son olarak, zaman içinde iş geçmişinizi görselleştirmek isteyebilirsiniz. Zaman içinde işlerinizin durumunu aramak için bu sorguyu kullanabilirsiniz.

AzureDiagnostics
| where ResourceProvider == "MICROSOFT.AUTOMATION" and Category == "JobLogs" and ResultType != "started"
| summarize AggregatedValue = count() by ResultType, bin(TimeGenerated, 1h)

Otomasyon işlerinde hataları bildiren günlükleri bulun.

AzureDiagnostics 
| where ResourceProvider == "MICROSOFT.AUTOMATION" 
| where StreamType_s == "Error" 
| project TimeGenerated, Category, JobId_g, OperationName, RunbookName_s, ResultDescription, _ResourceId 

Tamamlanan Azure Otomasyonu işleri bulma

AzureDiagnostics 
| where ResourceProvider == "MICROSOFT.AUTOMATION" and Category == "JobLogs" and ResultType == "Completed" 
| project TimeGenerated, RunbookName_s, ResultType, _ResourceId, JobId_g

Başarısız olan, askıya alınan veya durdurulan Azure Otomasyonu işleri bulma

AzureDiagnostics 
| where ResourceProvider == "MICROSOFT.AUTOMATION" and Category == "JobLogs" and (ResultType == "Failed" or ResultType == "Stopped" or ResultType == "Suspended") 
| project TimeGenerated, RunbookName_s, ResultType, _ResourceId, JobId_g 

Hatalarla başarıyla tamamlanan tüm runbook'ları ve işleri listeleme

AzureDiagnostics 
| where ResourceProvider == "MICROSOFT.AUTOMATION" and Category == "JobStreams" and StreamType_s == "Error" 
| project TimeGenerated, RunbookName_s, StreamType_s, _ResourceId, ResultDescription, JobId_g 

Runbook işi başarısız olduğunda veya askıya alındığında e-posta gönderme

Aşağıdaki adımlarda, runbook işinde bir sorun oluştuğunda bildirim almak için Azure İzleyici'de e-posta uyarılarının nasıl ayarlanacağı açıklanmaktadır.

Uyarı kuralı oluşturmak için, günlükleri sorgulama bölümünde açıklandığı gibi uyarıyı çağırması gereken runbook iş kayıtları için bir günlük araması oluşturun. Uyarı kuralını yapılandırmak için +Yeni uyarı kuralına tıklayın.

1. Otomasyon hesabınızdaki İzleme'nin altında Günlükler'i seçin.

2. Sorgu alanına bir arama ölçütü girerek uyarınız için bir günlük arama sorgusu oluşturun.

   AzureDiagnostics | where ResourceProvider == "MICROSOFT.AUTOMATION" and Category == "JobLogs" and (ResultType == "Failed" or ResultType == "Suspended")   
   

   Aşağıdakini kullanarak runbook adına göre de gruplandırabilirsiniz:

   AzureDiagnostics | where ResourceProvider == "MICROSOFT.AUTOMATION" and     Category == "JobLogs" and (ResultType == "Failed" or ResultType == "Suspended") | summarize AggregatedValue = count() by RunbookName_s 
   

3. Uyarı kuralı oluştur ekranını açmak için sayfanın üst kısmındaki +Yeni uyarı kuralı'na tıklayın. Uyarıları yapılandırma seçenekleri hakkında daha fazla bilgi için bkz . Azure'da uyarıları günlüğe kaydetme

Tanılama denetim günlüklerini Azure Otomasyonu

Artık denetim günlüklerini Azure İzleyici çalışma alanına da gönderebilirsiniz. Bu, kuruluşların güvenlik ve uyumluluk için önemli otomasyon hesabı etkinliklerini izlemesine olanak tanır. Azure Tanılama ayarları aracılığıyla etkinleştirildiğinde Otomasyon runbook'ları, işler ve bağlantı, kimlik bilgileri, değişken ve sertifika gibi otomasyon varlıkları için oluşturma, güncelleştirme ve silme işlemleri hakkında telemetri toplayabilirsiniz. Güvenlik izleme gereksinimlerinizin bir parçası olarak denetim günlüğü koşullarına yönelik uyarıları da yapılandırabilirsiniz.

Etkinlik günlükleri ile denetim günlükleri arasındaki fark

Etkinlik günlüğü, Azure'da abonelik düzeyi olaylar hakkında içgörü sağlayan bir platform günlüğüdür. Otomasyon hesabının etkinlik günlüğü, otomasyon kaynağının ne zaman değiştirildiği, oluşturulduğu veya silindiği hakkındaki bilgileri içerir. Ancak, kaynağın adını veya kimliğini yakalamaz.

Otomasyon hesapları için denetim günlükleri, kaynak için gerçekleştirilen işlemin türüyle birlikte otomasyon değişkeni, kimlik bilgileri, bağlantı vb. kaynağın adını ve kimliğini yakalar ve Azure Otomasyonu GDPR uyumluluğuna uygun istemci IP verileri gibi bazı ayrıntıları temizler.

Etkinlik günlüğü, Azure kaynakları için ayrıntılı tanılama ve denetim bilgileri sağlayan bir platform günlüğü olduğundan, etkinlik günlükleri istemci IP'si gibi ayrıntıları gösterir. BUNLAR ARM'de gerçekleşen etkinlikler için otomatik olarak oluşturulur ve etkinlik günlüğü kaynak sağlayıcısına gönderilir. Etkinlik günlükleri Azure izlemesinin bir parçası olduğundan, istemci etkinliğiyle ilgili içgörüler sağlamak için bazı istemci verilerini gösterir.  

Denetim günlükleri için örnek sorgular

Otomasyon kaynağı denetim günlüklerini görüntülemek için sorgulama

AzureDiagnostics 
| where ResourceProvider == "MICROSOFT.AUTOMATION" and Category == "AuditEvent" 

Herhangi bir değişken güncelleştirmesini izlemek, oluşturma veya silme işlemini sorgulama

AzureDiagnostics 
| where ResourceProvider == "MICROSOFT.AUTOMATION" and Category == "AuditEvent" and targetResources_Resource_s == "Variable" 

Oluşturma, taslak oluşturma veya güncelleştirme gibi herhangi bir runbook işlemini izlemek için sorgulama

AzureDiagnostics 
| where ResourceProvider == "MICROSOFT.AUTOMATION" and Category == "AuditEvent" and targetResources_Resource_s contains "Runbook" 

Herhangi bir sertifika oluşturma, güncelleştirme veya silme işlemini izlemek için sorgulama

AzureDiagnostics 
| where ResourceProvider == "MICROSOFT.AUTOMATION" and Category == "AuditEvent" and targetResources_Resource_s contains "Certificate" 

Kimlik bilgileri oluşturma, güncelleştirme veya silmeyi izlemek için sorgulama

AzureDiagnostics 
| where ResourceProvider == "MICROSOFT.AUTOMATION" and Category == "AuditEvent" and targetResources_Resource_s contains "Credential" 

İş durumu çıkışını JSON nesnesine dönüştüren filtre uygulama

Son zamanlarda, Otomasyon günlük verilerinin Log Analytics hizmetindeki tabloya AzureDiagnostics nasıl yazıldığına ilişkin davranışı değiştirdik ve JSON özelliklerini artık ayrı alanlara bölmedi. Runbook'unuzu çıkış akışındaki nesneleri JSON biçiminde ayrı sütunlar olarak biçimlendirecek şekilde yapılandırdıysanız, bu özelliklere erişmek için sorgularınızı bu alanı bir JSON nesnesine ayrıştıracak şekilde yeniden yapılandırmanız gerekir. Bu, bilinen bir yolda belirli bir JSON öğesine erişmek için json ayrıştırma kullanılarak gerçekleştirilir.

Örneğin, bir runbook çıktı akışındaki ResultDescription özelliğini birden çok alanla JSON biçiminde biçimlendirmektedir. Durum adlı bir alanda belirtildiği gibi başarısız durumda olan işlerinizin durumunu aramak için bu örnek sorguyu kullanarak ResultDescription'da Başarısız durumuyla arama yapın:

AzureDiagnostics
| where Category == 'JobStreams'
| extend jsonResourceDescription = parse_json(ResultDescription)
| where jsonResourceDescription.Status == 'Failed'

Sonraki adımlar

• Azure İzleyici günlükleriyle arama sorguları oluşturma ve Otomasyon iş günlüklerini gözden geçirme hakkında bilgi edinmek için bkz . Azure İzleyici günlüklerinde günlük aramaları.
• Runbook'lardan çıktı ve hata iletilerinin oluşturulmasını ve alınmasını anlamak için bkz . Runbook çıkışını izleme.
• Runbook yürütme, runbook işlerini izleme ve diğer teknik ayrıntılar hakkında daha fazla bilgi edinmek için bkz. Azure Otomasyonu'de Runbook yürütme.
• Azure İzleyici günlükleri ve veri toplama kaynakları hakkında daha fazla bilgi edinmek için bkz . Azure İzleyici günlüklerinde Azure depolama verilerini toplamaya genel bakış.
• Log Analytics sorunlarını giderme konusunda yardım için bkz . Log Analytics'in artık veri toplamama sorunlarını giderme.