OneAgent ActiveGate المنفذ 9999: تشخيص تعذّر الاتصال

OneAgent ActiveGate المنفذ 9999: اختبر جدار الحماية، واقرأ الـ endpoints عبر oneagentctl، وافحص network zones، واجمع أرشيف الدعم الخاص بـ ActiveGate.
OneAgent ActiveGate port 9999 : diagnostiquer une connexion impossible

يظهر مضيف «متجمّدًا» أو يتوقف عن إرسال البيانات، ويقود الأثر إلى مشكلة OneAgent ActiveGate المنفذ 9999: الوكيل مثبّت، لكنه لا يستطيع الوصول إلى ActiveGate الذي كان يفترض أن يمرّر حركته. في أغلب الحالات يكون السبب عاديًا (جدار الحماية، أو endpoint خاطئ، أو network zone خاطئة) ويمكن تشخيصه بعدة أوامر، بشرط اتباع ترتيب محدد.

تقترح هذه المقالة منهجًا لاستكشاف الأخطاء في ست خطوات، من جهاز الوكيل حتى أرشيف الدعم الخاص بـ ActiveGate. وهي صالحة لـ Dynatrace SaaS؛ والمنافذ والأوامر المذكورة ترد أيضًا في وثائق Managed، لكن لا تخلط بين المصدرين، وتحقق دائمًا من إصدارك. وللاطلاع على الفرق بين أنواع ActiveGate، اقرأ أولًا مقالتنا عن ActiveGate البيئة مقابل ActiveGate العنقود.

باختصار

  • يستقبل Environment ActiveGate الاتصالات على المنفذ 9999؛ ويستقبلها عنقود SaaS على المنفذ 443 (وثائق «Supported connectivity schemes for ActiveGates»).
  • يُنشئ ActiveGate اتصالاته الصادرة الخاصة نحو Dynatrace على المنفذ 443: مساران وقاعدتان لجدار الحماية.
  • عند عدم وجود ActiveGate قابل للوصول، يفضّل OneAgent الاتصال مباشرة بعنقود SaaS؛ فما يُحجب يتوقف إذن على إعدادك (network zone، الوضع الاحتياطي).
  • ابدأ بالأمر oneagentctl --get-server على المضيف: سترى فورًا الـ endpoints التي يستهدفها الوكيل.

فهم المسار: OneAgent وActiveGate وDynatrace

وفق وثائق Dynatrace عن مخططات الاتصال، تفضّل وكلاء OneAgent استخدام Environment ActiveGate؛ فإذا تعذّر الوصول إلى أي منها، اتصلت مباشرة بعنقود SaaS. وتدفع network zones الوكلاء إلى تفضيل ActiveGate الموجودة في منطقتها قبل تلك الواقعة خارجها.

إذن المنفذ 9999 هو منفذ الشطر الأول من المسار، من الوكيل إلى ActiveGate. أما الشطر الثاني، من ActiveGate إلى Dynatrace، فيمر عبر 443. وهذه التفصيلة تغيّر التشخيص: قد يحجب جدار الحماية أحد الشطرين دون المساس بالآخر.

ملخص المنافذ في وثائق Dynatrace: 9999 للدخول إلى Environment ActiveGate، و443 نحو Dynatrace، واللاحقة /communication، وقائمة السماح في جدار الحماية

OneAgent ActiveGate المنفذ 9999: خطوات التشخيص الست

الخطوة 1: قراءة الـ endpoints التي يستهدفها الوكيل

على المضيف المعني، توجد الأداة oneagentctl افتراضيًا في /opt/dynatrace/oneagent/agent/tools (Linux، بصلاحيات root) أو في %PROGRAMFILES%\dynatrace\oneagent\agent\tools (Windows، بصلاحيات المسؤول). وبحسب الوثائق، يعرض --get-server «الـ endpoints التي يرسل OneAgent البيانات إليها». ومنذ OneAgent 1.207 تُجمع الـ endpoints ذات الأولوية نفسها بين قوسين معقوصين، وتشير نجمة إلى الـ endpoint قيد الاستخدام.

أوامر oneagentctl في وثائق Dynatrace: get-server وget-network-zone وget-tenant وset-server مع المنفذ 9999 واللاحقة communication
cd /opt/dynatrace/oneagent/agent/tools
sudo ./oneagentctl --get-server
sudo ./oneagentctl --get-network-zone
sudo ./oneagentctl --get-tenant

ثلاثة أسئلة: هل يظهر ActiveGate المتوقع في القائمة؟ هل رقم المنفذ صحيح؟ هل network zone الخاصة بالوكيل هي نفسها الخاصة بـ ActiveGate؟ أسماء المناطق غير حساسة لحالة الأحرف وتُخزَّن بأحرف صغيرة، مما يتجنب فرقًا زائفًا.

الخطوة 2: التحقق مما تتوقعه البيئة

تعيد واجهة النشر (deployment API) قائمة مرتبة بـ endpoints الخاصة بـ ActiveGate لمنطقة network zone (في SaaS: GET https://{id-environnement}.live.dynatrace.com/api/v1/deployment/installer/agent/connectioninfo/endpoints، مع المعامل networkZone). الاستجابة نص خام، وتُفصل ActiveGate بفاصلة منقوطة، والأعلى أولوية أولًا. يجب أن يحمل رمز API النطاق InstallerDownload. قارن هذه القائمة بقائمة الخطوة 1: إذا ثُبّت الوكيل قبل ActiveGate، فقد تكون endpoints الخاصة به قديمة.

الخطوة 3: اختبار المنفذ من مضيف الوكيل

يجب أن ينطلق الاختبار من الجهاز الذي يحمل OneAgent، لا من ActiveGate نفسه. يكفي اختبار TCP بسيط للفصل بين «الشبكة» و«التطبيق»:

nc -zv activegate.exemple.fr 9999
curl -vk --connect-timeout 5 https://activegate.exemple.fr:9999/ -o /dev/null

يدل الرفض الفوري عادةً على أنه لا توجد خدمة تستمع أو أن جدار حماية يرفض الاتصال؛ أما التوقف دون استجابة حتى انتهاء المهلة فيوحي بتصفية صامتة على المسار. ونجاح مصافحة TLS يثبت أن المنفذ مفتوح، لكنه لا يعني أن الوكيل سيُقبل. هذان الأمران أداتا شبكة عامتان وليسا من أوامر Dynatrace: وتفسير نتيجتهما متروك لتقديرك.

الخطوة 4: فحص ActiveGate نفسه

على ActiveGate، تأكد من وجود استماع على 9999 ومن أن جدار الحماية المحلي يسمح به. تذكر وثائق Dynatrace أن ActiveGate يستمع عادةً على المنفذ 9999 ويتصل بـ Dynatrace على 443؛ وتطلب أيضًا السماح بالعناوين البعيدة المذكورة أسفل صفحة التثبيت.

sudo ss -tlnp | grep 9999
sudo firewall-cmd --list-ports    # si firewalld est utilisé

في Dynatrace، تذكر صفحة التثبيت أنه يمكن متابعة حالة ActiveGate في Fleet Management، قسم ActiveGate. وتضيف وثائق «Troubleshoot monitoring interruptions» أمرين: البحث عن تغيير حديث في جدار الحماية يحجب الحركة الصادرة من الوكلاء، وفحص الحالة التشغيلية لـ ActiveGate الذي تمر عبره الحركة. كما توصي بمقاييس المراقبة الذاتية لـ ActiveGate لتقييم سلامته.

الخطوة 5: مراجعة network zones والوضع الاحتياطي

قد يرفض وكيل مضبوط في منطقة ما ActiveGate خارج المنطقة. تصف وثائق «OneAgent connectivity in network zones» ثلاثة أوضاع: «Any ActiveGate (default)» الذي يسمح بمجموعات الأولوية من 1 إلى 4؛ و«Only DefaultZone» للمجموعات من 1 إلى 3؛ و«None (drop traffic)» للمجموعتين 1 و2. ومع الوضع الأخير تُسقط الحركة إذا لم يتوفر أي ActiveGate في المنطقة: وهي حالة نموذجية لعبارة «الوكيل لا يصل إلى شيء».

للتصحيح، إما يُعاد الوكيل إلى المنطقة الصحيحة، وإما يُفرض الـ endpoint. توضح الوثائق أن --set-server يأخذ عنوانًا بالشكل https://hôte:port/communication، وأنه يمكن فصل عدة عناوين بفاصلة منقوطة بين علامتي اقتباس، وأن إعادة التشغيل لازمة: الخيار --restart-service ينفذها (OneAgent 1.189 وما بعده).

sudo ./oneagentctl --set-network-zone=zone.exemple --restart-service
sudo ./oneagentctl --set-server="https://ag1.exemple.fr:9999/communication;https://ag2.exemple.fr:9999/communication" --restart-service

الخطوة 6: جمع أرشيف الدعم

إذا استمرت المشكلة، فاجمع السجلات. مع ActiveGate بالإصدار 1.333 أو أحدث، الأمر هو agctl support-archive create؛ وقبل 1.333 هو create-support-archive (متقادم). على Linux يُنفَّذ بمستخدم عملية ActiveGate، وهو dtuserag افتراضيًا. يحتوي الأرشيف، وهو ملف ZIP، على لقطة من السجلات والإعدادات وغيرها. وتوجد سجلات ActiveGate تحت /var/log/dynatrace/gateway.

الأمر agctl support-archive create على Linux وقائمة محتويات الأرشيف: details.txt وconfig وlog وinstall وzremote وsynthetic
sudo -u dtuserag /opt/dynatrace/gateway/agctl support-archive create --directory=/tmp --days=7

كيف تتحقق من أن الحل يعمل

  1. يعرض oneagentctl --get-server ActiveGate المتوقع، مع نجمة على الـ endpoint النشط.
  2. ينتهي اختبار المنفذ من مضيف الوكيل في أقل من بضع ثوانٍ.
  3. يعود المضيف بظهور بيانات حديثة في Dynatrace، ويظهر ActiveGate بحالة تشغيلية في Fleet Management.

حالات خاصة يجدر معرفتها

  • شهادة مرفوضة. وفق وثائق استكشاف أخطاء التثبيت، قد ينتج «Server certificate check failed» عن وكيل وسيط (proxy) يعدّل الشهادة أو عن Environment ActiveGate بشهادة مخصصة، لأن OneAgent يتضمن شهادات الثقة الخاصة بـ Dynatrace.
  • SELinux في وضع enforcing. قد تُمنع العمليات المحقونة (مثل httpd) من الوصول إلى ActiveGate؛ وتحيل الصفحة نفسها إلى سجل التدقيق والقيمة المنطقية httpd_can_network_connect.
  • موازن الحمل. إذا وُضع load balancer أمام ActiveGate، فيُصرَّح بعنوانه عبر الخاصية dnsEntryPoint.
  • Kubernetes. في العنقود يجب أن تسمح سياسة الشبكة بالتدفقات؛ راجع مقالتنا عن Dynatrace Operator.

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

  • وثّق التدفق (المصدر والوجهة والمنفذ والاتجاه) في طلب قاعدة جدار الحماية: يوفّر ذلك وقت فريق الشبكة.
  • انشر ActiveGate اثنين على الأقل في كل منطقة كي لا يقطع عطل واحد الجمع، وراقبهما كخادمين حرجين.
  • احتفظ بـ endpoint احتياطي ووضع احتياطي صريح بدلًا من «drop traffic» مفروض.
  • اربط تغطية المراقبة بأهدافك: مضيف أعمى يثقل MTTR، ومن هنا أهمية التنبيه على غياب البيانات، كما في مقالتنا الرصد مقابل المراقبة.
  • بعد التصحيح، اكتب مراجعة ما بعد الحادثة دون لوم: أي تغيير في الشبكة لم يُعلَن عنه؟

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

ما المنفذ الذي يستخدمه OneAgent للوصول إلى ActiveGate؟

يستقبل Environment ActiveGate الاتصالات على المنفذ 9999 وفق وثائق Dynatrace. ويُكتب الـ endpoint بالشكل https://hôte:9999/communication.

هل يجب فتح 9999 نحو الإنترنت؟

ليس بالضرورة: يكفي فتحه بين مضيفي الوكلاء وActiveGate. أما حركة ActiveGate نحو Dynatrace فتمر عبر 443 الصادر.

ماذا يفعل OneAgent إذا تعذّر الوصول إلى ActiveGate؟

افتراضيًا يمكنه الاتصال مباشرة بعنقود SaaS، ما لم تمنعه network zone والوضع الاحتياطي. ومع «None (drop traffic)» تُسقط الحركة.

الخلاصة

احتفظ بالترتيب: endpoints الوكيل، ثم ما تتوقعه البيئة، ثم اختبار المنفذ، ثم حالة ActiveGate، ثم المناطق والوضع الاحتياطي، وأخيرًا أرشيف الدعم. وللمزيد، يشرح دليل OneAgent على Linux التثبيت بالتفصيل، ويضع الوحدة التدريبية عن OneAgent وActiveGate الأسس.

المصادر

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
Injection de prompt MCP : limiter le rayon d'action de l'agent

حقن الموجّهات في MCP: الحد من نطاق تأثير الوكيل

Next Post
Logs OpenTelemetry stables : faut-il migrer sa stack de logs ?

سجلات OpenTelemetry المستقرة: هل ترحّل منظومة السجلات؟

Related Posts