مشاركة عبر

نظرة عامة على واجهة برمجة تطبيقات Azure Monitor Log Analytics

  • مقالة

واجهة برمجة تطبيقات استعلام تحليلات السجل هي واجهة برمجة تطبيقات REST يمكنك استخدامها للاستعلام عن المجموعة الكاملة من البيانات التي تم جمعها بواسطة سجلات Azure Monitor. يمكنك استخدام نفس لغة الاستعلام المستخدمة في الخدمة. استخدم واجهة برمجة التطبيقات هذه لاسترداد البيانات، وإنشاء مرئيات جديدة لبياناتك، وتوسيع قدرات Log Analytics.

مصادقة واجهة برمجة تطبيقات Log Analytics

يجب المصادقة للوصول إلى واجهة برمجة تطبيقات Log Analytics:

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

مصادقة Microsoft Entra لبيانات مساحة العمل

تدعم واجهة برمجة تطبيقات Log Analytics مصادقة Microsoft Entra مع ثلاثة تدفقات مختلفة من Microsoft Entra ID OAuth2 :

  • التعليمة البرمجية للتخويل
  • ضمني
  • بيانات اعتماد العميل

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

بعد تلقي رمز مميز، تكون عملية استدعاء واجهة برمجة تطبيقات Log Analytics هي نفسها لجميع التدفقات. تتطلب الطلبات العنوان Authorization: Bearer، الذي يتم ملؤه بالرمز المميز المستلم من تدفق OAuth2.

مصادقة مفتاح واجهة برمجة التطبيقات لنموذج البيانات

لاستكشاف واجهة برمجة التطبيقات بسرعة دون استخدام مصادقة Microsoft Entra، نقدم مساحة عمل توضيحية مع بيانات نموذجية. يمكنك المصادقة باستخدام مفتاح API.

إشعار

عند استخدام مصادقة Microsoft Entra، قد يستغرق الأمر ما يصل إلى 60 دقيقة لواجهة برمجة تطبيقات Rest ل Application Insights للتعرف على أذونات التحكم في الوصول الجديدة المستندة إلى الدور. أثناء نشر الأذونات، قد تفشل استدعاءات REST API مع رمز الخطأ 403.

حدود استعلام Log Analytics API

للحصول على معلومات حول حدود الاستعلام، راجع قسم واجهة برمجة تطبيقات الاستعلام في صفحة الويب هذه.

جرب واجهة برمجة تطبيقات Log Analytics

لتجربة واجهة برمجة التطبيقات دون كتابة أي تعليمة برمجية، يمكنك استخدام:

  • عميلك المفضل مثل Bruno أو Insomnia لإنشاء استعلامات يدويا باستخدام واجهة مستخدم.
  • cURL من سطر الأوامر. ثم توجيه الإخراج إلى jsonlint للحصول على JSON قابل للقراءة.

بدلا من استدعاء واجهة برمجة تطبيقات REST مباشرة، يمكنك استخدام مكتبات عميل استعلام Azure Monitor idiomatic:

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