إدارة تكوينات الأصول عن بعد

هام

معاينة عمليات Azure IoT - التي تم تمكينها بواسطة Azure Arc قيد المعاينة حاليا. يجب عدم استخدام برنامج المعاينة هذا في بيئات الإنتاج.

ستحتاج إلى نشر تثبيت Azure IoT Operations جديد عند توفير إصدار متوفر بشكل عام. لن تتمكن من ترقية تثبيت معاينة.

للحصول على الشروط القانونية التي تنطبق على ميزات Azure الموجودة في الإصدار التجريبي، أو المعاينة، أو التي لم يتم إصدارها بعد في التوفر العام، راجع شروط الاستخدام التكميلية لمعاينات Microsoft Azure.

الأصل في Azure IoT Operations Preview هو كيان منطقي تقوم بإنشائه لتمثيل أصل حقيقي. يمكن أن يحتوي أصل عمليات Azure IoT على خصائص وعلامات وأحداث تصف سلوكه وخصائصه.

خوادم OPC UA هي تطبيقات برامج تتصل بالأصول. تعرض خوادم OPC UA علامات OPC UA التي تمثل نقاط البيانات. توفر علامات OPC UA بيانات في الوقت الفعلي أو تاريخية حول حالة الأصول أو أدائها أو جودتها أو حالتها.

نقطة نهاية الأصل هي مورد مخصص في مجموعة Kubernetes التي تربط خوادم OPC UA بالموصل لوحدات OPC UA النمطية. يمكن هذا الاتصال موصل OPC UA من الوصول إلى نقاط بيانات الأصل. بدون نقطة نهاية الأصل، لا يمكن تدفق البيانات من خادم OPC UA إلى موصل OPC UA ووسيط MQTT. بعد تكوين الموارد المخصصة في نظام المجموعة الخاص بك، يتم إنشاء اتصال بخادم OPC UA المتلقي للمعلومات ويحيل الخادم القياس عن بعد إلى موصل OPC UA.

الموقع عبارة عن مجموعة من مثيلات عمليات Azure IoT. تجمع المواقع عادة المثيلات حسب الموقع الفعلي وتجعل من السهل على مستخدمي OT تحديد موقع الأصول وإدارتها. يقوم مسؤول تكنولوجيا المعلومات بإنشاء مواقع وتعيين مثيلات عمليات Azure IoT لها. لمعرفة المزيد، راجع ما هو مدير موقع Azure Arc (معاينة)؟.

في واجهة مستخدم الويب لتجربة العمليات، يمثل المثيل مجموعة عمليات Azure IoT. يمكن أن يحتوي المثيل على نقطة نهاية أصل واحدة أو أكثر.

توضح هذه المقالة كيفية استخدام واجهة مستخدم الويب لتجربة العمليات وAzure CLI من أجل:

• حدد نقاط نهاية الأصول التي تربط الأصول بمثيل عمليات Azure IoT.
• أضف الأصول، وحدد علاماتها وأحداثها لتمكين تدفق البيانات من خوادم OPC UA إلى وسيط MQTT.

تقوم هذه الأصول والعلامات والأحداث بتعيين البيانات الواردة من خوادم OPC UA إلى الأسماء المألوفة التي يمكنك استخدامها في وسيط MQTT وتدفقات البيانات.

المتطلبات الأساسية

لتكوين نقطة نهاية الأصول، تحتاج إلى مثيل قيد التشغيل لعمليات Azure IoT.

لتسجيل الدخول إلى واجهة مستخدم ويب تجربة العمليات، تحتاج إلى حساب معرف Microsoft Entra مع أذونات المساهم على الأقل لمجموعة الموارد التي تحتوي على مثيل Kubernetes - Azure Arc . لا يمكنك تسجيل الدخول باستخدام حساب Microsoft (MSA). لإنشاء حساب معرف Microsoft Entra مناسب في مستأجر Azure الخاص بك:

1. سجل الدخول إلى مدخل Microsoft Azure بنفس المستأجر واسم المستخدم الذي استخدمته لنشر عمليات Azure IoT.
2. في مدخل Microsoft Azure، انتقل إلى قسم Microsoft Entra ID ، وحدد Users > +New user > Create new user. أنشئ مستخدما جديدا وقم بتدوين كلمة المرور، فأنت بحاجة إليها لتسجيل الدخول لاحقا.
3. في مدخل Microsoft Azure، انتقل إلى مجموعة الموارد التي تحتوي على مثيل Kubernetes - Azure Arc . في صفحة Access control (IAM)، حدد +Add > role assignment.
4. في صفحة Add role assignment، حدد Privileged administrator roles. ثم حدد المساهم ثم حدد التالي.
5. في صفحة الأعضاء ، أضف المستخدم الجديد إلى الدور.
6. حدد Review and assign لإكمال إعداد المستخدم الجديد.

يمكنك الآن استخدام حساب المستخدم الجديد لتسجيل الدخول إلى مدخل عمليات Azure IoT.

تسجيل الدخول

تجربة العمليات

لتسجيل الدخول إلى تجربة العمليات، انتقل إلى تجربة العمليات في المستعرض وسجل الدخول باستخدام بيانات اعتماد معرف Microsoft Entra.

تحديد موقعك

بعد تسجيل الدخول، تعرض تجربة العمليات قائمة بالمواقع. كل موقع عبارة عن مجموعة من مثيلات عمليات Azure IoT حيث يمكنك تكوين أصولك وإدارتها. يمثل الموقع عادة موقعا فعليا حيث يتم نشر الأصول المادية. تسهل المواقع عليك تحديد موقع الأصول وإدارتها. مسؤول تكنولوجيا المعلومات مسؤول عن تجميع المثيلات في المواقع. تظهر أي مثيلات عمليات Azure IoT لم يتم تعيينها إلى موقع في عقدة المثيلات غير المعينة . حدد الموقع الذي تريد استخدامه:

تلميح

يمكنك استخدام مربع عامل التصفية للبحث عن المواقع.

إذا لم تشاهد أي مواقع، فقد لا تكون في مستأجر Azure Active Directory الصحيح. يمكنك تغيير المستأجر من القائمة العلوية اليمنى في تجربة العمليات. إذا كنت لا تزال لا ترى أي مواقع تعني أنك لم تتم إضافتها إلى أي مواقع حتى الآن. تواصل مع مسؤول تكنولوجيا المعلومات لطلب الوصول.

حدد المثيل الخاص بك

بعد تحديد موقع، تعرض تجربة العمليات قائمة بمثيلات عمليات Azure IoT التي تعد جزءا من الموقع. حدد المثيل الذي تريد استخدامه:

تلميح

يمكنك استخدام مربع عامل التصفية للبحث عن مثيلات.

بعد تحديد المثيل الخاص بك، تعرض تجربة العمليات صفحة نظرة عامة للمثيل. تعرض صفحة نظرة عامة حالة المثيل والموارد، مثل الأصول، المقترنة به:

Azure CLI

قبل استخدام az iot ops asset الأوامر، سجل الدخول إلى الاشتراك الذي يحتوي على نشر عمليات Azure IoT:

az login

إنشاء نقطة نهاية أصل

يمكن أن يتضمن توزيع عمليات Azure IoT محاكاة OPC PLC مضمنة اختيارية. لإنشاء نقطة نهاية أصل تستخدم محاكي OPC PLC المضمن:

تجربة العمليات

1. حدد نقاط نهاية الأصول ثم إنشاء نقطة نهاية الأصل:

   

   تلميح

   يمكنك استخدام مربع التصفية للبحث عن نقاط نهاية الأصول.

2. أدخل معلومات نقطة النهاية التالية:

   الحقل	القيمة
   الاسم	opc-ua-connector-0
   موصل عنوان URL OPC UA	opc.tcp://opcplc-000000:50000
   مصادقة المستخدم	Anonymous

3. لحفظ التعريف، حدد إنشاء.

Azure CLI

شغّل الأمر التالي:

az iot ops asset endpoint opcua create --name opc-ua-connector-0 --target-address opc.tcp://opcplc-000000:50000 -g {your resource group name} --instance {your instance name} 

تلميح

استخدم az connectedk8s list لسرد المجموعات التي لديك حق الوصول إليها.

لمعرفة المزيد، راجع نقطة نهاية أصل az iot ops.

ينشر هذا التكوين موردا جديدا assetendpointprofile يسمى opc-ua-connector-0 إلى نظام المجموعة. بعد تحديد أصل، يكتشفه موصل ل OPC UA POD. يستخدم pod نقطة نهاية الأصل التي تحددها في تعريف الأصل للاتصال بخادم OPC UA.

عند تشغيل محاكي OPC PLC، تتدفق البيانات من المحاكي، إلى موصل OPC UA، ثم إلى وسيط MQTT.

تكوين نقطة نهاية أصل لاستخدام اسم مستخدم وكلمة مرور

يستخدم Anonymous المثال السابق وضع المصادقة. لا يتطلب هذا الوضع اسم مستخدم أو كلمة مرور.

لاستخدام UsernamePassword وضع المصادقة، أكمل الخطوات التالية:

تجربة العمليات

1. اتبع الخطوات الواردة في تكوين مصادقة مستخدم OPC UA باستخدام اسم المستخدم وكلمة المرور لإضافة أسرار لاسم المستخدم وكلمة المرور في Azure Key Vault، وإسقاطها في مجموعة Kubernetes.
2. في تجربة العمليات، حدد كلمة مرور اسم المستخدم لحقل مصادقة المستخدم لتكوين نقطة نهاية الأصل لاستخدام هذه الأسرار. ثم أدخل القيم التالية لحقول مرجع اسم المستخدم ومرجع كلمة المرور:

الحقل	القيمة
مرجع اسم المستخدم	aio-opc-ua-broker-user-authentication/username
مرجع كلمة المرور	aio-opc-ua-broker-user-authentication/password

Azure CLI

1. اتبع الخطوات الواردة في تكوين مصادقة مستخدم OPC UA باستخدام اسم المستخدم وكلمة المرور لإضافة أسرار لاسم المستخدم وكلمة المرور في Azure Key Vault، وإسقاطها في مجموعة Kubernetes.

2. استخدم أمر مثل المثال التالي لإنشاء نقطة نهاية الأصل:

   az iot ops asset endpoint opcua create --name opc-ua-connector-0 --target-address opc.tcp://opcplc-000000:50000 -g {your resource group name} --instance {your instance name} --username-ref "aio-opc-ua-broker-user-authentication/username" --password-ref "aio-opc-ua-broker-user-authentication/password"
   

إضافة أصل وعلامات وأحداث

تجربة العمليات

لإضافة أصل في تجربة العمليات:

1. حدد علامة التبويب Assets. قبل إنشاء أي أصول، سترى الشاشة التالية:

   

   تلميح

   يمكنك استخدام مربع التصفية للبحث عن الأصول.

2. حدد Create asset.

3. في شاشة تفاصيل الأصل، أدخل معلومات الأصل التالية:

   • نقطة نهاية الأصل. حدد نقطة نهاية الأصل من القائمة.
   • اسم الأصل
   • ‏‏الوصف

4. تكوين مجموعة الخصائص التي تريد إقرانها بالأصل. يمكنك قبول القائمة الافتراضية للخصائص أو إضافة خصائصك. تتوفر الخصائص التالية بشكل افتراضي:

   • الشركة المصنعة
   • عنوان URI للشركة المصنعة
   • النموذج
   • رمز المنتج
   • إصدار الأجهزة
   • إصدار البرنامج
   • الرقم التسلسلي
   • وثائق URI

   

5. حدد التالي للانتقال إلى صفحة إضافة علامات .

إضافة علامات فردية إلى أصل

الآن يمكنك تحديد العلامات المقترنة بالأصل. لإضافة علامات OPC UA:

1. حدد Add tag أو CSV > Add tag.

2. أدخل تفاصيل العلامة:

   • معرف العقدة. هذه القيمة هي معرف العقدة من خادم OPC UA.
   • اسم العلامة (اختياري). هذه القيمة هي الاسم المألوف الذي تريد استخدامه للعلامة. إذا لم تحدد اسم علامة، يتم استخدام معرف العقدة كاسم العلامة.
   • وضع المراقبة (اختياري) مع الخيارات التالية:
     • بلا
     • جهاز قياس
     • العداد
     • المدرج التكراري
     • سجل
   • الفاصل الزمني لأخذ العينات (مللي ثانية). يمكنك تجاوز القيمة الافتراضية لهذه العلامة.
   • حجم قائمة الانتظار. يمكنك تجاوز القيمة الافتراضية لهذه العلامة.

   

   يعرض الجدول التالي بعض أمثلة قيم العلامات التي يمكنك استخدامها مع محاكي OPC PLC المضمن:

   معرف العقدة	اسم العلامة	وضع المراقبة
   ns=3؛ s=FastUInt10	درجة الحرارة	بلا
   ns=3؛ s=FastUInt100	الرطوبة	بلا

3. حدد إدارة الإعدادات الافتراضية لتكوين إعدادات القياس عن بعد الافتراضية للأصل. تنطبق هذه الإعدادات على جميع علامات OPC UA التي تنتمي إلى الأصل. يمكنك تجاوز هذه الإعدادات لكل علامة تضيفها. تتضمن إعدادات القياس عن بعد الافتراضية ما يلي:

   • الفاصل الزمني لأخذ العينات (مللي ثانية): يشير الفاصل الزمني لأخذ العينات إلى أسرع معدل يجب على خادم OPC UA أخذ عينات من مصدره الأساسي لتغييرات البيانات.
   • الفاصل الزمني للنشر (مللي ثانية): معدل نشر خادم OPC UA للبيانات.
   • حجم قائمة الانتظار: عمق قائمة الانتظار للاحتفاظ ببيانات أخذ العينات قبل نشرها.

إضافة علامات بشكل مجمع إلى أصل

يمكنك استيراد ما يصل إلى 1000 علامة OPC UA في كل مرة من ملف CSV:

1. إنشاء ملف CSV يبدو مثل المثال التالي:

   معرف العقدة	اسم العلامة	حجم قائمة الانتظار	وضع إمكانية المراقبة	الفاصل الزمني لأخذ العينات بالمللي ثانية
   ns=3؛ s=FastUInt1000	العلامة 1000	5	بلا	1000
   ns=3؛ s=FastUInt1001	العلامة 1001	5	بلا	1000
   ns=3؛ s=FastUInt1002	العلامة 1002	10	بلا	5000

2. حدد Add tag أو ملف CSV > Import CSV (.csv). حدد ملف CSV الذي أنشأته وحدد فتح. يتم استيراد العلامات المعرفة في ملف CSV:

   

   إذا قمت باستيراد ملف CSV يحتوي على علامات مكررة للعلامات الموجودة، تعرض تجربة العمليات الرسالة التالية:

   

   يمكنك إما استبدال العلامات المكررة وإضافة علامات جديدة من ملف الاستيراد، أو يمكنك إلغاء الاستيراد.

3. لتصدير جميع العلامات من أصل إلى ملف CSV، حدد تصدير الكل واختر موقعا للملف:

   

4. في صفحة Tags ، حدد Next للانتقال إلى صفحة Add events .

تلميح

يمكنك استخدام مربع عامل التصفية للبحث عن العلامات.

Azure CLI

استخدم الأوامر التالية لإضافة أصل "منظم الحرارة" باستخدام Azure CLI. تضيف الأوامر اثنين من العلامات/نقاط البيانات إلى الأصل باستخدام point add الأمر :

# Create the asset
az iot ops asset create --name thermostat -g {your resource group name} --instance {your instance name} --endpoint opc-ua-connector-0 --description 'A simulated thermostat asset'

# Add the datapoints
az iot ops asset dataset point add --asset thermostat -g {your resource group name} --dataset default --data-source 'ns=3;s=FastUInt10' --name temperature
az iot ops asset dataset point add --asset thermostat -g {your resource group name} --dataset default --data-source 'ns=3;s=FastUInt100' --name 'Tag 10'

# Show the datapoints
az iot ops asset dataset show --asset thermostat -n default -g {your resource group name}

عند إنشاء أصل باستخدام Azure CLI، يمكنك تحديد:

• نقاط بيانات/علامات متعددة باستخدام point add الأمر عدة مرات.
• أحداث متعددة باستخدام المعلمة --event عدة مرات.
• معلومات اختيارية للأصل مثل:
  • الشركة المصنعة
  • عنوان URI للشركة المصنعة
  • النموذج
  • رمز المنتج
  • إصدار الأجهزة
  • إصدار البرنامج
  • الرقم التسلسلي
  • وثائق URI
• القيم الافتراضية للفاصل الزمني لأخذ العينات والفاصل الزمني للنشر وحجم قائمة الانتظار.
• قيم محددة لنقطة البيانات للفاصل الزمني لأخذ العينات، والفاصل الزمني للنشر، وحجم قائمة الانتظار.
• قيم خاصة بالحدث للفاصل الزمني لنشر أخذ العينات وحجم قائمة الانتظار.
• وضع المراقبة لكل علامة وحدث

إضافة أحداث فردية إلى أصل

تجربة العمليات

الآن يمكنك تحديد الأحداث المقترنة بالأصل. لإضافة أحداث OPC UA:

1. حدد Add event أو CSV > Add event.

2. أدخل تفاصيل الحدث:

   • إعلام الحدث. هذه القيمة هي إعلام الحدث من خادم OPC UA.
   • اسم الحدث (اختياري). هذه القيمة هي الاسم المألوف الذي تريد استخدامه للحدث. إذا لم تحدد اسم حدث، يتم استخدام مخطر الحدث كاسم الحدث.
   • وضع المراقبة (اختياري) مع الخيارات التالية:
     • بلا
     • سجل
   • حجم قائمة الانتظار. يمكنك تجاوز القيمة الافتراضية لهذه العلامة.

   

3. حدد إدارة الإعدادات الافتراضية لتكوين إعدادات الحدث الافتراضية للأصل. تنطبق هذه الإعدادات على جميع أحداث OPC UA التي تنتمي إلى الأصل. يمكنك تجاوز هذه الإعدادات لكل حدث تضيفه. تتضمن إعدادات الحدث الافتراضية ما يلي:

   • الفاصل الزمني للنشر (مللي ثانية): معدل نشر خادم OPC UA للبيانات.
   • حجم قائمة الانتظار: عمق قائمة الانتظار للاحتفاظ ببيانات أخذ العينات قبل نشرها.

إضافة أحداث مجمعة إلى أصل

يمكنك استيراد ما يصل إلى 1000 حدث OPC UA في كل مرة من ملف CSV.

لتصدير كافة الأحداث من أصل إلى ملف CSV، حدد تصدير الكل واختر موقعا للملف.

في صفحة الأحداث، حدد التالي للانتقال إلى صفحة المراجعة.

تلميح

يمكنك استخدام مربع عامل التصفية للبحث عن الأحداث.

مراجعة التغييرات

راجع الأصل الخاص بك وعلامة OPC UA وتفاصيل الحدث وقم بإجراء أي تعديلات تحتاج إليها:

Azure CLI

عند إنشاء أصل باستخدام Azure CLI، يمكنك تعريف أحداث متعددة باستخدام المعلمة --event عدة مرات:

az iot ops asset create --name thermostat -g {your resource group name} --cluster {your cluster name} --endpoint opc-ua-connector-0 --description 'A simulated thermostat asset' --event event_notifier='ns=3;s=FastUInt12', name=warning

لكل حدث تقوم بتعريفه، يمكنك تحديد:

• إعلام الحدث. هذه القيمة هي إعلام الحدث من خادم OPC UA.
• اسم الحدث. هذه القيمة هي الاسم المألوف الذي تريد استخدامه للحدث. إذا لم تحدد اسم حدث، يتم استخدام مخطر الحدث كاسم الحدث.
• وضع المراقبة.
• حجم قائمة الانتظار.

يمكنك أيضا استخدامأوامر حدث أصل عمليات z iot لإضافة الأحداث وإزالتها من أحد الأصول.

تحديث أصل

تجربة العمليات

ابحث عن الأصل الذي أنشأته مسبقا وحدده. استخدم علامات التبويب تفاصيل الأصول والعلامات والأحداث لإجراء أي تغييرات:

في علامة التبويب علامات ، يمكنك إضافة علامات أو تحديث العلامات الموجودة أو إزالة العلامات.

لتحديث علامة، حدد علامة موجودة وقم بتحديث معلومات العلامة. ثم حدد تحديث:

لإزالة العلامات، حدد علامة واحدة أو أكثر ثم حدد إزالة العلامات:

يمكنك أيضا إضافة الأحداث والخصائص وتحديثها وحذفها بنفس الطريقة.

عند الانتهاء من إجراء التغييرات، حدد حفظ لحفظ التغييرات.

Azure CLI

لسرد أصولك، استخدم الأمر التالي:

az iot ops asset query -g {your resource group name}

تلميح

يمكنك تحسين أمر الاستعلام للبحث عن الأصول التي تطابق معايير محددة. على سبيل المثال، يمكنك البحث عن الأصول حسب الشركة المصنعة.

لعرض تفاصيل أصل منظم الحرارة، استخدم الأمر التالي:

az iot ops asset show --name thermostat -g {your resource group}

لتحديث أصل، استخدم az iot ops asset update الأمر . على سبيل المثال، لتحديث وصف الأصل، استخدم أمر مثل المثال التالي:

az iot ops asset update --name thermostat --description 'A simulated thermostat asset' -g {your resource group}

لسرد علامات أصل منظم الحرارة، استخدم الأمر التالي:

az iot ops asset dataset show --asset thermostat --name default -g {your resource group}

لسرد أحداث أصل منظم الحرارة، استخدم الأمر التالي:

az iot ops asset event list --asset thermostat -g {your resource group}

لإضافة علامة جديدة إلى أصل منظم الحرارة، استخدم أمر مثل المثال التالي:

az iot ops asset dataset point add --asset thermostat -g {your resource group name} --dataset default --data-source 'ns=3;s=FastUInt1002' --name 'humidity'

لحذف علامة، استخدم az iot ops asset dataset point remove الأمر .

يمكنك إدارة أحداث أحد الأصول باستخدام az iot ops asset event الأوامر.

حذف أحد الأصول

تجربة العمليات

لحذف أصل، حدد الأصل الذي تريد حذفه. في صفحة تفاصيل الأصل ، حدد حذف. تأكد من التغييرات التي أجريتها لحذف الأصل:

Azure CLI

لحذف أصل، استخدم أمر يشبه المثال التالي:

az iot ops asset delete --name thermostat -g {your resource group name}

الإعلامات

كلما قمت بإجراء تغيير على الأصل في تجربة العمليات، سترى إعلاما يبلغ عن حالة العملية:

عرض سجلات النشاط

في تجربة العمليات، يمكنك عرض سجلات النشاط لكل مثيل أو كل مورد في مثيل.

لعرض سجلات النشاط على مستوى المثيل، حدد علامة التبويب سجلات النشاط. يمكنك استخدام عوامل تصفية Timespan ونوع المورد لتخصيص طريقة العرض.

لعرض سجلات النشاط كمستوى المورد، حدد المورد الذي تريد فحصه. يمكن أن يكون هذا المورد أصل أو نقطة نهاية أصل أو مسار بيانات. في نظرة عامة على الموارد، حدد View activity logs. يمكنك استخدام عامل تصفية Timespan لتخصيص طريقة العرض.

المحتوى ذو الصلة

• نظرة عامة على موصل OPC UA
• أصل az iot ops
• نقطة نهاية أصل az iot ops