تثبيت GlitchTip على VPS: تتبع الأخطاء بشكل مستقل

لماذا الترحيل إلى GlitchTip الآن

ما تحصل عليه مع GlitchTip v6 المُستضاف ذاتياً

• بصمة صغيرة — أربعة حاويات فقط (‏Django و‏Celery و‏PostgreSQL و‏Redis)، مقارنةً بعشرين خدمة في Sentry self-hosted.
• توافق SDK Sentry — جميع SDKs Sentry الرسمية تعمل بدون تعديل؛ المتغير الوحيد المُستبدل هو DSN.
• سيادة البيانات — تبقى آثار الأخطاء وبيانات المستخدمين على بنيتك التحتية وفق سياسة الاحتفاظ التي تحددها.
• رخصة GPL-3.0 — الكود قابل للمراجعة، بدون مكوّن مغلق أو ميزة مقيّدة بخطة مدفوعة.
• مراقبة الإتاحة — يشمل GlitchTip مراقبة الاتصال HTTP بدون أي تبعية خارجية.
• واجهة إدارة الأداء — تتبع المعاملات وآثار N+1 والاستعلامات البطيئة عبر واجهة برمجية متوافقة مع Sentry.
• استهلاك ذاكرة منخفض — تكفي 2 جيجابايت من RAM للاستخدام الفردي أو الفريق الصغير بدون أي ضبط للإعدادات.

المتطلبات قبل البدء

نشر GlitchTip باستخدام Docker Compose

1. 01

   إنشاء مجلد العمل

   اتصل بخادم VPS عبر SSH، ثم أنشئ مجلداً مخصصاً:

   mkdir -p /opt/glitchtip && cd /opt/glitchtip

2. 02

   إنشاء ملف متغيرات البيئة

   أنشئ ملف .env بقيم الإعداد:

   SECRET_KEY=<سلسلة-عشوائية-طويلة> — يمكنك توليدها بالأمر openssl rand -hex 32.
   DATABASE_URL=postgresql://glitchtip:كلمة_المرور@db:5432/glitchtip
REDIS_URL=redis://redis:6379/0
GLITCHTIP_DOMAIN=https://glitchtip.your-domain.com
[email protected]
EMAIL_URL=smtp://user:[email protected]:587

   استبدل القيم ببياناتك الخاصة. يجب أن يتطابق GLITCHTIP_DOMAIN تماماً مع النطاق الذي ستؤمّنه بـ HTTPS — يُدمج في الـ DSNs التي ينشئها GlitchTip.

3. 03

   إنشاء ملف docker-compose.yml

   أنشئ ملف docker-compose.yml بالمحتوى التالي (مستوحى من التوثيق الرسمي لـ GlitchTip):

   version: "3.8"
   x-environment: &default-environment
     env_file: .env
   services:
     db:
       image: postgres:16
       environment:
         POSTGRES_DB: glitchtip
         POSTGRES_USER: glitchtip
         POSTGRES_PASSWORD: password
       volumes:
         - pg_data:/var/lib/postgresql/data
     redis:
       image: redis:7
       volumes:
         - redis_data:/data
     web:
       image: glitchtip/glitchtip:latest
       depends_on: [db, redis]
       ports:
         - "127.0.0.1:8000:8080"
       <<: *default-environment
     worker:
       image: glitchtip/glitchtip:latest
       command: ./bin/run-celery-with-beat.sh
       depends_on: [db, redis]
       <<: *default-environment
   volumes:
     pg_data:
     redis_data:

   لاحظ أن المنفذ 8000 مرتبط بـ 127.0.0.1 فقط: لا يُعرض الخدمة مباشرة بل عبر وسيط عكسي فقط.

4. 04

   تهيئة قاعدة البيانات

   شغّل عمليات ترحيل Django لإنشاء المخطط:

   docker compose run --rm web ./manage.py migrate

   شغّل هذا الأمر مرة واحدة عند التثبيت، ثم مجدداً في كل مرة تُحدّث فيها GlitchTip إلى إصدار جديد.

5. 05

   إنشاء أول مستخدم مشرف

   أنشئ حساب المشرف الخاص بك:

   docker compose run --rm web ./manage.py createsuperuser

   أدخل البريد الإلكتروني وكلمة المرور حين يطلبهما المساعد.

6. 06

   تشغيل المجموعة

   شغّل جميع الحاويات في الخلفية:

   docker compose up -d

   تحقق من تشغيل الحاويات الأربع بالأمر docker compose ps. تستجيب خدمة الويب على http://127.0.0.1:8000.

7. 07

   إعداد وسيط nginx العكسي مع HTTPS

   ثبّت nginx وCertbot إن لم يكونا موجودين:

   apt install -y nginx certbot python3-certbot-nginx

   أنشئ ملف vhost في /etc/nginx/sites-available/glitchtip بكتلة server تستمع على المنفذ 80، وتضع server_name glitchtip.your-domain.com، وتُعيد توجيه الطلبات إلى http://127.0.0.1:8000 عبر proxy_pass. فعّل الإعداد ثم احصل على الشهادة:

   certbot --nginx -d glitchtip.your-domain.com

   يُحدّث Certbot ملف vhost تلقائياً لإعادة توجيه HTTP إلى HTTPS ويضيف كتلة SSL.

8. 08

   توصيل SDK Sentry من تطبيقاتك

   في واجهة GlitchTip، أنشئ منظمة ثم مشروعاً. يُنشئ GlitchTip DSN بالتنسيق https://<مفتاح>@glitchtip.your-domain.com/<معرّف-المشروع>.

   في كل تطبيق من تطبيقاتك، استبدل قيمة SENTRY_DSN (أو المعامل dsn الممرَّر إلى Sentry.init()) بهذا الـ DSN الجديد. أعد تشغيل العمليات. تظهر الأحداث في GlitchTip بدون أي تعديل آخر.

الإعداد بعد التثبيت

الأخطاء الشائعة وحلولها

GlitchTip في الإنتاج على VPS