دليل Spring Boot مع AllStak

التثبيت

أضف اعتمادية مُشغّل Spring Boot (Maven). لا يتضمّن README الخاص بالـ SDK مقتطف Gradle.

<dependency>
  <groupId>sa.allstak</groupId>
  <artifactId>allstak-spring-boot-starter</artifactId>
  <version>0.4.0</version>
</dependency>

الإعداد

اضبط مفتاح API في application.properties. كل بوّابات capture-* مفعّلة افتراضيًا.

allstak.api-key=ask_live_xxx
allstak.environment=production
allstak.release=v1.0.0
allstak.service-name=my-service
allstak.capture-http-requests=true
allstak.capture-exceptions=true

مثال أساسي

لا حاجة لأي شيفرة تهيئة — يربط المُشغّل التقاط HTTP والاستثناءات والسجلات واستعلامات JDBC تلقائيًا عند البدء.

التقاط الأخطاء

تُلتقط الاستثناءات غير المُعالَجة تلقائيًا (allstak.capture-exceptions). ولالتقاط استثناء مُعالَج يدويًا، استخدم واجهة AllStak الثابتة من المكتبة الأساسية.

import dev.allstak.AllStak;

AllStak.captureException(new RuntimeException("checkout failed"));

تتبّع الطلبات

تُلتقط طلبات HTTP الواردة تلقائيًا عندما تكون allstak.capture-http-requests مفعّلة (الافتراضي)؛ وتُتتبَّع نداءات RestTemplate/WebClient الصادرة. ولا يوثّق README أي نداء يدوي لالتقاط الطلبات.

أفضل الممارسات

• حقن مفتاح API من متغيّر بيئة لا مضمّنًا في الشيفرة.
• اضبط allstak.release (نسخة التطبيق أو commit SHA) للتجميع لكل نشر.
• عطّل أي تكامل تلقائي عبر بوّابته capture-* (مثل allstak.capture-kafka=false).