--json للحصول على مخرجات
منظّمة تناسب البرامج النصية ووكلاء الذكاء الاصطناعي.
استبدل كل عنصر نائب بين قوسين زاويين قبل أن تشغّل أي أمر. استخدم معرّفات
المشاريع والمشكلات والتتبّعات التي أرجعها LogBrew.
تثبيت CLI
اختر طريقة تثبيت واحدة. macOS أو Linux:يحتاج Cargo إلى Rust 1.87 أو أحدث. أما الطرق الأخرى فتثبّت ملفًا تنفيذيًا أصليًا
ولا تحتاج إلى Rust.
تحديث CLI
لا يحدّث CLI نفسه تلقائيًا. استخدم الطريقة نفسها التي ثبّتها بها. Homebrew:ok وname وversion وbinary وos وarch.
تسجيل الدخول والتحقق من الجلسة
اقرأ الحساب المستخدم في الطرفية الحالية:whoami الحساب المتوقع، فتابع. وإلا، فسجّل الدخول. يُكمل شخص تسجيل
الدخول لدى المزوّد في المتصفح. ويجب على وكيل البرمجة أن يطلب من شخص تنفيذ هذه
الخطوة.
github (الافتراضي) أو gitlab أو bitbucket أو google.
على جهاز لا يمكنه فتح متصفح، مثل جلسة SSH أو حاوية أو مهمة CI، استخدم تسجيل
الدخول عبر جهاز آخر:
--no-open مثل --device.
مع --json، يطبع CLI الرابط والرمز في سطر JSON واحد، ثم يطبع النتيجة في سطر
JSON ثانٍ. ويمكن لوكيل البرمجة أن يعطي الرابط والرمز لشخص ثم ينتظر.
بعد تسجيل الدخول، شغّل status وwhoami مرة أخرى. لا تضع بيانات اعتماد الحساب
في موجّه (prompt) أو تقرير أو ملف مصدري.
إعداد مشروع
انتقل إلى المجلد الذي يحتوي على ملف الحزمة أو ملف البناء الخاص بالتطبيق. في المستودع الموحّد (monorepo)، اختر تطبيقًا واحدًا أو خدمة واحدة. ثم شغّل:--yes --json. وتضيف هذه الخيارات خطوات أخرى:
التخطيط لإعداد SDK
لقراءة خطة الإعداد دون أي تغيير، شغّل:detected وinstall_ready وinstall_plan وnext. تحدد الخطة بيئة
التشغيل وإطار العمل ومدير الحزم وأمر التثبيت. لا يثبّت CLI أي حزم ولا يغيّر أي
ملفات. وتعطي الأوامر logbrew init وinstall وconfigure وsdk الخطة نفسها.
راجع دمج SDK لمعرفة الخطوات
الخاصة بكل بيئة تشغيل. شغّل logbrew examples لعرض قائمة قصيرة بالأوامر الشائعة.
قراءة المشاريع وإنشاؤها وإعدادها
اعرض المشاريع النشطة في حسابك:
تحتوي نتيجة JSON على
status وproject_id وingest_key وchecks وnext.
ويحتوي ingest_key على id وlabel وkind وcreated_at وexpires_at
الخاصة بالمفتاح. لاستبدال مفتاح، راجع تدوير مفتاح الاستيعاب.
لإبطال مفتاح، استخدم قيمة id الخاصة به من تلك النتيجة:
--abandon-retry فقط لبدء محاولة جديدة.
لإنشاء مشروع جديد، اتبع البدء السريع. يستخدم
logbrew projects create "<name>" --ingest-key-file "<private_key_file>"،
الذي يخزّن المفتاح الأول بالطريقة نفسها. شغّل logbrew setup --create-project
لقراءة تعليمات إنشاء المشروع. هذا الأمر لا ينشئ مشروعًا.
بعد أي خطوة إعداد، يمكنك تسجيلها للمشروع. قيمة --source هي api أو cli أو
sdk:
0 لا يعني أن كل الفحوص نجحت. اقرأ status في التقرير وكل فحص على
حدة. راجع مرجع تقرير التشخيص.
قراءة استخدام الحساب
اقرأ الاستخدام والحدود. هذا لا يغيّر حالة الحساب أو الفوترة.logbrew account usage --json النتيجة نفسها. تعرض الاستجابة الخطة، وحالة
الحصة، وتاريخ إعادة التعيين، وإجمالي الاستخدام حسب المشروع وحسب نوع بيانات
القياس، والخطوة التالية. تشمل الحقول plan وstate وreset_at وby_project
وby_stream وnext.
تحقيقات شائعة
صفِّ كل قراءة حسب المشروع. أضف عوامل تصفية الإصدار أو البيئة أو الوقت أو الخطورة عندما يدعمها الأمر. راجع عوامل التصفية.المشكلات في إصدار معيّن
طلب واحد فاشل
سجلات إصدار معيّن
المشكلات المُسندة إليك
مشاهدة الأحداث المباشرة
استخدم watch لرؤية الأحداث الجديدة أثناء اختبار تغيير ما. اضغط Ctrl+C للإيقاف.--json، يتوقف الأمر مع خطأ. أضف logs أو
issues أو actions لمشاهدة نوع واحد، مثل logbrew watch logs --json. لا يدعم
watch التتبّعات أو الـ Spans.
لا يحتوي watch على عامل تصفية للمشروع أو الإصدار أو البيئة. لمشروع واحد، استخدم
القراءات السابقة. راجع المتابعة المباشرة لمعرفة الموارد
وعوامل التصفية المدعومة.
افهم المشكلة قبل تغيير الشيفرة
اقرأ السياق قبل أن تقترح إصلاحًا.1
قراءة المشكلة
2
قراءة التتبّع
نفّذ هذه الخطوة فقط إذا كان للمشكلة معرّف تتبّع. المشكلة التي ليس لها تتبّع
تظل صالحة.
3
قراءة الشرح
logbrew explain log "<log_id>" --json. وللإجراء، استخدم
logbrew explain action "<action_id>" --json.4
الحلّ بعد التحقق
مخرجات JSON
- ضع
--jsonقبل الأمر أو بعده، مثلlogbrew --json statusأوlogbrew status --json. - اقرأ رمز الخروج قبل أن تستخدم المخرجات.
- تحتوي أخطاء JSON على
okوerrorوmessageوnext. انتهاء المهلة لا يثبت أن عملية الكتابة فشلت. قبل أن تكرر عملية كتابة، اقرأ قواعد إعادة المحاولة الخاصة بها. - لا تعتمد في الأتمتة على مخرجات من دون
--json، فقد تتغير.
