أداة مطوّرين مجانية

مدقّق OpenTelemetry لحمولات OTLP/JSON

الصق حمولة ExportTraceServiceRequest واحصل على تدقيق بنيوي بنتائج لكل حقل — كل شيء داخل متصفحك ولا يُرفع أي شيء.

مدقق OTLP/JSON للتتبع

الصق حمولة ExportTraceServiceRequest بصيغة OTLP/JSON للتحقق من بنيتها. كل شيء يعمل داخل المتصفح — بياناتك ما تطلع من هالصفحة.

التحقق يتم بالكامل داخل المتصفح. حمولتك ما تغادر جهازك أبداً.

اكتشف حمولات OTLP المعطوبة قبل أن يرفضها الخادم

عندما يُرسل مُصدِّر OpenTelemetry التتبّعات ولا يظهر شيء، يكون السبب غالبًا بنيويًا: traceId ليس 32 خانة سداسية، أو spanId ليس 16، أو طوابع زمنية ليست بالنانوثانية، أو نوع span غير صحيح، أو سمات بشكل مخالف لمواصفة OTLP. أغلب الخوادم ترفض هذه الحمولات أو تتجاهلها بصمت، فتبقى أمام لوحة فارغة بلا أي تفسير.

يحلّل هذا المدقّق حمولة OTLP/JSON من نوع ExportTraceServiceRequest ويمرّ على كل resource span و scope و span، ويعرض نتائج لكل حقل: أطوال traceId و spanId السداسية، وسلامة الطوابع الزمنية، وقيم أنواع الـ spans، وشكل مفاتيح وقيم السمات، مع تحذير عند غياب service.name — أكثر سبب شائع لظهور التتبّعات تحت خدمة "مجهولة". كل شيء يعمل محليًا في متصفحك، وبياناتك لا تغادر جهازك أبدًا.

كيف تتحقّق من حمولة OTLP

  1. 1

    التقط حمولة JSON

    احصل على جسم OTLP/JSON الذي يرسله الـ SDK أو الـ collector — مثلًا بتوجيه المُصدِّر إلى نقطة محلية، أو تفعيل سجلات التصحيح، أو استخدام console exporter.

  2. 2

    الصقها في المدقّق

    الصق JSON الخاص بـ ExportTraceServiceRequest في الحقل. تُحلَّل الحمولة فورًا داخل متصفحك — لا يُرسل شيء إلى أي خادم.

  3. 3

    راجع النتائج لكل حقل

    تُعرض الأخطاء والتحذيرات لكل حقل: أطوال traceId أو spanId غير صحيحة، وطوابع زمنية مشكوك فيها، وأنواع spans خاطئة، وسمات معطوبة، وتحذير عند غياب service.name.

  4. 4

    أصلح وأعد التحقق

    عدّل الـ instrumentation أو خط الـ collector، والصق الحمولة الجديدة، وتأكد أنها تجتاز التدقيق قبل إعادة توجيه المُصدِّر إلى خادمك.

الأسئلة الشائعة عن مدقّق OpenTelemetry

هل مدقّق OTLP هذا مجاني؟

نعم، مجاني بالكامل بدون تسجيل ولا حساب ولا حدود استخدام.

هل تُرفع بيانات التتبّع الخاصة بي إلى أي مكان؟

لا. يعمل التدقيق بالكامل في متصفحك عبر JavaScript، وحمولة OTLP لا تغادر جهازك — وهذا مهم عندما تحتوي التتبّعات على أسماء مضيفين داخلية أو بيانات طلبات.

ما الصيغة التي يتوقعها المدقّق؟

OTLP/JSON — أي ترميز JSON لـ ExportTraceServiceRequest، وهو نفس الجسم المُرسل إلى ‎/v1/traces عبر HTTP. حمولات Protobuf الثنائية تحتاج تحويلًا إلى JSON أولًا.

لماذا يحذّر من غياب service.name؟

service.name هي السمة التي تستخدمها الخوادم لتجميع الـ spans حسب الخدمة. بدونها تضع أغلب الخوادم تتبّعاتك تحت خدمة مجهولة، فيصعب العثور عليها.

ما القيم الصحيحة لـ traceId و spanId؟

في OTLP/JSON يجب أن يكون traceId مكوّنًا من 32 خانة سداسية (16 بايت) و spanId من 16 خانة (8 بايت)، ولا يجوز أن يكون أيٌّ منهما أصفارًا فقط. يفحص المدقّق كليهما في كل span.

استكشف المزيد

القدرات

حسب إطار العمل

قارن

تحتاج خادمًا لهذه التتبّعات؟

AllStak خادم أصيل لـ OpenTelemetry: وجّه مُصدِّر OTLP إلى AllStak واحصل على التتبّع الموزّع مع الأخطاء والسجلات وزمن التشغيل في منصّة واحدة. اطّلع على تكامل OpenTelemetry للبدء.

ابدأ مجاناً كل الأدوات المجانية