البرنامج التعليمي: استدعاء واجهات برمجة تطبيقات Grafana برمجيا

في هذا البرنامج التعليمي، تتعلم كيفية:

• تعيين دور Azure Managed Grafana إلى كيان الخدمة للتطبيق الخاص بك
• استرداد تفاصيل التطبيق
• طلب رمز مميز للوصول
• استدعاء واجهات برمجة تطبيقات Grafana

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

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

تسجيل الدخول إلى Azure

سجل الدخول إلى مدخل Microsoft Azure على https://portal.azure.com/ باستخدام بيانات حساب Azure.

تعيين دور Azure Managed Grafana إلى كيان الخدمة للتطبيق الخاص بك

1. في مدخل Microsoft Azure، افتح مثيل Grafana المدار.

2. حدد Access control (IAM) في قائمة التنقل.

3. حدد إضافة، ثم إضافة تعيين دور.

4. حدد دور محرر Grafana ثم التالي.

5. ضمن تعيين الوصول إلى، حدد المستخدم أو المجموعة أو كيان الخدمة.

6. حدد Select members، وحدد كيان الخدمة، واضغط على Select.

7. حدد مراجعة + تعيين.

   

استرداد تفاصيل التطبيق

تحتاج الآن إلى جمع بعض المعلومات، والتي ستستخدمها للحصول على رمز مميز للوصول إلى واجهة برمجة تطبيقات Grafana، واستدعاء واجهات برمجة تطبيقات Grafana.

1. ابحث عن معرف المستأجر الخاص بك:

   1. في مدخل Microsoft Azure، أدخل معرف Microsoft Entra في البحث عن الموارد والخدمات والمستندات (G+ /).
   2. حدد معرف Microsoft Entra.
   3. حدد Properties من القائمة اليسرى.
   4. حدد موقع الحقل Tenant ID واحفظ قيمته.

   

2. ابحث عن معرف العميل الخاص بك:

   1. في مدخل Microsoft Azure، في Microsoft Entra ID، حدد App registrations من القائمة اليسرى.
   2. حدد تطبيقك.
   3. في نظرة عامة، ابحث عن حقل معرف التطبيق (العميل) واحفظ قيمته.

   

3. إنشاء سر تطبيق:

   1. في مدخل Microsoft Azure، في Microsoft Entra ID، حدد App registrations من القائمة اليسرى.
   2. حدد تطبيقك.
   3. حدد Certificates & secrets من القائمة اليسرى.
   4. حدد سر عميل جديد.
   5. إنشاء سر عميل جديد وحفظ قيمته.

   

   إشعار

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

4. ابحث عن عنوان URL لنقطة نهاية Grafana:

   1. في مدخل Microsoft Azure، أدخل Azure Managed Grafana في شريط البحث عن الموارد والخدمات والمستندات (G+ / ).
   2. حدد Azure Managed Grafana وافتح مساحة عمل Grafana المدارة.
   3. حدد نظرة عامة من القائمة اليسرى واحفظ قيمة نقطة النهاية.

   

طلب رمز مميز للوصول

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

Azure CLI

سجل الدخول إلى Azure CLI عن طريق تشغيل أمر تسجيل الدخول az واستبدل <client-id><client-secret>و و <tenant-id> بمعرف التطبيق (العميل) وسر العميل ومعرف المستأجر الذي تم جمعه في الخطوة السابقة:

az login --service-principal --username "<client-id>" --password "<client-secret>" --tenant "<tenant-id>"

استخدم الأمر az grafana api-key create لإنشاء مفتاح. فيما يلي مثال على ذلك:

az grafana api-key create --key keyname --name <name> --resource-group <rg> --role editor --output json

{
  "id": 3,
  "key": "<redacted>",
  "name": "keyname"
}

إشعار

يمكنك عرض هذا المفتاح هنا مرة واحدة فقط. احفظه في مكان آمن.

طلب POST

اتبع المثال أدناه لاستدعاء معرف Microsoft Entra واسترداد رمز مميز. استبدل <tenant-id>و <client-id>و <client-secret> بمعرف المستأجر ومعرف التطبيق (العميل) وسر العميل الذي تم جمعه في الخطوة السابقة.

curl -X POST -H 'Content-Type: application/x-www-form-urlencoded' \
-d 'grant_type=client_credentials&client_id=<client-id>&client_secret=<client-secret>&resource=ce34e7e5-485f-4d76-964f-b3d2b16d1e4f' \
https://login.microsoftonline.com/<tenant-id>/oauth2/token

فيما يلي مثال على الاستجابة:

{
  "token_type": "Bearer",
  "expires_in": "599",
  "ext_expires_in": "599",
  "expires_on": "1575500555",
  "not_before": "1575499766",
  "resource": "ce34...1e4f",
  "access_token": "eyJ0eXAiOiJ......AARUQ"
}

استدعاء واجهات برمجة تطبيقات Grafana

يمكنك الآن استدعاء واجهات برمجة تطبيقات Grafana باستخدام رمز الوصول الذي تم استرداده في الخطوة السابقة كعنوان التخويل. على سبيل المثال:

curl -X GET \
-H 'Authorization: Bearer <access-token>' \
https://<grafana-url>/api/user

استبدل <access-token> و <grafana-url> برمز الوصول الذي تم استرداده في الخطوة السابقة وعنوان URL لنقطة النهاية لمثيل Grafana الخاص بك. على سبيل المثالhttps://my-grafana-abcd.cuse.grafana.azure.com.

تنظيف الموارد

إذا كنت لن تستمر في استخدام هذه الموارد، فاحذفها بالخطوات التالية:

1. حذف Azure Managed Grafana:

   1. في مدخل Microsoft Azure، في Azure Managed Grafana، حدد Overview من القائمة اليسرى.
   2. حدد حذف.
   3. أدخل اسم المورد لتأكيد الحذف وحدد حذف.

2. حذف تطبيق Microsoft Entra:

   1. في مدخل Microsoft Azure، في Microsoft Entra ID، حدد App registrations من القائمة اليسرى.
   2. حدد تطبيقك.
   3. في علامة التبويب نظرة عامة ، حدد حذف.
   4. حدد حذف.

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

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