التثبيت حسب المنصة
Go
التثبيت go get github.com/blipit-io/blipit-go
أضف وحدة blipit-go (الإصدار v0.3.0 أو أحدث) واستدعِ Init مرة واحدة في main بالمفتاح العام ومعرّف المشروع الخاصين بمشروعك. تعمل على نواة Blipit الخاصة ولا تستخدم سوى مكتبة Go القياسية. استدعِ Flush قبل خروج العملية حتى لا تضيع آخر الأحداث.
1التثبيت
go get github.com/blipit-io/blipit-go2التهيئة في main
لا يسبب Init حالة panic أبدًا: إذا كان المفتاح أو معرّف المشروع فارغًا يعيد خطأ ويبقى Blipit متوقفًا، لذا سجّل الخطأ بدل إنهاء البرنامج.
import (
"log"
"time"
"github.com/blipit-io/blipit-go"
)
func main() {
if err := blipit.Init(blipit.Options{
Key: "<public key>",
Project: "<project id>",
Environment: "production",
Release: "myapp@1.4.2",
}); err != nil {
log.Printf("blipit: %v", err)
}
defer blipit.Flush(2 * time.Second)
}3احصل على مفاتيحك
سجّل الدخول في app.blipit.io وافتح «مفاتيح API» في الشريط الجانبي، ثم مشروعك. لكل مشروع مفتاحان. يبدأ المفتاح العام بـ blipit_pk_: يوضع في كود المتصفح والتطبيقات، ولا يستطيع سوى إرسال الأحداث، ومن الآمن أن يراه أي شخص. يبدأ المفتاح السري بـ blipit_sk_: يبقى على خادمك أو في Odoo، وليس في متصفح أبدًا، لأنه يستطيع أيضًا قراءة المشكلات وتغييرها. يُعرض المفتاح السري مرة واحدة فقط، فور إنشائه، لذا انسخه حينها؛ وإذا فقدته، فاضغط «إنشاء مفتاح سري جديد»، فيتوقف القديم عن العمل فورًا. تحتاج بعض حزم SDK أيضًا إلى معرّف المشروع، المعروض في الصفحة نفسها.
4احتفظ بالمفتاح في البيئة
ترسل هذه SDK باستخدام المفتاح العام ومعرّف المشروع. اقرأهما من متغيرات البيئة التي تضبطها منصة الاستضافة، أو وحدة systemd، أو docker run -e.
blipit.Init(blipit.Options{
Key: os.Getenv("BLIPIT_KEY"),
Project: os.Getenv("BLIPIT_PROJECT"),
})5أبقِ المفاتيح خارج git
احتفظ بالمفاتيح في متغيرات البيئة أو في الإعدادات السرية لمنصة الاستضافة، وليس أبدًا في كود تودعه في المستودع، وأضف ملفات .env إلى .gitignore. وجود مفتاح عام في صفحة ويب أمر طبيعي. إذا انتهى مفتاح سري يومًا في git أو صفحة عامة أو لقطة شاشة أو محادثة، فافتح «مفاتيح API»، واضغط «إنشاء مفتاح سري جديد»، والصق المفتاح الجديد في كل مكان كان يُستخدم فيه القديم: يتوقف المفتاح القديم عن العمل فورًا.
.env
.env.local
.env.*.local6الالتقاط اليدوي ومحاولات تسجيل الدخول
تتطلب محاولات تسجيل الدخول المفتاح السري: على الخادم، ابدأ التهيئة بالمفتاح السري بدلاً من المفتاح العام، وإلا فسترفضها خدمة الاستقبال بالرمز 403 security_needs_secret_key. خطة Scale.
blipit.CaptureException(err)
blipit.CaptureMessage("cache miss rate above 50%")
blipit.SetUser(blipit.User{ID: "42", Email: "ana@example.com"})
blipit.CaptureSecurity(blipit.Security{Kind: "login_failed", Actor: email, IP: ip, UserAgent: agent, Outcome: "bad_password"})7حالات panic وnet/http
يبلّغ defer blipit.Recover() في أعلى main أو أي goroutine عن حالة panic مع مكدسها، ثم يرسل ما في الطابور ويعيد إطلاق الـ panic. غلّف المعالج الذي تقدّمه بـ blipit.Handler للإبلاغ عن حالات panic مع الطلب وقياس زمن كل طلب في Pulse، مسمّى بنمط ServeMux الخاص به. تستخدم Gin وEcho وFiber الدوال StartRequest وSetRoute وEnd، كما في ملف README للحزمة.
go func() {
defer blipit.Recover()
work()
}()
mux := http.NewServeMux()
mux.HandleFunc("GET /items/{id}", item)
http.ListenAndServe(":8080", blipit.Handler(mux))8تحقق من أنه يعمل
افتح المشكلات في app.blipit.io. يظهر الحدث الأول خلال بضع ثوانٍ، مجمّعًا في مشكلة، ويتلقى المسؤولون بريدًا إلكترونيًا.
blipit.CaptureMessage("Hello from Go")من المفيد معرفته
- يرسل TracesSampleRate: 0.2 في Options الطلبات إلى صفحة Pulse؛ ويضيف blipit.Trace(ctx, name, fn) خطوة مقيسة الزمن داخل الطلب.
- الترقية من v0.2: أُزيلت blipit.DSN، وأصبحت User وBreadcrumb وLevel أنواعًا خاصة بـ Blipit (يحتفظ User بـ ID وEmail وUsername؛ ويحتفظ Breadcrumb بـ Category وMessage وLevel وData وTimestamp).
- إبقاء Blipit محدّثًا: يشرح دليل إبقاء Blipit محدّثًا (docs.blipit.io/updates) لافتة التحديث، ورسائل البريد للإصدارات المهمة، والتنبيه في وحدة تحكم التطوير، وأمر التحديث لهذه المنصة.
- مشروع واحد لكل تطبيق ومنصة: يختار كل مشروع منصته عند إنشائه (Android أو iOS أو React Native أو Flutter أو Web أو Backend أو Odoo)، ويرفض Blipit البيانات القادمة من أي منصة أخرى مع رسالة خطأ واضحة، لذلك يحتاج تطبيق iOS وتطبيق Android إلى مشروعين بمفتاحين. الإصدارات والنسخ ومعدلات الأعطال وإصدارات المتاجر تختلف من منصة لأخرى، وخلطها في مشروع واحد يجعلها كلها خاطئة. يقبل مشروع Web أيضًا جانب الخادم من تطبيق الويب نفسه (خادم Next.js أو Node)، ويقبل مشروع React Native أو Flutter أيضًا تقارير الأعطال الأصلية الخاصة به على Android وiOS.
هل واجهتك مشكلة؟ راسل support@blipit.io. المفاتيح ومعرّف كل مشروع موجودة تحت مفاتيح API في app.blipit.io.

