جمع التتبعات وفحصها في مجموعة أدوات Microsoft Foundry

استخدم Microsoft Foundry Toolkit تعليمة Visual Studio برمجية لجمع التتبعات المحلية أو عرض بيانات تتبع الاستخدام للوكلاء المنشورين في Microsoft Foundry. مجموعات تتبع العمليات المسجلة لطلب. كل عملية هي امتداد مع التوقيت والحالة وأي سمات أو أحداث يوفرها تقرير عن حالة النظام.

تتناول هذه المقالة المجموعة المحلية أولا، ثم تتبع السحابة للوكلاء الموزعين. اختر مصدر البيانات الذي يطابق التحقيق الخاص بك:

النهج	استخدمه لـ	البيانات والمسؤوليات
مركز التحكم بالعامل	إرسال طلب محلي أو فحص الاستجابة المباشرة وأحداث الأدوات أو إيقاف التعليمات البرمجية مؤقتا عند نقطة توقف.	يوفر الخادم أحداث البروتوكول وتشخيصات التطوير. لا يتطلب هذا الأسلوب مجمع OTLP أو إنشاء محفوظات تتبع السحابة.
التتبع المحلي	مقارنة نطاقات النموذج والأداة والوكيل المسجلة أثناء التطوير.	يقوم تطبيقك بتصدير بيانات تتبع الاستخدام إلى مجمع Toolkit المحلي. يمكنك تكوين الأجهزة وإدارة البيانات المحلية المخزنة.
تتبع العامل المستضاف	تحقق من الطلبات التي يعالجها عامل تم نشره في Foundry.	توجد عمليات التتبع في مورد Application Insights المتصل بالمشروع. يتبع الوصول والاحتفاظ والرسوم تكوين مورد Azure.

يقوم عامل مستضاف بتشغيل التعليمات البرمجية المخصصة في Foundry Agent Service. يدير Foundry الاستضافة، ولكنك تظل مسؤولا عن التعليمات البرمجية والتبعيات. لا يحل التتبع محل إنشاء العامل ونشره.

المتطلبات المسبقه

تعليمة Visual Studio برمجية مع ملحق مجموعة أدوات Foundry العامة الحالية. راجع تثبيت مجموعة أدوات Foundry.
تطبيق يمكنك تشغيله محليا، مع تكوين اتصالات النموذج والأدوات الخاصة به.
على سبيل المثال الأول، تطبيق إطار عمل عامل Python Microsoft وبيئة Python المحددة. بالنسبة إلى حزم SDK الأخرى، استخدم إعداد Python أو JavaScript وTypeScript.
للتتبع السحابي، عامل منشور ومورد Application Insights متصل بمشروع Foundry الخاص به، أو إذن للاتصال أو إنشاء واحد.
بالنسبة للاستعلامات السحابية، دور Log Analytics Reader على مورد Application Insights المتصل. بالنسبة للجداول المحمية، قم أيضا بتعيين دور قارئ بيانات المراقبة المتميزة. راجع متطلبات تتبع Foundry.

لا تتطلب المجموعة المحلية Application Insights أو أذونات بيانات تتبع الاستخدام السحابية. لا يزال بإمكان استدعاءات النموذج وتنفيذ الأدوات استخدام الخدمات عن بعد وتحمل رسوم.

جمع التتبعات المحلية

يتلقى المجمع المحلي بيانات تتبع الاستخدام عبر بروتوكول القياس المفتوح (OTLP). لا يقوم بأداة تطبيق تلقائيا. يجب أن يقوم إطار العمل أو مكتبة الأجهزة الخاصة بك بإنشاء امتدادات وتصديرها إلى المجمع.

SDK وإعداد اللغة

SDKs مع الأجهزة المضمنة لا تزال بحاجة إلى مصدر. تستخدم SDKs الأخرى حزمة تقرير عن حالة النظام منفصلة.

SDK أو إطار العمل	Python	JavaScript وTypeScript (Node.js)
إطار عمل وكيل Microsoft	تقرير عن حالة النظام OpenTelemetry المضمن.	لا يوجد إرشادات إعداد مجموعة أدوات مخصصة.
Azure AI Inference SDK (معاينة)	Azure SDK أداة الأدوات.	Azure SDK تقرير عن حالة النظام.
Foundry Projects SDK	أدوات من جانب العميل (معاينة).	صك عميل OpenAI أو Azure SDK الأساسي.
Foundry classic Agents SDK	Azure SDK أداة الأدوات.	لا يوجد إرشادات إعداد مجموعة أدوات مخصصة.
الأنثروبي	أدوات OpenLLMetry.	أدوات Traceloop.
Google GenAI (Gemini)	أدوات القياس عن بعد المفتوح ل Google GenAI.	لا يوجد إرشادات إعداد مجموعة أدوات مخصصة.
LangChain	أدوات OpenLLMetry.	أدوات Traceloop.
OpenAI SDK، بما في ذلك عملاء OpenAI Azure	أدوات OpenLLMetry.	أدوات Traceloop.
حزمة تطوير أوبن آي لوكلاء	معالج تتبع OpenLLMetry.	لا يوجد إرشادات إعداد مجموعة أدوات مخصصة.

"لا يوجد إرشادات إعداد مجموعة أدوات مخصصة" يعني أنه لا يوجد مسار إعداد خاص ب SDK هنا لتلك اللغة، وليس أن المجمع يرفض بيانات تتبع الاستخدام الخاصة به. يقبل المجمع بيانات OTLP. يحدد تقرير عن العمليات وتفاصيل الرسالة التي يتم التقاطها.

تستخدم هذه الأمثلة خيارات الأجهزة المحددة، وليس قائمة شاملة من المكتبات المتوافقة. تعد OpenLLMetry وأجهزة Traceloop مكتبات غير Microsoft.

إعداد تقرير عن حالة النظام

استخدم هذا الإجراء مع تطبيق إطار عمل عامل Python موجود. احتفظ بالعامل والجامع في نفس البيئة المحلية لهذه المعاينة.

حدد Foundry Toolkit في شريط النشاط، ثم Developer Tools>Monitor Tracing>.
حدد Start Collector قبل تشغيل التطبيق الخاص بك.
في بيئة Python التطبيق، قم بتثبيت مصدر gRPC إذا لم يتم الإعلان عنه بالفعل في تبعياتك:
```
python -m pip install opentelemetry-exporter-otlp-proto-grpc
```
المرجع: OpenTelemetry Python مصدري OTLP.
تكوين OpenTelemetry مرة واحدة عند بدء تشغيل التطبيق، قبل إنشاء العامل أو تشغيله:
```
import os

os.environ["OTEL_EXPORTER_OTLP_ENDPOINT"] = "http://localhost:4317"
os.environ["OTEL_EXPORTER_OTLP_PROTOCOL"] = "grpc"

from agent_framework.observability import configure_otel_providers

configure_otel_providers(enable_sensitive_data=False)
```
المرجع: إمكانية مراقبة إطار عمل العامل.

إذا كان التطبيق أو مكتبة الاستضافة الخاصة بك تقوم بالفعل بتكوين موفري OpenTelemetry، فكون المصدرين الحاليين بدلا من إضافة إعداد موفر آخر. يمكن أن تتجاوز المتغيرات الخاصة OTEL_EXPORTER_OTLP_*_ENDPOINT بالإشارة نقطة النهاية الأساسية. تحقق من وجود إعدادات تتبع أو سجل أو مقياس تشير إلى مكان آخر.
قم بتشغيل التطبيق بنقطة الإدخال العادية الخاصة به وأرسل طلبا يمارس العامل. اسمح للطلب بالانتهاء ومنح المصدر الوقت لإرسال بيانات تتبع الاستخدام قبل إيقاف العملية.
في التتبع، حدد Refresh، ثم حدد التتبع الجديد لفحص امتداداته.

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

بالنسبة إلى SDK أو لغة أخرى، استخدم الإعداد أدناه بدلا من تكوين إطار عمل العامل. ابدأ تشغيل المجمع أولا، وقم بتكوين الأجهزة قبل إنشاء العملاء، ثم قم بتشغيل التطبيق الخاص بك وتحديث قائمة التتبع.

نقاط نهاية المجمع

مطابقة بروتوكول المصدر مع نقطة نهاية المجمع. يستمع Toolkit على localhost مع هذه الإعدادات الافتراضية:

المُصدِّر	Endpoint
OTLP gRPC	`http://localhost:4317`
مصدر تتبع OTLP HTTP	`http://localhost:4318/v1/traces`
مصدر سجل OTLP HTTP	`http://localhost:4318/v1/logs`

يقبل http://localhost:4318 بعض مصدري HTTP مسار الإشارة ويلحقون به بأنفسهم. اتبع تكوين المصدر بدلا من إلحاق المسار مرتين. ترسل بعض مكتبات الأجهزة محتوى الرسالة كسجلات سجل، لذلك قد لا يوفر تصدير الامتدادات وحدها تفاصيل الإدخال والإخراج.

هذه المنافذ غير مرتبطة بخادم HTTP العامل ومنافذ مصحح الأخطاء. في حاوية أو بيئة تطوير عن بعد، localhost يشير إلى تلك البيئة. قم بإنشاء الاتصال المناسب بالمجمع بدلا من افتراض أنه يشير إلى سطح المكتب الخاص بك.

إعداد Python SDK

تفترض الأمثلة التالية أن التطبيق الخاص بك يحتوي بالفعل على نموذج SDK وبيانات الاعتماد وتكوين النموذج. تثبيت التبعيات المشتركة والحزمة الإضافية ل SDK من الجدول التالي:

python -m pip install opentelemetry-sdk opentelemetry-exporter-otlp-proto-http

المرجع: OpenTelemetry Python SDK، مصدرو OTLP.

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

import os

os.environ["TRACELOOP_TRACE_CONTENT"] = "false"
os.environ["OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT"] = "false"
os.environ["AZURE_TRACING_GEN_AI_CONTENT_RECORDING_ENABLED"] = "false"

from opentelemetry import trace
from opentelemetry.sdk.resources import Resource
from opentelemetry.sdk.trace import TracerProvider
from opentelemetry.sdk.trace.export import BatchSpanProcessor
from opentelemetry.exporter.otlp.proto.http.trace_exporter import (
    OTLPSpanExporter,
)

provider = TracerProvider(
    resource=Resource.create({"service.name": "my-agent"})
)
provider.add_span_processor(BatchSpanProcessor(
    OTLPSpanExporter(endpoint="http://localhost:4318/v1/traces")
))
trace.set_tracer_provider(provider)

المرجع: TracerProvider ومعالجات الامتداد، OTLPSpanExporter.

ثبت الحزمة في الصف الذي اخترته باستخدام python -m pip install <package>. تستخدم أمثلة OpenAI Anthropic وLangChain وعوامل OpenAI المنفصلة الأجهزة غير Microsoft OpenLLMetry. يمكن أن تنتج إصدارات SDK وواجهات برمجة التطبيقات النموذجية تفاصيل مختلفة.

SDK	حزمة إضافية	تقرير عن حالة النظام بعد الإعداد المشترك
OpenAI، بما في ذلك عملاء OpenAI Azure	`opentelemetry-instrumentation-openai`	`from opentelemetry.instrumentation.openai import OpenAIInstrumentor` `OpenAIInstrumentor().instrument()`
الأنثروبي	`opentelemetry-instrumentation-anthropic`	`from opentelemetry.instrumentation.anthropic import AnthropicInstrumentor` `AnthropicInstrumentor().instrument()`
LangChain	`opentelemetry-instrumentation-langchain`	`from opentelemetry.instrumentation.langchain import LangchainInstrumentor` `LangchainInstrumentor().instrument()`
Google GenAI	`opentelemetry-instrumentation-google-genai`	`os.environ["OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT"] = "NO_CONTENT"` `from opentelemetry.instrumentation.google_genai import GoogleGenAiSdkInstrumentor` `GoogleGenAiSdkInstrumentor().instrument()`
التتبع من جانب العميل في Foundry Projects (معاينة)	`azure-core-tracing-opentelemetry`، جنبا إلى جنب مع `azure-ai-projects`	`os.environ["AZURE_EXPERIMENTAL_ENABLE_GENAI_TRACING"] = "true"` `from azure.ai.projects.telemetry import AIProjectInstrumentor` `AIProjectInstrumentor().instrument(enable_content_recording=False)`
Foundry classic Agents SDK	`azure-core-tracing-opentelemetry`، جنبا إلى جنب مع `azure-ai-agents`	`os.environ["AZURE_SDK_TRACING_IMPLEMENTATION"] = "opentelemetry"` `from azure.ai.agents.telemetry import AIAgentsInstrumentor` `AIAgentsInstrumentor().instrument()`
Azure AI Inference SDK (معاينة)	`azure-core-tracing-opentelemetry`، جنبا إلى جنب مع `azure-ai-inference`	`os.environ["AZURE_SDK_TRACING_IMPLEMENTATION"] = "opentelemetry"` `from azure.ai.inference.tracing import AIInferenceInstrumentor` `AIInferenceInstrumentor().instrument()`

بالنسبة لمشاريع Foundry، اتبع إرشادات التتبع من جانب العميل وأنشئ عميل OpenAI الخاص به بعد تقرير عن حالة النظام. تختلف هذه الإرشادات عن SDK للوكلاء الكلاسيكيين. لا تقم باستخدام نفس استدعاءات OpenAI مع كل من AIProjectInstrumentor وأداة OpenAI منفصلة.

بالنسبة ل OpenAI Agents SDK، قم بتثبيت opentelemetry-instrumentation-openai-agents هذه التعليمة البرمجية وإضافتها بعد الإعداد المشترك:

from agents import set_trace_processors
from opentelemetry.instrumentation.openai_agents import OpenAIAgentsInstrumentor

set_trace_processors([])
OpenAIAgentsInstrumentor().instrument()

المرجع: OpenAI Agents instrumentation، OpenAI Agents tracing.

يحل هذا المثال محل معالجات التتبع الموجودة قبل إضافة معالج OpenTelemetry. بدون هذا الاستبدال، يمكن ل SDK أيضا تصدير التتبعات إلى الواجهة الخلفية الافتراضية الخاصة به. إذا كنت بحاجة إلى معالجات موجودة، فراجع وجهات التتبع قبل تغييرها. حافظ على تمكين تتبع SDK حتى يتلقى معالج OpenTelemetry الأحداث.

بعد انتهاء تطبيق قصير الأجل من طلباته، اتصل provider.force_flush() قبل الإنهاء لإرسال الامتدادات المخزنة مؤقتا. للمساعدة في تكييف هذه القصاصات البرمجية، استخدم أداة تتبع التعليمات البرمجية لمجموعة الأدوات.

تصدير سجلات سجل الرسائل

تصدر بعض الأجهزة محتوى رسالة كسجلات سجل القياس المفتوح بدلا من سمات النطاق. إذا اخترت تسجيل هذا المحتوى في اختبار تطوير يتم التحكم فيه، فقم بإضافة هذا الإعداد مرة واحدة إلى جانب موفر تتبع Python السابق:

from opentelemetry import _logs
from opentelemetry.sdk._logs import LoggerProvider
from opentelemetry.sdk._logs.export import BatchLogRecordProcessor
from opentelemetry.exporter.otlp.proto.http._log_exporter import OTLPLogExporter

logger_provider = LoggerProvider(resource=provider.resource)
logger_provider.add_log_record_processor(BatchLogRecordProcessor(
    OTLPLogExporter(endpoint="http://localhost:4318/v1/logs")
))
_logs.set_logger_provider(logger_provider)

المرجع: OpenTelemetry Python تسجيل SDK، OTLPLogExporter.

اتصل logger_provider.force_flush() قبل إنهاء تطبيق قصير الأجل. لا يقوم مصدر السجل بتشغيل التقاط المحتوى بنفسه. اتبع إعدادات محتوى تقرير عن حالة النظام وإرشادات معالجة البيانات.

إعداد JavaScript وTypeScript SDK

بالنسبة للتطبيقات Node.js، شارك موفر تتبع واحد وسجل تقرير عن حالة النظام ل SDK الخاص بك. يستخدم هذا المثال CommonJS وتكوين موفر OpenTelemetry JavaScript 2.x. يمكن لتطبيقات TypeScript المحولة برمجيا إلى CommonJS استخدام نفس ترتيب التهيئة.

يجب أن يحتوي التطبيق الخاص بك بالفعل على نموذج SDK وبيانات الاعتماد وتكوين النموذج. تثبيت التبعيات المشتركة وأدوات OpenAI:

npm install @opentelemetry/api @opentelemetry/sdk-trace-node \
  @opentelemetry/sdk-trace-base @opentelemetry/exporter-trace-otlp-proto \
  @opentelemetry/instrumentation @traceloop/instrumentation-openai

المرجع: مصدرو OpenTelemetry JavaScript، تقرير عن حالة النظام OpenAI.

إنشاء tracing.cjs:

const { NodeTracerProvider } = require('@opentelemetry/sdk-trace-node');
const { BatchSpanProcessor } = require('@opentelemetry/sdk-trace-base');
const {
  OTLPTraceExporter
} = require('@opentelemetry/exporter-trace-otlp-proto');
const { registerInstrumentations } = require('@opentelemetry/instrumentation');
const { OpenAIInstrumentation } = require('@traceloop/instrumentation-openai');

const provider = new NodeTracerProvider({
  spanProcessors: [
    new BatchSpanProcessor(new OTLPTraceExporter({
      url: 'http://localhost:4318/v1/traces'
    }))
  ]
});
provider.register();

registerInstrumentations({
  instrumentations: [new OpenAIInstrumentation({ traceContent: false })]
});

module.exports = provider;

المرجع: NodeTracerProvider، تقرير عن حالة النظام OpenAI.

قم بتحميل هذا الملف قبل استيراد SDK النموذج الخاص بك أو طلبه. على سبيل المثال، قم بتشغيل node --require ./tracing.cjs app.cjs لتطبيق CommonJS. بالنسبة إلى SDK آخر، استبدل حزمة OpenAI، والاستيراد، وإدخال التسجيل بالصف المطابق:

SDK	حزمة الأجهزة	إدخال الاستيراد والتسجيل
OpenAI، بما في ذلك عملاء OpenAI Azure	`@traceloop/instrumentation-openai`	`const { OpenAIInstrumentation } = require('@traceloop/instrumentation-openai');` `new OpenAIInstrumentation({ traceContent: false })`
الأنثروبي	`@traceloop/instrumentation-anthropic`	`const { AnthropicInstrumentation } = require('@traceloop/instrumentation-anthropic');` `new AnthropicInstrumentation({ traceContent: false })`
LangChain	`@traceloop/instrumentation-langchain`	`const { LangChainInstrumentation } = require('@traceloop/instrumentation-langchain');` `new LangChainInstrumentation({ traceContent: false })`
Azure SDK العمليات، بما في ذلك استدلال الذكاء الاصطناعي Azure	`@azure/opentelemetry-instrumentation-azure-sdk`	`const { createAzureSdkInstrumentation } = require('@azure/opentelemetry-instrumentation-azure-sdk');` `createAzureSdkInstrumentation()`

حزم Traceloop هي أدوات غير Microsoft. بالنسبة لتطبيق مشاريع Foundry، ضع علامة على العميل الذي يقدم طلب النموذج. لا يحل تقرير حالة النظام Azure SDK محل تقرير عن حالة النظام OpenAI للمكالمات التي يتم إجراؤها من خلال عميل OpenAI.

بالنسبة إلى وحدات ECMAScript الأصلية، اتبع إعداد ESM الخاص ب OpenTelemetry. يمكن أن يؤدي تحميل تقرير عن حالة النظام بعد SDK الهدف إلى ترك المكالمات غير مثقف. عند إيقاف التشغيل، انتظر provider.shutdown() بعد اكتمال الطلبات لتصدير النطاقات المخزنة مؤقتا.

مهم

تقوم هذه الأمثلة بإيقاف تشغيل التقاط محتوى الرسالة لأجهزة GenAI المدرجة. هذا ليس ضمانا عاما للتراجع. راجع المصدرين الآخرين وتسجيل SDK وسمات النطاق والأجهزة المخصصة قبل مشاركة البيانات. تحقق من وثائق الأجهزة المرتبطة للحزم وواجهات برمجة التطبيقات المدعومة.

فحص التتبعات المحلية وإدارتها

استخدم شجرة الامتداد لمتابعة الطلب من تنسيق العامل إلى عمليات النموذج والأدوات.

حدد امتدادا بطيئا أو فاشلا.
افحص مدتها وحالتها.
افتح الإدخال + الإخراج للرسائل المسجلة، عند توفيرها بواسطة تقرير عن حالة النظام، أو بيانات التعريف لسمات النطاق.

تبقي الأمثلة التقاط المحتوى الحساس متوقفا عن التشغيل. يمكن أن تكون بيانات التوقيت بدون رسائل هي النتيجة المتوقعة.

لاختبار تطوير إطار عمل العامل المتحكم به، قم بتعيين enable_sensitive_data=True في التكوين الحالي الخاص به لتسجيل محتوى المطالبة والاستجابة والأدوات المدعومة. قم باستعادة إلى False عند اكتمال الاختبار. لدى الأجهزة الأخرى إعدادات المحتوى الخاصة بها.

احتياط

يمكن لتسجيل المحتوى التقاط البيانات الشخصية والأسرار ووسيطات الأدوات والنتائج. استخدم بيانات الاختبار غير الحساسة وقم بتقليل المحتوى أو تنقيحه قبل إدخال بيانات تتبع الاستخدام. لا تقم بتشغيل تسجيل محتوى الإنتاج فقط لملء طريقة عرض الإدخال والإخراج الفارغة.

تستمر التتبعات المجمعة في قاعدة بيانات SQLite محلية تسمى traces.db، في tracing الدليل الفرعي ضمن .aitk المجلد الرئيسي للمستخدم. إغلاق العارض لا يؤدي إلى حذفها.

حدد Stop Collector لإيقاف المجموعة المحلية. يستمر عاملك ومكالمات النموذج الخاصة به في العمل. لإزالة السجلات المحلية، حدد التتبعات في القائمة وحدد حذف.

التخزين المحلي منفصل عن Application Insights. لا يؤدي حذف التتبعات المحلية إلى إزالة بيانات تتبع الاستخدام السحابية، ولا يؤدي مسح محادثة في Inspector إلى حذف أي من المتجرين.

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

بعد التوزيع، استخدم تتبعات السحابة للتحقيق في العامل الذي يعمل في Foundry بدلا من العملية المحلية. يستعلم مربع الأدوات عن مورد Application Insights المتصل بالمشروع. لا يقوم بتحميل قاعدة بيانات التتبع المحلية.

تأكد من المتطلبات الأساسية للسحابة قبل البدء. لا يمنح الوصول إلى العامل وحده الإذن للاستعلام عن بيانات تتبع الاستخدام.

توصيل Application Insights وفحص طلب

استخدم علامة التبويب Traces للعامل لتوصيل Application Insights والعثور على طلب عامل تم نشره.

في الشريط الجانبي Foundry Toolkit، افتح My Resources>Agents. حدد علامة التبويب Hosted Agent ، ثم حدد اسم العامل.
حدد Traces. إذا لم يكن للمشروع مورد متصل، فحدد Enable App Insights.
في App Insights Settings، حدد اسم مورد Application Insights موجود. بدلا من ذلك، اختر إنشاء مورد وإكمال حقول المورد ومساحة العمل المطلوبة. حدد إرسال وانتظر التأكيد.

يؤدي هذا إلى تغيير اتصال Application Insights المشترك للمشروع، وليس تفضيل مساحة عمل محلية. يمكن أن يؤدي إنشاء الموارد وجمع بيانات تتبع الاستخدام إلى فرض رسوم Azure. قم بتأكيد المشروع والمورد المقصودين قبل الإرسال.
ارجع إلى Playground وأرسل طلب اختبار إلى العامل المنشور.
اسمح بوقت الاستيعاب، ثم افتح Traces مرة أخرى. استخدم عوامل تصفية النطاق الزمني أو البحث حسب معرف المحادثة أو الحالة أو المدة لتحديد موقع الطلب.
حدد تتبعا، ثم امتدادا، لمراجعة بيانات التعريفوالإدخال + الإخراج، عندما يتوفر المحتوى.

لفحص العمليات المقترنة بمحادثة، حدد معرف المحادثة الخاص بها في قائمة التتبع. تعرض طريقة عرض المحادثة شجرة عملية وبيانات تعريف.

يتيح توصيل Application Insights التتبع من جانب الخادم في Foundry. تعتمد الرؤية في مكالمات النموذج واستدعاءات الأدوات والرمز المخصص أيضا على مكتبة الاستضافة وأجهزة إطار العمل. راجع إعداد التتبع في Foundry للمجموعة من جانب الخدمة وأدوات العميل الإضافية.

يغطي استعلام تتبع تفاصيل مجموعة الأدوات حاليا الأيام السبعة الأخيرة. هذه نافذة استعلام، وليست إعداد استبقاء. بالنسبة للبيانات القديمة، استخدم مدخل Foundry أو Azure Monitor، رهنا تكوين الاحتفاظ بمساحة العمل المتصلة.

البيانات والوصول والاستبقاء والتكلفة

حدد المكان الذي يجب أن تذهب إليه بيانات تتبع الاستخدام قبل تمكين التقاط المحتوى أو توصيل مورد سحابي. يمكن أن ينشئ نفس الطلب امتدادات محلية وبيانات تتبع الاستخدام السحابية والبيانات المرسلة إلى موفري النماذج أو الأدوات.

مصدر البيانات	المسؤوليات
تتبعات محلية	حماية الوصول إلى قاعدة البيانات المحلية والبيانات المنسخة. إيقاف المجمع لا يوقف المصدرين الآخرين الذين تم تكوينهم في التطبيق الخاص بك.
تتبعات السحابة	يتحكم Application Insights و Log Analytics في رسوم الوصول والاستبقاء وبيانات تتبع الاستخدام. لا تغير عوامل تصفية مجموعة الأدوات هذه النهج.
استدعاءات النموذج والأدوات	لا تمنع المجموعة المحلية الطلبات من مغادرة الكمبيوتر. راجع معالجة بيانات كل خدمة متصلة، بما في ذلك الأدوات غير Microsoft.

استخدم إرشادات تتبع Foundry للأمان والخصوصية والاحتفاظ بالبيانات والتكلفة. بالنسبة إلى هوية الإنتاج وعزل الشبكة والوصول إلى انتقال البيانات من الخادم، اتبع أمان العامل المستضاف ومعالجة البيانات. لا تعامل بيانات الاعتماد المحلية كأذونات للعامل المنشور.

Troubleshooting

مشكلة	ما يجب التحقق منه
لا يتوفر التتبع في الشريط الجانبي.	تأكد من تثبيت الملحق الحالي وتمكينه في البيئة التي تقوم بتشغيله فيها. يتطلب التتبع المحلي تحميل مكون SQLite الأصلي الخاص به.
المجمع لا يبدأ.	تحقق من وجود عملية أخرى باستخدام المنفذ 4317 أو 4318 وراجع إخراج Toolkit. تجنب المجمعات المتنافسة على نفس المنافذ.
ينجح الطلب المحلي ولكن لا يظهر أي تتبع.	تأكد من تشغيل الأجهزة قبل الطلب، ويعمل المجمع، ويستخدم المصدر البروتوكول الصحيح ونقطة النهاية. تحقق من تجاوزات نقطة النهاية وأخطاء المصدر وبيانات تتبع الاستخدام المخزنة مؤقتا، ثم حدد تحديث.
تظهر الامتدادات بدون رسائل.	تحقق من إعدادات تسجيل المحتوى والسمات المدعومة. تتطلب بعض المكتبات أيضا مصدر سجل. لا يعني المحتوى المفقود بالضرورة فشل المجموعة.
تتبعات السحابة فارغة.	تأكيد اتصال المشروع وApplication Insights، وإنشاء حركة مرور جديدة، وتوسيع النطاق الزمني، والسماح بتأخير الاستيعاب.
تفشل الاستعلامات السحابية مع حدوث خطأ في التخويل.	تحقق من الوصول للقراءة إلى Application Insights Log Analytics، بما في ذلك الجداول المحمية، باستخدام متطلبات الخدمة الأساسية.
لا يحتوي التتبع القديم على أي تفاصيل في مجموعة الأدوات.	يغطي استعلام التفاصيل سبعة أيام. الاستعلام عن السجلات القديمة التي تم الاحتفاظ بها في Foundry أو Azure Monitor.

الملاحظات

هل كانت هذه الصفحة مفيدة؟

تاريخ آخر تحديث في 2026-10-08