skill

مراقبة واجهة سطر الأوامر لوكلاء Google

تستخدم هذه المهارة عندما يرغب المستخدم في "إعداد التتبع"، "مراقبة وكيله"، "تهيئة التسجيل"، "إضافة قابلية الملاحظة"، "تصحيح أخطاء حركة المرور في الإنتاج"، أو يحتاج إلى إرشادات حول مراقبة الوكلاء المنشورين، بما في ذلك وكلاء ADK (Agent Development Kit). تغطي Cloud Trace، وتسجيل الاستجابة الفورية، وتحليلات وكيل BigQuery، وعمليات التكامل مع الجهات الخارجية (AgentOps، Phoenix، MLflow، إلخ)، واستكشاف الأخطاء وإصلاحها. وهي جزء من مجموعة مهارات agents-cli. لا تستخدم لإعداد النشر (استخدم google-agents-cli-d...).

google581,608+ تثبيتموثوق

نبذة

# دليل المراقبة

> تعمل **Cloud Trace** فورا — لا حاجة للبنية التحتية. يتطلب **تسجيل الاستجابة الفورية (Prompt-response logging)** و**تحليلات وكيل BigQuery (BigQuery Agent Analytics)** بنية تحتية مجهزة بواسطة Terraform (حساب خدمة، حاوية GCS، مجموعة بيانات BigQuery). قم بتشغيل `agents-cli infra single-project --apply --project PROJECT_ID` لتوفير هذه الموارد. تحصل مشاريع Go أيضا على مكدس قياسات BigQuery؛ تحميل إكمال GCS خلف تسجيل الاستجابة الفورية ومكون BigQuery Agent Analytics الإضافي متاحان فقط في Python. راجع `references/cloud-trace-and-logging.md` للحصول على التفاصيل، ومتغيرات البيئة، وأوامر التحقق. إذا لم يتم إعداد مشروعك بعد، فراجع `/google-agents-cli-scaffold` أولا.

### ترتيب النشر

| هل تريد مراقبة مدارة بواسطة Terraform؟ | الإجراء | |---|---| | **لا** | قم بتشغيل `agents-cli deploy` مباشرة (يعمل لجميع الأهداف). | | **نعم** | قم بتشغيل `agents-cli infra single-project --apply` أولا، ثم `agents-cli deploy`. |

**إذا قمت بالفعل بتشغيل `agents-cli deploy` بشكل إلزامي:** لا تقم بتطبيق Terraform بعد ذلك. بالنسبة ل Agent Runtime في منصة Gemini، يمتلك Terraform المحرك بأكمله (حساب الخدمة، مواصفات النشر، متغيرات البيئة)، لذا لا يمكن التوفيق بين تطبيق لاحق دون الاستيلاء على المورد. إما أن تحذف النشر وتبدأ من جديد، أو تحتفظ بالمثيل المنشور بواسطة SDK — تخطى `infra single-project` وقم بتعيين متغيرات بيئة المراقبة عن طريق إعادة تشغيل `agents-cli deploy --update-env-vars "KEY=VALUE,..."`؛ يتطابق النشر مع Reasoning Engine الحالي حسب اسم العرض ويحدثه في مكانه، مع الحفاظ على متغيرات البيئة المعينة خارج النشر. يجب عليك أيضا منح حساب خدمته أدوار IAM الخاصة بالقياسات التي سيوفرها Terraform بخلاف ذلك: `roles/storage.admin` (لكتابة الإكمال إلى حاوية السجلات)، `roles/logging.logWriter`، `roles/cloudtrace.agent`، بالإضافة إلى `roles/bigquery.dataOwner` + `roles/bigquery.jobUser` عند الإعداد باستخدام `--bq-analytics`. المجموعة الكاملة موجودة في `deployment/terraform/single-project/iam.tf` (من `app_sa_roles`) و`telemetry.tf`. متغيرات البيئة المدارة بواسطة Terraform غير متاحة في هذا الوضع.

### ملفات المرجع

| الملف | المحتويات | |------|----------| | `references/cloud-trace-and-logging.md` | تفاصيل المشروع المجهز — الموارد الموفرة بواسطة Terraform، متغيرات البيئة، أوامر التحقق، التمكين/التعطيل محليا | | `references/bigquery-agent-analytics.md` | مكون BQ Agent Analytics الإضافي — التمكين، الميزات الرئيسية، تفريغ GCS، مصدر الأداة | | `references/adk-docs.md` | **ADK:** صفحات adk.dev لجلب التفاصيل التي تتجاوز هذه المهارة | | `references/feedback-mechanism.md` | إضافة نقطة نهاية لتعليقات المستخدمين — نموذج الطلب، التسجيل المنظم، مجمع السجلات ← BigQuery |

---

## مستويات المراقبة

اختر المستوى المناسب من المراقبة بناء على احتياجاتك:

| المستوى | ما يفعله | النطاق | الحالة الافتراضية | الأفضل ل | |------|-------------|-------|---------------|----------| | **Cloud Trace** | التتبع الموزع — تدفق التنفيذ، زمن الوصول، الأخطاء عبر نطاقات OpenTelemetry | جميع القوالب، جميع البيئات | ممكن دائما | تصحيح أخطاء زمن الوصول، فهم تدفق تنفيذ الوكيل | | **Prompt-Response Logging** | تفاعلات GenAI المصدرة إلى GCS و BigQuery و Cloud Logging | مشاريع ADK Python و Claude المجهزة | معطل محليا، ممكن عند النشر | تدقيق تفاعلات LLM، الامتثال | | **BigQuery Agent Analytics** | أحداث الوكيل المنظمة (استدعاءات LLM، استخدام الأداة، النتائج) إلى BigQuery | وكلاء ADK Python مع تمكين المكون الإضافي؛ وكلاء قالب Claude | اختياري (`--bq-analytics` وقت الإعداد) | تحليلات المحادثة، لوحات المعلومات المخصصة، تقييمات LLM-as-judge | | **Third-Party Integrations** | منصات المراقبة الخارجية (AgentOps, Phoenix, MLflow, إلخ.) | أي وكيل مزود بأدوات OpenTelemetry | اختياري، إعداد لكل مزود | التعاون الجماعي، التصور المتخصص، إدارة المطالبات |

**اسأل المستخدم** عن المستويات التي يحتاجها — يمكن دمجها. Cloud Trace يعمل دائما؛ المستويات الأخرى إضافية.

---

## Cloud Trace

تستخدم الوكلاء المجهزة OpenTelemetry لإصدار آثار موزعة. ينتج كل استدعاء للوكيل نطاقات تتتبع تدفق التنفيذ الكامل.

### التسلسل الهرمي للنطاقات

> **مشاريع ADK.** هذه هي أسماء نطاقات ADK؛ تصدر الأطر الأخرى نطاقاتها الخاصة (`generate_content` يأتي من أداة google-genai المشتركة على أي حال).

``` invoke_workflow (top-level run) └── invoke_agent (one per agent in the chain) ├── call_llm (model request) │ └── generate_content (underlying GenAI model call) └── execute_tool (tool execution) ```

### الإعداد حسب نوع النشر

| النشر | الإعداد | |-----------|-------| | **Agent Runtime** | تلقائي — يتم توصيل المصدرين عند بدء التشغيل، ويتم التحكم فيه بواسطة `GOOGLE_CLOUD_AGENT_ENGINE_ENABLE_TELEMETRY` (يتم تعيينه بواسطة النشر)؛ يصدر إلى Cloud Trace/Logging + صفحة Agent Runtime في وحدة تحكم Google Cloud | | **Cloud Run / GKE (مجهز)** | تلقائي — يتم توصيل المصدرين عند بدء التشغيل، يصدر إلى Cloud Trace/Logging | | **Cloud Run / GKE (يدوي)** | قم بتكوين مصدر OpenTelemetry في تطبيقك | | **التطوير المحلي** |

التثبيت

شغل هذا الأمر

npx skills add google/agents-cli

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `npx skills add google/agents-cli`، أو استنسخ المستودع وانسخ مجلد `skills/google-agents-cli-observability` إلى دليل مهارات Claude الخاص بك.

عرض المصدر

أسئلة شائعة

ما هي مهارة مراقبة واجهة سطر الأوامر لوكلاء Google؟

تستخدم هذه المهارة عندما يرغب المستخدم في "إعداد التتبع"، "مراقبة وكيله"، "تهيئة التسجيل"، "إضافة قابلية الملاحظة"، "تصحيح أخطاء حركة المرور في الإنتاج"، أو يحتاج إلى إرشادات حول مراقبة الوكلاء المنشورين، بما في ذلك وكلاء ADK (Agent Development Kit). تغطي Cloud Trace، وتسجيل الاستجابة الفورية، وتحليلات وكيل BigQuery، وعمليات التكامل مع الجهات الخارجية (AgentOps، Phoenix، MLflow، إلخ)، واستكشاف الأخطاء وإصلاحها. وهي…

كيف أثبت مراقبة واجهة سطر الأوامر لوكلاء Google؟

شغل هذا الأمر في الطرفية:

npx skills add google/agents-cli
مع أي أدوات ذكاء اصطناعي تعمل مراقبة واجهة سطر الأوامر لوكلاء Google؟

تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.

من طور مراقبة واجهة سطر الأوامر لوكلاء Google؟

طورها google.

هل مراقبة واجهة سطر الأوامر لوكلاء Google مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في البيانات والتحليلات.

كل بدائل مراقبة واجهة سطر الأوامر لوكلاء Google ←
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
سجل Hyperframes
حوالي 450 قالب HyperFrames جاهز ومكونات مثبتة كمصدر قابل للتعديل - انتقالات، تراكبات، عناوين، نصوص حركية، تسميات توضيحية، رسوم بيانية، تراكبات خرائط،…1,357,856+
skillclaude_appclaude_codeclaude_api
npx skills add microsoft/azure-skills
Microsoft Foundry
بناء ونشر وتقييم وتحسين وضبط وإدارة وكلاء ونماذج وموارد Microsoft Foundry من البداية إلى النهاية. يستخدم ل: foundry, azd ai agent, azd provision/deplo…738,286+
skillclaude_appclaude_codeclaude_api
npx skills add microsoft/azure-skills
Azure Kusto
استعلام وتحليل البيانات في Azure Data Explorer (Kusto/ADX) باستخدام KQL لتحليلات السجلات، القياس عن بعد، وتحليل السلاسل الزمنية. متى: استعلامات KQL، ا…552,598+
skillclaude_appclaude_codeclaude_api
npx skills add microsoft/azure-skills
تخزين Azure
خدمات Azure Storage بما في ذلك Blob Storage وFile Shares وQueue Storage وTable Storage وData Lake. يجيب على الأسئلة المتعلقة بمستويات الوصول للتخزين (…546,701+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
الساحر
أنشئ معالج bash تفاعليا يرشد المستخدم البشري عبر خطوات لا يمكن إلا له تنفيذها. استخدمه عند توفير البنية التحتية، أو إعداد بيانات الاعتماد أو أسرار CI،…424,988+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
الترحيل إلى Shoehorn
ترحيل ملفات الاختبار من تأكيدات النوع `as` إلى @total-typescript/shoehorn. استخدمه عندما يذكر المستخدم shoehorn، أو يريد استبدال `as` في الاختبارات، أ…388,771+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في البيانات والتحليلات