אירוח עצמי של Superlog לניטור לוגים מבוסס AI
למדו כיצד להריץ את Superlog על גבי Docker Compose כדי לנתח OTLP traces ולוגים באמצעות סוכן AI. המדריך מפרט את דרישות המערכת, ניהול גרסאות לפי commit וטביעת הרגל האמיתית של השרת.
מה באמת מותקן בתהליך אירוח עצמי של Superlog
כדי לארח את Superlog באופן עצמאי, עליכם לשכפל את ה-repository, להעלות את Postgres, ClickHouse ואת ה-OpenTelemetry collector באמצעות Docker Compose, להריץ migration אחד למסד הנתונים, ולאחר מכן להפעיל ארבעה שירותי Node מתוך קוד המקור. היישומים שלכם שולחים traces, לוגים ו-metrics בפרוטוקול OTLP (OpenTelemetry protocol) לפורט קליטה; Superlog מבצע להם fingerprinting, מקבץ אירועים חוזרים לתקרית אחת, וסוכן הקהילה המוגדר כברירת מחדל מתעד סיכום תקריות מקומי. ההתקנה אורכת אחר-צהריים אחד. טביעת הרגל של המערכת והמגבלות המוצהרות הן החלקים שכדאי לקרוא לפני שמתחילים.
Superlog מופץ תחת רישיון Apache 2.0 וזמין בכתובת github.com/superloglabs/superlog. נכון ל-13 באוקטובר 2026, יש לו כ-1.5k כוכבים, בערך 490 commits ב-main, וללא תגיות release כלל. קבעו (pin) גרסה לפי commit ספציפי בעצמכם, במקום להריץ את מה ש-main במקרה היה בבוקר שבו ביצעתם clone.
מה Superlog מספק ש-Uptime Kuma ו-Langfuse אינם מספקים
כלי ניטור בהתקנה עצמית נראים דומים מבחוץ. הם אינם כאלה, והרצה של הכלי הלא נכון תעלה לכם בשרת ללא כל תועלת.
- Uptime Kuma בודק את נקודות הקצה שלכם מבחוץ ועונה על שאלה אחת: האם השירות זמין.
- Zabbix מנטר מארחים ושירותים על Ubuntu 24.04, עם נתוני CPU, זיכרון, דיסק ומצב שירות מול ספים שהגדרתם.
- Langfuse עוקב אחר קריאות LLM, ומתעד את ה-prompt, המודל, ה-tokens, השיהוי (latency) והעלות של כל קריאה.
- Superlog לוקח את הטלמטריה שהשירותים הרגילים שלכם כבר מפיקים והופך כשלים חוזרים לאירועים (incidents).
Superlog עונה על שאלה אחרת: משהו התקלקל, מה התקלקל, ומדוע. אין לו דעה לגבי קריאות LLM והוא לא מבצע בדיקות מבחוץ. הוא קולט OTLP מקוד היישום הרגיל שלכם ומציב סוכן בשלב המיון (triage), שהוא הצעד הראשון שאיש תורן ממילא היה מבצע.
ההבחנה שחשובה לתקציב ה-VPS היא האחסון. Superlog משתמש ב-column store, כיוון שטלמטריה נכתבת פעם אחת ואז נשלפת לפי טווח זמן על פני מיליוני שורות. זה הייעוד של ClickHouse, וזה לא הייעוד של Postgres. ה-Postgres עדיין נמצא ב-stack, ומחזיק את הנתונים היחסיים הקטנים: פרויקטים, משתמשים, אירועים ומפתחות קליטה (ingest keys).
מה הפקודה docker compose up -d מפעילה בפועל?
שלושה מכולות (containers), ואף אחת מהן אינה Superlog. זה מפתיע אנשים שמצפים להתקנה בפקודה אחת.
postgres:16, מפורסם בפורט המארח 5434clickhouse/clickhouse-server:26.1, בפורט 8123 עבור HTTP ובפורט 9000 עבור הפרוטוקול המקוריotel/opentelemetry-collector-contrib:0.150.1, בפורט 4317 עבור gRPC ובפורט 4318 עבור OTLP על גבי HTTP
יישומי Superlog רצים על המארח, מתוך קוד המקור, ומופעלים על ידי pnpm dev. נכון ל-13 באוקטובר 2026, אין ב-repository קובץ compose המיועד לסביבת production, לכן התקנה לטווח ארוך מחייבת יצירת יחידות systemd משלכם, או שימוש ב-Dockerfiles הייעודיים לכל יישום שמגיעים עם המערכת. ליישומי ה-api, ה-worker וה-proxy יש לכל אחד סקריפט start שנועד לעטוף יחידת שירות. ליישום ה-web אין כזה: מדובר ביישום Vite, לכן עליכם לבנות אותו עם סקריפט ה-build שלו ולהגיש את הפלט כקבצים סטטיים מ-nginx או מ-Caddy, או להריץ את סקריפט ה-preview שלו, שהוא vite preview.
שמרו בראש את הנתיב שעובר המידע, כיוון שכל כשל שמתואר בהמשך הוא שבירה באחת התחנות בנתיב זה. היישום שלכם שולח נתוני OTLP ל-proxy הקליטה של Superlog. ה-proxy מאמת את הבקשה באמצעות מפתח ה-ingest שלכם, מוסיף לה את מזהה הפרויקט, ומעביר אותה ל-collector. ה-collector מסיר כל מאפיין superlog.* שהלקוח ניסה להגדיר, מוסיף superlog.project_id מה-header שסיפק ה-proxy, מבצע batching, וכותב ל-ClickHouse. לאחר מכן, יישום ה-web וה-API קוראים את נתוני הטלמטריה בחזרה מ-ClickHouse ואת כל שאר הנתונים מ-Postgres.
הסרת המאפיינים הזו היא בקרת multi-tenancy אמיתית, לא קישוט. בלעדיה, כל מי שמחזיק במפתח ingest תקף יכול היה להגדיר superlog.project_id בעצמו ולכתוב לתוך הנתונים של פרויקט אחר.
מה צריך להיות גודל ה-VPS?
תכננו עבור 4 vCPU, 8 GB של RAM ו-40 GB של SSD עבור התקנת צומת בודד בנפח קליטה נמוך. זהו רף תכנון, לא מדידה, לכן התייחסו אליו כאל גודל התחלתי ובדקו אותו מול התעבורה שלכם.
הזיכרון מתחלק לארבעה מקומות. ClickHouse בנוי עבור מכונות עם הרבה RAM וברירות המחדל שלו מניחות זאת. Postgres 16 צנוע כאן, כיוון שהוא מחזיק מטא-דאטה ולא טלמטריה. גם ה-collector צנוע. ארבעת תהליכי ה-Node כוללים שרת פיתוח Vite פלוס שלושה תהליכי tsx watch; מדדו את צריכת הזיכרון שלהם על השרת שלכם.
הדיסק הוא הבעיה השקטה יותר. pnpm install ב-monorepo הזה מושך את ה-AWS SDK, לקוח ClickHouse, את ה-OpenTelemetry SDK ושרשרת כלים של React עוד לפני שקלטתם span אחד. לאחר מכן, ClickHouse גדל עם התעבורה שלכם. מדדו את שניהם:
df -h /
free -m
docker stats --no-stream
docker compose exec clickhouse clickhouse-client --database superlog --query "SELECT table, formatReadableSize(sum(bytes_on_disk)) AS size FROM system.parts WHERE active AND database = 'superlog' GROUP BY table ORDER BY sum(bytes_on_disk) DESC"העומס שמזיק הוא ה-burst: פריסה (deploy) לא תקינה שמייצרת אלפי שגיאות זהות בדקה. יצירת טביעת אצבע (fingerprinting) מאחדת אותן לאירוע אחד עבור הקורא, אך ClickHouse עדיין כותב כל שורה מתחת לפני השטח.
השמירה (retention) היא באחריותכם. ה-ClickHouse exporter של ה-collector יוצר את הטבלאות, otel_traces, otel_logs וטבלה אחת לכל סוג מטריקה, והוא מחיל זמן חיים (TTL) רק אם התצורה ב-infra/collector/config.yaml מגדירה זאת. שום דבר לא פג תוקף מעצמו, לכן חודש עמוס יהפוך לדיסק מלא אלא אם תתכננו זאת מראש.
התקנה מתוך commit נעול
git clone https://github.com/superloglabs/superlog.git
cd superlog
git tag -l
git log -1 --format='%H %cs %s'git tag -l הדפסת תוצאה ריקה היא ההתנהגות הצפויה נכון ל-13 באוקטובר 2026. בחרו את ה-commit שבדקתם והישארו עליו:
git checkout 0d3a6c8bb63eda3493e6ba0003e7c2a70750bc1eלאחר מכן, ה-toolchain:
node -v
corepack enable
corepack prepare pnpm@9.12.0 --activate
pnpm -vpackage.json מגדיר את engines.node כ->=20.0.0 ואת packageManager כ-pnpm@9.12.0. גרסת Node לא תואמת לא תעצור את ההתקנה באופן אוטומטי: אכיפת המנוע תלויה בתצורה, ול-pnpm 9.12.0 יש נתיב אזהרה כאשר engineStrict מושבת. חבילת ה-nodejs במאגר של Ubuntu 24.04 ישנה מגרסה 20, לכן התקינו Node 20 או גרסה חדשה יותר מ-NodeSource או מ-nvm. המאגר מספק .nvmrc, לכן nvm use יבחר את הגרסה המיועדת אם מותקן אצלכם nvm.
pnpm install
docker compose up -d
docker compose psהמתינו לבדיקות התקינות (health checks) במקום להסתמך על כך ש-up -d מעיד על מוכנות. Postgres ו-ClickHouse שתיהן מצהירות על בדיקה כזו בקובץ ה-compose:
curl -sS http://127.0.0.1:8123/ping
pg_isready -h 127.0.0.1 -p 5434 -U postgresClickHouse משיבה Ok. ו-pg_isready משיבה accepting connections. שגיאת connection refused בפורט 8123 משמעותה שה-container עדיין בתהליך עלייה או שקרס. הפקודה docker compose logs clickhouse תציג מה המצב, ו-docker inspect $(docker compose ps -q clickhouse) | grep -i oomkilled תדווח על true אם ה-kernel הרג את התהליך עקב מחסור בזיכרון, מה שמעיד על כך שהשרת קטן מדי ולא על בעיה בתצורה שלכם.
לאחר מכן ה-migration והיישומים:
pnpm --filter @superlog/db db:migrate
pnpm devשימו לב לפורט: 5434, לא 5432. קובץ ה-compose מפרסם את Postgres בפורט 5434 כדי שלא יתנגש עם שרת Postgres שכבר מותקן על ה-host, וקובצי ה-.env.example של היישום תואמים, עם DATABASE_URL=postgres://postgres:postgres@localhost:5434/superlog. אם תפנו את ה-migration לפורט 5432 בשרת שכבר מריץ Postgres, תקבלו שגיאת חיבור או, במקרה הגרוע, ה-migration יוחל על מסד הנתונים הלא נכון.
pnpm dev מריץ את turbo run dev, שמפעיל את סקריפט ה-dev של כל יישום דרך Turborepo, כולל api, web, worker ו-proxy, כאשר הפלט של כולם משולב בטרמינל אחד. ה-Procfile של המאגר מפרט את אותם ארבעה תהליכים ומנתב את הפלט של כל אחד מהם ל-tmp/logs/. הפעילו זאת עם מריץ Procfile כגון overmind או foreman במקום pnpm dev אם אתם רוצים ש-tail -f tmp/logs/proxy.log יהיה המקום שבו אתם עוקבים אחר ה-ingest. ה-README מציב את יישום ה-web ב-http://localhost:5173, את ה-API ב-http://localhost:4100 ואת ה-OTLP intake ב-http://localhost:4101.
וודאו מה באמת מאזין לפני שאתם מפנים אליו משהו:
ss -lntp | grep -E '4000|4100|4101|5173'
curl -sS http://127.0.0.1:4101/healthזה חשוב להמשך. ה-proxy קורא את הפורט שלו ממשתנה הסביבה PORT וחוזר ל-4000 כאשר PORT אינו מוגדר, וקובץ ה-apps/proxy/.env.example שהוא טוען מגדיר גם את PORT=4000, למרות שה-README מציין את ה-intake ב-4101 (שניהם נבדקו ב-13 באוקטובר 2026). השתמשו בפורט ש-ss מציג. הדוגמאות להלן משתמשות ב-4101, לכן החליפו ל-4000 אם זה הפורט שמאזין. יחידת systemd שתכתבו בעצמכם לא מגדירה דבר אלא אם תכניסו לתוכה PORT, לכן exporter שמכוון ל-4101 מול proxy שמאזין ב-4000 ייכשל עם connection refused ולא יספק לכם רמז נוסף.
שליחת עקבה אחת, יצירת שגיאה אחת, צפייה בתקרית אחת
צרו פרויקט באפליקציית ה-web והעתיקו את מפתח ה-ingest שלו. מנגנון ה-intake מאמת כל בקשה מול מפתח זה, לכן טלמטריה שנשלחת ללא מפתח לא תגיע לעולם ל-ClickHouse.
כוונו כל OpenTelemetry SDK אל ה-intake באמצעות משתני הסביבה הסטנדרטיים:
export OTEL_SERVICE_NAME=checkout-api
export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_ENDPOINT=http://127.0.0.1:4101
export OTEL_EXPORTER_OTLP_HEADERS='x-api-key=YOUR_INGEST_KEY'ה-intake קורא את המפתח מה-header מסוג x-api-key, ומקבל גם את authorization: bearer YOUR_INGEST_KEY אם קל יותר להגדיר כך את ה-exporter שלכם. הוא משרת את שלושת נתיבי ה-OTLP הסטנדרטיים, /v1/traces, /v1/logs ו-/v1/metrics, בנוסף ל-/health.
מלכודת אחת ראויה לציון. OTEL_EXPORTER_OTLP_ENDPOINT הוא כתובת בסיס (base URL) וה-SDK מצרף אליו את נתיב האות (signal path). משתנים ספציפיים לאותות כגון OTEL_EXPORTER_OTLP_TRACES_ENDPOINT משמשים בדיוק כפי שהם כתובים, ללא צירוף נתיב. אם תגדירו את המשתנה הספציפי לאות כ-http://127.0.0.1:4101, כל ייצוא יישלח ל-/, שאינו נתיב תקין; כתוצאה מכך דבר לא יגיע וה-SDK יתעד כשל בייצוא בעוד האפליקציה שלכם תיראה תקינה.
עבור שירות Node, מסלול ה-zero code מספיק כדי להוכיח שה-pipeline עובד:
npm install @opentelemetry/api @opentelemetry/auto-instrumentations-node
node --require @opentelemetry/auto-instrumentations-node/register server.jsכעת, גרמו לתקלה בכוונה. כל נתיב שזורק שגיאה יספיק:
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3000/boomבדקו את הדילוגים (hops) לפי הסדר, שכן הפער הראשון יצביע על השלב שנכשל:
tail -n 50 tmp/logs/proxy.log
docker compose exec clickhouse clickhouse-client --database superlog --query 'SELECT count() FROM otel_traces'עלייה במספר ב-otel_traces כאשר אפליקציית ה-web ריקה מעידה על אי-התאמה בפרויקט, לכן בדקו לאיזה פרויקט שייך מפתח ה-ingest. מספר שטוח עם פעילות בלוג ה-proxy מצביע על ה-collector או על הכתיבה ל-ClickHouse, לכן קראו את docker compose logs collector. היעדר פעילות בלוג ה-proxy לחלוטין אומר שה-exporter מעולם לא הגיע ל-intake: פורט שגוי, נתיב שגוי, או מפתח שנדחה.
באפליקציית ה-web, כשלים חוזרים אלו מגיעים כתקרית אחת במקום כשורה אחת לכל בקשה. Superlog מבצע fingerprinting לאותות נכנסים ומקבץ את התואמים שבהם, וזהו ההבדל בין תיבת דואר נכנס המכילה 4,000 שגיאות זהות לבין דף המציג תקרית אחת. ה-agent runner הקהילתי המוגדר כברירת מחדל מתעד לאחר מכן סיכום תקרית מקומי עבור אותה קבוצה.
חקירה מבוססת מודל דורשת ספק מודל ו-agent runner תואם מוגדר; ה-runner הקהילתי המוגדר כברירת מחדל מתעד סיכום מקומי. קחו את שמות המשתנים הללו מקובץ .env.example הנמצא בתוך כל ספריית אפליקציה של ה-commit שקיבעתם (pinned), במקום מכל מסמך חיצוני, כיוון שהם משתנים עם main. אותו הדבר תקף לאינטגרציות של GitHub ו-Sentry, הנושאות את מסמכי ההגדרה שלהן ב-docs/github-app-setup.md ו-docs/sentry-app-setup.md, כאשר ה-payloads של ה-webhook מתועדים ב-docs/webhooks.md.
שמירה על פרטיות הנתונים והגבלת הרשאות ה־agent
Docker מפרסם פורטים של מכולות בכתובת 0.0.0.0 כברירת מחדל, ופורטים אלו עוקפים את ufw. Docker מנתב תעבורת מכולות בטבלת nat, כך שחבילות המיועדות לפורט מפורסם מופנות לפני שהן מגיעות לשרשראות INPUT ו-OUTPUT שבהן נמצאים חוקי ה-ufw, ולכן ל-ufw אין השפעה עליהן. בשרת VPS עם כתובת IP ציבורית, קובץ ה-compose כפי שהוא מסופק חושף את ClickHouse HTTP בפורט 8123 ואת Postgres בפורט 5434 לגישה מהאינטרנט. פרטי ההתחברות בקובץ זה הם ברירות מחדל לפיתוח: משתמש ClickHouse הוא default ללא סיסמה, וב-Postgres המשתמש והסיסמה הם postgres.
יש להגדיר אותם ל-loopback. כל פורט שמפורסם בקובץ ה-compose שואב את צד המארח שלו ממשתנה סביבה, לכן יצירת קובץ .env בשורש המאגר מספיקה:
POSTGRES_HOST_PORT=127.0.0.1:5434
CLICKHOUSE_HTTP_HOST_PORT=127.0.0.1:8123
CLICKHOUSE_TCP_HOST_PORT=127.0.0.1:9000
COLLECTOR_GRPC_HOST_PORT=127.0.0.1:4317
COLLECTOR_HTTP_HOST_PORT=127.0.0.1:4318יש לוודא את התוצאה לפני שסומכים עליה, ולאחר מכן להקים מחדש את המכולות:
docker compose config
docker compose up -d
ss -lntp | grep -E '5434|8123|9000|4317|4318'הפקודה docker compose config מציגה את הקובץ המפורש, כך שניתן לקרוא את 127.0.0.1:5434:5432 במקום לנחש. ss אמור להציג כעת 127.0.0.1:5434 ולעולם לא 0.0.0.0:5434. הגדרה מחדש של ports בקובץ override של Compose שומרת על שני הקישורים כאשר ה-IP של המארח שונה; גרסאות Compose 2.24.4 ומעלה תומכות ב-ports: !override כדי להחליף את הרשימה.
ה-intake דורש התייחסות דומה. מפתח ה-ingest עובר בתוך header, לכן הוא מחייב TLS (אבטחת שכבת תעבורה) לפניו: יש לבצע TLS termination ב-nginx או ב-Caddy לפני ה-proxy, או לשמור את ה-ingest בתוך רשת פרטית או מנהרת WireGuard. אפליקציית ה-web בפורט 5173 היא שרת פיתוח של Vite ואין לה שום סיבה להיחשף לאינטרנט.
לאחר מכן, ה-agent עצמו. הערך המוסף של Superlog הוא שה-agent חוקר ומציע תיקון, והמילה החשובה כאן היא "מציע". יש להגדיר אותו כ-read only מול סביבת הייצור עד שתצפו בו פועל בכמה אירועים אמיתיים. אפליקציית GitHub עם הרשאות read-only אינה יכולה לדחוף ענף תיקון או לפתוח pull requests: מדריך ההתקנה דורש הרשאות כתיבה מסוג Contents ו-Pull requests עבור תהליך עבודה זה, בתוספת הרשאת כתיבה מסוג Issues עבור תגובות. agent שקורא טלמטריה וכותב patch הוא כלי שימושי. agent שיכול לבצע restart לשירותים שלכם הוא רמת סיכון שונה, וזו צריכה להיות החלטה מודעת שלכם ולא ברירת מחדל שאתם יורשים. עלויות דורשות תשומת לב דומה בעת הגדרת runner מבוסס מודל: תקציב להוצאות ה-agent ב-VPS לפני שמכוונים אותו למערכת ייצור רועשת, ושמרו תיעוד של הפעולות שה-agent ביצע בפועל כך שלכל pull request מפתיע יהיה נתיב ביקורת (audit trail) מאחוריו.
כשלים נפוצים ושמות השגיאות שלהם
ERR_PNPM_UNSUPPORTED_ENGINEבמהלךpnpm installמציין שדרישות המנוע אינן תואמות. הגרסה pnpm 9.12.0 בודקת את דרישות Node ו-pnpm; יש לעיין בגרסאות הנדרשות והנוכחיות המופיעות בשגיאה, ולאחר מכן לבדוק אתnode -vואתpnpm -v.ECONNREFUSED 127.0.0.1:5434במהלך המיגרציה מציין שחבילת ה-compose אינה פעילה, או ש-DATABASE_URLמציין פורט שגוי.- יש לבדוק אתחולים של ClickHouse באמצעות
docker compose logs clickhouse, ולאחר מכן לבדוק בקונטיינר האםOOMKilledמוגדר כ-true. - אקספורטר שמדווח על הצלחה בעוד אפליקציית ה-web נשארת ריקה, מציין בדרך כלל שהנתונים עברו ישירות ל-collector בפורט 4318, מה שעוקף את תיוג הפרויקט שמבצע ה-proxy.
- שגיאת Connection refused בפורט 4101 מציינת בדרך כלל שה-proxy מאזין בפורט 4000, הפורט שבו הקוד משתמש כברירת מחדל וזה שמוגדר ב-
.env.example. יש להגדיר אתPORTבמפורש בקובץ ה-unit או ב-.envשל האפליקציה. docker compose psהמציג0.0.0.0:8123מציין שקישורי ה-loopback אינם פעילים. יש להריץ אתdocker compose configולבדוק את הפורטים שזוהו.
Flawless, HyperProbe והמיקום של Superlog
קטגוריה זו חדשה, והכלים בה נבדלים זה מזה במידת הגישה המותרת לסוכן (agent). המאגר של Flawless מציג כעת את CISRE, פלטפורמת AI SRE (הנדסת אמינות אתרים) עבור Kubernetes ותשתית ענן, תחת רישיון PolyForm Noncommercial. הכלי HyperProbe מציב בדיקות (probes) בתוך תהליך רץ כדי ללכוד מצב משתנים וחושף מצב זה לעוזר חכם באמצעות MCP (פרוטוקול הקשר למודל); הוא גם מתעד אירוח עצמי באמצעות Docker Compose ומפתח רישיון.
Superlog ממוקם בין השניים. הוא שולט בצינור הנתונים (pipeline) מקצה לקצה, החל מקליטת OTLP ועד לאחסון ב-ClickHouse, והוא מציב את הסוכן בשלב המיון (triage) ולא בשלב התיקון. תכנון זה הוא בדיוק הסיבה לכך שאירוח עצמי שלו הוא החלטה תשתיתית ולא מכולה שאפשר לשכוח ממנה. ברגע שמריצים את Superlog, מריצים מסד נתונים טורי (column store), והוא דורש את אותה רמת תחזוקה כמו כל מסד נתונים אחר שבבעלותכם.
FAQ
כמה זיכרון RAM דרוש להרצה עצמית של Superlog?
תכננו עבור 8 GB של RAM, 4 vCPU ו-40 GB של שטח דיסק עבור צומת יחיד בנפח קליטה נמוך. ה-stack כולל את Postgres, ClickHouse, אוסף OpenTelemetry וארבעה תהליכי Node, כאשר ClickHouse דורש מרווח נשימה. מדדו את הנתונים שלכם בעזרת docker stats --no-stream ו-free -m במקום להסתמך על נתונים מפורסמים, כולל אלו המופיעים כאן.
לאיזה פורט עליי להפנות את ה-OTLP exporter שלי?
ל-proxy הקליטה של Superlog, אשר ה-README מגדיר ב-http://localhost:4101. הוא משרת את /v1/traces, /v1/logs ו-/v1/metrics, ומבצע אימות מול מפתח הקליטה של הפרויקט שלכם, הנלקח מה-header x-api-key או מ-header מסוג authorization: bearer. פורט 4318 הוא אוסף ה-OpenTelemetry שמתחתיו, וייצוא ישיר אליו מדלג על ה-proxy, שהוא הרכיב שמצמיד את מזהה הפרויקט שלכם לנתונים. ה-proxy חוזר לפורט 4000 כאשר PORT אינו מוגדר, וה-.env.example שלו מגדיר גם הוא את 4000, לכן הריצו את ss -lntp וודאו לאיזה פורט הוא נקשר לפני שתניחו שמדובר ב-4101.
האם Superlog מחליף את Uptime Kuma או את Zabbix?
לא. Uptime Kuma עונה על השאלה האם נקודת קצה מגיבה מחוץ לרשת שלכם, ו-Zabbix מנטר מדדי מארח ושירותים מול ספים שהגדרתם. Superlog צורך את ה-traces, הלוגים והמדדים שהיישומים שלכם פולטים ומקבץ כשלים חוזרים לאירועים (incidents). שמרו בדיקת זמינות חיצונית לצדו, כיוון שבדיקה שרצה ממקום אחר תדווח גם כאשר השרת שמחזיק את צינור הטלמטריה שלכם הוא זה שקרס.
האם ה-agent של Superlog יכול לשנות את מערכות הייצור שלי?
רק באמצעות הרשאות שאתם מעניקים לו. ה-runner הקהילתי המוגדר כברירת מחדל מתעד סיכום אירועים מקומי; סביבות הרצה אחרות לחקירה תלויות ב-runner שתגדירו. שמרו על הרשאות גישה לייצור ברמת קריאה בלבד; פתיחת pull requests דורשת הרשאות כתיבה נפרדות ב-GitHub עבור ענפים ו-pull requests. התייחסו לגישת כתיבה לייצור כאל החלטה נפרדת ומכוונת, כיוון ש-agent שמסוגל להפעיל מחדש שירותים מהווה מחויבות גדולה בהרבה מ-agent שרק קורא טלמטריה וכותב תיקון לבדיקה.
האם עליי לקבע commit או לעקוב אחרי main?
קבעו commit. נכון ל-13 באוקטובר 2026, לא היו תגיות release במאגר. תעדו את ה-SHA שבדקתם, בצעו פריסה שלו, וקראו את ה-diff לפני שתתקדמו הלאה. git log --oneline <old-sha>..main הוא הסקירה, וקובצי ה-.env.example לכל יישום הם המקום הראשון לבדוק בו משתנים חדשים שנדרשים לאחר כל עדכון גרסה.