تكوين ملف تعريف تدفق البيانات

هام

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

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

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

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

يجب تجنب ربط عدد كبير جدا من تدفقات البيانات بملف تعريف تدفق بيانات واحد. إذا كان لديك عدد كبير من تدفقات البيانات، فقم بإنشاء ملفات تعريف متعددة لتدفق البيانات لتقليل خطر تجاوز حد حجم تكوين ملف تعريف تدفق البيانات.

ملف تعريف تدفق البيانات الافتراضي

يتم إنشاء ملف تعريف تدفق البيانات المسمى default عند نشر عمليات Azure IoT. يمكنك استخدام ملف تعريف تدفق البيانات هذا للبدء في عمليات Azure IoT.

بوابة

1. لعرض ملف تعريف تدفق البيانات الافتراضي، انتقل إلى مثيل عمليات IoT في مدخل Microsoft Azure.

2. في الجزء الأيمن ضمن Components، حدد Data flow profiles.

3. حدد ملف تعريف تدفق البيانات الافتراضي .

   

Azure CLI

استخدم الأمر az iot operations dataflow profile show لعرض ملف تعريف تدفق البيانات الافتراضي:

az iot operations dataflow profile show --resource-group <ResourceGroupName> --instance <AioInstanceName> --name default

فيما يلي مثال على الأمر لعرض ملف تعريف تدفق البيانات الافتراضي:

az iot operations dataflow profile show --resource-group myResourceGroup --instance myAioInstance --name default

Bicep

param aioInstanceName string = '<AIO_INSTANCE_NAME>'
param customLocationName string = '<CUSTOM_LOCATION_NAME>'

// Pointer to the Azure IoT Operations instance
resource aioInstance 'Microsoft.IoTOperations/instances@2024-11-01' existing = {
  name: aioInstanceName
}

// Pointer to your custom location where AIO is deployed
resource customLocation 'Microsoft.ExtendedLocation/customLocations@2021-08-31-preview' existing = {
  name: customLocationName
}

// Pointer to the default data flow profile
resource defaultDataflowProfile 'Microsoft.IoTOperations/instances/dataflowProfiles@2024-11-01' = {
  parent: aioInstance
  name: 'default'
  extendedLocation: {
    name: customLocation.id
    type: 'CustomLocation'
  }
  properties: {
    instanceCount: 1
  }
}

Kubernetes (معاينة)

apiVersion: connectivity.iotoperations.azure.com/v1
kind: DataflowProfile
metadata:
  name: default
  namespace: azure-iot-operations
spec:
  instanceCount: 1

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

إنشاء ملف تعريف تدفق بيانات جديد

لإنشاء ملف تعريف تدفق بيانات جديد، حدد اسم ملف التعريف وعدد المثيلات.

هام

يجب أن يتراوح طول اسم ملف تعريف البيانات بين 1 و39 حرفا.

بوابة

1. في مدخل Microsoft Azure، انتقل إلى مثيل عمليات IoT.

2. في الجزء الأيمن ضمن Components، حدد Data flow profiles.

3. حدد + ملف تعريف تدفق البيانات لإنشاء ملف تعريف تدفق بيانات جديد.

4. في جزء إنشاء ملف تعريف تدفق البيانات ، أدخل اسما لملف تعريف تدفق البيانات وقم بتعيين عدد المثيلات. يمكنك أيضا تعيين إعدادات أخرى مثل إعدادات التشخيص.

   

استخدم الأمر az iot operations dataflow profile create لإنشاء ملف تعريف تدفق بيانات جديد:

az iot operations dataflow profile create --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <ProfileName>

فيما يلي مثال على الأمر لإنشاء ملف تعريف تدفق بيانات جديد باسم myDataFlowProfile:

az iot operations dataflow profile create --resource-group myResourceGroup --instance myAioInstance --name myDataFlowProfile

Bicep

resource dataflowProfile 'Microsoft.IoTOperations/instances/dataflowProfiles@2024-11-01' = {
  parent: aioInstance
  name: '<NAME>'
  properties: {
    instanceCount: <COUNT>
  }
}

Kubernetes (معاينة)

apiVersion: connectivity.iotoperations.azure.com/v1
kind: DataflowProfile
metadata:
  name: '<NAME>'
  namespace: azure-iot-operations
spec:
  instanceCount: <COUNT>

تغير الحجم

يمكنك تغيير حجم ملف تعريف تدفق البيانات لضبط عدد المثيلات التي تقوم بتشغيل تدفقات البيانات. بالنسبة لتدفق بيانات معين، يكون عدد المثيلات هو عدد النسخ التي تعمل على نظام المجموعة. يمكن أن تؤدي زيادة عدد المثيلات إلى تحسين معدل نقل تدفقات البيانات عن طريق إنشاء عملاء متعددين لمعالجة البيانات. عند استخدام تدفقات البيانات مع الخدمات السحابية التي لها حدود للمعدل لكل عميل، يمكن أن تساعدك زيادة عدد المثيلات في البقاء ضمن حدود المعدل.

يمكن أن يؤدي التحجيم أيضا إلى تحسين مرونة تدفقات البيانات من خلال توفير التكرار في حالة الفشل.

لتغيير حجم ملف تعريف تدفق البيانات يدويا، حدد عدد المثيلات التي تريد تشغيلها. على سبيل المثال، لتعيين عدد المثيلات إلى 3:

بوابة

1. في مدخل Microsoft Azure، انتقل إلى مثيل عمليات IoT.

2. في الجزء الأيمن ضمن Components، حدد Data flow profiles.

3. حدد ملف تعريف تدفق البيانات الذي تريد تكوينه.

4. استخدم شريط التمرير لتعيين عدد المثيلات.

   

استخدم الأمر az iot operations dataflow profile update لتحديث عدد مثيلات ملف تعريف تدفق البيانات:

az iot operations dataflow profile update --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <ProfileName> --profile-instance <InstanceCount>

فيما يلي مثال على الأمر لتعيين عدد المثيلات إلى ثلاثة لملف تعريف myDataFlowProfileتدفق البيانات :

az iot operations dataflow profile update --resource-group myResourceGroup --instance myAioInstance --name myDataFlowProfile --profile-instances 3

Bicep

properties: {
  instanceCount: 3
}

Kubernetes (معاينة)

spec:
  instanceCount: 3

إعدادات التشخيص

يمكنك تكوين إعدادات تشخيص أخرى لملف تعريف تدفق البيانات مثل مستوى السجل.

في معظم الحالات، تكون الإعدادات الافتراضية كافية. ومع ذلك، يمكنك تجاوز مستوى السجل أو الإعدادات الأخرى لتصحيح الأخطاء.

لمعرفة كيفية تكوين إعدادات التشخيص هذه، راجع ProfileDiagnostics.

بوابة

1. في مدخل Microsoft Azure، انتقل إلى مثيل عمليات IoT.

2. ضمن Components، حدد Data flow profiles.

3. حدد ملف تعريف تدفق البيانات الذي تريد تكوينه.

   

استخدم الأمر az iot operations dataflow profile update لتحديث إعدادات التشخيص لملف تعريف تدفق البيانات:

az iot operations dataflow profile update --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <ProfileName> --log-level <level>

فيما يلي مثال على الأمر لتعيين مستوى السجل إلى debug لملف تعريف myDataFlowProfileتدفق البيانات :

az iot operations dataflow profile update --resource-group myResourceGroup --instance myAioInstance --name myDataFlowProfile --log-level debug

Bicep

resource dataflowProfile 'Microsoft.IoTOperations/instances/dataflowProfiles@2024-11-01' = {
  parent: aioInstance
  name: '<NAME>'
  properties: {
    instanceCount: 1
    diagnostics: {
      {
        logs: {
          level: 'debug'
        }
      }
    }
  }
}

Kubernetes (معاينة)

apiVersion: connectivity.iotoperations.azure.com/v1
kind: DataflowProfile
metadata:
  name: '<NAME>'
  namespace: azure-iot-operations
spec:
  instanceCount: 1
  diagnostics:
    logs:
      level: debug

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

لمعرفة المزيد حول تدفقات البيانات، راجع إنشاء تدفق بيانات.