التفاعل مع أحداث تكوين تطبيق Azure
تمكن أحداث تكوين تطبيقات Azure التطبيقات من التفاعل مع التغييرات في القيم الرئيسية. ويتم ذلك دون الحاجة إلى تعليمات برمجية معقدة أو خدمات اقتراع باهظة الثمن وغير فعالة. بدلا من ذلك، يتم دفع الأحداث عبر Azure Event Grid للمشتركين مثل وظائف Azure أو تطبيقات Azure Logic أو حتى إلى مستمع http المخصص الخاص بك. بشكل حاسم ، أنت تدفع فقط مقابل ما تستخدمه.
يتم إرسال أحداث تكوين تطبيق Azure إلى شبكة أحداث Azure، التي توفر خدمات تسليم موثوقة لتطبيقاتك من خلال نهج إعادة المحاولة الغنية وتسليم الأحرف الميتة. لمعرفة المزيد، راجع تسليم رسالة شبكة الأحداث وإعادة المحاولة.
تتضمن سيناريوهات أحداث تكوين التطبيق الشائعة تحديث تكوين التطبيق أو تشغيل عمليات النشر أو أي سير عمل موجه نحو التكوين. عندما تكون التغييرات نادرة، ولكن السيناريو الخاص بك يتطلب استجابة فورية، يمكن أن تكون البنية القائمة على الأحداث فعالة بشكل خاص.
ألق نظرة على استخدام شبكة الأحداث للحصول على إشعارات تغيير البيانات للحصول على مثال سريع.
أحداث تكوين تطبيق Azure المتوفرة
تستخدم شبكة الأحداث اشتراكات الأحداث لتوجيه رسائل الحدث إلى المشتركين. يمكن أن تتضمن اشتراكات أحداث تكوين تطبيق Azure نوعين من الأحداث:
اسم الحفل الوصف Microsoft.AppConfiguration.KeyValueModifiedيتم تشغيله عند إنشاء قيمة مفتاح أو استبدالها Microsoft.AppConfiguration.KeyValueDeletedيتم تشغيله عند حذف قيمة مفتاح
مخطط الأحداث
تحتوي أحداث تكوين تطبيق Azure على جميع المعلومات التي تحتاجها للاستجابة للتغييرات في بياناتك. يمكنك تحديد حدث تكوين التطبيق لأن الخاصية eventType تبدأ ب "Microsoft.AppConfiguration". يتم توثيق معلومات إضافية حول استخدام خصائص حدث "شبكة الأحداث" في مخطط حدث "شبكة الأحداث".
الخاصية النوع الوصف الموضوع سلسلة معرف Azure الكامل Resource Manager لتكوين التطبيق الذي يصدر الحدث. الموضوع سلسلة عنوان URI للقيمة الرئيسية التي هي موضوع الحدث. توقيت الحدث سلسلة تاريخ/وقت إنشاء الحدث، بتنسيق ISO 8601. نوع الحدث سلسلة "Microsoft.AppConfiguration.KeyValueModified" أو "Microsoft.AppConfiguration.KeyValueDelete". المعرّف سلسلة معرف فريد لهذا الحدث. إصدار البيانات سلسلة إصدار مخطط عنصر البيانات. إصدار بيانات التعريف سلسلة إصدار المخطط لخصائص المستوى الأعلى. البيانات كائن جمع بيانات الأحداث الخاصة بتكوين تطبيق Azure البيانات.key سلسلة مفتاح قيمة المفتاح الذي تم تعديله أو حذفه. data.label سلسلة التسمية، إن وجدت، لقيمة المفتاح التي تم تعديلها أو حذفها. data.etag سلسلة للحصول KeyValueModifiedعلى etag قيمة المفتاح الجديد. للحصولKeyValueDeletedعلى etag قيمة المفتاح التي تم حذفها.
فيما يلي مثال على حدث KeyValueModified :
[{
"id": "84e17ea4-66db-4b54-8050-df8f7763f87b",
"topic": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/microsoft.appconfiguration/configurationstores/contoso",
"subject": "https://contoso.azconfig.io/kv/Foo?label=FizzBuzz",
"data": {
"key": "Foo",
"label": "FizzBuzz",
"etag": "FnUExLaj2moIi4tJX9AXn9sakm0"
},
"eventType": "Microsoft.AppConfiguration.KeyValueModified",
"eventTime": "2019-05-31T20:05:03Z",
"dataVersion": "1",
"metadataVersion": "1"
}]
لمزيد من المعلومات، راجع مخطط أحداث تكوين تطبيقات Azure.
ممارسات لاستهلاك الأحداث
يجب أن تتبع التطبيقات التي تتعامل مع أحداث تكوين التطبيق هذه الممارسات الموصى بها:
- يمكن تكوين اشتراكات متعددة لتوجيه الأحداث إلى معالج الأحداث نفسه، لذلك لا تفترض أن الأحداث من مصدر معين. بدلا من ذلك، تحقق من موضوع الرسالة للتأكد من أن مثيل تكوين التطبيق يرسل الحدث.
- تحقق من eventType ولا تفترض أن جميع الأحداث التي تتلقاها ستكون الأنواع التي تتوقعها.
- استخدم حقول etag لفهم ما إذا كانت معلوماتك حول الكائنات لا تزال محدثة.
- استخدم حقول التسلسل لفهم ترتيب الأحداث على أي كائن معين.
- استخدم حقل الموضوع للوصول إلى قيمة المفتاح التي تم تعديلها.
الخطوات التالية
تعرف على المزيد حول شبكة الأحداث وجرب أحداث تكوين تطبيق Azure: