حزمة Astro SDK

مراقبة Astro لكل صفحة وكل طلب SSR

تكامل واحد في astro.config.mjs ويبدأ موقع Astro بالإبلاغ عن أعطاله بنفسه: تُلتقط أخطاء عرض SSR تلقائيًا عبر الوسيط، ويُغلَّف كل طلب خادم في span من نوع http.server، ويتاح الالتقاط اليدوي مباشرة في الـ frontmatter. وتعيش source maps وإعادة تشغيل الجلسات على المنصة نفسها.

لماذا تحتاج مواقع Astro إلى مراقبة حقيقية

قوة Astro — تقديم HTML شبه ثابت مع جزر تفاعلية — تجعل أعطاله سهلة الإفلات أيضًا. جلب بيانات يرمي خطأ في frontmatter صفحةٍ ما، ومسار SSR يبدأ بإرجاع 500 بعد نشر جديد، وما لم يكن أحد يراقب سجلات الخادم في تلك اللحظة بالذات، يأتي أول بلاغ من مستخدم. فالمواقع التي تبدو ثابتة لها أنماط فشل ديناميكية، وتستحق الرؤية نفسها التي يستحقها أي تطبيق.

يجعل تكامل AllStak لـ Astro هذه الرؤية سطر إعداد واحدًا. أضف allstak إلى integrations في astro.config.mjs، وفي مخرجات SSR تُلتقط أخطاء عرض الخادم تلقائيًا عبر وسيط التكامل بينما يُغلَّف كل طلب في span من نوع http.server يسجّل الطريقة والمسار والحالة. والتقط الأخطاء المعالَجة في أي مكان — في الـ frontmatter أو شيفرة الخادم — عبر AllStak.captureException. ارفع source maps لتحصل على traces مقروءة، وشاهد إعادة تشغيل الجلسات لجانب المتصفّح، وكل ذلك إلى جانب سجلاتك وتوافر خدماتك على منصة واحدة.

مراقبة كاملة لموقع Astro

من جلب بيانات يفشل في الـ frontmatter إلى طلب SSR الذي خدمه، يغطّي AllStak موقع Astro لديك عبر كل طبقة.

تتبّع الأخطاء

في مخرجات SSR، تُلتقط أخطاء عرض الخادم تلقائيًا عبر وسيط التكامل — ويبلّغ AllStak.captureException عن الأخطاء المعالَجة من الـ frontmatter أو شيفرة الخادم.

مراقبة طلبات SSR

يغلّف الوسيط كل طلب خادم في span من نوع http.server يسجّل الطريقة والمسار والحالة — وautoInstrumentServer مفعّل افتراضيًا، فلا شيء إضافيًا عليك ربطه.

إعادة تشغيل الجلسات

شاهد ما فعله المستخدم فعلًا قبل الخطأ — النقرات والتنقّل ولحظة العطل — مع إخفاء للخصوصية يضمن ألّا تغادر المدخلات الحساسة المتصفّح.

خرائط المصدر

ارفع source maps فتُحَلّ stack traces الإنتاج المصغّرة إلى شيفرتك الأصلية — الملف والسطر والدالة — فيبدأ الإصلاح فورًا.

breadcrumbs وسياق الإصدار

تصل الأخطاء ومعها الـ breadcrumbs والإصدار الذي وصلت فيه — اضبط release في إعداد التكامل فيجمّع كل نشر مشكلاته على حدة.

التنبيهات والحوادث

تلقَّ إشعارًا لحظة ظهور خطأ جديد أو ارتفاع خطأ قديم — قبل وصول تذاكر الدعم لا بعدها.

أضف AllStak خلال دقائق

ثبّت من npm (يتطلّب astro@>=3.5) وأضف التكامل في astro.config.mjs — وتُراقَب أخطاء SSR وطلباته من تلك اللحظة.

astro.config.mjs
npm install @allstak/astro

import { defineConfig } from 'astro/config';
import allstak from '@allstak/astro';

export default defineConfig({
  integrations: [
    allstak({
      apiKey: process.env.ALLSTAK_API_KEY,
      environment: process.env.NODE_ENV,
      release: process.env.npm_package_version,
    }),
  ],
});

اضبط ALLSTAK_API_KEY في البيئة لا في الشيفرة — واضبط release لتُجمَّع الأخطاء لكل نشر. ويغطّي autoInstrumentServer (الافتراضي true) مراقبة طلبات SSR. دليل الإعداد الكامل ومرجع الـ SDK.

ما تراه في AllStak

تفاصيل الخطأ مع سياق كامل

افتح أي مشكلة لترى stack trace مقروءًا (عبر source maps)، والـ breadcrumbs التي سبقته، والإصدار الذي وصل فيه — إعادة إنتاج دون تخمين.

طلبات SSR بالطريقة والمسار والحالة

يظهر كل طلب خادم كـ span من نوع http.server — فيُرى المسار الذي بدأ يفشل أو يتباطأ بعد نشرٍ ما فورًا، لا بعد وصول الشكاوى.

إعادة تشغيل جلسة العطل

شاهد جلسة المستخدم حول لحظة الخطأ — ما الذي نقر عليه، وأين تنقّل، وكيف بدت الصفحة عندما تعطّلت.

لوحة تحكّم موحّدة آنية

أخطاء Astro إلى جانب السجلات والتوافر وأخطاء الخلفية للـ APIs خلف موقعك — لوحة واحدة، بالعربية أو الإنجليزية، للفريق بأكمله.

لماذا تختار الفرق AllStak لـ Astro

  • سطر تكامل واحد في astro.config.mjs — أخطاء SSR ومراقبة الطلبات دون أي ربط إضافي.
  • يعمل الالتقاط اليدوي مباشرة في الـ frontmatter — AllStak.captureException أينما كان تحميل بياناتك.
  • تحوّل إعادة تشغيل الجلسات وsource maps بلاغات الأخطاء الغامضة إلى أدلة مرئية ومقروءة.
  • منصة متكاملة — الأخطاء والسجلات والتتبّعات والتوافر بفاتورة واحدة بدلًا من أربع أدوات.
  • تسعير واضح بالريال السعودي مع باقة مجانية حقيقية — ابدأ دون بطاقة ائتمان.
  • تبقى بياناتك داخل السعودية، مع لوحة تحكّم بالعربية والإنجليزية للفريق بأكمله.

أسئلة شائعة حول مراقبة Astro

كيف أضيف تتبّع الأخطاء إلى موقع Astro؟

ثبّت @allstak/astro من npm وأضف allstak إلى integrations في astro.config.mjs بمفتاح API لمشروعك. في مخرجات SSR، تُلتقط أخطاء عرض الخادم تلقائيًا عبر الوسيط؛ والتقط الأخطاء المعالَجة في أي مكان عبر AllStak.captureException — ويغطّي دليل الإعداد كليهما.

هل يعمل AllStak مع مواقع Astro الثابتة؟

نعم — مع فارق واحد. يعمل الالتقاط اليدوي عبر AllStak.captureException في الـ frontmatter وشيفرة الخادم أيًّا كان نمط المخرجات. أما الوسيط التلقائي (التقاط الأخطاء وspans من نوع http.server) فينطبق على مخرجات الخادم (SSR)؛ فالمخرجات الثابتة لا خطّ طلبات فيها لتجهيزه.

ما إصدارات Astro المدعومة؟

يتطلّب التكامل astro@>=3.5. أضفه كأي تكامل Astro آخر في astro.config.mjs واضبطه عبر متغيّرات البيئة.

هل AllStak مجاني لـ Astro؟

نعم. يوفّر AllStak باقة مجانية يمكنك البدء بها دون بطاقة ائتمان، مع تسعير واضح بالريال السعودي مع نموّك. وتكامل Astro نفسه مجاني الاستخدام.

هل AllStak بديل لـ Sentry في Astro؟

نعم. تحصل على تتبّع أخطاء Astro مع source maps وإعادة تشغيل الجلسات ومراقبة طلبات SSR كما في Sentry، إضافة إلى السجلات والتوافر ومراقبة البنية التحتية لكل ما يقف خلف موقعك على المنصة نفسها — بفاتورة واحدة بالريال السعودي وبيانات مخزّنة داخل السعودية بدلًا من كومة أدوات منفصلة.

ابدأ مراقبة موقع Astro اليوم

أضف التكامل، وانشر، وشاهد الأخطاء وطلبات SSR تصل إلى لوحة واحدة. ابدأ مجانًا — دون الحاجة إلى بطاقة ائتمان.