تلقي بيانات تتبع الاستخدام للهوائي في الوقت الحقيقي

تنبعث من المحطة الأرضية المدارة Azure أحداث القياس عن بعد للهوائيات التي يمكن استخدامها لتحليل عملية المحطة الأرضية أثناء الاتصال. يمكنك تكوين ملف تعريف جهة الاتصال لإرسال أحداث بيانات تتبع الاستخدام إلى Azure Event Hubs.

سوف تتعلم في هذا الدليل الإرشادي كيفية:

• تكوين Azure Event Hubs لمحطة Azure Orbital الأرضية
• تمكين بيانات تتبع الاستخدام في ملف تعريف جهة الاتصال.
• التحقق من محتوى بيانات تتبع الاستخدام
• فهم نقاط بيانات تتبع الاستخدام

تكوين مراكز الأحداث

1. في اشتراكك، انتقل إلى موفري الموارد في الإعدادات. ابحث عن Microsoft.Orbital وسجله كموفر.
2. إنشاء مساحة اسم Azure Event Hubs ومركز أحداث في اشتراكك.

إشعار

اختر الوصول العام للوصول إلى الاتصال ب Eventhubs. الوصول الخاص أو نقاط نهاية الخدمة غير مدعومة.

3. من القائمة اليسرى، حدد Access control (IAM). ضمن "منح حق الوصول إلى هذا المورد"، حدد إضافة تعيين دور.

إشعار

لتعيين أدوار Azure، يجب أن يكون لديك: Microsoft.Authorization/roleAssignments/write أذونات، مثل وصول المستخدم مسؤول istrator أو المالك

4. ضمن علامة التبويب Role، ابحث عن Azure Event Hubs Data Sender وحدده. انقر فوق التالي.
5. ضمن علامة التبويب الأعضاء، قم بتعيين الوصول إلى المستخدم أو المجموعة أو كيان الخدمة.
6. انقر فوق + Select members.
7. ابحث عن Azure Orbital Resource Provider وانقر فوق Select.
8. انقر فوق مراجعة + تعيين. يمنح هذا الإجراء Azure Orbital Ground Station حقوق إرسال بيانات تتبع الاستخدام إلى مركز الأحداث الخاص بك.
9. لتأكيد تعيين الدور المضاف حديثا، ارجع إلى صفحة التحكم في الوصول (IAM) وحدد عرض الوصول إلى هذا المورد. يجب أن يكون موفر موارد Azure Orbital ضمن Azure Event Hubs Data Sender.

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

تكوين ملف تعريف جهة اتصال كما يلي:

1. اختر مساحة اسم باستخدام القائمة المنسدلة Event Hubs Namespace.
2. اختر مثيلا باستخدام القائمة المنسدلة Event Hubs Instance التي تظهر بعد تحديد مساحة الاسم.

يمكنك تحديث إعدادات ملف تعريف جهة اتصال موجود من خلال

التحقق من بيانات تتبع استخدام الهوائيات من جهة اتصال

جدولة جهات الاتصال باستخدام ملف تعريف جهة الاتصال الذي قمت بتكوينه مسبقا لبيانات تتبع الاستخدام لمراكز الأحداث. بمجرد بدء جهة اتصال، يجب أن تبدأ في رؤية البيانات في مراكز الأحداث الخاصة بك بعد وقت قصير.

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

لوحة معلومات مساحة اسم مراكز الأحداث

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

تسليم بيانات تتبع استخدام الهوائي إلى حساب تخزين

يمكنك تمكين ميزة التقاط مراكز الأحداث لتسليم بيانات تتبع الاستخدام تلقائيا إلى حساب تخزين Azure Blob من اختيارك. اتبع الإرشادات لتمكين التقاط البيانات والتقاطها إلى تخزين Azure. بمجرد التمكين، يمكنك التحقق من الحاوية وعرض/تنزيل البيانات.

فهم نقاط بيانات تتبع الاستخدام

إصدار مخطط بيانات تتبع الاستخدام الحالي: 4.1

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

{
  "namespace": "EventSchema",
  "name": "TelemetryEventSchema",
  "type": "record",
  "fields": [
    {
      "name": "version",
      "type": [ "null", "string" ]
    },
    {
      "name": "contactId",
      "type": [ "null", "string" ]
    },
    {
      "name": "contactPlatformIdentifier",
      "type": [ "null", "string" ]
    },
    {
      "name": "groundStationName",
      "type": [ "null", "string" ]
    },
    {
      "name": "antennaType",
      "type": {
        "name": "antennaTypeEnum",
        "type": "enum",
        "symbols": [
          "Microsoft",
          "KSAT"
        ]
      }
    },
    {
      "name": "antennaId",
      "type": [ "null", "string" ]
    },
    {
      "name": "spacecraftName",
      "type": [ "null", "string" ]
    },
    {
      "name": "gpsTime",
      "type": [ "null", "double" ]
    },
    {
      "name": "utcTime",
      "type": "string"
    },
    {
      "name": "azimuthDecimalDegrees",
      "type": [ "null", "double" ]
    },
    {
      "name": "elevationDecimalDegrees",
      "type": [ "null", "double" ]
    },
    {
      "name": "contactTleLine1",
      "type": [ "null", "string" ]
    },
    {
      "name": "contactTleLine2",
      "type": [ "null", "string" ]
    },
    {
      "name": "links",
      "type": [
        "null",
        {
          "type": "array",
          "items": {
            "name": "antennaLink",
            "type": "record",
            "fields": [
              {
                "name": "name",
                "type": [ "null", "string" ]
              },
              {
                "name": "direction",
                "type": {
                  "name": "directionEnum",
                  "type": "enum",
                  "symbols": [
                    "Uplink",
                    "Downlink"
                  ]
                }
              },
              {
                "name": "polarization",
                "type": {
                  "name": "polarizationEnum",
                  "type": "enum",
                  "symbols": [
                    "RHCP",
                    "LHCP",
                    "linearVertical",
                    "linearHorizontal"
                  ]
                }
              },
              {
                "name": "uplinkEnabled",
                "type": [ "null", "boolean" ]
              },
              {
                "name": "channels",
                "type": [
                  "null",
                  {
                    "type": "array",
                    "items": {
                      "name": "antennaLinkChannel",
                      "type": "record",
                      "fields": [
                        {
                          "name": "name",
                          "type": [ "null", "string" ]
                        },
                        {
                          "name": "modemName",
                          "type": [ "null", "string" ]
                        },
                        {
                          "name": "digitizerName",
                          "type": [ "null", "string" ]
                        },
                        {
                          "name": "endpointName",
                          "type": "string"
                        },
                        {
                          "name": "inputEbN0InDb",
                          "type": [ "null", "double" ]
                        },
                        {
                          "name": "inputEsN0InDb",
                          "type": [ "null", "double" ]
                        },
                        {
                          "name": "inputRfPowerDbm",
                          "type": [ "null", "double" ]
                        },
                        {
                          "name": "outputRfPowerDbm",
                          "type": [ "null", "double" ]
                        },
                        {
                          "name": "packetRate",
                          "type": [ "null", "double" ]
                        },
                        {
                          "name": "gapCount",
                          "type": [ "null", "double" ]
                        },
                        {
                          "name": "modemLockStatus",
                          "type": [
                            "null",
                            {
                              "name": "modemLockStatusEnum",
                              "type": "enum",
                              "symbols": [
                                "Unlocked",
                                "Locked"
                              ]
                            }
                          ]
                        },
                        {
                          "name": "commandsSent",
                          "type": [ "null", "double" ]
                        }
                      ]
                    }
                  }
                ]
              }
            ]
          }
        }
      ]
    }
  ]
}

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

نقطة بيانات تتبع الاستخدام	جهاز/نقطة المصدر	القيم المحتملة	التعريف
إصدار	تعيين يدويا داخليا		إصدار بيانات تتبع الاستخدام
معرف جهة الاتصال	مورد جهة الاتصال		رقم تعريف جهة الاتصال
contactPlatformIdentifier	مورد جهة الاتصال
اسم محطة أرضية	مورد جهة الاتصال		اسم محطة أرضية
نوع الهوائي	يقوم منشئو بيانات تتبع الاستخدام المعنيون من Microsoft / الشريك بتعيين هذه القيمة	MICROSOFT، KSAT، VIASAT	شبكة الهوائيات المستخدمة لجهة الاتصال.
معرف الهوائي	مورد جهة الاتصال		اسم معرف الهوائي القابل للقراءة من قبل الإنسان
اسم المركبة الفضائية	تم تحليله من معرف النظام الأساسي لجهة الاتصال		اسم المركبة الفضائية
gpsTime	تغطية utcTime		الوقت في وقت GPS الذي تم فيه إنشاء رسالة بيانات تتبع الاستخدام للعميل.
utcTime	الوقت الحالي		الوقت بالتوقيت العالمي المتفق عليه الذي تم فيه إنشاء رسالة بيانات تتبع الاستخدام للعميل.
azimuthDecimalDegrees	ACU: هوائيزيموث		كثخينة الهوائي بالدرجات العشرية.
الارتفاعDecimalDegrees	ACU: ترقيم الهوائيات		ارتفاع الهوائي بالدرجات العشرية.
contactTleLine1	ACU: Satellite[0]. Model.Value	سلسلة TLE السطر 1	السطر الأول من TLE المستخدم لجهة الاتصال.
contactTLeLine2	ACU: Satellite[0]. Model.Value	سلسلة TLE السطر 2	السطر الثاني من TLE المستخدم لجهة الاتصال.
الاسم [مستوى الارتباط]	ارتباط ملف تعريف جهة الاتصال		اسم الارتباط
اتجاه	ارتباط ملف تعريف جهة الاتصال	ارتباط لأعلى، ارتباط لأسفل	اتجاه الارتباط المستخدم لجهة الاتصال.
الاستقطاب	ارتباط ملف تعريف جهة الاتصال	RHCP، LHCP، DualRhcpLhcp، LinearVertical، LinearHorizontal	استقطاب الارتباط المستخدم لجهة الاتصال.
uplinkEnabled	ACU: SBandCurrent أو UHFTotalCurrent	• NULL (اتجاه CenterFrequencyMhz أو Downlink غير صالح) • خطأ (نطاقات أخرى غير S و UHF أو Amp Current < Threshold) • True (S/UHF-band, Uplink, Amp Current > Threshold)	يشير إلى ما إذا كان قد تم تمكين ارتباط لأعلى لجهة الاتصال.
الاسم [مستوى القناة]	قناة ارتباط ملف تعريف جهة الاتصال		اسم القناة
اسم المودم	المودم		اسم جهاز المودم
اسم الرقم الرقمي	رقم رقمي		اسم جهاز المحول الرقمي
endpointName	قناة ارتباط ملف تعريف جهة الاتصال		اسم نقطة النهاية المستخدمة لجهة الاتصال.
inputEbN0InDb	مودم: مقيسEbN0	• NULL (طراز مودم غير QRadio أو QRx) • مزدوج: إدخال EbN0	إدخال الطاقة لكل بت لكثافة الضوضاء الطيفية للطاقة في dB.
inputEsN0InDb	المودم: مقاسEsN0	• NULL (طراز مودم غير QRx) • مزدوج: إدخال EsN0	إدخال الطاقة لكل رمز لكثافة الضوضاء الطيفية للطاقة في dB.
inputRfPowerDbm	Digitizer: inputRfPower	• NULL (برنامج تشغيل Uplink أو Digitizer بخلاف SNNB أو SNWB) • مزدوج: إدخال طاقة Rf	إدخال طاقة RF في dBm.
outputRfPowerDbm	رقمنة: outputRfPower	• NULL (برنامج تشغيل Downlink أو Digitizer بخلاف SNNB أو SNWB) • مزدوج: إخراج طاقة Rf	طاقة Ouput RF في dBm.
outputPacketRate	رقمنة: rfOutputStream[0].measuredPacketRate	• NULL (برنامج تشغيل Downlink أو Digitizer بخلاف SNNB أو SNWB) • مزدوج: معدل حزمة الإخراج	معدل الحزمة المقاسة للارتباط الصاعد
عدد التباعد	رقمنة: rfOutputStream[0].gapCount	• NULL (برنامج تشغيل Downlink أو Digitizer بخلاف SNNB أو SNWB) • مزدوج: عدد الثغرات	عدد فجوات الحزمة للارتباط الصاعد
modemLockStatus	المودم: carrierLockState	• NULL (طراز مودم غير QRadio أو QRx؛ تعذر تحليل قائمة تعداد حالة التأمين) • سلسلة فارغة (إذا كانت قراءة القياس فارغة) • سلسلة: حالة التأمين	تأكيد تأمين المودم.
commandsSent	Modem: commandsSent	• NULL (إن لم يكن Uplink وQRadio) • مزدوج: # من الأوامر المرسلة	تأكيد إرسال الأوامر أثناء جهة الاتصال.

مستهلكو الأحداث

يمكنك كتابة تطبيقات المستهلكين البسيطة لتلقي الأحداث من مراكز الأحداث باستخدام مستهلكي الأحداث. راجع الوثائق التالية لمعرفة كيفية إرسال واستقبال الأحداث مراكز الأحداث بلغات مختلفة:

• Python
• NET.
• Java
• جافا سكريبت

سجل التغيير

2024-04-17 - تم تحديث المخطط لتضمين NULL المحتمل ل TLEs، وإضافة EsN0 ل QRX، وإضافة تمويه حول كيفية وجود NULL في هوائيات Microsoft لحقل خلال الثانية الأولى من جهة الاتصال. 2023-10-03 - تقديم الإصدار 4.0. مخطط محدث ليتضمن مقاييس حزمة الربط الأعلى وأسماء البنية الأساسية المستخدمة (المحطة الأرضية، والهوائي، والمركبة الفضائية، والمودم، والمرقمن، والارتباط، والقناة)
2023-06-05 - مخطط محدث لإظهار المقاييس ضمن القنوات بدلا من الارتباطات.

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

• مراكز الأحداث باستخدام Python Getting Started
• مكتبة عميل Azure Event Hubs لعينات التعليمات البرمجية ل Python