Blank white background with no objects or features visible.

تحية إلى منطقة أوروبا والشرق الأوسط وأفريقيا! توسع TrueFoundry نطاق حضورها في هذه المنطقة الحيوية. اقرأ المزيد ←

تتبع Gateway وسجلات الطلبات: استكشاف أخطاء كل استدعاء LLM وإصلاحها

By أشيش دوبي

Updated: نوفمبر 3, 2026

Published: أكتوبر 9, 2026

لماذا تحتاج إلى التتبع (Tracing) على Gateway

عندما يكون استدعاء LLM بطيئًا، أو مكلفًا، أو غير صحيح، فأنت بحاجة إلى معرفة ما حدث بالفعل. هل قام Guardrail بحجب Prompt؟ كم استغرق النموذج من الوقت مقارنة بالشبكة؟ ما الذي أرسلته Gateway إلى المزود؟ تجيب تسجيل الطلبات والتتبع على AI Gateway عن هذه الأسئلة لكل استدعاء.

ولأن كل طلب يتدفق بالفعل عبر Gateway، فإنك تحصل على هذه الرؤية الشاملة دون الحاجة إلى تجهيز كل تطبيق يدويًا.

التحكم فيما يتم تسجيله

تتيح لك وثائق تسجيل الطلبات التحكم في الطلبات التي يتم تسجيلها. أبسط طريقة للتحكم هي على مستوى كل طلب، باستخدام Header المسُمى X-TFY-LOGGING-CONFIG مع قيمة JSON مكتوبة كنص (stringified). قم بضبط enabled على true لتسجيل الطلب أو false لتخطيه.

هناك نقطة مهمة تستحق الملاحظة: قيمة هذا Header هي JSON مكتوب كنص وليس كائن JSON خام، لأن معظم SDKs تقوم بتسلسل الـ Headers كـ strings. يتم حاليًا استبدال أوضاع التسجيل العامة القديمة بـ تكوين التسجيل القائم على القواعد، مما يتيح لك التحكم في التسجيل حسب Subject أو Model أو Metadata وحجب القيم الحساسة.

عرض سجلات الطلبات

لعرض الطلبات المسجلة في واجهة المستخدم، انتقل إلى AI Gateway، ثم Monitor، ثم Requests. يمنحك هذا قائمة بجميع الاستدعاءات المسجلة، والتي يمكنك فتحها لفحص طلب واحد بالتفصيل.

سجلات الطلبات في قسم Monitor في AI Gateway.

مفهوم Traces و Spans

تصف وثائق التتبع الـ Trace بأنه دورة الحياة الكاملة للطلب أثناء تدفقه عبر الخدمات التي تتفاعل مع LLM. عادةً ما يتوافق Trace مع استدعاء API واحد لتطبيق ما.

أما Span فهو وحدة عمل فردية داخل هذا Trace، مثل استدعاء دالة، أو طلب HTTP، أو استنتاج نموذج (Model Inference). الـ Trace هو عبارة عن شجرة من الـ Spans تربطها علاقات الأب والابن (parent and child)، حيث يكون Child span مسببًا عادةً بواسطة Parent span الخاص به. توفر TrueFoundry بنية تحتية لجامع OpenTelemetry تقوم بتخزين هذه الـ Traces وواجهة مستخدم للاستعلام عنها وتحليلها، ويمكنها استقبال الـ Traces من أي SDK متوافق مع OpenTelemetry.

الـ Trace هو شجرة من الـ Spans تربطها علاقات الأب والابن.
هل يمكنك شرح سبب بطء آخر طلب بطيء لديك؟
سنفتح Trace مباشرًا على حركة المرور الخاصة بك ونستعرض شجرة Span معك.

قراءة Trace واحد

تستعرض وثائق فحص Trace مثالاً واقعياً: Chat completion مع PII redaction guardrail، يتم التقاطه كخمسة Spans تشكل تسلسلاً هرمياً.

  • ChatCompletion span (الRoot) يمثل دورة حياة الطلب الكاملة من منظور العميل. في المثال، يستغرق حوالي 7 ثوانٍ ويحمل مقاييس الـ Tokens، والتكلفة، و المدخلات، والمخرجات.
  • Guardrail span هو Child للـ Root ويمثل معالجة حجب PII، ويستغرق أقل من نصف ثانية.
  • Guardrail network call span هو استدعاء HTTP الفعلي لخدمة Guardrail، متضمنًا طريقة HTTP ورقم حالة الاستجابة (status code).
  • Model span هو Sibling لـ Guardrail span ويمثل استنتاج النموذج، ويستغرق معظم وقت الطلب.
  • Model network call span هو استدعاء HTTP الفعلي للمزود، على سبيل المثال طلب POST لنقطة نهاية Chat completions للمزود.

في نفس هذا المثال، يظهر الإدخال محجوبًا بوضوح من اسم إلى نص بديل (placeholder)، مما يوضح عمل PII guardrail من البداية إلى النهاية داخل الـ Trace.

Trace لـ Chat completion يوضح Guardrail و Model و Outbound network spans.

من Trace واحد إلى مقاييس شاملة للبنية التحتية

الـ Traces الفردية مخصصة لاستكشاف الأخطاء وإصلاحها. ولتتبع الاتجاهات العامة، تقوم لوحة تحليلات البيانات بتجميع نفس البيانات. تغطي علامات التبويب Overview، و Model Metrics، و MCP Metrics، و Guardrail Metrics، و Routing Metrics، و Cache Metrics.

يمكن تجميع مقاييس النموذج حسب Models، أو Virtual Models، أو Users، أو Virtual Accounts، أو Teams، أو Metadata، وتقوم طرق عرض Latency بتقسيم زمن استجابة الطلب (Request Latency)، والوقت حتى أول Token (Time to first token)، وزمن الاستجابة بين الـ Tokens (Inter token latency)، والوقت لكل Token مخرج. جنبًا إلى جنب مع الـ Traces لكل طلب، يمنحك هذا الرؤية الدقيقة واللوحة الشاملة في آن واحد.

مقاييس النموذج في لوحة التحليلات، قابلة للتجميع حسب الفريق، والمستخدم، والنموذج، والمزيد.
امنح كل فريق ميزة التتبع دون عناء أعمال التجهيز اليدوي
شاهد سجلات الطلبات، و Traces على مستوى Span، والتحليلات عبر حركة مرور Gateway الخاصة بك.

Try now.

One gateway for all your models, MCP servers, and agents. No credit card needed.

Start free
Table of Contents

One Gateway for Every LLM, Agent and MCP Server

Book a 30-min with our AI expert

Book a Demo

The fastest way to build, govern and scale your AI

Book Demo
Summarize with
ChatGPT logo by OpenAI
Perplexity AI logo
Blurry red snowflake on white background, symmetrical frosty design with soft edges and abstract shape.

Discover More

No items found.
نوفمبر 18, 2026
|
5 min read

شرح قيود Claude Code (إصدار 2026)

No items found.
Analyzing how Cloudflare detects MCP traffic
نوفمبر 18, 2026
|
5 min read

How Cloudflare Detects MCP Traffic and Helps Secure It

No items found.
نوفمبر 18, 2026
|
5 min read

What Is AI Search? How It Works, Architecture, and Enterprise Use Cases

No items found.
Explaining LLM fine-tuning for enterprise AI teams
نوفمبر 18, 2026
|
5 min read

A Practical Guide to LLM Fine-Tuning: Methods, Data, Costs, and Deployment

No items found.
No items found.

Recent Blogs

Black left pointing arrow symbol on white background, directional indicator.
Black left pointing arrow symbol on white background, directional indicator.

Frequently asked questions

How do I turn logging on or off for a request?

Send the X-TFY-LOGGING-CONFIG header with a stringified JSON value and set enabled to true or false. Remember that the value is stringified JSON, not a raw object, because most SDKs serialize headers as strings.

Where do I view logs and traces?

Logged requests appear under AI Gateway, then Monitor, then Requests. Opening a request shows its trace, which is the tree of spans covering guardrails, the model, and the outbound provider calls.

‍

What is the difference between a trace and a span?

A trace is the full lifecycle of a single request. A span is one unit of work inside that trace, such as a guardrail check or a model inference. Spans form a parent and child tree within the trace

Can I use my own OpenTelemetry SDK?

Yes. TrueFoundry runs an OpenTelemetry collector backend and can receive traces from any OpenTelemetry compatible SDK. For LLM use cases the docs recommend an LLM focused SDK that captures model specific traces and metrics.

Take a quick product tour
Start Product Tour
Product Tour