إذا لم يكن AWS X-Ray يجمع الطلبات كما هو متوقع، فقد يكون هناك العديد من الأسباب لذلك. إليك بعض الخطوات التي يمكنك اتخاذها لاستكشاف المشكلة وحلها:
-
التحقق من التوثيق: تأكد من أن تطبيقك مزود بشكل صحيح باستخدام AWS X-Ray SDK. يجب دمج SDK في شفرتك لالتقاط بيانات التتبع وإرسالها.
-
التحقق من أذونات IAM: تأكد من أن دور IAM المرتبط بحالات EC2 أو وظائف Lambda لديه الأذونات اللازمة لإرسال بيانات التتبع إلى X-Ray. يجب أن يحتوي الدور على سياسة AWSXRayDaemonWriteAccess.
-
التحقق من تكوين الخادم: إذا كنت تستخدم الخادم X-Ray (xray-daemon)، تأكد من أنه يعمل وأنه مُعد بشكل صحيح على الخادم. المسؤول عن إرسال بيانات التتبع إلى خدمة X-Ray هو الخادم.
-
التحقق من قواعد العينة: راجع قواعد العينة في وحدة تحكم X-Ray. إذا كانت معدلات العينة منخفضة جدًا، فقد يتم استبعاد بعض الطلبات من الالتقاط.
-
مراجعة تعبيرات الفلتر: في وحدة تحكم X-Ray، تحقق مما إذا كانت هناك أي تعبيرات فلتر تم تطبيقها. قد تحد هذه من التتبع الذي يتم عرضه.
-
التحقق من التوثيق الخدمي: تأكد من أن جميع الخدمات المعنية في الطلب (مثل حالات EC2، وظائف Lambda، قواعد البيانات) مزودة بشكل صحيح باستخدام SDK X-Ray.
-
التحقق من تمرير رأس التتبع: تأكد من أن رأس تتبع X-Ray يتم تمريره بين الخدمات. هذا الرأس مهم لربط التتبع عبر مكونات التطبيق المختلفة.
-
مشاكل الشبكة: تحقق من أي مشكلات في الشبكة قد تمنع تطبيقك من الاتصال بخدمة X-Ray. تأكد من فتح المنافذ اللازمة (منفذ UDP 2000 ومنفذ TCP 2000).
-
التحقق من الأخطاء في السجلات: راجع السجلات التي يتم إنشاؤها بواسطة تطبيقك للبحث عن أي أخطاء تتعلق بتوثيق X-Ray أو إرسال التتبع.
-
التحقق من المنطقة AWS: تأكد من أن موارد AWS الخاصة بك (مثل حالات EC2، وظائف Lambda) وخدمة X-Ray في نفس المنطقة الخاصة بـ AWS.
-
التحقق من التتبع النشط: في وحدة تحكم X-Ray، تحقق من مقياس "التتبع النشط" لمعرفة ما إذا كانت هناك أي تتبعات يتم تسجيلها.
-
وحدة تحكم AWS X-Ray: انتقل إلى وحدة تحكم AWS X-Ray وتوجه إلى خريطة الخدمة أو عرض التتبع لمعرفة ما إذا كانت هناك أي بيانات يتم تسجيلها.
إذا كنت قد مررت بهذه الخطوات وما زلت تواجه مشاكل، يفضل التواصل مع دعم AWS للحصول على مساعدة إضافية. يمكنهم تقديم إرشادات مفصلة ومساعدتك في استكشاف أي مشاكل قد تواجهها مع توثيق X-Ray.