# إعداد بيانات القياس في LogBrew اختر تطبيقًا أو إطار عمل، وأنشئ مشروعًا، وتحقّق من وصول إشارة آمنة واحدة. # اختر المنصة اختر التطبيق أو إطار العمل الذي يرسل بيانات القياس. واستخدم الاختيار نفسه في «إضافة مشروع». ## خدمة Node.js استخدم حزمة Node.js عندما تحتاج خدمة خلفية إلى السجلات وSpans الطلبات والإجراءات والإصدارات والمقاييس. ```bash npm install @logbrew/sdk @logbrew/node ``` Next: اتبع مسار أول إشارة لـNode ## خدمة Express استخدم حزمة Express عندما تعالج خدمة Node الطلبات عبر وسيط Express (middleware). ```bash npm install @logbrew/sdk @logbrew/express express ``` Next: فتح «إضافة مشروع» ## خدمة Fastify استخدم حزمة Fastify عندما تعالج خدمة Node المسارات عبر إضافات Fastify. ```bash npm install @logbrew/sdk @logbrew/fastify fastify ``` Next: فتح «إضافة مشروع» ## تطبيق JavaScript استخدم حزمة JavaScript للمتصفح في صفحات الواجهة الأمامية التي تُصدر إجراءات المنتج والسجلات وإشارات خفيفة من جهة العميل. ```bash npm install @logbrew/sdk @logbrew/browser ``` Next: فتح «إضافة مشروع» ## تطبيق Next.js استخدم حزمة Next.js عندما تحتاج المسارات والعرض على الخادم وإجراءات العميل إلى مسار إعداد واحد. ```bash npm install @logbrew/sdk @logbrew/next next react react-dom ``` Next: فتح «إضافة مشروع» ## تطبيق React استخدم حزمة React لتطبيقات الويب المبنية على المكوّنات التي ترسل إجراءات المستخدمين وحالة الواجهة. ```bash npm install @logbrew/sdk @logbrew/react react ``` Next: فتح «إضافة مشروع» ## تطبيق Angular استخدم حزمة Angular عندما ينبغي أن يتشارك توجيه إطار العمل وأخطاء التطبيق مسار إعداد واحدًا. ```bash npm install @logbrew/sdk @logbrew/angular @angular/core ``` Next: فتح «إضافة مشروع» ## تطبيق Vue استخدم حزمة Vue لتطبيقات Vue التي تحتاج إلى إجراءات منتج واضحة وإشارات من جهة المتصفح. ```bash npm install @logbrew/sdk @logbrew/vue vue ``` Next: فتح «إضافة مشروع» ## تطبيق Svelte استخدم حزمة Svelte لتطبيقات Svelte التي تحتاج إلى مسار تثبيت مباشر لـSDK. ```bash npm install @logbrew/sdk @logbrew/svelte svelte ``` Next: فتح «إضافة مشروع» ## خدمة NestJS استخدم حزمة NestJS عندما تكون خدمة Node منظّمة حول وحدات Nest ومعالجة الطلبات. ```bash npm install @logbrew/sdk @logbrew/nestjs @nestjs/common @nestjs/core @nestjs/platform-express reflect-metadata rxjs ``` Next: فتح «إضافة مشروع» ## خدمة Python ابدأ بالحزمة الأساسية لعمليات Python الخلفية وخدماتها. ```bash python3 -m pip install logbrew-sdk ``` Next: فتح «إضافة مشروع» ## تطبيق Django استخدم حزمة Django لإشارات الطلبات والتطبيق من مشروع Django. ```bash python3 -m pip install logbrew-sdk logbrew-django ``` Next: فتح «إضافة مشروع» ## خدمة FastAPI استخدم حزمة FastAPI لواجهات Python البرمجية مع Spans طلبات وإجراءات صريحة. ```bash python3 -m pip install logbrew-sdk logbrew-fastapi ``` Next: فتح «إضافة مشروع» ## خدمة .NET ثبّت حزمة .NET عندما تتولى خدمة إشارات جهة الخادم. ```bash dotnet add package LogBrew ``` Next: فتح «إضافة مشروع» ## تطبيق ASP.NET Core استخدم حزمة ASP.NET Core عندما تحتاج معالجة طلبات .NET وإشارات تطبيق الويب إلى مسار إعداد واحد. ```bash dotnet add package LogBrew.AspNetCore ``` Next: فتح «إضافة مشروع» ## خدمة Java استخدم حزمة JVM لخدمات Java التي تحتاج إلى سجلات خاصة بالتطبيق وSpans طلبات وإجراءات منتج. ```bash implementation("co.logbrew:logbrew-sdk:0.1.0") ``` Next: فتح «إضافة مشروع» ## خدمة Go أضف حزمة Go عندما تتولى خدمة السجلات وSpans والمقاييس وسياق التتبّع بشكل صريح. ```bash go get github.com/LogBrewCo/sdk/go/logbrew@v0.1.3 ``` Next: فتح «إضافة مشروع» ## تطبيق PHP استخدم Composer لخدمات PHP وإشارات الطلبات الخاصة بالتطبيق. ```bash composer require logbrew/sdk ``` Next: فتح «إضافة مشروع» ## خدمة Ruby استخدم Ruby gem لخدمات Ruby التي تحتاج إلى إشارات صريحة للتطبيق والطلبات. ```bash gem install logbrew-sdk ``` Next: فتح «إضافة مشروع» ## خدمة Rust أضف Rust crate للخدمات التي تبني سجلاتها وSpans وإجراءاتها ومقاييسها بنفسها. ```bash cargo add logbrew ``` Next: فتح «إضافة مشروع» ## تطبيق iOS استخدم حزمة منصات Apple لتطبيقات iOS التي ترسل إشارات منتج صريحة. ```bash .package(url: "https://github.com/LogBrewCo/sdk.git", from: "0.1.1") ``` Next: فتح «إضافة مشروع» ## تطبيق Android استخدم حزمة Android للتطبيقات التي ترسل إشارات خاصة بالتطبيق من بيئة تشغيل Android. ```bash implementation("co.logbrew:logbrew-kotlin:0.1.0") ``` Next: فتح «إضافة مشروع» ## تطبيق React Native استخدم حزمة React Native لتطبيقات الهاتف المحمول التي تتشارك إجراءات منتج مكتوبة بـJavaScript. ```bash npm install @logbrew/sdk @logbrew/react-native react react-native ``` Next: فتح «إضافة مشروع» ## تطبيق Unity استخدم حزمة Unity للألعاب أو المحاكاة التي ترسل إجراءات المنتج وإشارات بيئة التشغيل. ```bash "co.logbrew.unity": "file:../Packages/co.logbrew.unity" ``` Next: فتح «إضافة مشروع» ## تطبيق C استخدم ملفات C المصدرية للخدمات الأصلية أو التطبيقات المضمّنة التي تحتاج إلى تحكم مباشر في الإشارات. ```bash cc -std=c99 -Wall -Wextra -Wpedantic -Iinclude src/logbrew.c src/logbrew_metric.c src/logbrew_recording_transport.c src/logbrew_timeline.c src/logbrew_trace.c your_app.c -o your_app ``` Next: فتح «إضافة مشروع» ## تطبيق C++ شغّل خطة CLI المنشورة في مشروع CMake 3.16+ بلغة C++17. اربط LogBrew::LogBrew. فعّل LogBrew::HttpTransport وlibcurl فقط عندما يلزم الإرسال إلى الخدمة المستضافة. ```bash logbrew setup --json ``` Next: فتح «إضافة مشروع» ## مسار الإعداد في لمحة اتبع هذا الترتيب لتنتقل من التوثيق إلى إجراء منتج متحقَّق منه دون مغادرة مسار الإعداد. - التثبيت. إضافة الحزمة: ابدأ بحزمة SDK الخاصة ببيئة التشغيل لديك. - الإنشاء. إنشاء المشروع: افتح «إضافة مشروع» وانسخ بيانات اعتماد المشروع. تُعرض مرة واحدة. - الإرسال. إرسال إجراء منتج واحد: شغّل إجراء منتج واحدًا لا يحتوي على أسرار قبل ربط التطبيق. - التحقق. فحص السجلات: تأكد من الإشارة في السجلات أو عبر CLI. # أول تشغيل ناجح لـSDK اجعل الجلسة الأولى مركّزة: ثبّت الحزمة، وأنشئ المشروع، وأرسل إجراء منتج واحدًا لا يحتوي على أسرار، ثم تأكد منه في LogBrew. ## متطلبات إعداد أول إشارة الاستيعاب المباشر عبر SDK يُبقي مسار الإعداد قصيرًا. - المُجمِّع: لا يلزم وكيل محلي. ثبّت حزمة SDK وأرسل البيانات مباشرة إلى LogBrew API. - بيانات الاعتماد: بيانات اعتماد واحدة للمشروع. انسخها من «إضافة مشروع» فقط عند إنشاء ذلك المشروع أو إعداده. - الإثبات: التحقق في السجلات. أرسل إشارة info واحدة، ثم تأكد منها قبل توسيع أدوات القياس. ## سياق مساعد الذكاء الاصطناعي أعطِ الوكيل خريطة LogBrew العامة قبل أن يعدّل تطبيقك أو أمر الإعداد. ```bash curl -L https://logbrew.co/llms.txt ``` ### موجّه التثبيت ```bash اقرأ 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. ``` Next: فتح دليل الوكلاء ## تثبيت SDK استخدم حزم Node لخدمة خلفية تحتاج إلى السجلات وSpans والإجراءات والإصدارات والمقاييس. ```bash npm install @logbrew/sdk @logbrew/node ``` ## إنشاء المشروع افتح «إضافة مشروع»، واختر منصة، وانسخ بيانات اعتماد الاستيعاب. تعرضها لوحة الإعداد مرة واحدة. Next: فتح «إضافة مشروع» ## إرسال إجراء منتج واحد شغّل المثال المرفق بالحزمة قبل ربط كود الإنتاج، لتعرف شكل البيانات الأولى دون أي رمز مميز. ```bash node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs ``` ## التحقق في LogBrew اقرأ أول إشارة info في السجلات قبل إضافة مزيد من أدوات القياس. ```bash logbrew logs info --json ``` # أرسل أول إشارة من Node SDK إلى LogBrew أعِدّ خدمة Node.js وتحقّق من أول بيانات قياس منها. ينشئ «إضافة مشروع» المشروع ويعرض بيانات اعتماد الاستيعاب مرة واحدة. تغطي الخطوات التالية التثبيت والتحقق. ## إضافة حزم JavaScript SDK ابدأ بـSDK الأساسي ومساعد Node عندما تحتاج خدمة خلفية إلى السجلات وSpans الطلبات والإجراءات والإصدارات والمقاييس. ```bash npm install @logbrew/sdk @logbrew/node ``` ## إنشاء المشروع من «إضافة مشروع» سجّل الدخول، وافتح «إضافة مشروع»، واختر منصة، وانسخ بيانات اعتماد الاستيعاب. تُعرض مرة واحدة، ولا يعرضها الموقع مرة أخرى بعد مغادرة لوحة الإعداد. ## تشغيل مثال أول إشارة من SDK استخدم مثال الحزمة المثبّتة لتفحص شكل الإصدار والبيئة وSpan الطلب وإجراء المنتج ومرحلة الشبكة والمقياس قبل ربط تطبيقك. ```bash node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs ``` ## قراءة أول إشارة في LogBrew بعد أن يرسل SDK إشارة info باستخدام بيانات اعتماد المشروع، استخدم CLI أو عرض السجلات في لوحة التحكم لتتأكد من وصولها قبل إضافة مزيد من أدوات القياس. ```bash logbrew logs info --json ``` # اختر مسارك ## تحقّق من جاهزية LogBrew شغّل status أولًا لتتأكد من إمكانية الوصول وحالة تسجيل الدخول والقراءة الآمنة التالية. ```bash logbrew status --json ``` ## ابدأ من أحدث الأعطال اقرأ سجلات الأخطاء الحديثة، ثم انتقل إلى المشكلات أو التتبّعات عندما يحتاج إصدار أو مشروع إلى سياق. ```bash logbrew logs error --json ``` ## شارك عرضًا ثابتًا للمشكلات اعرض المشكلات المفتوحة عندما يحتاج زميل إلى مجموعات الأعطال نفسها. ```bash logbrew issues open --json ``` # خريطة الأوامر ## الحالة افحص المصادقة المحلية وإمكانية الوصول إلى API وخطوات الاسترداد قبل أي قراءة خاصة. ```bash logbrew status --json ``` ## السجلات ابدأ بالأخطاء الحديثة عندما يحتاج إصدار أو مشروع أو تتبّع إلى سياق. ```bash logbrew logs error --json ``` ## المشكلات اعرض مجموعات الأعطال المفتوحة قبل أن تقرر الحل أو الإغلاق أو التجاهل أو إعادة الفتح. ```bash logbrew issues open --json ``` ## تفاصيل التتبّع اقرأ تتبّعًا معروف المعرّف عندما تشير السجلات أو المشكلات إلى طلب واحد فاشل. ```bash logbrew trace --json ``` ## الإجراءات صفِّ أحداث المستخدمين حسب الاسم عندما يكون السياق المهم إجراءً في المنتج. ```bash logbrew actions --name checkout_failed --json ``` ## الإصدارات قارن سياق الطرح بأعداد السجلات والمشكلات وSpans التتبّع والإجراءات. ```bash logbrew releases --json ``` ## افحص المصادقة المحلية وإمكانية الوصول إلى API ينبغي أن تخبرك القراءة الأولى هل يستطيع CLI الوصول إلى LogBrew API دون كشف بيانات الرمز المميز. - استخدم وضع JSON عندما يحتاج سكربت أو أتمتة إلى حقول ثابتة. - استخدم المخرجات المقروءة للبشر عندما يحتاج المطوّر إلى الأمر التالي. - اجعل استرداد المصادقة يعيدك دائمًا إلى login وstatus. ## اقرأ إشارات الإنتاج حسب المورد ابدأ بالإشارة التي تجيب عن سؤالك. وافتح تفاصيلها لترى الأدلة المرتبطة. - تحتفظ السجلات بعوامل تصفية الخطورة والإصدار والبيئة والمشروع والتتبّع والبحث. - افحص حالة المشكلة وآخر حدوث لها قبل أن تحقّق فيها. - تحتفظ التتبّعات بأسماء Spans وسياق الإصدار وسياق البيئة ونطاق المشروع. ## أرسل سياقًا مفيدًا دون كشف بيانات المشروع استخدم التوثيق العام وMarkdown والأوامر القابلة للنسخ عندما يحتاج أحدهم إلى مساعدة في الإعداد أو إلى تسليم آمن. - شارك رابط التوثيق عندما تكون الخطوة التالية هي الإعداد أو اكتشاف الأوامر. - شارك Markdown عندما يكون النص العادي أسهل من لقطة الشاشة. - لا تشارك بيانات المشروع الخاصة إلا مع من لديهم إذن برؤيتها. ## اختر المشروع والنطاق الزمني استخدم مرجع API لبيانات القياس لمعرفة المسارات وعوامل التصفية المدعومة وأمثلة النجاح والخطأ. - صادِق قبل أن تطلب بيانات مشروع خاصة. - اختر المشروع والنطاق الزمني قبل مقارنة النتائج. - اتبع خطوات الاسترداد المُعادة عندما يفشل طلب ما. - افصل بين الأدلة الغائبة والأدلة التي تعذّر تحميلها. ## Public agent links - Full docs site: https://docs.logbrew.co - Docs: https://logbrew.co/ar/docs - Docs Markdown: https://logbrew.co/ar/docs.md - Agent guide: https://logbrew.co/ar/agents - Home Markdown: https://logbrew.co/ar/page.md - llms.txt: https://logbrew.co/llms.txt - Sitemap: https://logbrew.co/sitemap.xml