mirror of
https://github.com/crewAIInc/crewAI.git
synced 2026-07-07 16:09:30 +00:00
f523a7d029
* docs: udpate docs to reflect new state of OpenTelemetry collector * docs: add OTel collector and Datadog screenshots These images are referenced by the capture_telemetry_logs guides but were missing from the tree, which broke the link checker across all locales. * docs: address PR review on OTel collector guide - Clarify that OpenTelemetry Traces and Logs are separate integrations sharing the same fields (resolves Traces/Logs wording inconsistency) - List regional Datadog OTLP hosts (US1/US3/US5/EU1/AP1) so users outside US5 can copy the right domain
64 lines
4.0 KiB
Plaintext
64 lines
4.0 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.
|
|
|
|
## المتطلبات المسبقة
|
|
|
|
<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 Site Domain** — مضيف OTLP لموقع Datadog الخاص بك فقط، دون بروتوكول أو مسار. يقوم CrewAI ببناء نقطة نهاية HTTPS OTLP الكاملة نيابةً عنك. استخدم المضيف المطابق لـ [موقع Datadog](https://docs.datadoghq.com/getting_started/site/) الخاص بك:
|
|
- `otlp.datadoghq.com` (US1)
|
|
- `otlp.us3.datadoghq.com` (US3)
|
|
- `otlp.us5.datadoghq.com` (US5)
|
|
- `otlp.datadoghq.eu` (EU1)
|
|
- `otlp.ap1.datadoghq.com` (AP1)
|
|
- **API Key** — مفتاح واجهة برمجة تطبيقات Datadog الخاص بك. راجع [كيفية إنشاء واحد](https://docs.datadoghq.com/account_management/api-app-keys/#api-keys).
|
|
|
|
يصدّر تكامل Datadog **التتبعات**.
|
|
|
|
<Frame></Frame>
|
|
</Tab>
|
|
</Tabs>
|
|
|
|
5. *(اختياري)* انقر على **Test Connection** للتحقق من قدرة CrewAI على الوصول إلى نقطة النهاية باستخدام بيانات الاعتماد التي قدمتها.
|
|
6. انقر على **Save**.
|
|
|
|
<Tip>
|
|
يمكنك إضافة مجمّعات متعددة — على سبيل المثال، واحد للتتبعات وآخر للسجلات، أو الإرسال إلى واجهات خلفية مختلفة لأغراض مختلفة.
|
|
</Tip>
|