المهارات Azure Monitor Query SDK for Python
📦

Azure Monitor Query SDK for Python

آمن 🔑 متغيرات البيئة

استعلام سجلات ومقاييس Azure Monitor باستخدام Python SDK

يكافح المطورون للاستعلام عن بيانات Azure Monitor بكفاءة بدون إرشادات SDK مناسبة. يوفر هذا المهارة أمثلة كود جاهزة للاستخدام لعملاء Log Analytics وMetrics Query مع أنماط المصادقة.

يدعم: Claude Codex Code(CC)
🥉 72 برونزي
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "Azure Monitor Query SDK for Python". استعلام مساحة العمل لأفضل 10 طلبات حسب المدة

النتيجة المتوقعة:

  • كود مُنشأ باستخدام LogsQueryClient مع الاستعلام: AppRequests | top 10 by DurationMs
  • الاستجابة تتكرر عبر الجداول والصفوف لطباعة بيانات الطلب
  • يتضمن timedelta لتكوين نطاق الوقت

استخدام "Azure Monitor Query SDK for Python". الحصول على مقاييس CPU لجهاز افتراضي بفواصل 5 دقائق

النتيجة المتوقعة:

  • كود يستخدم MetricsQueryClient مع URI المورد من البيئة
  • استعلام مقاييس Percentage CPU مع تجميع Average
  • التكرار عبر بيانات السلسلة الزمنية لطباعة الطابع الزمني والقيم

التدقيق الأمني

آمن
v1 • 2/25/2026

This skill contains documentation and code examples for the Azure Monitor Query SDK for Python. Static analysis scanned 0 files with 0 lines of executable code, resulting in a risk score of 0/100. The skill is prompt-only with no executable code, containing reference documentation for querying Log Analytics workspaces and Azure Monitor metrics. Environment variable access is documented for Azure authentication but poses no security risk as these are standard Azure SDK configuration patterns.

0
الملفات التي تم فحصها
0
الأسطر التي تم تحليلها
1
النتائج
1
إجمالي عمليات التدقيق

عوامل الخطر

🔑 متغيرات البيئة (1)
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
50
المجتمع
100
الأمان
74
الامتثال للمواصفات

ماذا يمكنك بناءه

مهندس DevOps لمراقبة صحة التطبيق

استعلام معدلات الطلبات وأخطاءCounts وأوقات الاستجابة من Log Analytics لإنشاء لوحات معلومات وتنبيهات لمراقبة الإنتاج

محلل البيانات للتحقيق في مشاكل الأداء

تشغيل استعلامات Kusto لتحديد الطلبات البطيئة والاستثناءات واختناقات في بيانات أداء التطبيق المخزنة في Azure Monitor

工程师 تحليل استخدام الموارد السحابية

استعلام مقاييس Azure Monitor لتحليل استخدام CPU وحركة مرور الشبكة وأنماط استهلاك الموارد عبر البنية التحتية لـ Azure

جرّب هذه الموجهات

استعلام السجل الأساسي
اكتب استعلام Kusto لحساب AppRequests مجمعة حسب ResultCode خلال الساعة الأخيرة باستخدام LogsQueryClient في Python
استعلام نطاق الوقت
استعلم Log Analytics عن AppExceptions خلال نطاق تاريخ محدد من 1-2 يناير 2024 باستخدام Python مع التعامل الصحيح للمنطقة الزمنية
المقاييس مع التجميعات
استعلم مقاييس Azure Monitor لنسبة CPU مع تجميعات Average وMaximum وMinimum باستخدام MetricsQueryClient بدقة 5 دقائق
استعلام دفعي لمساحات عمل متعددة
تنفيذ استعلامات دفعية عبر مساحات عمل Log Analytics متعددة لاسترداد AppRequests وAppExceptions في وقت واحد، مع التعامل مع النتائج الجزئية والأخطاء بشكل سلس

أفضل الممارسات

  • استخدم DefaultAzureCredential للمصادقة الآمنة التي تدعم أنواع بيانات اعتماد متعددة
  • ضبط نطاقات الوقت والدقة المناسبة لتقليل حجم البيانات وتحسين أداء الاستعلام
  • معالجة النتائج الجزئية والفشل بشكل سلس باستخدام فحوصات LogsQueryStatus

تجنب

  • لا تقم بكتابة معرفات مساحات العمل أو URIs المورد بشكل ثابت - استخدم دائمًا متغيرات البيئة
  • تجنب الاستعلام بدون حدود زمنية لأنه قد يُرجع بيانات مفرطة ويتكبد تكاليف عالية
  • لا تتجاهل النتائج الجزئية - تحقق دائمًا من LogsQueryStatus قبل معالجة الاستجابة

الأسئلة المتكررة

ما هي صلاحيات Azure التي أحتاجها للاستعلام عن Log Analytics؟
تحتاج دور Log Analytics Reader على مساحة العمل أو صلاحيات أعلى. للمقاييس، تحتاج وصول Reader إلى المورد.
كيف أقوم بالمصادقة مع Azure Monitor Query SDK؟
استخدم DefaultAzureCredential التي تحاول تلقائيًا طرق مصادقة متعددة بما في ذلك الهوية المُدارة وAzure CLI وبيانات اعتماد البيئة.
ما هي تكلفة الاستعلام عن Log Analytics؟
يحسب Log Analytics لكل جيجابايت من البيانات الممسوحة ضوئيًا. قم بتحسين الاستعلامات باستخدام نطاقات الوقت والمرشحات والإسقاط لتقليل التكاليف.
هل يمكنني الاستعلام عن مساحات عمل متعددة في طلب واحد؟
نعم، استخدم ميزة الاستعلام الدفعي مع كائنات LogsBatchQuery لتشغيل استعلامات متعددة بكفاءة في استدعاء API واحد.
ما هي تنسيقات الوقت التي يقبلها SDK؟
استخدم timedelta في Python لل أوقات النسبية (مثال: آخر ساعة) أو كائنات datetime مع معلومات المنطقة الزمنية لنطاقات الوقت المطلقة.
كيف أتعامل مع العمليات غير المتزامنة مع SDK؟
استخدم عملاء وحدة aio (LogsQueryClient, MetricsQueryClient) مع صيغة async/await وتذكر إغلاق العملاء وبيانات الاعتماد.

تفاصيل المطور

بنية الملفات

📄 SKILL.md