مشاركة عبر

الترقية إلى واجهة برمجة تطبيقات قواعد الاستعلام المجدولة من واجهة برمجة تطبيقات تنبيه Log Analytics القديمة

  • مقالة

هام

كما تم الإعلان عنه، سيتم إيقاف واجهة برمجة تطبيقات تنبيه Log Analytics في 1 أكتوبر 2025. يجب الانتقال إلى استخدام واجهة برمجة تطبيقات قواعد الاستعلام المجدولة لتنبيهات بحث السجل بحلول ذلك التاريخ. تستخدم مساحات عمل Log Analytics التي تم إنشاؤها بعد 1 يونيو 2019 واجهة برمجة تطبيقات scheduledQueryRules لإدارة قواعد تنبيه بحث السجل. قم بالتبديل إلى واجهة برمجة التطبيقات الحالية في مساحات العمل القديمة للاستفادة من مزايا Azure Monitor scheduledQueryRules. بمجرد ترحيل القواعد إلى واجهة برمجة تطبيقات scheduledQueryRules، لا يمكنك العودة إلى واجهة برمجة تطبيقات تنبيه Log Analytics القديمة.

في الماضي، استخدم المستخدمون واجهة برمجة تطبيقات تنبيه Log Analytics القديمة لإدارة قواعد تنبيه بحث السجل. تستخدم مساحات العمل حاليا واجهة برمجة تطبيقات قواعد الاستعلام المجدولة للقواعد الجديدة. توضح هذه المقالة فوائد عملية تبديل إدارة قواعد تنبيه بحث السجل القديمة من واجهة برمجة التطبيقات القديمة إلى واجهة برمجة التطبيقات الحالية.

المزايا

  • إدارة جميع قواعد تنبيه البحث في السجل في واجهة برمجة تطبيقات واحدة.
  • قالب واحد لإنشاء قواعد التنبيه (مطلوب مسبقًا ثلاثة قوالب منفصلة).
  • واجهة برمجة تطبيقات واحدة لكافة تنبيهات سجل موارد Azure.
  • دعم تنبيهات البحث ذات الحالة (المعاينة) والسجل لمدة دقيقة واحدة.
  • دعم PowerShell cmdletsوAzure CLI للقواعد المحولة.
  • محاذاة درجات الخطورة مع جميع أنواع التنبيهات الأخرى والقواعد الأحدث.
  • القدرة على إنشاء تنبيه سجل عبر مساحات العمل يمتد عبر العديد من الموارد الخارجية مثل مساحات عمل Log Analytics أو موارد Application Insights للقواعد المحولة.
  • يمكن للمستخدمين تحديد أبعاد لتقسيم التنبيهات لقواعد التبديل.
  • تحتوي تنبيهات بحث السجل على فترة طويلة تصل إلى يومين من البيانات (تقتصر سابقا على يوم واحد) للقواعد المحولة.

تأثير

  • يجب إنشاء / تحرير جميع القواعد التي تم تبديلها باستخدام واجهة برمجة التطبيقات الحالية. راجع استخدام عينة عبر قالب Azure Resource واستخدام العينة باستخدام PowerShell.
  • عندما تصبح القواعد موارد Azure Resource Manager المتعقبة في واجهة برمجة التطبيقات الحالية ويجب أن تكون فريدة، تتغير معرفات الموارد للقواعد إلى هذه البنية: <WorkspaceName>|<savedSearchId>|<scheduleId>|<ActionId>. تظل أسماء العرض لقواعد التنبيه دون تغيير.

معالجة

عرض مساحات العمل للترقية باستخدام استعلام Azure Resource Graph Explorerهذا. افتح الرابط، وحدد جميع الاشتراكات المتوفرة، وقم بتشغيل الاستعلام.

عملية التبديل ليست تفاعلية، ولا تتطلب خطوات يدوية، في معظم الحالات. لا يتم إيقاف قواعد التنبيه أو إيقافها، أثناء التبديل أو بعده. قم بهذا الاستدعاء للتبديل بين كافة قواعد التنبيه المقترنة بمساحة عمل Log Analytics المحددة:

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

مع نص الطلب الذي يحتوي على JSON أدناه:

{
    "scheduledQueryRulesEnabled" : true
}

وفيما يلي مثال على استخدام ARMClient، وهو عبارة عن أداة مفتوحة المصدر لسطر الأوامر تبسط استدعاء API أعلاه:

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

يمكنك أيضا استخدام أداة Azure CLI :

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

إذا كان مفتاح التبديل ناجحًا، فستكون الاستجابة:

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

تحقق من حالة تبديل مساحة العمل

يمكنك أيضًا استخدام استدعاء API هذا للتحقق من حالة التبديل:

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

يمكنك أيضا استخدام أداة ARMClient :

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

يمكنك أيضا استخدام أداة Azure CLI :

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

إذا تم تبديل مساحة عمل Log Analytics إلى واجهة برمجة التطبيقات لـ scheduledQueryRules، فإن الاستجابة هي:

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

إذا لم يتم تبديل مساحة عمل Log Analytics، فإن الاستجابة هي:

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

الخطوات التالية