आवश्यक शर्तें
- कंटेनर इमेज खींचने और आर्टिफैक्ट डाउनलोड करने के लिए एक GitHub PAT (देखें enterprise-docs/github-token.md)
- एक समर्पित Kubernetes क्लस्टर (नीचे आवश्यकताएं देखें)
- डेटाबेस बैकअप के लिए एक स्टोरेज बकेट
- नेटवर्क कनेक्टिविटी: क्लस्टर के लोड बैलेंसर के लिए पोर्ट 443 इनबाउंड
चरण 1: एक समर्पित Kubernetes क्लस्टर प्रदान करें
AgentEye के लिए एक Kubernetes क्लस्टर बनाएं जो अन्य workloads के साथ साझा न हो। पूरा प्लेटफॉर्म (एप्लिकेशन सेवाएं, डेटाबेस, विश्लेषण और कैशिंग) अलगाव में चलता है जिससे आपके मौजूदा बुनियादी ढांचे को प्रभावित न करे।| आवश्यकता | विवरण |
|---|---|
| वितरण | कोई भी conformant Kubernetes: EKS, GKE, AKS, या self-managed |
| संस्करण | 1.27 या बाद में |
| नोड पूल | न्यूनतम: 3 नोड्स, 4 vCPU / 8 GB RAM प्रत्येक (standard general-purpose instances) |
| स्टोरेज | एक default StorageClass जो ब्लॉक वॉल्यूम प्रदान करता है (जैसे AWS पर gp3, GCP पर pd-ssd) |
| लोड बैलेंसर | क्लस्टर को cloud LoadBalancer सेवाएं प्रदान करने में सक्षम होना चाहिए (EKS, GKE, AKS पर default) |
Exosphere क्लस्टर के अंदर सब कुछ स्थापित और प्रबंधित करता है: ingress controllers, TLS प्रमाणपत्र, डेटाबेस, कैशिंग, निगरानी और सभी एप्लिकेशन स्थापन।
चरण 2: AgentEye टीम को एक्सेस प्रदान करें
Exosphere को cluster-admin एक्सेस (या समतुल्य व्यापक RBAC) की आवश्यकता है namespaces, custom resource definitions, ingress controllers और storage provisioners को प्रबंधित करने के लिए।| आवश्यकता | विवरण |
|---|---|
| एक्सेस विधि | IAM role (EKS/GKE के लिए पसंदीदा), kubeconfig, या SSO-आधारित एक्सेस |
| VPN / bastion | यदि Kubernetes API सर्वर निजी है, तो Exosphere ऑपरेशन टीम के लिए VPN क्रेडेंशियल या bastion एक्सेस प्रदान करें |
चरण 3: नेटवर्क कनेक्टिविटी कॉन्फ़िगर करें
आपकी नेटवर्क टीम को क्लस्टर के लोड बैलेंसर के लिए पोर्ट 443 पर इनबाउंड ट्रैफिक की अनुमति देनी चाहिए। स्थापना दो अलग-अलग लोड बैलेंसर चलाता है: एक इवेंट ingestion के लिए (mTLS-सुरक्षित) और एक डैशबोर्ड के लिए:| ट्रैफिक | स्रोत | गंतव्य | सुरक्षा |
|---|---|---|---|
| इवेंट ingestion | आपके क्लस्टर में Collector pods | Ingest LoadBalancer, पोर्ट 443 | mTLS (client certificate) + API key |
| डैशबोर्ड | डेवलपर ब्राउज़र | Dashboard LoadBalancer, पोर्ट 443 | आपके डोमेन पर HTTPS, passwordless email OTP sign-in |
agenteye.your-company.example) — लोड बैलेंसर होस्टनाम की ओर जो Exosphere प्रदान करता है। Exosphere फिर दोनों होस्टनाम के लिए publicly-trusted TLS प्रमाणपत्र स्वचालित रूप से प्रदान करता है, renewals सहित।
पोर्ट 80 नोट: स्वचालित प्रमाणपत्र issuance और renewal प्रत्येक लोड बैलेंसर के पोर्ट 80 पर HTTP पर validate करते हैं। यदि आपकी सुरक्षा नीति को डैशबोर्ड लोड बैलेंसर को corporate IP ranges तक सीमित करने की आवश्यकता है, तो पहले Exosphere को बताएं — हम प्रमाणपत्र validation को DNS-आधारित विधि में स्विच करते हैं (आपकी ओर से एक अतिरिक्त DNS रिकॉर्ड) ताकि प्रतिबंध के पीछे renewals काम करती रहें।
आउटबाउंड: क्लस्टर नोड्स कोghcr.ioसे कंटेनर इमेज खींचने के लिए इंटरनेट एक्सेस की आवश्यकता है। यदि आपका नेटवर्क आउटबाउंड ट्रैफिक को प्रतिबंधित करता है, तोghcr.ioको allowlist करें या इमेज को अपने आंतरिक registry में mirror करें।
चरण 4: एक बैकअप स्टोरेज बकेट प्रदान करें
डेटाबेस बैकअप एक क्लाउड स्टोरेज बकेट में संग्रहीत होते हैं जो आप स्वामित्व रखते हैं।| आवश्यकता | विवरण |
|---|---|
| सेवा | S3 (AWS), GCS (GCP), या Azure Blob Storage |
| एक्सेस | IAM role के माध्यम से क्लस्टर के नोड्स को write एक्सेस प्रदान करें service accounts के लिए (EKS पर IRSA, GKE पर Workload Identity) या क्रेडेंशियल प्रदान करें |
| Retention | आप बकेट की lifecycle policy को नियंत्रित करते हैं (retention period, archival rules)। Exosphere बैकअप लिखता है; आप तय करते हैं कि उन्हें कितने समय तक रखना है |
चरण 5: एक संपर्क बिंदु नामित करें
cluster-level समस्याओं के लिए अपनी ओर से एक व्यक्ति या Slack/Teams चैनल प्रदान करें: नोड स्वास्थ्य, क्लाउड खाता सीमाएं, नेटवर्क परिवर्तन। दिन-प्रतिदिन के ऑपरेशन में इस संपर्क को शामिल नहीं किया जाता है।हम क्या स्थापित करते हैं
एक बार Exosphere को क्लस्टर एक्सेस हो जाने के बाद, निम्नलिखित घटक आपके लिए स्थापित और प्रबंधित किए जाते हैं:| घटक | भूमिका |
|---|---|
| AgentEye Server | HTTP API जो collectors से events प्राप्त करता है, विश्लेषण चलाता है और डैशबोर्ड को डेटा प्रदान करता है |
| Dashboard | एजेंट सेशन, टूल कॉल, मॉडल अनुरोध और त्रुटियां देखने के लिए web interface; वैकल्पिक read-only AI सहायक को होस्ट करता है |
| ClickHouse | Ingested events, विश्लेषण और evaluations के लिए आवश्यक canonical store |
| PostgreSQL | संगठन, API keys, users, dashboards और saved queries के लिए relational store |
| Redis | वैकल्पिक shared cache और rate-limit backend; यदि यह उपलब्ध नहीं है तो प्लेटफॉर्म gracefully degrade होता है |
| AI सहायक (वैकल्पिक) | Internal read-only assistant container; जब तक कोई LLM एंडपॉइंट configured न हो तब तक disabled रहता है |
| Ingress controllers | दो लोड बैलेंसर (एक mTLS-सुरक्षित ingest के लिए, एक डैशबोर्ड के लिए) TLS को terminate करते हुए publicly-trusted, auto-renewed प्रमाणपत्र के साथ और ingest एंडपॉइंट पर mTLS लागू करते हैं |
| cert-manager | TLS प्रमाणपत्र provisioning और mTLS client-certificate issuance को स्वचालित करता है |
| प्रमाणपत्र निगरानी | एक scheduled job प्रमाणपत्र की expiry की जांच करता है और जब प्रमाणपत्र renewal के करीब हों तो alerts भेजता है (जैसे Slack को) |
हम आपको क्या प्रदान करते हैं
स्थापना के बाद, आपको निम्नलिखित प्राप्त होते हैं:| आइटम | विवरण |
|---|---|
| Dashboard URL | आपके डोमेन के तहत एक होस्टनाम (जैसे https://agenteye.your-company.example), publicly-trusted, auto-renewed TLS प्रमाणपत्र के साथ served। आप हम द्वारा प्रदान किए गए लोड बैलेंसर होस्टनाम के लिए एक CNAME बनाते हैं; sign-in passwordless email OTP है |
| Collector endpoint | Ingest होस्टनाम का /events path (जैसे https://ingest.your-company.example/events), mTLS-सुरक्षित |
| Client certificate bundle | प्रति-क्लस्टर: client cert, private key, और CA cert एक Kubernetes Secret manifest के रूप में delivered। इसे एक बार प्रति क्लस्टर लागू करें |
| GitHub PAT | Collector binaries और Python SDK packages डाउनलोड करने के लिए |
| Collector API keys | events:add permission के साथ scoped keys, प्रत्येक collector deployment के लिए एक |
| Installation guides | Collector और Python SDK के लिए step-by-step दस्तावेज़ |
सेटअप के बाद आप क्या करते हैं
आपका एकमात्र चल रहा काम आपनी अपनी agent machines पर है, AgentEye क्लस्टर पर नहीं:- Collector स्थापित करें हर Kubernetes क्लस्टर में जो AI agents चलाता है: client certificate को mount करें और endpoint URL और API key को configure करें। देखें enterprise-docs/collector-installation.md।
- Python SDK को एकीकृत करें अपने agent code में। देखें enterprise-docs/python-sdk.md।
- Dashboard खोलें अपने ब्राउज़र में agent activity को देखने के लिए।
सुरक्षा
- डेटा आपके क्लाउड खाते में रहता है। क्लस्टर, स्टोरेज और डेटाबेस सभी आपके environment में चलते हैं। कोई डेटा आपकी boundary को नहीं छोड़ता।
- आप एक्सेस को नियंत्रित करते हैं। क्लस्टर आपके खाते में है। आप किसी भी समय Exosphere के एक्सेस को audit, monitor या revoke कर सकते हैं। सभी ऑपरेशन आपके क्लाउड के audit log (CloudTrail, GCP Audit Logs, आदि) के माध्यम से जाते हैं।
- Event ingestion पर mTLS। हर collector अनुरोध को एक valid client certificate और एक API key दोनों की आवश्यकता है। एक leaked key प्रमाणपत्र के बिना बेकार है; एक stolen cert एक valid key के बिना बेकार है।
- Dashboard एक्सेस नियंत्रण। Dashboard अपने स्वयं के लोड बैलेंसर पर चलता है, event ingestion से अलग, और sign-in passwordless email OTP है जो आपके द्वारा allowlist किए गए ईमेल पते/डोमेन तक सीमित है। लोड बैलेंसर पर IP source-range allowlist अनुरोध पर उपलब्ध है; क्योंकि स्वचालित प्रमाणपत्र renewal को लोड बैलेंसर तक पहुंचना चाहिए, Exosphere प्रतिबंध को DNS-based प्रमाणपत्र validation के साथ जोड़ता है ताकि renewals काम करती रहें।
- प्रति-क्लस्टर प्रमाणपत्र। आपके प्रत्येक क्लस्टर को अपना client certificate मिलता है। यदि एक क्लस्टर compromised है, तो वह प्रमाणपत्र स्वतंत्र रूप से revoke किया जाता है अन्य को प्रभावित किए बिना।
स्थापना समयरेखा
| चरण | अवधि | आपकी involvement |
|---|---|---|
| क्लस्टर provisioning | 1-2 दिन | क्लस्टर को provision करें और Exosphere को एक्सेस दें |
| प्लेटफॉर्म सेटअप | 1 दिन | कोई नहीं; Exosphere सभी बुनियादी ढांचे के घटक स्थापित करता है |
| एप्लिकेशन स्थापना | 1 दिन | कोई नहीं; Exosphere server, dashboard को स्थापित करता है और API keys बनाता है |
| Collector rollout | 1-3 दिन | अपने क्लस्टर में collectors स्थापित करें (Exosphere के मार्गदर्शन के साथ) |
| उत्पादन burn-in | 1 सप्ताह | कोई नहीं; Exosphere निगरानी और tuning करता है |
समर्थन
प्रश्नों या समस्याओं के लिए, Exosphere कोsupport@exosphere.host पर संपर्क करें।
अगले चरण
- Getting Started: end-to-end walkthrough
- Collector Installation: collector को स्थापित और कॉन्फ़िगर करें
- Python SDK: अपने agent code को instrument करें
- API Keys: एक्सेस और permissions को manage करें
- Troubleshooting: सामान्य समस्याएं और fixes

