Eski Log Analytics Uyarı API'sinden Zamanlanmış Sorgu Kuralları API'sine yükseltme

Önemli

Duyurulduğu gibi Log Analytics Uyarı API'si 1 Ekim 2025'te kullanımdan kaldırılacaktır. Bu tarihe kadar günlük araması uyarıları için Zamanlanmış Sorgu Kuralları API'sini kullanmaya geçmeniz gerekir. 1 Haziran 2019'dan sonra oluşturulan Log Analytics çalışma alanları, günlük araması uyarı kurallarını yönetmek için zamanlanmışQueryRules API'sini kullanır. Eski çalışma alanlarındaki geçerli API'ye geçin ve Azure İzleyici zamanlanmışQueryRules avantajlarından yararlanın. Kuralları zamanlanmışQueryRules API'sine geçirdikten sonra eski eski Log Analytics Uyarı API'sine geri döndüremezsiniz. Bu API'nin kullanımdan kaldırılması, scheduledQueryRules API sürümleri 2018-04-16 veya üzeri kullanılarak oluşturulan Günlük araması uyarı kurallarını etkilemez.

Geçmişte kullanıcılar günlük araması uyarı kurallarını yönetmek için eski Log Analytics Uyarı API'sini kullanıyordu. Şu anda çalışma alanları yeni kurallar için Zamanlanmış Sorgu Kuralları API'sini kullanmaktadır. Bu makalede, eski günlük araması uyarı kuralları yönetimini eski API'den geçerli API'ye geçirmenin avantajları ve süreci açıklanmaktadır.

Sosyal haklar

  • Tüm günlük arama uyarı kurallarını tek bir API aracılığıyla yönetin.
  • Uyarı kuralları oluşturmak için tek şablon (daha önce üç ayrı şablon gerekiyordu).
  • Tüm Azure kaynakları için tek bir API ile günlük izleme uyarısı.
  • 1 dakikalık log arama uyarıları ve durum tabanlı (önizleme) destek.
  • PowerShell cmdlet'leri ve Azure CLI için anahtarlı kurallar desteği.
  • Önem derecelerinin diğer tüm uyarı türleri ve daha yeni kurallarla uyumlu hale getirme.
  • Birden fazla Log Analytics çalışma alanı veya değiştirilmiş kurallar için Application Insights kaynakları gibi çeşitli dış kaynakları kapsayan bir çalışma alanları arası günlük uyarısı oluşturabilme yeteneği.
  • Kullanıcılar, değiştirilmiş kuralların uyarılarını bölmek için boyutlar belirtebilir.
  • Günlük arama uyarıları, değiştirilmiş kurallar için iki güne kadar kapsama süresi içermektedir (daha önce bir günle sınırlıydı).

Etki

  • Tüm değiştirilen kurallar geçerli API ile oluşturulmalı/düzenlenmelidir. Bkz. Azure Kaynak Şablonu aracılığıyla örnek kullanım ve PowerShell aracılığıyla örnek kullanım.
  • Kurallar, geçerli API'de Azure Resource Manager tarafından izlenen kaynaklar haline geldiği ve benzersiz olmaları gerektiği için, kuralların kaynak kimlikleri şu yapıya dönüşür: <WorkspaceName>|<savedSearchId>|<scheduleId>|<ActionId>. Uyarı kuralları için görünen adlar değişmeden kalır.

İşlem

Bu Azure Kaynak Grafı Gezgini sorgusunu kullanarak yükseltecek çalışma alanlarını görüntüleyin. Bağlantıyı açın, kullanılabilir tüm abonelikleri seçin ve sorguyu çalıştırın.

Geçiş işlemi etkileşimli değildir ve çoğu durumda el ile adım atılması gerekmez. Uyarı kurallarınız geçiş sırasında veya sonrasında durdurulmaz veya askıya alınmaz. Log Analytics çalışma alanlarının her biriyle ilişkili tüm uyarı kurallarını değiştirmek için bu çağrıyı yapın:

PUT /subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.OperationalInsights/workspaces/<workspaceName>/alertsversion?api-version=2017-04-26-preview

Aşağıdaki JSON'yi içeren istek gövdesiyle:

{
    "scheduledQueryRulesEnabled" : true
}

Yukarıdaki API çağrısını çağırmayı kolaylaştıran açık kaynak komut satırı aracı ARMClient'ı kullanma örneği aşağıda verilmiştir:

$switchJSON = '{"scheduledQueryRulesEnabled": true}'
armclient PUT /subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.OperationalInsights/workspaces/<workspaceName>/alertsversion?api-version=2017-04-26-preview $switchJSON

Azure CLI aracını da kullanabilirsiniz:

az rest --method put --url /subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.OperationalInsights/workspaces/<workspaceName>/alertsversion?api-version=2017-04-26-preview --body "{\"scheduledQueryRulesEnabled\" : true}"

Eğer değişiklik başarıyla gerçekleşirse yanıt:

{
    "version": 2,
    "scheduledQueryRulesEnabled" : true
}

Çalışma alanının durumunu değiştirme durumunu denetleme

Anahtar durumunu denetlemek için bu API çağrısını da kullanabilirsiniz:

GET /subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.OperationalInsights/workspaces/<workspaceName>/alertsversion?api-version=2017-04-26-preview

ARMClient aracını da kullanabilirsiniz:

armclient GET /subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.OperationalInsights/workspaces/<workspaceName>/alertsversion?api-version=2017-04-26-preview

Azure CLI aracını da kullanabilirsiniz:

az rest --method get --url /subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.OperationalInsights/workspaces/<workspaceName>/alertsversion?api-version=2017-04-26-preview

Log Analytics çalışma alanı scheduledQueryRules API'sine geçirildiyse yanıt:

{
    "version": 2,
    "scheduledQueryRulesEnabled" : true
}

Log Analytics çalışma alanına geçiş yapmadıysanız yanıt şu şekildedir:

{
    "version": 2,
    "scheduledQueryRulesEnabled" : false
}

Sonraki adımlar

  • Last updated on