استكشاف مشكلات Azure Managed Grafana وإصلاحها

ترشدك هذه المقالة إلى استكشاف الأخطاء وإصلاحها باستخدام Azure Managed Grafana، وتقترح حلولا لحلها.

يتم عرض تنبيهات الوصول الصحيحة عند إنشاء مساحة العمل

عند إنشاء مساحة عمل Azure Managed Grafana من مدخل Microsoft Azure، يحصل المستخدم على تنبيه في علامة التبويب Basics : قد لا يكون لديك حق وصول كاف مباشرة في أسفل الاشتراك أو مجموعة الموارد لتمكين جميع الميزات، يرجى مراجعة علامة التبويب "Permission" التالية للحصول على التفاصيل.

في علامة التبويب أذونات ، يتم عرض تنبيه آخر: يجب أن تكون "مالك" اشتراك أو "مسؤول وصول المستخدم" لاستخدام هذه الميزة. تم تعطيل عناصر تحكم تعيين الدور.

يتم تشغيل هذه التنبيهات لأن المستخدم ليس مسؤول اشتراك أو مالك وستحدث العواقب التالية عندما يقوم المستخدم بإنشاء مساحة العمل:

• لن يحصل المستخدم على دور "مسؤول Grafana" لمساحة عمل Azure Grafana الجديدة
• لن تحصل الهوية المدارة المعينة من قبل النظام لمساحة عمل Azure Grafana هذه على دور قارئ المراقبة.

الحل 1: المتابعة والحصول على تعليمات المسؤول

تابع إنشاء مساحة عمل Azure Managed Grafana. يجب أن تعرف أنك لن تتمكن من استخدام مساحة عمل Azure Managed Grafana حتى يقوم مسؤول الاشتراك بتعيين دور مسؤول Grafana أو محرر Grafana أو Grafana Viewer.

الحل 2: حدد اشتراكا آخر

يمكن للمستخدم تحديد اشتراك آخر في علامة التبويب Basics . يجب أن يكونوا مسؤولين أو مالكين. ستختفي الشعار.

فشل إنشاء مساحة عمل Azure Managed Grafana

يتم عرض خطأ عندما يقوم المستخدم بإنشاء مساحة عمل Azure Managed Grafana من مدخل Microsoft Azure.

الحل 1: تحرير اسم مساحة العمل

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

أدخل اسما:

• فريد في منطقة Azure بأكملها. لا يمكن استخدامه بالفعل من قبل مستخدم آخر.
• طوله 23 حرفا أو أصغر
• يبدأ بحرف. يمكن أن تكون البقية أحرفا أبجدية رقمية أو واصلات فقط، ويجب أن ينتهي الاسم بحرف أبجدي رقمي.

الحل 2: مراجعة خطأ التوزيع

1. راجع تفاصيل نشر Azure Managed Grafana واقرأ رسالة الحالة.

   

2. نفذ الإجراء التالي، استنادا إلى رسالة الخطأ:

• تشير رسالة الحالة إلى أن المنطقة غير مدعومة وتوفر قائمة بمناطق Azure المدعومة. حاول نشر مساحة عمل Azure Managed Grafana جديدة مرة أخرى. عند محاولة إنشاء مساحة عمل Azure Managed Grafana للمرة الأولى، يقترح مدخل Microsoft Azure مناطق Azure غير المتوفرة. لن يتم عرض هذه المناطق في المحاولة الثانية.

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

  • تعيين دور قارئ المراقبة على مستوى الاشتراك إلى الهوية المدارة لمساحة عمل Azure Managed Grafana
  • تعيين دور مسؤول Grafana لمساحة عمل Azure Managed Grafana الجديدة هذه

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

لا يمكن للمستخدم الوصول إلى واجهة مستخدم Grafana الخاصة به

نجح المستخدم في إنشاء مساحة عمل Azure Managed Grafana ولكن لا يمكنه الوصول إلى واجهة مستخدم Grafana عند فتح عنوان URL لنقطة النهاية.

الحل 1: تحقق من حالة التوفير

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

1. في النظام الأساسي Azure، افتح مساحة العمل الخاصة بك وانتقل إلى صفحة نظرة عامة . تأكد من نجاح حالةالتزويد ومن ملء كافة الحقول الأخرى في قسم Essentials. إذا كان كل شيء يبدو جيدا، فتابع العملية أدناه. وإلا، احذف مساحة عمل وأعد إنشائها.

   

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

3. إذا كان لديك جدار حماية يمنع حركة المرور الصادرة، فاسمح بالوصول إلى مساحة العمل الخاصة بك، إلى عنوان URL الذي ينتهي grafana.azure.com، ومعرف Microsoft Entra.

الحل 2: إصلاح مشكلات دور الوصول

إذا تلقيت صفحة خطأ تفيد "لم يتم تعيين أدوار":

يمكن أن تحدث هذه المشكلة إذا:

1. لم يكن لديك الإذن لإضافة دور مسؤول Grafana لنفسك. راجع عرض تنبيهات Access الصحيحة عند إنشاء مساحة العمل للحصول على مزيد من المعلومات.

2. لقد استخدمت CLI أو قالب ARM أو وسيلة أخرى لإنشاء مساحة عمل ليست مدخل Microsoft Azure. سيقوم مدخل Azure فقط بإضافتك تلقائيا كمسؤول Grafana. في جميع الحالات الأخرى، يجب أن تمنح نفسك يدويا دور مسؤول Grafana.

   1. في مساحة عمل Azure Managed Grafana، حدد Access control (IAM) > Add role assignment لإضافة تعيين الدور هذا. يجب أن يكون لديك دور وصول المسؤول أو المالك للاشتراك أو مورد Azure Managed Grafana لإجراء تعيين الدور هذا. اطلب من المسؤول مساعدتك إذا لم يكن لديك حق وصول كاف.
   2. حسابك هو حساب خارجي: مساحة عمل Azure Managed Grafana غير مسجلة في مستأجر منزلك.
   3. إذا قمت مؤخرا بمعالجة هذه المشكلة وتم تعيين دور Grafana كاف، فقد تحتاج إلى الانتظار لبعض الوقت قبل انتهاء صلاحية ملف تعريف الارتباط وتحديثه. تستغرق هذه العملية عادة 5 دقائق. إذا كنت في شك، فاحذف جميع ملفات تعريف الارتباط أو ابدأ جلسة متصفح خاصة لفرض ملف تعريف ارتباط جديد جديد بمعلومات دور جديدة.

لا يظهر المستخدمون المعتمدون في تكوين مستخدمي Grafana

لا يتم سرد المستخدمين في قائمة مستخدمي واجهة مستخدم Grafana مباشرة بعد إضافتهم إلى دور RBAC المضمن في Grafana، مثل Grafana Viewer. هذا السلوك حسب التصميم. يتم تخزين أدوار Grafana RBAC في معرف Microsoft Entra. لأسباب تتعلق بالأداء، لا تقوم Azure Managed Grafana تلقائيا بمزامنة المستخدمين المعينين للأدوار المضمنة عبر جميع مساحة العمل. لا يوجد إعلام بالتغييرات في تعيينات RBAC والاستعلام عن معرف Microsoft Entra بشكل دوري للحصول على التعيينات الحالية يضيف تحميلا إضافيا إلى خدمة Microsoft Entra.

لا يوجد حل لهذا في حد ذاته. يتم سرد المستخدمين وأدوارهم المعينة فقط في إدارة>المستخدمين والوصول إلى>المستخدمين في واجهة مستخدم Grafana بمجرد تسجيل الدخول إلى مساحة عمل Azure Managed Grafana.

لا تعرض لوحة معلومات Azure Managed Grafana أي بيانات

لا تعرض واحدة أو عدة لوحات لوحة معلومات Azure Managed Grafana أي بيانات.

الحل: مراجعة إعدادات لوحة المعلومات

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

1. تحقق من مدى تكرار تكوين لوحة المعلومات لتحديث البيانات.
   1. في لوحة المعلومات، انتقل إلى إعدادات لوحة المعلومات.
   2. في الإعدادات العامة، خفض معدل التحديث التلقائي للوحة المعلومات ليكون أسرع من الوقت الذي يستغرقه الاستعلام للتحميل.
2. عندما يستغرق الاستعلام وقتا طويلا لاسترداد البيانات. ستخرج Grafana تلقائيا بعض استدعاءات التبعية التي تستغرق وقتا أطول من، على سبيل المثال، 30 ثانية. تحقق من عدم وجود عمليات بطء غير عادية في نهاية الاستعلام.

مشكلات عامة في مصادر البيانات

لا يمكن للمستخدم الاتصال بمصدر بيانات، أو لا يمكن لمصدر بيانات إحضار البيانات.

الحل: مراجعة إعدادات الشبكة وعنوان IP

لاستكشاف هذه المشكلة:

1. تحقق من إعداد الشبكة لخادم مصدر البيانات. يجب ألا يكون هناك جدار حماية يمنع Grafana من الوصول إليه.
2. تحقق من أن مصدر البيانات لا يحاول الاتصال بعنوان IP خاص. لا تدعم Azure Managed Grafana حاليا الاتصالات بالشبكات الخاصة.

لا يمكن ل Azure Monitor إحضار البيانات

تأتي كل مساحة عمل Azure Managed Grafana مكونة مسبقا باستخدام مصدر بيانات Azure Monitor. عند محاولة استخدام لوحة معلومات مسبقة التوفير، يجد المستخدم أن مصدر بيانات Azure Monitor لا يمكنه إحضار البيانات.

الحل: مراجعة إعدادات بيانات Azure Monitor

1. ابحث عن لوحة معلومات تم توفيرها مسبقا عن طريق فتح نقطة نهاية Azure Managed Grafana وتحديد Dashboards>Browse. ثم حدد لوحة معلومات، على سبيل المثال مراقبة تطبيق Azure Monitor>- Application Insights.

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

   

3. في واجهة مستخدم Azure Managed Grafana، حدد Configurations>Data Sources من القائمة اليسرى، وحدد Azure Monitor.

4. إذا تم تكوين مصدر البيانات لاستخدام هوية مدارة:

   1. حدد الزر تحميل الاشتراكات لإجراء اختبار سريع. إذا تم ملء الاشتراك الافتراضي باشتراكك، يمكن ل Azure Managed Grafana الوصول إلى Azure Monitor ضمن هذا الاشتراك. إذا لم يكن الأمر كما هو، فهناك مشكلات في الأذونات.

      

      تحقق مما إذا كان قد تم تمكين هوية مدارة معينة من قبل النظام أو تم تعيينها من قبل المستخدم في مساحة العمل الخاصة بك عن طريق الانتقال إلى الإعدادات>الهوية (معاينة). انتقل إلى إعداد مصادقة Azure Managed Grafana والأذونات لمعرفة كيفية تمكين الهوية المدارة وتكوينها.

   2. بمجرد تحديد اشتراكك، حدد حفظ واختبار. إذا رأيت لم يتم العثور على مساحات عمل Log Analytics، فقد تحتاج إلى تعيين دور القارئ إلى الهوية المدارة في مساحة عمل Log Analytics. افتح مساحة عمل Log Analytics، وانتقل إلى Settings>Access control (IAM)، Add>add role assignment..

5. إذا كان مصدر البيانات يستخدم مصادقة تسجيل التطبيق:

   1. في نقطة نهاية Grafana، انتقل إلى التكوينات > مصادر > البيانات Azure Monitor وتحقق مما إذا كانت معلومات معرف الدليل (المستأجر) ومعرفالتطبيق (العميل) صحيحة.

   2. تحقق مما إذا كان كيان الخدمة لديه دور قارئ المراقبة المعين لمساحة عمل Azure Managed Grafana. إذا لم يكن الأمر كذلك، قم بإضافته من مدخل Microsoft Azure عن طريق فتح اشتراكك في مدخل Microsoft Azure والذهاب إلى التحكم في الوصول (IAM)>إضافة>تعيين دور.

   3. إذا لزم الأمر، أعد تطبيق سر العميل.

      

لا يمكن ل Azure Data Explorer إحضار البيانات

لا يمكن لمصدر بيانات Azure Data Explorer إحضار البيانات.

الحل: مراجعة إعدادات Azure Data Explorer

1. ابحث عن لوحة معلومات تم توفيرها مسبقا عن طريق فتح نقطة نهاية Azure Managed Grafana وتحديد Dashboards>Browse. ثم حدد لوحة معلومات، على سبيل المثال Azure Monitor>Azure Data Explorer Cluster Resource Insights.

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

   

3. تحقق من مصدر بيانات Azure Data Explorer وشاهد كيفية إعداد المصادقة. يمكنك حاليا إعداد المصادقة فقط ل Azure Data Explorer من خلال معرف Microsoft Entra.

4. في نقطة نهاية Grafana، انتقل إلى Configurations > Data Sources > Azure Data Explorer

5. تحقق مما إذا كانت المعلومات المدرجة في سحابة Azure وعنوان URL لنظام المجموعة ومعرف الدليل (المستأجر) ومعرف التطبيق (العميل) وسر العميل صحيحة. إذا لزم الأمر، قم بإنشاء مفتاح جديد لإضافته كبيانات سرية للعميل.

6. في أعلى الصفحة، يمكنك العثور على إرشادات توجهك خلال العملية لمنح الأذونات اللازمة لتطبيق Microsoft Entra هذا لقراءة قاعدة بيانات Azure Data Explorer.

7. تأكد من أن مثيل Azure Data Explorer الخاص بك لا يحتوي على جدار حماية يمنع الوصول إلى Azure Managed Grafana. يجب أن تتعرض قاعدة بيانات Azure Data Explorer للإنترنت العام.

فشل استيراد لوحة المعلومات

يحصل المستخدم على خطأ عند استيراد لوحة معلومات من المعرض أو ملف JSON. تظهر رسالة خطأ: تم تغيير لوحة المعلومات من قبل شخص آخر.

الحل: تحرير اسم لوحة المعلومات أو UID

يحدث هذا الخطأ في معظم الأحيان لأن المستخدم يحاول استيراد لوحة معلومات لها نفس الاسم أو المعرف الفريد (UID) كلوحة معلومات أخرى.

للتحقق مما إذا كانت مساحة عمل Azure Managed Grafana لديك تحتوي بالفعل على لوحة معلومات بنفس الاسم:

1. في نقطة نهاية Grafana، حدد لوحات المعلومات من قائمة التنقل على اليسار ثم استعرض.

2. مراجعة أسماء لوحة المعلومات.

   

3. أعد تسمية لوحة المعلومات القديمة أو الجديدة.

4. يمكنك أيضا تحرير UID للوحة معلومات JSON قبل استيرادها عن طريق تحرير الحقل المسمى uid في ملف JSON.

لا يتغير أي شيء بعد تحديث تعيين دور الهوية المدارة

بعد تعطيل الهوية المدارة المعينة من قبل النظام، لا يزال بإمكان مصدر البيانات الذي تم تكوينه باستخدام الهوية المدارة الوصول إلى البيانات من خدمات Azure.

الحل: انتظر حتى يدخل التغيير حيز التنفيذ

قد لا تزال مصادر البيانات التي تم تكوينها بهوية مدارة قادرة على الوصول إلى البيانات من خدمات Azure لمدة تصل إلى 24 ساعة. عند تحديث تعيين دور في هوية مدارة ل Azure Managed Grafana، قد يستغرق هذا التغيير ما يصل إلى 24 ساعة ليكون فعالا، بسبب قيود الهويات المدارة.

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