Azure Monitor OpenTelemetry Distro for Python
تكوين Azure Monitor OpenTelemetry لـ Python
يتطلب إعداد مراقبة التطبيق في Azure فهم سلاسل الاتصال والقياس التلقائي للبيانات وتكوين القياس عن بعد. يوفر هذا الملف جاهز للاستخدام مقتطفات الكود وأفضل الممارسات لإضافة مراقبة Application Insights إلى تطبيقات Python بأقل قدر من التغييرات في الكود.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "Azure Monitor OpenTelemetry Distro for Python". كيف أضيف Azure Monitor إلى تطبيق FastAPI Python الخاص بي؟
النتيجة المتوقعة:
أضف Azure Monitor OpenTelemetry إلى تطبيق FastAPI الخاص بك في خطوتين فقط:
1. ثبت الحزمة:
pip install azure-monitor-opentelemetry
2. أضف هذا في أعلى ملف main.py الخاص بك:
from azure.monitor.opentelemetry import configure_azure_monitor
configure_azure_monitor()
هذا يقوم بقياس FastAPI وطلبات HTTP والمكتبات الشائعة تلقائيًا. سيرسل تطبيقك الآن عمليات التتبع والقياسات والسجلات إلى Application Insights.
استخدام "Azure Monitor OpenTelemetry Distro for Python". أظهر لي كيفية تتبع حدث عمل مخصص
النتيجة المتوقعة:
يمكنك إضافة عمليات تتبع مخصصة مع السمات لتتبع أحداث العمل:
from opentelemetry import trace
tracer = trace.get_tracer(__name__)
with tracer.start_as_current_span("checkout_processed") as span:
span.set_attribute("order.total", 99.99)
span.set_attribute("customer.tier", "premium")
span.set_attribute("items.count", 3)
هذا ينشئ نطاقًا في Application Insights مع بيانات العمل المخصصة الخاصة بك، مما يمكّنك من التصفية والتحليل حسب هذه السمات في استعلاماتك.
التدقيق الأمني
آمنThis is a prompt-only documentation skill with no executable code. The static analyzer detected no suspicious patterns. The skill provides reference documentation for the Azure Monitor OpenTelemetry Python package - a legitimate Microsoft monitoring library. No security risks identified.
درجة الجودة
ماذا يمكنك بناءه
إضافة المراقبة إلى تطبيق Flask ويب
إضافة سريعة لبيانات Application Insights التelemetry إلى واجهة Flask API الموجودة مع القياس التلقائي لطلبات HTTP والاستثناءات
إعداد المراقبة الإنتاجية مع مصادقة AAD
تكوين Azure Monitor مع مصادقة Azure Active Directory بدلاً من مفاتيح القياس للنشر الإنتاجي الآمن
إضافة مقاييس العمل المخصصة إلى Application Insights
إنشاء عدادات ومقاييس وسمات تتبع مخصصة لمراقبة أحداث العمل المحددة جنبًا إلى جنب مع البيانات التelemetry المجمعة تلقائيًا
جرّب هذه الموجهات
أظهر لي كيفية إضافة Azure Monitor OpenTelemetry إلى تطبيق Python الخاص بي ببضع أسطر فقط من الكود.
كيف أقوم بتكوين Azure Monitor OpenTelemetry لتطبيق Flask؟ أظهر لي الإعداد الكامل بما في ذلك الاستيرادات والتهيئة.
أظهر لي كيفية إضافة عمليات تتبع مخصصة مع سمات مخصصة ومقاييس مخصصة إلى Application Insights باستخدام OpenTelemetry.
ما هي أفضل الممارسات لتكوين Azure Monitor في الإنتاج باستخدام مصادقة Azure AD بدلاً من سلاسل الاتصال؟
أفضل الممارسات
- استدعِ configure_azure_monitor() قبل استيراد أي مكتبات مقاسة لضمان تحميل القياس التلقائي بشكل صحيح
- استخدم متغيرات البيئة لس سلاسل الاتصال في الإنتاج بدلاً من كتابتها بشكل ثابت في ملفات المصدر
- عيّن اسم دور السحابة عبر معلمة resource لتحديد خدمتك بشكل صحيح في خريطة التطبيق
تجنب
- استدعاء configure_azure_monitor() بعد استيراد المكتبات المقاسة - هذا يكسر القياس التلقائي
- كتابة سلاسل الاتصال الثابتة مع مفاتيح القياس في الكود المصدري - استخدم متغيرات البيئة بدلاً من ذلك
- تمكين جميع القياسات في بيئات الذاكرة المنخفضة - فعّل فقط الأطر التي تستخدمها بشكل انتقائي