mirror of
https://github.com/crewAIInc/crewAI.git
synced 2026-07-06 07:29:24 +00:00
fa89ac428e
Adds a consolidated `datadog.mdx` under `docs/edge/{en,pt-BR,ko,ar}/enterprise/guides/`
covering both the Datadog Agent path (stdout JSON logs via `CREWAI_LOG_FORMAT=json`)
and the Datadog OTLP intake, with a JSON log schema reference and a ready-to-import
operations dashboard (`datadog_dashboard.json`). Reframes `capture_telemetry_logs.mdx`
to lead with OpenTelemetry as the vendor-neutral path and point readers to the new
Datadog page for that ecosystem's setup.
58 lines
3.9 KiB
Plaintext
58 lines
3.9 KiB
Plaintext
---
|
|
title: "تصدير OpenTelemetry"
|
|
description: "تصدير التتبعات والسجلات من عمليات نشر CrewAI AMP إلى مجمّع OpenTelemetry الخاص بك"
|
|
icon: "magnifying-glass-chart"
|
|
mode: "wide"
|
|
---
|
|
|
|
يمكن لـ CrewAI AMP تصدير **التتبعات** و**السجلات** من OpenTelemetry من عمليات النشر مباشرة إلى مجمّعك الخاص. يتيح لك ذلك مراقبة أداء الوكلاء وتتبع استدعاءات LLM وتصحيح الأخطاء باستخدام مجموعة المراقبة الحالية.
|
|
|
|
تتبع بيانات القياس [اتفاقيات OpenTelemetry GenAI الدلالية](https://opentelemetry.io/docs/specs/semconv/gen-ai/) بالإضافة إلى سمات خاصة بـ CrewAI.
|
|
|
|
<Tip>
|
|
تُعدّ OpenTelemetry **مسار المراقبة الموصى به** — محايدة تجاه الموردين، وتعمل مع أي خلفية متوافقة مع OTLP (Grafana, Honeycomb, NewRelic، أو مجمّعك الخاص). إذا كنت تستخدم Datadog تحديدًا، فراجع دليل [تكامل Datadog](./datadog) المخصص، الذي يغطي كلًا من مسار وكيل Datadog واستيعاب OTLP من Datadog.
|
|
</Tip>
|
|
|
|
## المتطلبات المسبقة
|
|
|
|
<CardGroup cols={2}>
|
|
<Card title="حساب CrewAI AMP" icon="users">
|
|
يجب أن يكون لدى مؤسستك حساب CrewAI AMP نشط.
|
|
</Card>
|
|
<Card title="مجمّع OpenTelemetry" icon="server">
|
|
تحتاج إلى نقطة نهاية مجمّع متوافقة مع OpenTelemetry (مثل OTel Collector الخاص بك أو Datadog أو Grafana أو أي واجهة خلفية متوافقة مع OTLP).
|
|
</Card>
|
|
</CardGroup>
|
|
|
|
## إعداد مجمّع
|
|
|
|
1. في CrewAI AMP، انتقل إلى **Settings** > **OpenTelemetry Collectors**.
|
|
2. انقر على **Add Collector**.
|
|
3. اختر تكاملاً:
|
|
- **OpenTelemetry Traces** و**OpenTelemetry Logs** — صدّر إلى أي مجمّع أو واجهة خلفية متوافقة مع OTLP.
|
|
- **Datadog** — أرسل التتبعات مباشرة إلى استقبال OTLP الخاص بـ Datadog، دون الحاجة إلى مجمّع منفصل أو Datadog Agent.
|
|
4. هيّئ الاتصال. تعتمد الحقول على التكامل الذي اخترته:
|
|
|
|
<Tabs>
|
|
<Tab title="OpenTelemetry Traces / Logs">
|
|
إن **OpenTelemetry Traces** و**OpenTelemetry Logs** تكاملان منفصلان يتشاركان نفس الحقول — اختر التكامل المطابق للإشارة التي تريد تصديرها.
|
|
|
|
- **Endpoint** — نقطة نهاية OTLP لمجمّعك (مثل `https://otel-collector.example.com:4317`).
|
|
- **Service Name** — اسم لتعريف هذه الخدمة في منصة المراقبة.
|
|
- **Custom Headers** *(اختياري)* — أضف رؤوس المصادقة أو التوجيه كأزواج مفتاح-قيمة.
|
|
- **Certificate** *(اختياري)* — قدم شهادة TLS إذا كان مجمّعك يتطلبها.
|
|
|
|
<Frame></Frame>
|
|
</Tab>
|
|
<Tab title="Datadog">
|
|
لإعداد Datadog، راجع دليل [تكامل Datadog](./datadog) المخصص — فهو يغطي كلًا من مسار وكيل Datadog (الموصى به، أرخص لحجم السجلات الكبير) واستيعاب OTLP من Datadog، مع خطوات تهيئة كاملة للمجمّع.
|
|
</Tab>
|
|
</Tabs>
|
|
|
|
5. *(اختياري)* انقر على **Test Connection** للتحقق من قدرة CrewAI على الوصول إلى نقطة النهاية باستخدام بيانات الاعتماد التي قدمتها.
|
|
6. انقر على **Save**.
|
|
|
|
<Tip>
|
|
يمكنك إضافة مجمّعات متعددة — على سبيل المثال، واحد للتتبعات وآخر للسجلات، أو الإرسال إلى واجهات خلفية مختلفة لأغراض مختلفة.
|
|
</Tip>
|