يحتاج فريقك إلى شيء لا تقدمه أي شاشة جاهزة: واجهة تجمع بين الفرق والخدمات واستعلام DQL خاص بك. والقرار التشغيلي هنا بسيط الصياغة: هل تواصل بلوحة معلومات ولقطات شاشة ملصقة في ويكي، أم تبني تطبيقًا صغيرًا يعيش داخل بيئتك؟ أداة Dynatrace App Toolkit هي أداة سطر الأوامر التي تجعل الخيار الثاني في المتناول. يتناولها هذا المقال بعكس ترتيب الوثائق: أولًا ما ينبغي حسمه قبل كتابة أي شيفرة، ثم الحد الأدنى من الخطوات للحصول على تطبيق يعمل.
ما يلي ينطبق على Dynatrace SaaS فقط (العناوين من نوع apps.dynatrace.com)، ولا يشمل Managed. لم تنشر span.observer أي تطبيق أثناء كتابة هذا النص: الأوامر والخيارات مأخوذة من وثائق المطورين ومن تدوينة الشركة المزوّدة المرتبطتين أدناه، ولم يُختلق أي ناتج.
تقدّم تدوينة الشركة الإصدار 1.0 من App Toolkit بوصفه سلسلة أدوات واحدة: إنشاء التطبيق وتطويره ونشره، وإضافة دوال التطبيق، وتحديث الحزم، كلها من الملف التنفيذي نفسه dt-app. احتفظ بهذه الفكرة، فهي تنظّم بقية المقال.
Dynatrace App Toolkit: هل تحتاج فعلًا إلى تطبيق؟
قبل فتح الطرفية، اطرح ثلاثة أسئلة على الفريق. فهي تجنّبك صيانة شيفرة بلا حاجة.
- هل تكفي لوحة معلومات؟ إذا اقتصرت الواجهة على بطاقات DQL فابقَ مع لوحة المعلومات: لا شيفرة ولا دورة نشر.
- من يتولى صيانة التطبيق؟ للتطبيق إصدار وتبعيات ومسؤول. سمِّ المسؤول قبل السطر الأول من الشيفرة، كما تفعل مع أي خدمة.
- ما البيانات التي سيقرؤها؟ تُعلن صلاحيات التطبيق (scopes) في إعداداته: كلما قلّ ما تطلبه قصرت مراجعة الأمان.
إذا مال الميزان نحو التطبيق (واجهة مخصصة وتنقّل ومنطق عرض)، فانتقل إلى التشغيل. وبالنسبة إلى استعلامات صفحاتك المقبلة، يصلح المقال عن تقنيات DQL المتقدمة أساسًا.
متطلبات يجب فحصها قبل تشغيل الأمر
تسرد صفحة App Toolkit متطلبات محددة. وهذه هي كما وردت في الوثائق:
- تثبيت Node.js 24 محليًا (للتحقق:
node --version)؛ - عنوان بيئتك بالصيغة
https://{identifier}.apps.dynatrace.com/، ويمكن نسخه من شريط عنوان المتصفح؛ - وصول الشبكة إلى
dt-cdn.netوregistry.npmjs.orgوبيئتك وgithub.com(للقوالب)؛ - منافذ حرة: من 3000 إلى 3005 لخادم التطوير، و30000 للتشغيل المحلي لدوال التطبيق، و5343 لمصادقة SSO (وإن كان المنفذ مشغولًا جرّبت الأداة التالي).
على حاسوب الشركة، سطر الشبكة هو أول ما يفشل: اطلب فتح المضيفين الأربعة قبل أن تضيع ساعة في خطأ تثبيت.
إنشاء التطبيق: الحلقة الدنيا
تقترح وثيقة «First app in 5 minutes» المسار التالي. والخطوات مرتبة كما كنت سأنفذها.
- في طرفية المحرر، شغّل
npx dt-app@latest create. - اختر اسمًا للتطبيق، مثل
my-first-app، ثم أدخل عنوان البيئة (قد يملؤه الأمر تلقائيًا إن كنت مسجّلًا للدخول). - ادخل المجلد بالأمر
cd my-first-app. - شغّل الخادم المحلي بالأمر
npx dt-app dev، فيُفتح التطبيق في المتصفح. - افتح الملف
ui/app/pages/Home.tsx، وغيّر نص العنصرHeadingإلى «My first app» ثم احفظ: يتحدّث المتصفح من تلقاء نفسه.

هذه اللقطة تجميع لأوامر مأخوذة من الوثائق، وليست جلسة مسجَّلة. وانتبه إلى تفصيل في المتصفح: تذكر الوثائق أن Chrome 142 أو أحدث يطلب إذنًا للاتصال بأجهزة الشبكة المحلية؛ فإن بقيت الصفحة بيضاء فانظر إلى هذا التنبيه أولًا.
ما تبرزه تدوينة الشركة هو سرعة الحلقة. فهي تعلن انخفاض زمن إعادة البناء من نحو 2.7 ثانية إلى 0.05 ثانية بفضل اكتشاف التغييرات (تُعاد بناء المكونات المعدّلة وفحصها فقط)، وفحص أنواع تزايدي لا يعيد إلا الملفات المعدّلة وتبعياتها. هذه أرقام الشركة، ولم تقسها span.observer.
قراءة المجلد المُنشأ والإعدادات
يفصل الإصدار 1.x من الأداة الواجهة عن دوال التطبيق. وتبدو مساحة العمل الموصوفة في الوثائق هكذا:

الملف الذي ينبغي أن تعرفه هو app.config.json (أو app.config.ts). في المستوى الأعلى يكون environmentUrl إلزاميًا. وتحت app تشترط الوثائق الحقول id (بأحرف صغيرة ومساحة اسم مفصولة بنقاط) وname وversion وdescription وscopes.

المثال أعلاه مبني على الحقول الموثّقة بقيم وهمية: معرّف البيئة abc12345 غير موجود، وستتوقف scopes عندك على ما سيقرؤه التطبيق. ويستحق الحقل version قاعدة للفريق: ارفعه عند كل نشر، فهو مرجعك عند الرجوع إلى إصدار سابق.
نشر بلا مفاجآت: تجربة جافة ثم نشر فعلي
خادم التطوير لا يشارك شيئًا. ولكي يرى زملاؤك التطبيق لا بد من نشره. يبني الأمر npx dt-app deploy التطبيق ثم ينشره في البيئة المضبوطة. وهناك خياران مفيدان بحسب الوثائق:
- الخيار
--dry-runينشئ أرشيف.zipقابلًا للتوزيع في المجلدout/دون نشر: وهو الفحص الذي ينبغي إجراؤه قبل أول إنتاج؛ - الخيار
--skip-buildيعيد استخدام بناء موجود، وهو مريح حين يكون خط الأنابيب قد بنى التطبيق سلفًا.
ولإزالة التطبيق يوجد الأمر dt-app uninstall، وله خيار --dry-run خاص به. أما ما لا تفصّله الوثائق التي اطلعتُ عليها فهو تسلسل المصادقة التفاعلية بدقة وما يظهر في البيئة بعد النشر، ولذلك لا أصفه؛ اتبع دليل «deploy your app» في موقع المطورين.
الأتمتة: الجزء المهم لمن يتناوب على المناوبة
تؤكد التدوينة نقطة مفيدة لفرق SRE: يمكن تشغيل كل الأوامر داخل سكربتات أو خطوط أنابيب، بوسائط وخيارات في سطر الأوامر بدل الأسئلة التفاعلية. وتقدّم الوثائق الوسائل: الخيار --non-interactive ومتغيرات بيئة. فالمتغير DT_APP_PLATFORM_TOKEN يتخطى مسار المصادقة الافتراضي، والمتغيران DT_APP_OAUTH_CLIENT_ID وDT_APP_OAUTH_CLIENT_SECRET يؤتمتان الحصول على رمز SSO، وهذا ما يفيد في التكامل المستمر. ولا يجوز أن تدخل هذه الأسرار المستودع أبدًا: ضعها في خزنة أداة CI لديك.
وهناك أمران آخران للصيانة: dt-app update يحدّث الحزم، وdt-app migration execute يرافق الانتقال بين الإصدارات (بالخيارين --from و--to). خطّط لتحديث كل ربع سنة بدل التحديث تحت الضغط. وإن كنت تدير منصتك بالشيفرة أصلًا فالمنطق قريب من Terraform للتنبيهات ولوحات المعلومات: يصبح التطبيق قطعة مُصدَّرة الإصدارات كغيره. ولفهم كيفية تعريف بيانات صفحاتك، راجع المقال عن معرّف الكيان.
ممارسات جيدة
- مسؤول مسمّى ومستودع لكل تطبيق، مع مراجعة شيفرة كما في أي خدمة.
- صلاحيات scopes في حدها الأدنى، تُراجع عند كل صفحة جديدة.
- تنفيذ
deploy --dry-runقبل أي إنتاج، مع رفعversion. - أسرار CI خارج المستودع؛ ويوجد الخيار
DT_APP_DISABLE_TELEMETRY=1إن كانت سياستك تمنع قياسات الأداة عن بُعد. - البدء بصفحة بسيطة تقرأ استعلام DQL واحدًا ثم التوسع.
الأسئلة الشائعة
ما إصدار Node.js المطلوب لـ Dynatrace App Toolkit؟
تذكر الوثائق Node.js 24. تحقق منه بالأمر node --version قبل تشغيل npx dt-app@latest create.
هل تعمل الأداة مع Dynatrace Managed؟
تتحدث المصادر التي اطلعتُ عليها عن بيئات apps.dynatrace.com، أي SaaS. ولم يُتحقق من شيء بخصوص Managed، ولذلك لا يؤكد المقال ذلك.
هل يمكن تشغيل الأوامر في CI دون تفاعل؟
نعم بحسب الوثائق: الخيار --non-interactive والمتغيران DT_APP_OAUTH_CLIENT_ID وDT_APP_OAUTH_CLIENT_SECRET مخصصة لهذه الحالة. جرّب أولًا مع --dry-run.
الخلاصة
بناء تطبيق Dynatrace قرار صيانة قبل أن يكون قرارًا تقنيًا. فإن كان الجواب نعم، تتسع الحلقة create ثم dev ثم deploy --dry-run ثم deploy لخمسة أوامر فقط. وللتفاصيل الرسمية اقرأ تدوينة الشركة عن App Toolkit 1.0 ووثائق المطورين.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. تحقق دائمًا من القيم (المنافذ والإصدارات والأحجام) في الوثائق الرسمية الخاصة بإصدارك.