פריסה

​

סקירת ארכיטקטורה

  [ AI agent machines ]                  [ Your infrastructure ]

    Python SDK
       |  writes JSONL                       +----------------------+
       v                                +--->| PostgreSQL 15+       |
 agenteye-collector --HTTP--+           |    | (relational store)   |
                            |           |    +----------------------+
                            v           |
                       +--------+       |    +----------------------+
                       | Server |<------+--->| ClickHouse 24+       |
                       +--------+       |    | (events / analytics) |
                            ^           |    +----------------------+
                        API |           |
                            |           |    +----------------------+
                      +-----------+     +- - >| Redis 7+ (optional) |
                      | Dashboard |           +----------------------+
                      +-----------+

• Server: שירות HTTP בשפת Rust; מקבל אצוות אירועים, כותב אותן ל-ClickHouse ותמונת מצב יחסית שמורה ב-PostgreSQL.
• Dashboard: אפליקציית Next.js; קוראת וכותבת בעקביות דרך API השרת בלבד.
• agenteye-collector: מפורסת על מכונות agent, לא על מארח השרת.
• Postgres 15+: נדרש. (הועלה מ-14 בהוצאה מרובה-דיירים; סכימת חברות הארגון משתמשת בעמודה ON DELETE SET NULL במפתח זר, שהוא Postgres 15+. שדרג את Postgres לפני פריסת גרסה זו.) מאחסן מצב OLTP: api_keys, users, sessions, evaluation_jobs (תור), dashboards, saved_queries, otp_codes, בתוספת טבלאות מרובות-דיירים orgs, org_memberships, org_settings.
• ClickHouse 24+: נדרש. אחסן האנליטיקה לכל אירוע שנספג. מנוע: ReplacingMergeTree, מחולק לפי חודש, סדור לפי (session_id, ts, dedup_key). השרת מתחבר דרך CLICKHOUSE_URL; ה-deploy/base/clickhouse/ המצורף משדר תצורת יחיד-קשר עם כיוונון ביצועים. דרישת מרובה-דיירים: התצורה המצורפת מאפשרת ניהול גישה SQL + users_without_row_policies_can_read_rows=false כך שהשרת יכול ליצור משתמש ClickHouse לקריאה בלבד ממנהל שורות אחד לכל ארגון (גבול בידוד שנאכף במנוע לעורך SQL וביעילות agent). אם אתה מספק תצורת ClickHouse משלך, הנקל את ההגדרות הללו (ראה deploy/base/clickhouse/configmap.yaml).
• Redis 7+: אופציונלי אחסן זיכרון משותף + בקצה שיעור הגבלה. שרת ולוח בקרה מתחברים דרך REDIS_URL. אם חסר, שניהם יורדים בחן לנתיבים Postgres בלבד. ראה Redis (אחסן זיכרון אופציונלי) למטה.

​

שרת

​

משוך את התמונה

echo $AGENTEYE_TOKEN | docker login ghcr.io -u x --password-stdin
docker pull ghcr.io/agenteye-enterprise/server:beta-latest

בניות נוכחיות מפרסמות תחת beta-latest; latest מוקצה רק להוצאות יציבות. לייצור, הצמד גרסה ספציפית :v<version>; ראה תגיות תמונה זמינות.

​

משתני סביבה

​

הרץ

docker run -d --restart unless-stopped \
  --name agenteye-server \
  -e DATABASE_URL="$DATABASE_URL" \
  -e ADMIN_KEY="$ADMIN_KEY" \
  -p 8080:8080 \
  ghcr.io/agenteye-enterprise/server:beta-latest

​

בדיקת בריאות

GET /health    # liveness  - always {"status":"ok"} once the process is up
GET /ready     # readiness - 200 when Postgres + ClickHouse are reachable, else 503

​

URL קישור קסום דוא”ל

1. כותר X-AgentEye-Dashboard-Url: הגדר באופן אוטומטי על ידי פרוקסי /api/auth/otp/request של לוח הבקרה מהמקור הציבורי שלו. בפריסה same-origin (שרת ולוח בקרה חלוקים מארח מאחורי ingress אחד שהכותרות פרוקסי מעבר), אין תצורה נדרשת.
2. DASHBOARD_URL env var: הגדר זאת אם לוח הבקרה שלך מושג ב-origin אחר מזה שנקודת הקשה OTP של השרת רואה (split api.example.com / app.example.com), או אם ingress שלך לא מתפשר את המארח הציבורי לתוך פוד לוח הבקרה (אז request.nextUrl.origin יפתור אחרת כמו 0.0.0.0:3000). דוגמה: DASHBOARD_URL=https://app.example.com.
3. ברירת מחדל: https://app.befailproof.ai, משומש רק אם לא אחד משני הלעיל קיים.

kubectl set env deployment/server -n agenteye \
  DASHBOARD_URL=https://app.example.com

​

לוח בקרה

​

משוך את התמונה

docker pull ghcr.io/agenteye-enterprise/dashboard:beta-latest

​

משתני סביבה

​

הרץ

docker run -d --restart unless-stopped \
  --name agenteye-dashboard \
  -e AGENTEYE_SERVER_URL="http://your-server-host:8080" \
  -e AGENTEYE_API_KEY="$ADMIN_KEY" \
  -p 3000:3000 \
  ghcr.io/agenteye-enterprise/dashboard:beta-latest

​

טלמטריה & פרטיות

• אף אחד סוכן, פעילות, או נתונים אירוע לעולם עוזב את התשתית שלך. רק שימוש UI לוח בקרה מדווח. כתובות דף מעלות זיהוי לפני שליחה, ומפעילים מזוהים רק על ידי id פנימי אטום, לעולם לא על ידי דוא”ל.
• טלמטריה מופעלת כברירת מחדל. כדי להכבות זאת לחלוטין, הגדר AE_ANALYTICS_DISABLED=1 בתא לוח הבקרה והפעל מחדש.
• אנליטיקה נשלחה ללוח הבקרה שלה בעצמו /ingest נתיב, בו לוח הבקרה reverse-proxies ל-PostHog (https://us.i.posthog.com). שמירת בקשות first-party אומר חוסמי פרסומות בדפדפן לא טרופים אותם. תא לוח הבקרה צריך גישה יוצאת ל-PostHog; אם זה חסום, טלמטריה שמחרישת ולוח הבקרה לא מושפע.

​

עוזר AI (אופציונלי)

​

ClickHouse (אחסן אנליטיקה נדרש)

​

סכימה

• agenteye.events: ReplacingMergeTree(ingested_at), חולק לפי toYYYYMM(ts), סדור לפי (session_id, ts, dedup_key). כפול insert (collector ניסיונות) קוטע שורה יחידה בהתמזגות זמן; השרת מחשב קובע SHA-256 dedup_key לכל אירוע אז ניסיונות בטוחים.
• agenteye.evaluations: ReplacingMergeTree(ingested_at), חולק לפי toYYYYMM(finished_at), סדור לפי (session_id, finished_at, dedup_key). כתובה פעם אחת לכל טרמינל הערכה תוצאה על ידי קו האורך evaluator. אותם dedup-key דגם כמו events.
• agenteye.agent_sessions: VIEW על agenteye.events, לא טבלה פיזית. כל עמודה נגזרת (started_at = min(ts), last_event_at = max(ts), ended_at = max(if event_type='agent_end', ts, NULL), event_count = count(), וכו’). אף לא לכל-אירוע upsert ולא ממלא נפרד; ה-view auto-מחזיר איך הוא בתוך events.

​

תצורה

• 2 GiB בקשה / 4 GiB כחוג זיכרון בבסיס משודר overlay (בגודל לעמוד קטן POC/staging צמתים); ייצור לקוחות צריכים overlay עד — הרצפה מומלצת היא 2c / 4Gi בקשה, 6c / 8Gi כחוג. max_server_memory_usage_to_ram_ratio=0.9
• 5 GiB סימן אחסן + 8 GiB דחוסu אחסן
• background_pool_size=16, background_merges_mutations_concurrency_ratio=2
• MergeTree: parts_to_throw_insert=3000, parts_to_delay_insert=1500, non_replicated_deduplication_window=1000
• local_io_method=auto (io_uring בתמיכת צמתים)
• fsync_metadata=0: קביל כי לפחות-פעם ingest + ReplacingMergeTree dedup
• query_log מופעל עם 30-יום TTL; query_thread_log הוסר (יקר בגבוה QPS)
• max_execution_time=30 לשאילתות בצד משתמש
• 100 GiB PVC בתבנית StatefulSet (לקוח overlays צריך לעלות מהיר SSD סוג אחסן לייצור)

​

גיבויים

​

Redis (אחסן זיכרון אופציונלי)

• Server משמור התייקדויות API-key, ה-/events/environments + /evaluations/environments רשימות, ה-/events/latency_aggregate rollup (הכבד ביותר שאילתה לוח הבקרה סקרים), ה-/sessions רשימה, וסוויץ’ שיעור הגבלה בקשה OTP מ-Postgres COUNT(*) ל-Redis INCR + EXPIRE.
• Dashboard משמור validateSession() תוצאות אז ה-10-20 authed API מטלות עלות דף טיפול שכל חלוקה משותף אחד בדיקה זרם שרת. זה גם משעות מקצב OTP-בקשה וOTP-עד זה קצה לוח הבקרה.

​

תצורה

​

זיכרון + התמשכות

​

מתי לא פרוס Redis

• יחיד-instance dev/QA. ה-in-process אחסנים בשרת לבד לספק כמו כל לכל-חזרה טובה; Redis מוסיף את כל-חזרה שיתוף עומס שיחיד-instance להגדרות לא צורך.
• אויר-מנותק התקנות איפה שהם תפעול עלות של הפעלה אחד יותר שירות משקל הזמן-חזון.

​

Docker Compose (מומלץ)

GITHUB_TOKEN=$AGENTEYE_TOKEN gh release download \
  --repo agenteye-enterprise/releases \
  --pattern 'docker-compose.yml' \
  --dir ./agenteye
cd agenteye

# Use URL-safe passwords (no /, +, or = characters).
# Generate with: openssl rand -hex 24
POSTGRES_PASSWORD=your-db-password
ADMIN_KEY=your-admin-secret

# Dashboard authentication
ADMIN_EMAIL=admin@yourcompany.com
ALLOWED_EMAILS=*@yourcompany.com

# SMTP for OTP emails (omit to log OTP codes to stdout)
# SMTP_HOST=smtp.yourprovider.com
# SMTP_PORT=587
# SMTP_USERNAME=your-smtp-user
# SMTP_PASSWORD=your-smtp-password
# SMTP_FROM=noreply@yourcompany.com

RUST_LOG=info

docker compose up -d

docker compose down

docker compose down -v

​

הגדרות תפעול

​

כיצד bootstrap עבודות

• ל-טרי redeploy, קבוע env vars כמו לעיל ו-ברירת המחדל ארגון קוראים אותם בהפעלה ראשונה.
• כדי שנה ערך מאוחר, היכנס לוח הבקרה ו-עריכה זה תחת /<org>/settings. השינוי מיושם בתוך שניות על כל שרת חזרות; אף restart נדרש.
• הפעלה יומן ישר רשמות מה זרע לעומת מה היה כבר קיים, אז אתה יכול לבטח bootstrap לקח אפקט:
  INFO settings bootstrap: seeded default-org row key=allowed_sign_ins env_var=ALLOWED_EMAILS seeded_from_env=true
  

​

Sign-in סמנטיקה על פני ארגונים

• פעילות / OTP lifetime: הקפיד (הקצרה) lifetime בין ארגונים משתמש שייכות לחמש.
• מורשה sign-ins: ה-קרית OR כל-ארגון allowlist יחד עם ארגון חברות: משתמש יכול בקשה OTP אם כל-ארגון allowlist יחמנים דוא”ל או הם כבר חברות של כל-ארגון.

​

הרשאות

• settings:read: ראה העמוד וערכים נוכחיים.
• settings:write: שמור שינויים.

​

ארגונים (רב-דיירים)

# Docker Compose - exec into the running server service:
docker compose exec server agenteye-orgctl org create --slug acme --name "Acme Corp"
docker compose exec server agenteye-orgctl member add --org acme --email alice@acme.example --set admin

# Kubernetes - exec into the running server Deployment:
kubectl -n agenteye exec deploy/server -- agenteye-orgctl org list