مشاركة عبر

قراءة بيانات التطبيق في الوقت الحقيقي باستخدام لوحة معلومات .NET Aspire في Azure Container Apps (معاينة)

  • مقالة

تعرض لوحة معلومات .NET Aspire بيانات مباشرة حول كيفية تشغيل التطبيقات والموارد الأخرى داخل بيئة.

الصورة التالية هي لقطة شاشة لمرئيات التتبع التي تم إنشاؤها بواسطة لوحة معلومات .NET Aspire.

لقطة شاشة لنافذة تتبع لوحة معلومات .NET Aspire.

تأتي المعلومات المعروضة على لوحة المعلومات من مصدرين:

  • OpenTelemetry (OTel)، وهي مكتبة مفتوحة المصدر لتتبع التتبعات والمقاييس والسجلات لتطبيقاتك. توفر هذه الوثائق المزيد من المعلومات حول كيفية تكامل لوحة معلومات Aspire مع OTel.

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

  • توفر واجهة برمجة تطبيقات Kubernetes معلومات حول جرابات Kubernetes الأساسية التي يعمل عليها تطبيقك وسجلاتها.

يتم تأمين لوحة المعلومات ضد الوصول غير المصرح به والتعديل. لاستخدام لوحة المعلومات، يجب أن يكون لدى المستخدم أذونات "كتابة" أو أعلى - بمعنى آخر، يجب أن يكون مساهما أو مالكا على البيئة.

قم بتمكين لوحة القيادة

تلميح

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

يمكنك تمكين لوحة معلومات .NET Aspire على أي تطبيق حاوية موجود باستخدام الخطوات التالية.

  1. انتقل إلى مدخل Azure.

  2. استعرض للوصول إلى تطبيق الحاوية.

  3. في صفحة Overview ، ابحث عن تسمية .NET Aspire Dashboard ، وحدد enable. يفتح هذا الإجراء صفحة إعدادات لوحة معلومات .NET Aspire.

  4. في صفحة الإعدادات، بجوار تسمية .NET Aspire Dashboard ، حدد خانة الاختيار Enabled . يمكنك تجاهل الإعدادات الأخرى في هذه الصفحة، لأنها تتعلق بالتسجيل بدلا من لوحة معلومات .NET Aspire.

  5. في صفحة Overview لتطبيق الحاوية، ابحث عن تسمية .NET Aspire Dashboard . تم استبدال ارتباط التمكين بارتباط Open dashboard. حدد هذا الارتباط. قد تحتاج إلى إعادة تحميل صفحة نظرة عامة حتى يظهر الارتباط.

يمكنك أيضا العثور على إعدادات لوحة معلومات .NET Aspire من خلال الاستعراض إلى بيئة Container Apps وتحديد خيارات Monitoring>Logging.

يمكنك تمكين لوحة معلومات .NET Aspire على أي بيئة تطبيق حاوية موجودة باستخدام الأوامر التالية. <PLACEHOLDERS> استبدل بقيمك.

az containerapp env dotnet-component create \
  --environment <ENVIRONMENT_NAME> \
  --name aspire-dashboard \
  --resource-group <RESOURCE_GROUP_NAME>

يقوم create الأمر بإرجاع عنوان URL للوحة المعلومات الذي يمكنك فتحه في مستعرض.

يمكنك تمكين لوحة معلومات .NET Aspire على أي تطبيق حاوية موجود باستخدام الخطوات التالية.

dotnet new aspire-starter
azd init --location westus2
azd config set aspire.dashboard on
azd up

يقوم up الأمر بإرجاع عنوان URL للوحة المعلومات الذي يمكنك فتحه في مستعرض.

استكشاف الأخطاء وإصلاحها

راجع العناصر التالية إذا كانت لديك مشكلات في تمكين لوحة المعلومات:

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

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

  • قد تتلقى خطأ مصادقة عند الوصول إلى لوحة المعلومات التي تنص على" تعذر مصادقة المستخدم مع المورد المطلوب."

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

    • انتقل إلى المورد:
      • افتح مدخل Azure وابحث عن بيئة تطبيق الحاوية.
    • الوصول إلى شفرة التحكم بالوصول (IAM):
      • انقر فوق Access Control (IAM) لبيئة تطبيق الحاوية.
    • تحقق من تعيينات الأدوار الموجودة:
      • تحقق مما إذا تم تعيين أي أدوار لك (أو حسابك). لاحظ أن الأذونات لا تنتشر حاليا من خلال مجموعات الأمان.
      • إذا لم تكن أنت، فاتبع الخطوات المتبقية لتعيين الدور.
    • تعيين دور صريح: - انقر فوق إضافة > إضافة تعيين دور. - اختر الدور: إما المساهم أو المالك، حسب الاقتضاء لمستوى الوصول المطلوب. - قم بتعيين الدور بشكل صريح إلى حساب المستخدم الخاص بك (على سبيل المثال، youremail@domain.com).
    • حفظ وتأكيد:
      • ا‏‏حفظ التغييرات. تأكد من أن الدور مرئي ضمن قسم Role Assignments.
    • تحقق من الوصول إلى لوحة المعلومات:
      • اختبر عن طريق محاولة الوصول إلى لوحة معلومات Aspire. إذا استمر ظهور الخطأ، فالرجاء التواصل مع فريقنا.

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

نظرة عامة على لوحة معلومات .NET Aspire