تعمل تطبيقاتك على أجهزة افتراضية وApp Service وAzure Database، وتبدأ كل حادثة بزيارة إلى Azure Monitor قبل فتح Dynatrace. ربط Dynatrace Azure باشتراكاتك يُصعِّد مقاييس Azure Monitor وسجلات الموارد إلى المنصة نفسها التي تضم تتبعاتك وأهداف مستوى الخدمة (SLO).
بالنسبة إلى فريق المناوبة يُقاس المكسب بالدقائق: حين تبلغ قاعدة Azure SQL سقف DTU، يجب أن تظهر المعلومة إلى جانب الخدمة التي تتباطأ، لا في بوابة منفصلة. تنقلات أقل، وعمل متكرر (toil) أقل، ومتوسط زمن إصلاح (MTTR) أقصر.
هدف هذا الدليل: إنشاء service principal للقراءة فقط، وربط اشتراك، ثم نقل سجلات Azure عبر Event Hub، والتحقق من كل ذلك بـ DQL. المحتوى صالح لـ Dynatrace SaaS وDynatrace Managed؛ وتُذكر الفروق.
تدفقا تكامل Dynatrace Azure
كما في السحب الأخرى، توجد آليتان مستقلتان:
- المقاييس والبيانات الوصفية (pull): يستعلم Dynatrace من API الخاص بـ Azure Monitor بهوية service principal يحمل الدور المدمج Monitoring Reader.
- السجلات (push): ترسل إعدادات التشخيص (diagnostic settings) للموارد سجلاتها إلى Event Hub؛ ثم يقرأ ناقل سجلات (log forwarder) هذا الـ Event Hub ويدفع إلى API استيعاب السجلات في Dynatrace.
مشكلة في دور RBAC لا تمنع وصول السجلات، وEvent Hub سيئ الإعداد لا يؤثر في المقاييس. شخّص التدفقين دائمًا كلًّا على حدة.
المتطلبات
- Azure CLI (
az) متصل بحساب مخوَّل بإنشاء تسجيل تطبيق (app registration) وإسناد أدوار على الاشتراك. - صلاحية تعديل إعدادات بيئة Dynatrace.
- رمز API في Dynatrace بنطاق استيعاب السجلات (
logs.ingest) للناقل. - مساحة أسماء Event Hub في منطقة الموارد المراد مراقبتها.
- في Managed: ActiveGate يصل إلى API الخاص بـ Azure وإلى عنقودك؛ وهو من يستعلم من Azure Monitor.
الخطوة 1: إنشاء service principal
أنشئ تسجيل تطبيق وservice principal الخاص به مع سر عميل (client secret):
az ad sp create-for-rbac \
--name "dynatrace-monitoring" \
--query "{CLIENT_ID:appId, TENANT_ID:tenant, CLIENT_SECRET:password}" \
--output table
دوّن القيم الثلاث فورًا: فلن يُعرض السر مرة أخرى. احفظه في خزنة أسرارك لا في تذكرة.
الخطوة 2: إسناد دور Monitoring Reader
استرجع معرّف كائن (object ID) الـ principal، ثم أسند الدور على مستوى الاشتراك:
OBJECT_ID=$(az ad sp list --display-name "dynatrace-monitoring" --query "[0].id" -o tsv)
az role assignment create \
--assignee-object-id "$OBJECT_ID" \
--role "Monitoring Reader" \
--scope "/subscriptions/<subscription-id>" \
--assignee-principal-type ServicePrincipal \
--description "Dynatrace Monitoring"
يمنح Monitoring Reader قراءة المقاييس والبيانات الوصفية دون أي حق كتابة. ولتغطية اشتراكات كثيرة، أسند الدور نفسه على مستوى مجموعة إدارة (management group) بالمعامل --scope "/providers/Microsoft.Management/managementGroups/<id>": فيُغطّى كل اشتراك جديد دون إجراء إضافي.
تحقق من الإسناد، بما في ذلك الوراثة:
az role assignment list \
--assignee-object-id "$OBJECT_ID" \
--role "Monitoring Reader" \
--scope "/subscriptions/<subscription-id>" \
--include-inherited
الجدول الفارغ يعني أن الدور مفقود: لا فائدة من المتابعة في جانب Dynatrace.
الخطوة 3: ربط الاشتراك في Dynatrace
في إعدادات Dynatrace أنشئ اتصال Azure بإدخال معرّف العميل ومعرّف المستأجر (tenant) والسر. ثم اختر الخدمات المراد مراقبتها، وصفِّ بحسب الموقع أو الوسم. في SaaS الحديث يعتمد اتصال Azure على امتداد مُدار يقبل أيضًا التصفية بحسب الاشتراك والإثراء بوسوم Azure؛ وفي Managed استخدم شاشة تكامل Azure في إصدار عنقودك. تختلف التسميات الدقيقة بحسب الإصدار: وثائق نشرك هي المرجع.
التصفية بالوسم (مثل environment=production) أفضل إعداد للبدء: فهي تحد من استدعاءات API الخاص بـ Azure Monitor ومن حجم المقاييس المستوعَبة.
الخطوة 4: إرسال السجلات عبر Event Hub
ينشر Dynatrace ناقل سجلات مفتوح المصدر على شكل سكربت نشر. ينشئ Function App تقرأ Event Hub وترسل إلى بيئتك:
DEPLOYMENT_NAME=dtlogs
TARGET_URL=https://<environment-id>.live.dynatrace.com
TARGET_API_TOKEN=<token-logs-ingest>
RESOURCE_GROUP=rg-observability
EVENT_HUB_CONNECTION_STRING="<connection-string-event-hub>"
REQUIRE_VALID_CERTIFICATE=true
wget -q https://github.com/dynatrace-oss/dynatrace-azure-log-forwarder/releases/latest/download/dynatrace-azure-logs.sh \
-O dynatrace-azure-logs.sh && chmod +x ./dynatrace-azure-logs.sh
./dynatrace-azure-logs.sh \
--deployment-name $DEPLOYMENT_NAME \
--target-url $TARGET_URL \
--target-api-token $TARGET_API_TOKEN \
--resource-group $RESOURCE_GROUP \
--event-hub-connection-string "$EVENT_HUB_CONNECTION_STRING" \
--require-valid-certificate $REQUIRE_VALID_CERTIFICATE
في Managed يشير TARGET_URL إلى ActiveGate لديك (https://<activegate>/e/<environment-id>)؛ ويقترح السكربت أيضًا خيارًا لإعادة استخدام ActiveGate قائم. ويقبل السكربت كذلك هوية مُدارة (managed identity) بدل سلسلة الاتصال، مما يوفر سرًّا إضافيًا.
يبقى ربط الموارد بـ Event Hub عبر إعداد تشخيص:
az monitor diagnostic-settings create \
--name to-dynatrace \
--resource "<resource-id>" \
--event-hub-rule "<authorization-rule-id>" \
--event-hub "<event-hub-name>" \
--logs '[{"categoryGroup":"allLogs","enabled":true}]'
لا تختر allLogs إلا للموارد الحرجة. أما الباقي فاستهدف فيه فئات محددة: ينخفض الحجم وتبقى الإشارة مقروءة.
كيف تتحقق من أن كل شيء يعمل
في جانب Azure افتح Event Hub: يجب أن يرتفع رسم Incoming Messages بعد بضع دقائق، وأن يتبعه Outgoing Messages. وإذا ارتفعت الرسائل الواردة وحدها فالناقل لا يستهلك: راجع سجلات Function App.
في جانب Dynatrace افتح notebook وشغّل:
fetch logs, from: now() - 1h
| filter matchesValue(cloud.provider, "Azure")
| summarize count(), by: {azure.resource.type}
| sort `count()` desc
إذا لم يكن الحقل azure.resource.type موجودًا في سجلاتك، فأزل التجميع وافحص سجلًّا خامًا لترى السمات المتاحة. وبالنسبة إلى المقاييس، ابحث عن «azure» في مستكشف المقاييس واعرض استهلاك المعالج لجهاز افتراضي معروف. ستجد استعلامات تحقق أخرى في أمثلة استعلامات DQL للتشغيل.
أفضل الممارسات
- service principal لكل نطاق (إنتاج، غير إنتاج)، لتتمكن من الإلغاء دون قطع كل شيء.
- دوّر سر العميل بالأمر
az ad app credential reset --append: يبقى السر القديم صالحًا حتى التحديث في Dynatrace. - مرّر وسوم Azure إلى Dynatrace واعتمد عليها في مناطق الإدارة والوسم التلقائي.
- خصص consumer group للناقل: إن شاركته أداة أخرى فسيتسبب في فقد رسائل.
- راقب صمت مصدر حرج: انظر كشف الثغرات في استيعاب السجلات.
الأسئلة الشائعة
هل يكفي Monitoring Reader أم يلزم Reader؟
لجمع المقاييس والبيانات الوصفية تطلب الوثائق Monitoring Reader. وقد تتطلب بعض الميزات المتقدمة قراءات إضافية؛ وتوفر الوثائق قالب دور مخصص بإجراءات قراءة فقط لكل مزوّد موارد. تجنب Contributor: لا شيء يبرره.
ما الفرق بين SaaS وManaged؟
في SaaS يستعلم Dynatrace من Azure انطلاقًا من بنيته التحتية. وفي Managed يتولى ActiveGate الخاص ببيئتك هذه الاستدعاءات ويجب أن يصل إلى API الخاص بـ Azure؛ وتمر السجلات أيضًا عبره. انظر Environment ActiveGate أم Cluster ActiveGate لتحديد مكانه.
تصل السجلات لكن لا تصل المقاييس: ماذا أتحقق؟
التدفقان مستقلان. تحقق من إسناد الدور بالمعامل --include-inherited، ومن انتهاء صلاحية سر العميل، ثم من مرشحات الاتصال: مرشح وسم شديد الصرامة يستبعد كل شيء دون إبلاغ بخطأ.
الخلاصة
يكفي service principal للقراءة فقط ودور Monitoring Reader وEvent Hub لإعادة Azure Monitor إلى Dynatrace. والفائدة ليست في تكرار بوابة Azure، بل في الربط: المورد المُدار المشبع يظهر في المشكلة نفسها مع الخدمة المتأثرة. ابدأ باشتراك إنتاج واحد، وتحقق بـ DQL، ثم وسّع بمجموعة إدارة. الإجراء المرجعي في docs.dynatrace.com.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. تتطور أسماء الشاشات والإجراءات، لذا تحقق دائمًا من القيم في الوثائق الرسمية الخاصة بإصدارك قبل أي تغيير في الإنتاج.