إعداد بيانات القياس في LogBrew

اختر تطبيقًا أو إطار عمل، وأنشئ مشروعًا، وتحقّق من وصول إشارة آمنة واحدة.

اختيار المنصةفتح «إضافة مشروع»

اختر المنصة

اختر التطبيق أو إطار العمل الذي يرسل بيانات القياس. واستخدم الاختيار نفسه في «إضافة مشروع».

تصفية المنصات
المعروض: 6 من 26

Node.js

خدمة Node.js

استخدم حزمة Node.js عندما تحتاج خدمة خلفية إلى السجلات وSpans الطلبات والإجراءات والإصدارات والمقاييس.

npm install @logbrew/sdk @logbrew/node
اتبع مسار أول إشارة لـNode

Express

خدمة Express

استخدم حزمة Express عندما تعالج خدمة Node الطلبات عبر وسيط Express (middleware).

npm install @logbrew/sdk @logbrew/express express
فتح «إضافة مشروع»

Fastify

خدمة Fastify

استخدم حزمة Fastify عندما تعالج خدمة Node المسارات عبر إضافات Fastify.

npm install @logbrew/sdk @logbrew/fastify fastify
فتح «إضافة مشروع»

NestJS

خدمة NestJS

استخدم حزمة NestJS عندما تكون خدمة Node منظّمة حول وحدات Nest ومعالجة الطلبات.

npm install @logbrew/sdk @logbrew/nestjs @nestjs/common @nestjs/core @nestjs/platform-express reflect-metadata rxjs
فتح «إضافة مشروع»

Python

خدمة Python

ابدأ بالحزمة الأساسية لعمليات Python الخلفية وخدماتها.

python3 -m pip install logbrew-sdk
فتح «إضافة مشروع»

Django

تطبيق Django

استخدم حزمة Django لإشارات الطلبات والتطبيق من مشروع Django.

python3 -m pip install logbrew-sdk logbrew-django
فتح «إضافة مشروع»

أمر التثبيت

أول تشغيل ناجح لـSDK

اجعل الجلسة الأولى مركّزة: ثبّت الحزمة، وأنشئ المشروع، وأرسل إجراء منتج واحدًا لا يحتوي على أسرار، ثم تأكد منه في LogBrew.

  1. 1تثبيت SDKاستخدم حزم Node لخدمة خلفية تحتاج إلى السجلات وSpans والإجراءات والإصدارات والمقاييس.
    npm install @logbrew/sdk @logbrew/node
  2. 2إنشاء المشروعافتح «إضافة مشروع»، واختر منصة، وانسخ بيانات اعتماد الاستيعاب. تعرضها لوحة الإعداد مرة واحدة.فتح «إضافة مشروع»
  3. 3إرسال إجراء منتج واحدشغّل المثال المرفق بالحزمة قبل ربط كود الإنتاج، لتعرف شكل البيانات الأولى دون أي رمز مميز.
    node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs
  4. 4التحقق في LogBrewاقرأ أول إشارة info في السجلات قبل إضافة مزيد من أدوات القياس.
    logbrew logs info --json

أعطِ الوكيل خريطة LogBrew العامة قبل أن يعدّل تطبيقك أو أمر الإعداد.

curl -L https://logbrew.co/llms.txt
موجّه التثبيتاقرأ https://logbrew.co/llms.txt، ثم اختر بطاقة SDK المطابقة في https://logbrew.co/en/docs#docs-sdk-choice-title. استخدم npm install @logbrew/sdk @logbrew/node فقط لخدمة Node.js تعمل على جهة الخادم. أما مع Next.js أو React أو iOS أو Android أو React Native، فاستخدم البطاقة المختارة وموجّه «إضافة مشروع». اطلب من المستخدم المسجَّل دخوله أن يفتح «إضافة مشروع»، وأن يضع بيانات الاعتماد في بيئة التطبيق المطابقة فقط. في Node.js على جهة الخادم، متغير البيئة هو LOGBREW_SERVER_API_KEY. شغّل node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs لخدمات Node فقط، ثم تحقّق باستخدام logbrew logs info --json. لا تطلب بيانات الاعتماد في المحادثة أو في الـcommits.
فتح دليل الوكلاء

أعِدّ خدمة Node.js وتحقّق من أول بيانات قياس منها. ينشئ «إضافة مشروع» المشروع ويعرض بيانات اعتماد الاستيعاب مرة واحدة. تغطي الخطوات التالية التثبيت والتحقق.

  1. إضافة حزم JavaScript SDK

    ابدأ بـSDK الأساسي ومساعد Node عندما تحتاج خدمة خلفية إلى السجلات وSpans الطلبات والإجراءات والإصدارات والمقاييس.

    npm install @logbrew/sdk @logbrew/node

  2. إنشاء المشروع من «إضافة مشروع»

    سجّل الدخول، وافتح «إضافة مشروع»، واختر منصة، وانسخ بيانات اعتماد الاستيعاب. تُعرض مرة واحدة، ولا يعرضها الموقع مرة أخرى بعد مغادرة لوحة الإعداد.

    فتح «إضافة مشروع»

  3. تشغيل مثال أول إشارة من SDK

    استخدم مثال الحزمة المثبّتة لتفحص شكل الإصدار والبيئة وSpan الطلب وإجراء المنتج ومرحلة الشبكة والمقياس قبل ربط تطبيقك.

    node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs

  4. قراءة أول إشارة في LogBrew

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

    logbrew logs info --json

docs.logbrew.co

موقع التوثيق الكامل

استخدم موقع التوثيق المخصص للإعداد المفصّل وتفاصيل API والأمثلة التي لا ينبغي أن تزدحم بها صفحات المنتج الرئيسية.

فتح موقع التوثيق

نص عادي

نسخة التوثيق بتنسيق Markdown

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

فتح Markdown

نص عادي

نسخ مخصصة للوكلاء

استخدم llms.txt ونسخ Markdown وملف robots وخريطة الموقع عندما يحتاج وكيل إلى مسارات قراءة عامة يمكن توقعها.

فتح llms.txt

الإعداد

تحقّق من جاهزية LogBrew

شغّل status أولًا لتتأكد من إمكانية الوصول وحالة تسجيل الدخول والقراءة الآمنة التالية.

logbrew status --json

الفرز

ابدأ من أحدث الأعطال

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

logbrew logs error --json

التسليم

شارك عرضًا ثابتًا للمشكلات

اعرض المشكلات المفتوحة عندما يحتاج زميل إلى مجموعات الأعطال نفسها.

logbrew issues open --json

خريطة الأوامر

الحالة

افحص المصادقة المحلية وإمكانية الوصول إلى API وخطوات الاسترداد قبل أي قراءة خاصة.

logbrew status --json

خريطة الأوامر

السجلات

ابدأ بالأخطاء الحديثة عندما يحتاج إصدار أو مشروع أو تتبّع إلى سياق.

logbrew logs error --json

خريطة الأوامر

المشكلات

اعرض مجموعات الأعطال المفتوحة قبل أن تقرر الحل أو الإغلاق أو التجاهل أو إعادة الفتح.

logbrew issues open --json

خريطة الأوامر

تفاصيل التتبّع

اقرأ تتبّعًا معروف المعرّف عندما تشير السجلات أو المشكلات إلى طلب واحد فاشل.

logbrew trace <trace_id> --json

خريطة الأوامر

الإجراءات

صفِّ أحداث المستخدمين حسب الاسم عندما يكون السياق المهم إجراءً في المنتج.

logbrew actions --name checkout_failed --json

خريطة الأوامر

الإصدارات

قارن سياق الطرح بأعداد السجلات والمشكلات وSpans التتبّع والإجراءات.

logbrew releases --json

CLI أولًا

افحص المصادقة المحلية وإمكانية الوصول إلى API

ينبغي أن تخبرك القراءة الأولى هل يستطيع CLI الوصول إلى LogBrew API دون كشف بيانات الرمز المميز.

  • استخدم وضع JSON عندما يحتاج سكربت أو أتمتة إلى حقول ثابتة.
  • استخدم المخرجات المقروءة للبشر عندما يحتاج المطوّر إلى الأمر التالي.
  • اجعل استرداد المصادقة يعيدك دائمًا إلى login وstatus.

المراقبة

اقرأ إشارات الإنتاج حسب المورد

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

  • تحتفظ السجلات بعوامل تصفية الخطورة والإصدار والبيئة والمشروع والتتبّع والبحث.
  • افحص حالة المشكلة وآخر حدوث لها قبل أن تحقّق فيها.
  • تحتفظ التتبّعات بأسماء Spans وسياق الإصدار وسياق البيئة ونطاق المشروع.

المشاركة

أرسل سياقًا مفيدًا دون كشف بيانات المشروع

استخدم التوثيق العام وMarkdown والأوامر القابلة للنسخ عندما يحتاج أحدهم إلى مساعدة في الإعداد أو إلى تسليم آمن.

  • شارك رابط التوثيق عندما تكون الخطوة التالية هي الإعداد أو اكتشاف الأوامر.
  • شارك Markdown عندما يكون النص العادي أسهل من لقطة الشاشة.
  • لا تشارك بيانات المشروع الخاصة إلا مع من لديهم إذن برؤيتها.

قراءات API

اختر المشروع والنطاق الزمني

استخدم مرجع API لبيانات القياس لمعرفة المسارات وعوامل التصفية المدعومة وأمثلة النجاح والخطأ.

  • صادِق قبل أن تطلب بيانات مشروع خاصة.
  • اختر المشروع والنطاق الزمني قبل مقارنة النتائج.
  • اتبع خطوات الاسترداد المُعادة عندما يفشل طلب ما.
  • افصل بين الأدلة الغائبة والأدلة التي تعذّر تحميلها.