Superlog को self-host कैसे करें और इसके क्या फायदे हैं
Superlog के जरिए OTLP logs और metrics को AI से triage करें। अपने VPS पर इसे सेटअप करने के लिए Postgres, ClickHouse और Node services का उपयोग करें। इसकी सीमाओं को समझें।
Superlog self-hosting में वास्तव में क्या इंस्टॉल होता है
Superlog को self-host करने के लिए आप repository को clone करते हैं, Docker Compose के साथ Postgres, ClickHouse और एक OpenTelemetry collector को start करते हैं, एक database migration चलाते हैं, और फिर source से चार Node services शुरू करते हैं। आपके applications OTLP (OpenTelemetry protocol) traces, logs और metrics को एक intake port पर भेजते हैं, Superlog उन्हें fingerprint करता है, दोहराए गए logs को एक single incident में group करता है, और default community agent runner एक local incident summary record करता है। इसे इंस्टॉल करने में एक दोपहर का समय लगता है। शुरू करने से पहले इसके footprint और वास्तविक सीमाओं (honest limits) के बारे में पढ़ना उपयोगी है।
Superlog Apache 2.0 licensed है और github.com/superloglabs/superlog पर उपलब्ध है। 13 October 2026 तक इसमें लगभग 1.5k stars हैं, main पर लगभग 490 commits हैं, और कोई भी release tag मौजूद नहीं है। जिस दिन आपने इसे clone किया, उस दिन जो भी main था उसे चलाने के बजाय, खुद एक विशिष्ट commit को pin करें।
Superlog उन सवालों के क्या जवाब देता है जो Uptime Kuma और Langfuse नहीं देते
Self-hosted monitoring tools बाहर से एक जैसे दिख सकते हैं। वे ऐसे नहीं हैं, और गलत टूल चलाने से आपको बिना किसी लाभ के एक सर्वर का नुकसान उठाना पड़ता है।
- Uptime Kuma आपके endpoints को बाहर से probe करता है और एक ही सवाल का जवाब देता है: क्या यह up है।
- Zabbix Ubuntu 24.04 पर hosts और services की निगरानी करता है, जिसमें आपके द्वारा निर्धारित thresholds के आधार पर CPU, memory, disk और service state की जाँच की जाती है।
- Langfuse LLM calls को trace करता है, जो प्रत्येक call के prompt, model, tokens, latency और cost को record करता है।
- Superlog उन telemetry डेटा को लेता है जिन्हें आपकी सामान्य services पहले से ही emit कर रही हैं और बार-बार होने वाली विफलताओं (repeated failures) को incidents में बदल देता है।
Superlog एक अलग सवाल का समाधान करता है: कुछ टूट गया है, तो क्या टूटा है, और क्यों टूटा है। LLM calls के बारे में इसकी कोई राय नहीं है और यह आपको बाहर से probe नहीं करता है। यह आपके सामान्य application code से OTLP को ingest करता है और triage चरण पर एक agent लगाता है, जो कि on-call रहने वाले व्यक्ति द्वारा किया जाने वाला पहला काम होता है।
VPS बजट के लिए जो अंतर मायने रखता है वह storage है। Superlog में एक column store होता है, क्योंकि telemetry को एक बार लिखा जाता है और फिर लाखों rows में समय सीमा (time range) के आधार पर query किया जाता है। ClickHouse इसी काम के लिए है और Postgres इसके लिए नहीं है। Postgres अभी भी stack में मौजूद रहता है, जो छोटे relational डेटा को संभालता है: projects, users, incidents और ingest keys।
docker compose up -d वास्तव में क्या शुरू करता है?
तीन containers, और उनमें से कोई भी Superlog नहीं है। यह उन लोगों को आश्चर्यचकित करता है जो एक ही command में install होने की उम्मीद करते हैं।
postgres:16, host port 5434 पर publishedclickhouse/clickhouse-server:26.1, HTTP के लिए 8123 और native protocol के लिए 9000 परotel/opentelemetry-collector-contrib:0.150.1, gRPC के लिए 4317 और HTTP पर OTLP के लिए 4318 पर
Superlog applications host पर, source से चलती हैं, जिन्हें pnpm dev द्वारा शुरू किया जाता है। 13 October 2026 तक repository में कोई production compose file नहीं है, इसलिए लंबे समय तक चलने वाले install का मतलब है कि आपको अपनी systemd units बनानी होंगी, या tree में दिए गए प्रति-app Dockerfiles का उपयोग करना होगा। api, worker और proxy apps में से प्रत्येक के पास wrap करने के लिए एक unit के रूप में start script है। web app के पास कोई नहीं है: यह एक Vite app है, इसलिए आप इसे इसकी build script के साथ build करते हैं और output को nginx या Caddy से static files के रूप में serve करते हैं, या इसकी preview script चलाते हैं, जो vite preview है।
एक span जिस path से गुजरता है उसे ध्यान में रखें, क्योंकि नीचे दी गई हर विफलता उस path के एक पड़ाव में रुकावट है। आपकी app Superlog intake proxy को OTLP post करती है। proxy आपके ingest key के साथ request को authenticate करती है, उस पर project id stamp करती है, और इसे collector को forward कर देती है। collector client द्वारा set किए गए किसी भी superlog.* attributes को हटा देता है, proxy द्वारा प्रदान किए गए header से superlog.project_id जोड़ता है, batch बनाता है, और ClickHouse में लिखता है। web app और API फिर ClickHouse से telemetry और बाकी सब कुछ Postgres से read करते हैं।
वह attribute stripping एक वास्तविक multi-tenancy control है, न कि केवल दिखावट। इसके बिना, एक वैध ingest key रखने वाला कोई भी व्यक्ति स्वयं superlog.project_id set कर सकता है और किसी अन्य project के data में लिख सकता है।
VPS का आकार कितना होना चाहिए?
कम ingest volume वाले single node install के लिए 4 vCPU, 8 GB RAM और 40 GB SSD की योजना बनाएँ। यह एक न्यूनतम आधार है, कोई सटीक माप नहीं, इसलिए इसे शुरुआती आकार मानें और अपने traffic के अनुसार इसकी जाँच करें।
Memory चार जगहों पर खर्च होती है। ClickHouse को अधिक RAM वाले मशीनों के लिए बनाया गया है और इसके defaults इसी आधार पर सेट हैं। यहाँ Postgres 16 की आवश्यकता कम है, क्योंकि यह telemetry के बजाय metadata रखता है। Collector भी कम संसाधन लेता है। चार Node processes में एक Vite development server और तीन tsx watch processes शामिल हैं; अपने सिस्टम पर इनके memory उपयोग को मापें।
Disk एक कम स्पष्ट समस्या है। इस monorepo पर pnpm install, एक भी span ingest करने से पहले ही AWS SDK, ClickHouse client, OpenTelemetry SDK और React toolchain को pull कर लेता है। इसके बाद ClickHouse आपके traffic के साथ बढ़ता है। दोनों को मापें:
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 जो प्रति मिनट हजारों समान errors पैदा करता है। Fingerprinting उन्हें पाठक के लिए एक ही incident में समेट देता है, लेकिन ClickHouse फिर भी हर row को नीचे लिखता है।
Retention सेट करना आपकी जिम्मेदारी है। Collector का ClickHouse exporter tables, otel_traces, otel_logs और प्रत्येक metric type के लिए एक table बनाता है, और यह केवल तभी time to live लागू करता है यदि infra/collector/config.yaml में config इसे सेट करे। अपने आप कुछ भी expire नहीं होता, इसलिए यदि आप योजना नहीं बनाते हैं, तो एक व्यस्त महीना disk को पूरा भर सकता है।
Pinned 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 October 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 version अपने आप इंस्टॉलेशन को नहीं रोकता है: engine enforcement कॉन्फ़िगरेशन पर निर्भर करता है, और जब engineStrict अक्षम (disabled) होता है तो pnpm 9.12.0 में एक warning path होता है। Ubuntu 24.04 आर्काइव में nodejs पैकेज 20 से पुराना है, इसलिए NodeSource या nvm से Node 20 या उससे नया वर्ज़न इंस्टॉल करें। रिपॉजिटरी में एक .nvmrc शामिल है, इसलिए यदि आपके पास nvm है तो nvm use इच्छित वर्ज़न को चुन लेता है।
pnpm install
docker compose up -d
docker compose psयह मान लेने के बजाय कि up -d का मतलब 'तैयार' है, health checks का इंतज़ार करें। Postgres और ClickHouse दोनों compose फ़ाइल में एक health check घोषित करते हैं:
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 का उत्तर देता है। 8123 पर 'Connection refused' का मतलब है कि कंटेनर अभी भी शुरू हो रहा है या बंद हो चुका है। docker compose logs clickhouse दिखाता है कि क्या स्थिति है, और docker inspect $(docker compose ps -q clickhouse) | grep -i oomkilled तब true रिपोर्ट करता है जब kernel ने इसे memory की कमी के कारण बंद कर दिया हो, जो यह दर्शाता है कि बॉक्स बहुत छोटा है, न कि आपकी कॉन्फ़िगरेशन में कोई समस्या है।
इसके बाद migration और applications:
pnpm --filter @superlog/db db:migrate
pnpm devपोर्ट पर ध्यान दें: 5434, 5432 नहीं। compose फ़ाइल Postgres को 5434 पर पब्लिश करती है ताकि यह होस्ट पर पहले से इंस्टॉल Postgres के साथ न टकराए, और ऐप की .env.example फ़ाइलें DATABASE_URL=postgres://postgres:postgres@localhost:5434/superlog के साथ मेल खाती हैं। यदि आप migration को उस बॉक्स पर 5432 की ओर निर्देशित करते हैं जहाँ पहले से ही Postgres चल रहा है, तो या तो connection refused हो जाएगा या, इससे भी बुरा, गलत डेटाबेस पर migration लागू हो जाएगा।
pnpm dev, turbo run dev को चलाता है, जो Turborepo के माध्यम से प्रत्येक ऐप की dev स्क्रिप्ट को शुरू करता है, जिसमें api, web, worker और proxy शामिल हैं, जिनका आउटपुट एक ही टर्मिनल में मिश्रित होता है। रिपॉजिटरी की Procfile में वही चार प्रक्रियाएं सूचीबद्ध हैं और प्रत्येक का आउटपुट tmp/logs/ में भेजा जाता है। यदि आप चाहते हैं कि tail -f tmp/logs/proxy.log वह जगह हो जहाँ आप ingest को मॉनिटर करें, तो pnpm dev के बजाय overmind या foreman जैसे Procfile रनर का उपयोग करें। README वेब ऐप को http://localhost:5173 पर, API को http://localhost:4100 पर और OTLP intake को http://localhost:4101 पर रखता है।
किसी भी चीज़ को निर्देशित करने से पहले पुष्टि करें कि वास्तव में क्या बाइंड (bind) हुआ है:
ss -lntp | grep -E '4000|4100|4101|5173'
curl -sS http://127.0.0.1:4101/healthयह बाद में महत्वपूर्ण होता है। प्रॉक्सी अपना पोर्ट PORT एनवायरनमेंट वेरिएबल से पढ़ता है और जब PORT अनसेट (unset) होता है तो 4000 पर वापस आ जाता है, और जो apps/proxy/.env.example यह लोड करता है वह भी PORT=4000 सेट करता है, भले ही README में intake 4101 पर सूचीबद्ध हो (दोनों 13 October 2026 को चेक किए गए)। ss जो भी पोर्ट दिखाता है उसका उपयोग करें। नीचे दिए गए उदाहरण 4101 का उपयोग करते हैं, इसलिए यदि 4000 बाइंड हुआ है तो उसे बदल लें। आपके द्वारा लिखी गई systemd यूनिट कुछ भी सेट नहीं करती है जब तक कि आप उसमें PORT न डालें, इसलिए 4000 पर लिसन कर रहे प्रॉक्सी के खिलाफ 4101 पर लक्षित exporter 'connection refused' के साथ विफल हो जाएगा और आपको कोई अन्य संकेत नहीं देगा।
एक ट्रेस भेजें, एक त्रुटि उत्पन्न करें, एक घटना देखें
वेब ऐप में एक प्रोजेक्ट बनाएँ और उसकी ingest key कॉपी करें। intake हर अनुरोध को उस key के विरुद्ध प्रमाणित करता है, इसलिए बिना key के भेजी गई टेलीमेट्री कभी भी ClickHouse तक नहीं पहुँचती है।
मानक environment variables का उपयोग करके किसी भी 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, x-api-key हेडर से key को पढ़ता है, और यदि आपके exporter को उस तरह कॉन्फ़िगर करना आसान है, तो authorization: bearer YOUR_INGEST_KEY को भी स्वीकार करता है। यह तीन मानक OTLP पाथ, /v1/traces, /v1/logs और /v1/metrics, और साथ ही /health को सर्व करता है।
एक जाल जिसका उल्लेख करना आवश्यक है: OTEL_EXPORTER_OTLP_ENDPOINT एक बेस URL है और SDK इसमें सिग्नल पाथ जोड़ देता है। OTEL_EXPORTER_OTLP_TRACES_ENDPOINT जैसे सिग्नल-विशिष्ट variables का उपयोग बिल्कुल वैसे ही किया जाता है जैसे वे लिखे गए हैं, बिना कोई पाथ जोड़े। यदि आप सिग्नल-विशिष्ट variable को http://127.0.0.1:4101 पर सेट करते हैं, तो हर एक्सपोर्ट / पर पोस्ट होगा, जो कि कोई रूट नहीं है। परिणामस्वरूप, कुछ भी प्राप्त नहीं होगा और SDK एक एक्सपोर्ट विफलता लॉग करेगा जबकि आपका ऐप स्वस्थ दिखाई देगा।
Node सर्विस के लिए, पाइपलाइन को सिद्ध करने हेतु जीरो-कोड पाथ पर्याप्त है:
npm install @opentelemetry/api @opentelemetry/auto-instrumentations-node
node --require @opentelemetry/auto-instrumentations-node/register server.jsअब जानबूझकर कुछ खराब करें। कोई भी रूट जो थ्रो (throw) करता है, वह काम करेगा:
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 में बढ़ती संख्या प्रोजेक्ट मिसमैच का संकेत है, इसलिए जाँचें कि ingest key किस प्रोजेक्ट से संबंधित है। प्रॉक्सी लॉग में गतिविधि के साथ स्थिर संख्या कलेक्टर या ClickHouse राइट की ओर इशारा करती है, इसलिए docker compose logs collector पढ़ें। प्रॉक्सी लॉग में बिल्कुल भी गतिविधि न होने का मतलब है कि exporter कभी intake तक पहुँचा ही नहीं: गलत पोर्ट, गलत पाथ, या अस्वीकृत key।
वेब ऐप में, वे बार-बार होने वाली विफलताएं प्रति अनुरोध एक पंक्ति के बजाय एक घटना (incident) के रूप में आती हैं। Superlog आने वाले सिग्नलों को फिंगरप्रिंट करता है और मेल खाने वालों को समूहबद्ध करता है। यही अंतर है एक इनबॉक्स में 4,000 समान त्रुटियां होने और एक पेज पर एक घटना होने के बीच। डिफ़ॉल्ट कम्युनिटी एजेंट रनर फिर उस समूह के लिए एक स्थानीय घटना सारांश रिकॉर्ड करता है।
मॉडल-समर्थित जांच के लिए एक मॉडल प्रदाता और एक संगत एजेंट रनर कॉन्फ़िगर होना चाहिए; डिफ़ॉल्ट कम्युनिटी रनर एक स्थानीय सारांश रिकॉर्ड करता है। उन variable नामों को किसी बाहरी लेख के बजाय उस कमिट की प्रत्येक ऐप डायरेक्टरी के अंदर मौजूद .env.example फ़ाइल से लें जिसे आपने पिन किया है, क्योंकि वे main के साथ बदलते रहते हैं। यही बात GitHub और Sentry इंटीग्रेशन पर भी लागू होती है, जिनके अपने सेटअप दस्तावेज़ docs/github-app-setup.md और docs/sentry-app-setup.md पर उपलब्ध हैं, और वेबहुक पेलोड docs/webhooks.md में प्रलेखित हैं।
Intake को private रखें और agent को read-only रखें
Docker डिफ़ॉल्ट रूप से container ports को 0.0.0.0 पर publish करता है, और ये published ports ufw को bypass कर देते हैं। Docker container traffic को nat table में route करता है, इसलिए published port के लिए आने वाला packet उन INPUT और OUTPUT chains तक पहुँचने से पहले ही divert हो जाता है जहाँ ufw के rules होते हैं, और ufw को निर्णय लेने का मौका ही नहीं मिलता। Public IP वाले VPS पर, compose file जैसा कि ship किया गया है, ClickHouse HTTP को 8123 पर और Postgres को 5434 पर डालता है जहाँ internet उन तक पहुँच सकता है। उस file में मौजूद credentials development डिफ़ॉल्ट हैं: ClickHouse user default बिना password के, और Postgres में postgres user और password दोनों के रूप में है।
उन्हें loopback पर bind करें। Compose file में प्रत्येक published port अपना host side एक environment variable से लेता है, इसलिए repository root में एक .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:4318Trust करने से पहले परिणाम को verify करें, फिर containers को recreate करें:
docker compose config
docker compose up -d
ss -lntp | grep -E '5434|8123|9000|4317|4318'docker compose config resolved file को print करता है, ताकि आप अनुमान लगाने के बजाय 127.0.0.1:5434:5432 को पढ़ सकें। ss को तब 127.0.0.1:5434 दिखाना चाहिए और कभी भी 0.0.0.0:5434 नहीं। Compose override file में बस ports को फिर से declare करने से दोनों bindings सुरक्षित रहती हैं जब host IP अलग हो; Compose 2.24.4 और उसके बाद के versions list को replace करने के लिए ports: !override का समर्थन करते हैं।
Intake को भी वैसी ही सावधानी की आवश्यकता है। आपकी ingest key एक header में जाती है, इसलिए इसके आगे TLS (transport layer security) की आवश्यकता है: proxy के आगे nginx या Caddy में TLS terminate करें, या ingest को private network या WireGuard tunnel के अंदर रखें। 5173 पर चल रहा web app एक Vite development server है और इसे internet के सामने बिल्कुल भी नहीं होना चाहिए।
फिर स्वयं agent की बात आती है। Superlog का मुख्य उद्देश्य यह है कि agent जाँच करता है और समाधान प्रस्तावित करता है, और यहाँ महत्वपूर्ण शब्द 'प्रस्तावित' (proposes) है। इसे production पर read-only रखें जब तक कि आपने इसे कुछ वास्तविक incidents पर काम करते हुए न देख लिया हो। एक read-only GitHub App fix branch push नहीं कर सकता या pull requests open नहीं कर सकता: setup guide के लिए उस workflow हेतु Contents और Pull requests write permissions की आवश्यकता होती है, साथ ही comments के लिए Issues write permission भी चाहिए। एक ऐसा agent जो telemetry पढ़ता है और patch लिखता है, उपयोगी है। एक ऐसा agent जो आपकी services को restart कर सकता है, वह अलग स्तर का जोखिम है, और यह एक ऐसा निर्णय होना चाहिए जो आप जानबूझकर लें, न कि कोई ऐसा डिफ़ॉल्ट जिसे आप विरासत में प्राप्त करें। जब आप model-backed runner configure करते हैं तो लागत (cost) भी समान ध्यान देने योग्य है: इसे किसी शोर मचाने वाले production system पर लक्षित करने से पहले VPS पर agent खर्च के लिए बजट तय करें, और agent ने वास्तव में क्या किया इसका रिकॉर्ड रखें ताकि किसी आश्चर्यजनक pull request के पीछे एक audit trail मौजूद हो।
ऐसी विफलताएँ जिनका आप सामना करेंगे, और उन्हें दर्शाने वाली स्ट्रिंग्स
ERR_PNPM_UNSUPPORTED_ENGINEके दौरानpnpm installका अर्थ है कि इंजन की आवश्यकता असंगत है। pnpm 9.12.0 Node और pnpm दोनों की आवश्यकताओं की जाँच करता है; त्रुटि में वांछित (wanted) और वर्तमान (current) वर्ज़न पढ़ें, फिरnode -vऔरpnpm -vकी जाँच करें।- माइग्रेशन के दौरान
ECONNREFUSED 127.0.0.1:5434का अर्थ है कि compose stack चालू नहीं है, याDATABASE_URLगलत पोर्ट का नाम दे रहा है। docker compose logs clickhouseके साथ ClickHouse के रीस्टार्ट की जाँच करें, फिर कंटेनर मेंOOMKilledकेtrueहोने की जाँच करें।- एक एक्सपोर्टर जो सफलता की रिपोर्ट करता है जबकि वेब ऐप खाली रहता है, उसका आमतौर पर मतलब है कि डेटा सीधे 4318 पर कलेक्टर के पास चला गया है, जो प्रॉक्सी द्वारा किए जाने वाले प्रोजेक्ट स्टैम्पिंग को छोड़ देता है।
- 4101 पर Connection refused का आमतौर पर मतलब है कि प्रॉक्सी 4000 पर लिसन कर रहा है, जो वह पोर्ट है जिस पर इसका कोड वापस चला जाता है और जिसे इसका
.env.exampleसेट करता है। यूनिट फ़ाइल या ऐप के.envमेंPORTको स्पष्ट रूप से सेट करें। 0.0.0.0:8123दिखाने वालाdocker compose psका अर्थ है कि आपके लूपबैक बाइंडिंग प्रभावी नहीं हैं।docker compose configचलाएँ और रिज़ॉल्व किए गए पोर्ट्स को पढ़ें।
Flawless, HyperProbe, और Superlog की स्थिति
यह श्रेणी अभी नई है और इसमें मौजूद टूल्स इस बात पर विभाजित हैं कि एजेंट को किन चीजों तक पहुँचने की अनुमति है। Flawless रिपॉजिटरी अब Kubernetes और क्लाउड इंफ्रास्ट्रक्चर के लिए CISRE नामक एक AI SRE (साइट रिलायबिलिटी इंजीनियरिंग) प्लेटफॉर्म प्रस्तुत करती है, जो PolyForm Noncommercial लाइसेंस के अंतर्गत आता है। HyperProbe वेरिएबल स्टेट को कैप्चर करने के लिए चल रही प्रोसेस के भीतर प्रोब लगाता है और उस स्टेट को MCP (मॉडल कॉन्टेक्स्ट प्रोटोकॉल) के माध्यम से एक असिस्टेंट के सामने लाता है; यह Docker Compose के साथ सेल्फ-होस्टिंग और लाइसेंस की (license key) का दस्तावेजीकरण भी करता है।
Superlog इन दोनों के बीच स्थित है। यह OTLP इनटेक से लेकर ClickHouse स्टोरेज तक, पूरी पाइपलाइन को नियंत्रित करता है, और यह एजेंट को फिक्स स्टेप के बजाय ट्राइएज (triage) स्टेप पर रखता है। यही डिज़ाइन कारण है कि इसे सेल्फ-होस्ट करना एक इंफ्रास्ट्रक्चर संबंधी निर्णय है, न कि कोई ऐसा कंटेनर जिसे आप भूल जाएं। एक बार जब आप Superlog चलाते हैं, तो आप एक कॉलम स्टोर चला रहे होते हैं, और इसे आपके द्वारा स्वामित्व वाले किसी भी अन्य डेटाबेस की तरह ही देखभाल की आवश्यकता होती है।
FAQ
एक self-hosted Superlog को कितनी RAM की आवश्यकता होती है?
कम ingest volume वाले एक single node के लिए 8 GB RAM, 4 vCPU और 40 GB disk की योजना बनाएँ। इस stack में Postgres, ClickHouse, एक OpenTelemetry collector और चार Node processes शामिल हैं, और ClickHouse को अतिरिक्त headroom की आवश्यकता होती है। किसी भी प्रकाशित आंकड़े पर भरोसा करने के बजाय, जिसमें यह भी शामिल है, अपने स्वयं के आंकड़े docker stats --no-stream और free -m के साथ मापें।
मुझे अपना OTLP exporter किस port पर point करना चाहिए?
Superlog intake proxy पर, जिसे README में http://localhost:4101 पर रखा गया है। यह /v1/traces, /v1/logs और /v1/metrics को serve करता है, और यह आपके project की ingest key के साथ authenticate करता है जिसे x-api-key header या authorization: bearer header से लिया जाता है। Port 4318 नीचे स्थित OpenTelemetry collector है, और सीधे वहां export करने से proxy skip हो जाता है, जो वह component है जो आपके data पर project id stamp करता है। जब PORT unset होता है, तो proxy port 4000 पर fallback करता है, और इसका .env.example भी 4000 ही set करता है, इसलिए 4101 मानने से पहले ss -lntp चलाएं और पुष्टि करें कि यह किस पर bound है।
क्या Superlog, Uptime Kuma या Zabbix की जगह ले सकता है?
नहीं। Uptime Kuma यह बताता है कि क्या कोई endpoint आपके network के बाहर से respond कर रहा है, और Zabbix आपके द्वारा set किए गए thresholds के आधार पर host और service metrics की निगरानी करता है। Superlog आपके applications द्वारा emit किए गए traces, logs और metrics को consume करता है और बार-बार होने वाली विफलताओं को incidents में group करता है। इसके साथ एक external uptime probe रखें, क्योंकि कहीं और चल रहा probe तब भी report करता है जब वह box ही बंद हो जाए जिस पर आपका telemetry pipeline चल रहा है।
क्या Superlog agent मेरे production systems को बदल सकता है?
केवल उन permissions के माध्यम से जो आप इसे देते हैं। Default community runner एक local incident summary record करता है; अन्य investigation runtimes आपके द्वारा configure किए गए runner पर निर्भर करते हैं। Production credentials को केवल reading तक सीमित रखें; pull requests खोलने के लिए branches और pull requests के लिए अलग GitHub write permissions की आवश्यकता होती है। Production पर write access को एक अलग और सोच-समझकर लिया गया निर्णय मानें, क्योंकि जो agent services को restart कर सकता है, वह telemetry पढ़ने और review के लिए patch लिखने वाले agent की तुलना में बहुत बड़ी जिम्मेदारी है।
क्या मुझे commit pin करना चाहिए या main track करना चाहिए?
Commit pin करें। 13 October 2026 तक repository में कोई release tags नहीं थे। जिस SHA को आपने test किया है उसे record करें, उसे deploy करें, और आगे बढ़ने से पहले diff को पढ़ें। git log --oneline <old-sha>..main वह review है, और किसी भी bump के बाद नई आवश्यक variables के लिए सबसे पहले per-app .env.example files को देखें।