modes OneAgent: Full-Stack وInfrastructure وDiscovery وOneAgent لـ AWS Lambda

modes OneAgent مقارنةً: ما تجمعه أوضاع Full-Stack وInfrastructure وDiscovery، وكيف تحوّل مضيفًا، ونشر OneAgent على AWS Lambda.
Modes OneAgent : Full-Stack vs Infrastructure, Discovery et OneAgent pour AWS Lambda

أسطول من 2000 مضيف، وميزانية قابلية ملاحظة محدودة، والسؤال نفسه في كل مراجعة: هل يجب فعلًا قياس كل شيء بعمق؟ تجيب modes OneAgent عن هذا السؤال مضيفًا مضيفًا. فأوضاع Full-Stack وInfrastructure وDiscovery لا تجمع البيانات نفسها، ولا تحقن في العمليات بالطريقة نفسها، ولا تستهلك الترخيص بالطريقة نفسها. يحسم المقال أولًا مسألة Dynatrace Full-Stack مقابل Infrastructure Monitoring، ثم يتناول Discovery وLambda.

للاختيار أثر مباشر في الموثوقية. فالخدمة الحرجة المراقَبة في وضع Infrastructure ليس لها تتبعات موزعة (Distributed traces): في يوم الحادثة يرى فريق المناوبة معالجًا مشبعًا لكنه لا يرى الطلب البطيء الذي يفسّره، فيطول MTTR. وعلى العكس، Full-Stack في كل مكان مكلف لخوادم لا يُراد منها سوى صحتها.

يقارن هذا المقال الأوضاع الثلاثة، ويبيّن كيف تُفعَّل (التثبيت وoneagentctl والواجهة وSettings API)، ثم يتناول حالة الدوال بلا خادم (serverless) على حدة: OneAgent لـ AWS Lambda، الموزَّع على شكل طبقة (layer). المحتوى صالح لـ Dynatrace SaaS وDynatrace Managed، مع الإشارة إلى الفروق في سياق النص.

modes OneAgent في لمحة: Dynatrace Full-Stack مقابل Infrastructure Monitoring مقابل Discovery

يُثبَّت OneAgent افتراضيًا في وضع Full-Stack. أما الوضعان الآخران فأخف ويركزان على البنية التحتية. يعيد الجدول أدناه المصفوفة المنشورة في الوثائق الرسمية.

مقتطف من وثائق Dynatrace يقارن المكونات المجموعة في أوضاع Full stack وInfrastructure وDiscovery

Full-Stack: التتبعات والتنميط والشيفرة

يوفر وضع Full-Stack الرؤية الكاملة للتطبيق: التتبعات الموزعة والتنميط (profiling) والرؤية على مستوى الشيفرة وتفاصيل العمليات وتحليل القرص والشبكة والذاكرة. وهو الوضع الوحيد الذي يوفر التتبع. أما بالنسبة إلى المقاييس المخصصة، فتشير مصفوفة الوثائق إلى «15 / 256 MiB»، مقابل «100 / host» في وضع Infrastructure.

Infrastructure: صحة المضيفين والخدمات المساندة

يحتفظ وضع Infrastructure بطوبولوجيا Smartscape وتفاصيل العمليات والقرص والشبكة والذاكرة، لكن دون التتبع. ومنذ OneAgent 1.213 يحقن مع ذلك تلقائيًا في العمليات لجمع مقاييس JMX/PMI ومقاييس التشغيل (runtime) لـ Java و.NET وNode.js وGo وPHP وخوادم الويب (Apache HTTP وNGINX وIIS). هذا الحقن مفعّل افتراضيًا ويمكن تعطيله (opt-out). وهو يلائم قواعد البيانات وطوابير الرسائل والخوادم التي تُراقَب صحتها أكثر من شيفرتها.

Discovery: تغطية منخفضة الكلفة

يوفر وضع Discovery، المتاح بدءًا من OneAgent 1.281، مقاييس أساسية لاكتشاف المضيفين والعمليات: المعالج (builtin:host.cpu.usage) والذاكرة (builtin:host.mem.usage) والقرص وواجهات الشبكة وتوافر المضيف. ولا يعطي تفاصيل العمليات ولا الامتدادات. ولا يُعرض إلا مع نموذج الترخيص Dynatrace Platform Subscription (DPS) ويستهلك سعة Foundation & Discovery. وتوصي الوثائق بـ Full-Stack للتطبيقات الحرجة، وInfrastructure للبنية التحتية الحرجة، وDiscovery لبقية الأسطول.

اختيار وضع OneAgent المناسب لكل مضيف

فكّر انطلاقًا من أهداف SLO لا من الجرد. اطرح ثلاثة أسئلة لكل مجموعة مضيفين:

  1. هل يعتمد هدف SLO على معاملة تمر بهذا المضيف؟ نعم: Full-Stack، فبدون تتبعات لن تحدد سبب تدهور زمن الاستجابة.
  2. هل يحمل المضيف خدمة مساندة (قاعدة بيانات أو Kafka أو ActiveMQ)؟ يكفي Infrastructure غالبًا، بفضل مقاييس JMX ومقاييس التشغيل.
  3. هل تريد فقط أن تعرف أنه موجود وبخير؟ Discovery، إذا كنت على DPS.

يتوقف تفصيل الاستهلاك لكل وضع على عقدك: يساعدك مقالنا عن ترخيص DPS واستهلاكه على تقدير السيناريو قبل تحويل مئات المضيفين.

عمليًا: تغيير الوضع

الخطوة 1: تحديد وضع افتراضي

قبل التثبيت يمكنك تغيير الوضع المقترح افتراضيًا في صفحة النشر (Linux وWindows وAIX). في المنصة الحديثة: Settings > Fleet management > Default mode. وفي Dynatrace Classic (ومنه Managed): Settings > General > Versions and updates > OneAgent default mode.

الخطوة 2: اختيار الوضع عند التثبيت

يقبل معامل التثبيت --set-monitoring-mode القيم fullstack أو infra-only أو discovery:

# Linux installation in Infrastructure mode
sudo /bin/sh Dynatrace-OneAgent-Linux.sh --set-monitoring-mode=infra-only

تفاصيل التثبيت على Linux مشروحة في دليل OneAgent Linux، وفي SaaS في الوحدة 2 من تدريب SaaS.

الخطوة 3: تحويل مضيف قائم باستخدام oneagentctl

توجد الأداة افتراضيًا في /opt/dynatrace/oneagent/agent/tools وتتطلب صلاحيات root:

cd /opt/dynatrace/oneagent/agent/tools
# read the current mode: fullstack, infra-only or discovery
sudo ./oneagentctl --get-monitoring-mode
# switch to Discovery and restart OneAgent
sudo ./oneagentctl --set-monitoring-mode=discovery --restart-service

يتطلب تغيير الوضع إعادة تشغيل OneAgent (--restart-service، الإصدار 1.189 وما بعده) والخدمات المراقَبة. فالوحدة المحقونة تبقى مرتبطة بالعملية ما دامت لم تُعد التشغيل: جدول التحويل في نافذة صيانة.

الخطوة 4: عبر الواجهة أو API

في الواجهة: Hosts Classic، صفحة المضيف، More (…) > Settings > Host monitoring > Monitoring Mode. وعلى نطاق واسع، استخدم Settings API بالمخطط builtin:host.monitoring: اجلب المخطط ثم أنشئ كائن الإعداد لكل مضيف.

الخطوة 5: إدارة الحقن

في Infrastructure يمكن إيقاف الحقن لكل مضيف (--set-auto-injection-enabled=false) أو عبر قواعد مراقبة العمليات. وتنصح الوثائق بعدم ذلك: فبدون الحقن لا يكتشف Application Security وLive Debugger شيئًا. وفي Discovery يحدث العكس: حقن وحدات الشيفرة معطَّل افتراضيًا ويُفعَّل لكل مضيف (Advanced settings > CodeModule Injection) إذا أردت Application Security.

OneAgent لـ AWS Lambda

لا مضيف لدالة Lambda يُثبَّت عليه وكيل. لذلك يوزع Dynatrace OneAgent على شكل طبقة Lambda (layer) عامة لكل بيئة تشغيل (runtime) ولكل منطقة، تُضبط بمتغيرات البيئة أو بملف dtconfig.json. وبيئات التشغيل المدعومة للتتبع هي Python وNode.js وJava و.NET وGo. ولا ينطبق مفهوم وضع Full-Stack أو Infrastructure هنا: الطبقة تتتبع الاستدعاءات.

ما الذي تضيفه الطبقة

  • تتبعات موزعة عبر API Gateway وSQS وSNS وEventBridge وApplication Load Balancer والاستدعاء عبر AWS SDK؛
  • اكتشاف البدايات الباردة (cold starts)، القابل للتصفية في الاستعلامات (Function cold start)؛
  • جمع السجلات عبر Telemetry API الخاص بـ Lambda، دون المرور بـ CloudWatch.

نشر الطبقة

  1. في Dynatrace Hub اختر AWS Lambda ثم Set up.
  2. اختر بيئة التشغيل والمعمارية والمنطقة والطريقة: متغيرات البيئة أو JSON أو Terraform أو AWS SAM أو Serverless Framework أو CloudFormation.
  3. أضف الطبقة بواسطة ARN الخاص بها (حساب Dynatrace 585768157899 للجيل الحالي) والمتغيرات التي يوفرها المعالج.

مع AWS CLI انتبه: المعامل --environment يستبدل جميع متغيرات الدالة. أعد إدراج المتغيرات الموجودة في الأمر نفسه:

aws lambda update-function-configuration \
  --function-name commande-api \
  --layers <ARN-de-la-couche-fourni-par-l-assistant> \
  --environment "Variables={AWS_LAMBDA_EXEC_WRAPPER=/opt/dynatrace,DT_TENANT=<tenant>,DT_CLUSTER=<cluster>,DT_CONNECTION_BASE_URL=<url>,DT_CONNECTION_AUTH_TOKEN_SECRETS_MANAGER_ARN=<arn-du-secret>}"

يقرأ المتغير DT_CONNECTION_AUTH_TOKEN_SECRETS_MANAGER_ARN (OneAgent 1.295 وما بعده) الرمز من AWS Secrets Manager بدل كتابته نصًا واضحًا. ويجب أن تملك الدالة الصلاحية secretsmanager:GetSecretValue على هذا السر، وأن يحتوي السر الرمز وحده لا JSON.

الكلفة والحدود التي يجب معرفتها

  • البداية الباردة: نحو 900 مللي ثانية في Node.js، و1000 في Python، و1500 في Java، و600 في Go، و5000 في .NET، مقيسة على دوال «hello world» بذاكرة 512 MB. ويزيد زمن الاستجابة عادةً بأقل من 10%.
  • إعداد محلي فقط: تتجاهل الطبقة الإعدادات المحددة من جهة الخادم؛ والمعتمد هو المتغيرات وdtconfig.json فقط.
  • Lambda Managed Instances غير مدعومة.
  • في Java 25، يمنع ذاكرة AOT المؤقتة المفعّلة افتراضيًا الحقن: JAVA_TOOL_OPTIONS="-XX:AOTCache=none" (OneAgent 1.343 وما بعده) على حساب بداية باردة أطول.
  • في Node.js، وحدات ESM اختيارية (opt-in) عبر DT_ENABLE_ESM_LOADERS=true.
  • Managed: تصف وثائق Managed التكامل نفسه، لكن عناقيد Managed غير المتصلة (offline) غير مدعومة.

إذا كانت دوالك لا تزال تستخدم الطبقات «classic» (الحساب 725887861453) فرحّلها: تذكر الوثائق أن البداية الباردة المعتادة في Java انخفضت من أقل من 4000 مللي ثانية إلى أقل من 1500، وأن الحد الأدنى للذاكرة في Java صار 128 MB بدل 1500 MB. وأعد تسمية DT_CLUSTER_ID إلى DT_CLUSTER في الوقت نفسه. ولمقاييس CloudWatch، أكمل مع تكامل AWS CloudWatch.

كيف تتحقق من أن كل شيء يعمل

  • المضيفون: يعيد oneagentctl --get-monitoring-mode الوضع المتوقع؛ وفي Deployment Status، تبويب OneAgents، يُظهر المرشح Auto-injection المضيفين الذين عُطِّل فيهم الحقن.
  • Lambda: تنتج الاستدعاءات تتبعات في Distributed Tracing وسجلات، وتظهر الدالة في Services. ولتشخيص التصدير، أضف مؤقتًا DT_LOGLEVELCON=info وDT_DEBUGFLAGS=debugHttpNative=true: يؤكد السطر HTTP/1.1 202 Accepted الإرسال. ويشير الخطأ 401 إلى الرمز أو المستأجر أو العنوان؛ ويشير 404 أو 200 إلى عنوان DT_CONNECTION_BASE_URL.

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

  • اربط الوضع بمجموعة مضيفين وبهدف SLO، ووثّق القاعدة، وطبّقها عبر Settings API بدل اليد.
  • حوّل خلال نافذة صيانة: يجب إعادة تشغيل العمليات ليكتمل التغيير.
  • في Lambda، خزّن الرمز في Secrets Manager، وقس البداية الباردة قبل التغيير وبعده، وقرّب ActiveGate من منطقة الدوال إذا كان زمن الاستجابة مهمًا.
  • راجع الاختيار كل ثلاثة أشهر: الخدمة التي تدخل مسارًا حرجًا يجب أن تنتقل إلى Full-Stack.

الأسئلة الشائعة

هل يمكن الانتقال من Full-Stack إلى Discovery دون إعادة تثبيت OneAgent؟

نعم، بالأمر oneagentctl --set-monitoring-mode=discovery --restart-service أو بالواجهة أو بـ Settings API. خطّط لإعادة تشغيل العمليات المراقَبة لإزالة الوحدات المحقونة سابقًا.

هل يوجد وضع Discovery في Dynatrace Managed؟

تصف وثائق Managed الأوضاع الثلاثة، لكن Discovery غير متاح إلا مع نموذج الترخيص DPS. تحقق من عقدك قبل التفكير فيه.

هل لـ OneAgent الخاص بـ Lambda وضع Infrastructure؟

لا. تتتبع طبقة Lambda الاستدعاءات ويمكنها جمع السجلات. أما مقاييس المنصة (المدة والأخطاء وthrottles) فتأتي من تكامل CloudWatch، ويُجمع مع الطبقة.

الخلاصة

ليست modes OneAgent إعدادًا للتثبيت يُنسى: فهي تقرر ما سيراه فريق المناوبة يوم الحادثة. Full-Stack حيث تعيش أهداف SLO، وInfrastructure للخدمات المساندة، وDiscovery للتغطية، وطبقة Lambda للـ serverless، مع عين على البداية الباردة. وللتفاصيل، راجع وثائق أوضاع OneAgent ودليل Trace Lambda functions.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. الأمثلة للاسترشاد فقط: تحقق منها على بيئتك قبل استخدامها في الإنتاج.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
Error Inspector Dynatrace et codes d'erreur : ce que Dynatrace compte vraiment comme une erreur

Error Inspector في Dynatrace ورموز الأخطاء: ما الذي يعدّه Dynatrace خطأً فعلًا

Next Post
Commandes DQL : filter, in(), summarize et timeseries en 30 exemples commentés

أوامر DQL: filter و in() و summarize و timeseries في 30 مثالًا موضحًا

Related Posts