Superlog-ஐ self-host செய்வது: உண்மையான footprint
Superlog-ஐ உங்கள் VPS-ல் இயக்க Postgres, ClickHouse, OpenTelemetry collector மற்றும் 4 Node services தேவை. நிறுவலுக்கு ஒரு பிற்பகல் ஒதுக்கி, உண்மையான footprint-ஐ அறியுங்கள்.
Superlog self-hosting உண்மையில் நிறுவுவது என்ன
Superlog-ஐ self-host செய்ய, repository-ஐ clone செய்து, Docker Compose மூலம் Postgres, ClickHouse மற்றும் OpenTelemetry collector-ஐ இயக்க வேண்டும். அதன் பிறகு ஒரு database migration-ஐ இயக்கி, source-இலிருந்து நான்கு Node services-ஐ தொடங்க வேண்டும். உங்கள் applications, OTLP (OpenTelemetry protocol) traces, logs மற்றும் metrics-ஐ intake port-க்கு அனுப்பும். Superlog அவற்றுக்கு fingerprints உருவாக்கி, மீண்டும் மீண்டும் வரும் பதிவுகளை ஒரே incident-ஆகக் குழுவாக்கும். பின்னர் இயல்புநிலை community agent runner, அந்த incident-ன் local summary-ஐ பதிவு செய்யும். நிறுவலுக்கு ஒரு பிற்பகல் நேரம் தேவைப்படும். நீங்கள் தொடங்குவதற்கு முன் படிக்க வேண்டிய முக்கிய பகுதிகள், இதன் footprint மற்றும் இதன் உண்மையான வரம்புகளாகும்.
Superlog, Apache 2.0 license-இன் கீழ் வெளியிடப்பட்டுள்ளது. இது github.com/superloglabs/superlog-ல் உள்ளது. 13 October 2026 நிலவரப்படி, இதற்கு சுமார் 1.5k stars உள்ளன; main-ல் சுமார் 490 commits உள்ளன; release tags எதுவும் இல்லை. நீங்கள் clone செய்த காலையில் main-ல் இருந்ததைப் பயன்படுத்துவதற்குப் பதிலாக, ஒரு commit-ஐ நீங்களே pin செய்யுங்கள்.
Superlog அளிக்கும் பதில்கள்: Uptime Kuma மற்றும் Langfuse அளிக்காதவை
வெளிப்புறமாகப் பார்க்கும்போது self-hosted monitoring tools அனைத்தும் ஒரே மாதிரியாகத் தோன்றலாம். ஆனால் அவை ஒரே மாதிரியானவை அல்ல. தவறான tool-ஐ இயக்கினால் எந்தப் பயனும் இல்லாமல் ஒரு server-ன் வளங்கள் செலவாகும்.
- Uptime Kuma உங்கள் endpoints-ஐ வெளிப்புறத்திலிருந்து probe செய்கிறது; அது பதிலளிக்கும் ஒரே கேள்வி: இது இயங்குகிறதா.
- Zabbix Ubuntu 24.04-ல் hosts மற்றும் services-ஐ கண்காணிக்கிறது; நீங்கள் அமைக்கும் thresholds-க்கு எதிராக CPU, memory, disk மற்றும் service state ஆகியவற்றைச் சரிபார்க்கிறது.
- Langfuse LLM calls-ஐ trace செய்கிறது; ஒவ்வொரு call-ன் prompt, model, tokens, latency மற்றும் cost ஆகியவற்றைப் பதிவு செய்கிறது.
- Superlog, உங்கள் வழக்கமான services ஏற்கனவே வெளியிடும் telemetry-ஐப் பெற்று, மீண்டும் மீண்டும் ஏற்படும் failures-ஐ incidents-ஆக மாற்றுகிறது.
Superlog கவனிக்கும் கேள்வி வேறுபட்டது: ஏதோ ஒன்று செயலிழந்தது, எது செயலிழந்தது, ஏன் செயலிழந்தது. இது LLM calls குறித்து எந்தக் கருத்தையும் கொண்டிருக்காது. மேலும், இது உங்களை வெளிப்புறத்திலிருந்து probe செய்யாது. இது உங்கள் வழக்கமான application code-இலிருந்து OTLP-ஐ ingest செய்து, triage படியில் ஒரு agent-ஐ அமைக்கிறது. On-call-ல் இருக்கும் ஒருவர் முதலில் செய்யும் பணியும் இதுதான்.
VPS budget-க்கு முக்கியமான வேறுபாடு storage ஆகும். Superlog ஒரு column store-ஐக் கொண்டுள்ளது. ஏனெனில் telemetry ஒருமுறை எழுதப்பட்ட பிறகு, millions of rows-ஐ time range அடிப்படையில் query செய்யப்படுகிறது. இதற்காகவே ClickHouse பயன்படுத்தப்படுகிறது; Postgres இதற்காக அல்ல. இருந்தாலும் Postgres stack-ல் உள்ளது. இது projects, users, incidents மற்றும் ingest keys போன்ற சிறிய relational data-வை வைத்திருக்கிறது.
docker compose up -d உண்மையில் எதைத் தொடங்குகிறது?
மூன்று containers தொடங்கப்படுகின்றன, அவற்றில் எதுவுமே Superlog அல்ல. ஒரே கட்டளையில் நிறுவல் முடிந்துவிடும் என்று எதிர்பார்ப்பவர்களுக்கு இது ஆச்சரியமாக இருக்கலாம்.
postgres:16, host port 5434-ல் வெளியிடப்பட்டதுclickhouse/clickhouse-server:26.1, HTTP-க்காக 8123 மற்றும் native protocol-க்காக 9000-ல் இயங்குகிறதுotel/opentelemetry-collector-contrib:0.150.1, gRPC-க்காக 4317 மற்றும் OTLP over HTTP-க்காக 4318-ல் இயங்குகிறது
Superlog applications host-ல், source-லிருந்து, pnpm dev மூலம் தொடங்கப்படுகின்றன. 13 October 2026 நிலவரப்படி, repository-ல் production compose file எதுவும் இல்லை. எனவே, நீண்ட காலம் இயங்கும் நிறுவலுக்கு நீங்கள் சொந்தமாக systemd units-ஐ உருவாக்க வேண்டும் அல்லது tree-ல் உள்ள per-app Dockerfiles-ஐப் பயன்படுத்த வேண்டும். api, worker மற்றும் proxy ஆகிய apps ஒவ்வொன்றிலும் unit-ஐ wrap செய்ய ஒரு start script உள்ளது. web app-க்கு அத்தகைய script எதுவும் இல்லை: இது ஒரு Vite app, எனவே நீங்கள் அதன் build script மூலம் build செய்து, output-ஐ nginx அல்லது Caddy மூலம் static files-ஆக வழங்க வேண்டும், அல்லது அதன் preview script-ஐ இயக்க வேண்டும், இது vite preview ஆகும்.
ஒரு span செல்லும் பாதையை நினைவில் கொள்ளுங்கள், ஏனெனில் கீழே குறிப்பிடப்பட்டுள்ள ஒவ்வொரு தோல்வியும் அந்தப் பாதையின் ஒரு கட்டத்தில் ஏற்படும் முறிவே ஆகும். உங்கள் app, OTLP-ஐ Superlog intake proxy-க்கு அனுப்புகிறது. அந்த proxy உங்கள் ingest key-ஐக் கொண்டு கோரிக்கையை அங்கீகரித்து, அதில் project id-ஐ முத்திரையிட்டு, collector-க்கு அனுப்புகிறது. collector, client அமைக்க முயன்ற எந்தவொரு superlog.* attributes-ஐயும் நீக்கிவிட்டு, proxy வழங்கிய header-லிருந்து superlog.project_id-ஐச் சேர்த்து, அவற்றை batch செய்து, ClickHouse-ல் எழுதுகிறது. பின்னர் web app மற்றும் API ஆகியவை telemetry தரவுகளை ClickHouse-லிருந்தும், மற்ற தரவுகளை Postgres-லிருந்தும் படிக்கின்றன.
அந்த attribute நீக்கம் என்பது வெறும் அலங்காரம் அல்ல, அது ஒரு உண்மையான multi-tenancy கட்டுப்பாடாகும். அது இல்லையென்றால், ஒரு செல்லுபடியாகும் ingest key-ஐ வைத்திருக்கும் எவரும் தாங்களாகவே superlog.project_id-ஐ அமைத்து, மற்றொரு project-ன் தரவுகளுக்குள் எழுத முடியும்.
VPS எவ்வளவு பெரியதாக இருக்க வேண்டும்?
குறைந்த ingest volume-ல் single node install-க்கு 4 vCPU, 8 GB RAM, 40 GB SSD திட்டமிடுங்கள். இது அளவீட்டால் நிர்ணயிக்கப்பட்ட அளவு அல்ல; திட்டமிடுவதற்கான குறைந்தபட்ச அளவு மட்டுமே. எனவே இதை தொடக்க அளவாகக் கொண்டு, உங்கள் சொந்த traffic அடிப்படையில் சரிபார்க்கவும்.
RAM நான்கு இடங்களில் பயன்படுத்தப்படுகிறது. ClickHouse அதிக RAM கொண்ட machines-க்காக உருவாக்கப்பட்டது; அதன் defaults-ம் அதையே கருதுகின்றன. இங்கு Postgres 16 அதிக வளங்களைப் பயன்படுத்தாது, ஏனெனில் அது telemetry-க்கு பதிலாக metadata-ஐ சேமிக்கிறது. Collector-மும் அதிக வளங்களைப் பயன்படுத்தாது. நான்கு Node processes-ல் ஒரு Vite development server மற்றும் மூன்று tsx watch processes உள்ளன; உங்கள் சொந்த machine-ல் அவற்றின் memory பயன்பாட்டை அளவிடுங்கள்.
Disk அமைதியான பிரச்சினையாகும். இந்த monorepo-வில் pnpm install, நீங்கள் ஒரு span-ஐ கூட ingest செய்வதற்கு முன் AWS SDK, ClickHouse client, OpenTelemetry SDK மற்றும் React toolchain-ஐ பதிவிறக்குகிறது. அதன் பிறகு 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"சிக்கலை ஏற்படுத்தும் load என்பது burst ஆகும்: ஒரு தவறான deploy காரணமாக ஒரு நிமிடத்தில் ஆயிரக்கணக்கான ஒரே மாதிரியான errors உருவாகலாம். Fingerprinting அவற்றை reader-க்காக ஒரே incident-ஆகச் சுருக்குகிறது. ஆனால் ClickHouse பின்னணியில் ஒவ்வொரு row-ஐயும் எழுதிக்கொண்டே இருக்கும்.
Retention காலத்தை நீங்கள் நிர்ணயிக்க வேண்டும். Collector-ன் ClickHouse exporter tables, otel_traces, otel_logs மற்றும் ஒவ்வொரு metric type-க்கும் ஒரு table-ஐ உருவாக்குகிறது. infra/collector/config.yaml-ல் உள்ள config ஒன்றை அமைத்திருந்தால் மட்டுமே அது time to live-ஐ பயன்படுத்தும். எதுவும் தானாக expire ஆகாது. எனவே அதற்கான திட்டமிடல் இல்லையெனில், busy month முடிவில் disk முழுமையாக நிரம்பிவிடும்.
pinned commit-இலிருந்து install செய்யவும்
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 நிலவரப்படி எதையும் print செய்யாமல் இருப்பதே எதிர்பார்க்கப்படும் முடிவு. நீங்கள் சோதித்த 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 இருந்தாலும் installation தானாக நிறுத்தப்படாது. Engine enforcement configuration-ஐப் பொறுத்தது. மேலும், engineStrict disabled நிலையில் இருந்தால் pnpm 9.12.0 warning path-ஐ பயன்படுத்துகிறது. Ubuntu 24.04 archive-ல் உள்ள nodejs package, version 20-க்கும் பழையது. ஆகவே Node 20 அல்லது அதற்குப் புதிய version-ஐ NodeSource அல்லது nvm மூலம் install செய்யவும். Repository ஒரு .nvmrc-ஐ வழங்குகிறது. எனவே nvm இருந்தால், nvm use விரும்பிய version-ஐத் தேர்ந்தெடுக்கும்.
pnpm install
docker compose up -d
docker compose psup -d ready என்று காட்டுகிறது என நம்புவதற்குப் பதிலாக, health checks முடியும் வரை காத்திருக்கவும். compose file-ல் Postgres மற்றும் ClickHouse இரண்டிற்கும் 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 கிடைத்தால், container இன்னும் தொடங்கிக்கொண்டிருக்கலாம் அல்லது நிறுத்தப்பட்டிருக்கலாம். எது நடந்தது என்பதை docker compose logs clickhouse காட்டும். Memory காரணமாக kernel அதை நிறுத்தியிருந்தால், docker inspect $(docker compose ps -q clickhouse) | grep -i oomkilled, true-ஐ report செய்யும். இது configuration பிரச்சினையைவிட server போதுமான அளவு பெரியதாக இல்லை என்பதைக் குறிக்கும்.
அடுத்து migration மற்றும் applications:
pnpm --filter @superlog/db db:migrate
pnpm devPort-ஐ கவனிக்கவும்: 5432 அல்ல, 5434. Host-ல் ஏற்கனவே install செய்யப்பட்டுள்ள Postgres-உடன் மோதாமல் இருக்க, compose file Postgres-ஐ 5434-ல் publish செய்கிறது. App-ன் .env.example files-லும் இதே port அமைக்கப்பட்டுள்ளது, DATABASE_URL=postgres://postgres:postgres@localhost:5434/superlog உடன். ஏற்கனவே Postgres இயங்கும் server-ல் migration-ஐ 5432-க்கு point செய்தால், connection refused கிடைக்கலாம். அதைவிட மோசமாக, தவறான database-ல் migration செயல்படுத்தப்படலாம்.
pnpm dev, turbo run dev-ஐ இயக்குகிறது. இது Turborepo மூலம் ஒவ்வொரு app-ன் dev script-ஐ தொடங்கும். இதில் api, web, worker மற்றும் proxy அடங்கும். அவற்றின் output ஒரே terminal-ல் கலந்தபடி தோன்றும். Repository-ன் Procfile அதே நான்கு processes-ஐ பட்டியலிடுகிறது. ஒவ்வொரு process-ன் output-ஐ tmp/logs/-க்குள் tee செய்கிறது. pnpm dev-க்கு பதிலாக overmind அல்லது foreman போன்ற Procfile runner மூலம் இதைத் தொடங்கவும். அப்போது tail -f tmp/logs/proxy.log-ல் ingest-ஐ கண்காணிக்கலாம். README, web app-ஐ http://localhost:5173-ல், API-ஐ http://localhost:4100-ல், OTLP intake-ஐ http://localhost:4101-ல் இயக்குகிறது என்று குறிப்பிடுகிறது.
எந்த process உண்மையில் port-ஐ bind செய்துள்ளது என்பதை உறுதிப்படுத்திய பிறகே, அதை நோக்கி requests அனுப்பவும்:
ss -lntp | grep -E '4000|4100|4101|5173'
curl -sS http://127.0.0.1:4101/healthஇது பின்னர் முக்கியமாகும். Proxy, தனது port-ஐ PORT environment variable-லிருந்து வாசிக்கும். PORT unset நிலையில் இருந்தால், அது 4000-ஐப் பயன்படுத்தும். அது load செய்யும் apps/proxy/.env.example, PORT=4000-ஐயும் அமைக்கிறது. இருப்பினும் README intake-ஐ 4101-ல் உள்ளது எனக் குறிப்பிடுகிறது. இவை இரண்டும் 13 October 2026 அன்று சரிபார்க்கப்பட்டன. ss காட்டும் port-ஐப் பயன்படுத்தவும். கீழே உள்ள examples 4101-ஐப் பயன்படுத்துகின்றன. உண்மையில் bind ஆனது 4000 என்றால், 4000-ஐ மாற்றிப் பயன்படுத்தவும். நீங்கள் எழுதும் systemd unit-ல் PORT-ஐ சேர்க்காவிட்டால், அது எந்த value-ஐயும் அமைக்காது. எனவே 4000-ல் listening செய்யும் proxy-க்கு 4101-ஐ நோக்கி exporter அனுப்பினால், connection refused கிடைக்கும். வேறு காரணம் குறித்த எந்தத் தகவலும் கிடைக்காது.
ஒரு trace அனுப்பி, ஒரு error உருவாக்கி, ஒரு incident-ஐப் பாருங்கள்
Web app-ல் ஒரு project உருவாக்கி, அதன் ingest key-ஐ copy செய்யவும். Intake ஒவ்வொரு request-ஐயும் அந்த key-க்கு எதிராக authenticate செய்கிறது. எனவே key இல்லாமல் அனுப்பப்படும் telemetry ClickHouse-ஐ ஒருபோதும் அடையாது.
பின்வரும் standard environment variables-ஐப் பயன்படுத்தி எந்த OpenTelemetry SDK-யையும் intake-க்கு point செய்யவும்:
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, key-ஐ x-api-key header-ல் இருந்து படிக்கிறது. உங்கள் exporter-ஐ அந்த முறையில் configure செய்வது எளிதாக இருந்தால், authorization: bearer YOUR_INGEST_KEY-ஐயும் ஏற்கிறது. இது மூன்று standard OTLP paths-ஆகிய /v1/traces, /v1/logs மற்றும் /v1/metrics, மேலும் /health ஆகியவற்றை serve செய்கிறது.
ஒரு பொதுவான தவறை கவனத்தில் கொள்ள வேண்டும். OTEL_EXPORTER_OTLP_ENDPOINT ஒரு base URL. SDK இதனுடன் signal path-ஐச் சேர்க்கிறது. OTEL_EXPORTER_OTLP_TRACES_ENDPOINT போன்ற signal-specific variables எழுதப்பட்டுள்ளபடியே பயன்படுத்தப்படுகின்றன; அவற்றுடன் எந்த path-உம் சேர்க்கப்படாது. Signal-specific variable-ஐ http://127.0.0.1:4101 என அமைத்தால், ஒவ்வொரு export-உம் /-க்கு POST செய்யப்படும். அது route அல்ல. எனவே எந்த data-வும் வந்து சேராது. SDK export failure-ஐ log செய்யும், ஆனால் உங்கள் app இயல்பாக செயல்படுவது போல் தோன்றும்.
Node service-க்கு pipeline-ஐச் சரிபார்க்க zero-code path போதுமானது:
npm install @opentelemetry/api @opentelemetry/auto-instrumentations-node
node --require @opentelemetry/auto-instrumentations-node/register server.jsஇப்போது திட்டமிட்டு ஒரு failure ஏற்படுத்தவும். Error throw செய்யும் எந்த route-உம் போதுமானது:
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3000/boomHops-ஐ வரிசையாகச் சரிபார்க்கவும். முதலில் காணப்படும் gap எந்த hop தோல்வியடைந்தது என்பதைத் தெரிவிக்கும்:
tail -n 50 tmp/logs/proxy.log
docker compose exec clickhouse clickhouse-client --database superlog --query 'SELECT count() FROM otel_traces'Web app காலியாக இருக்கும்போது otel_traces-ன் count அதிகரித்தால், அது project mismatch ஆகும். எனவே ingest key எந்த project-ஐச் சேர்ந்தது என்பதைச் சரிபார்க்கவும். Proxy log-ல் activity இருந்தும் count மாறாமல் இருந்தால், collector அல்லது ClickHouse write-ல் பிரச்சினை இருக்கலாம். எனவே docker compose logs collector-ஐப் படிக்கவும். Proxy log-ல் எந்த activity-யும் இல்லையெனில், exporter intake-ஐ அடையவில்லை. Port தவறாக இருக்கலாம், path தவறாக இருக்கலாம், அல்லது key நிராகரிக்கப்பட்டிருக்கலாம்.
Web app-ல் இந்த repeated failures ஒவ்வொரு request-க்கும் ஒரு row ஆக இல்லாமல், ஒரு incident ஆக வந்து சேரும். Superlog incoming signals-ஐ fingerprint செய்து, பொருந்துபவற்றை group செய்கிறது. இதனால் 4,000 ஒரே மாதிரியான errors கொண்ட inbox-க்கு பதிலாக, ஒரு item மட்டுமே உள்ள page கிடைக்கும். Default community agent runner அந்த group-க்கான local incident summary-ஐப் பதிவு செய்கிறது.
Model-backed investigation-க்கு model provider மற்றும் compatible agent runner configure செய்யப்பட்டிருக்க வேண்டும். Default community runner local summary-ஐப் பதிவு செய்கிறது. ஒவ்வொரு app directory-யிலும் உள்ள, நீங்கள் pin செய்த commit-ன் .env.example file-லிருந்து இந்த variable names-ஐ எடுத்துக்கொள்ளவும். வெளிப்புற write-up-களில் இருந்து அவற்றை எடுக்க வேண்டாம். ஏனெனில் அவை main உடன் மாறுகின்றன. GitHub மற்றும் Sentry integrations-க்கும் இதே விதி பொருந்தும். அவற்றின் setup documents முறையே docs/github-app-setup.md மற்றும் docs/sentry-app-setup.md-ல் உள்ளன. Webhook payloads docs/webhooks.md-ல் documented செய்யப்பட்டுள்ளன.
Intake-ஐ private-ஆக வைத்திருந்து, agent-க்கு read-only அணுகல் வழங்கவும்
Docker, container ports-ஐ default-ஆக 0.0.0.0-ல் publish செய்கிறது; இந்த published ports, ufw-ஐ bypass செய்கின்றன. Docker, container traffic-ஐ nat table-ல் route செய்கிறது. ஆகவே, published port-க்கு அனுப்பப்பட்ட packet, ufw rules இருக்கும் INPUT மற்றும் OUTPUT chains-ஐ அடையும் முன்பே divert செய்யப்படுகிறது; ufw-க்கு அதை கட்டுப்படுத்த வாய்ப்பு கிடையாது. Public IP கொண்ட VPS-ல், வழங்கப்பட்ட compose file, ClickHouse HTTP-ஐ 8123-லும் Postgres-ஐ 5434-லும் expose செய்கிறது. இதனால் இணையத்திலிருந்து அவற்றை அணுக முடியும். அந்த file-ல் உள்ள credentials, development defaults ஆகும்: காலியான password கொண்ட ClickHouse user default, மேலும் postgres user மற்றும் password ஆகப் பயன்படுத்தப்படும் Postgres.
அவற்றை loopback-க்கு bind செய்யவும். Compose file-ல் உள்ள ஒவ்வொரு published port-உம் host side-ஐ environment variable-இலிருந்து பெறுகிறது. ஆகவே repository root-ல் ஒரு .env file இருந்தால் போதும்:
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அதை நம்புவதற்கு முன் முடிவைச் சரிபார்த்து, பின்னர் containers-ஐ மீண்டும் உருவாக்கவும்:
docker compose config
docker compose up -d
ss -lntp | grep -E '5434|8123|9000|4317|4318'docker compose config resolved file-ஐ அச்சிடுகிறது. அதனால் ஊகிப்பதற்குப் பதிலாக 127.0.0.1:5434:5432-ஐப் பார்க்கலாம். அதன் பிறகு ss, 127.0.0.1:5434-ஐ காட்ட வேண்டும்; 0.0.0.0:5434-ஐ ஒருபோதும் காட்டக்கூடாது. Host IP மாறுபடும் போது, Compose override file-ல் ports-ஐ மீண்டும் வரையறுப்பது இரண்டு bindings-ஐயும் வைத்திருக்கும். Compose 2.24.4 மற்றும் அதற்குப் பிந்தைய versions, list-ஐ மாற்ற ports: !override-ஐ ஆதரிக்கின்றன.
Intake-க்கும் இதே பாதுகாப்பு தேவை. உங்கள் ingest key, header-ல் அனுப்பப்படுகிறது. ஆகவே அதற்கு முன்பாக TLS (transport layer security) தேவை. Proxy-க்கு முன் nginx அல்லது Caddy-ல் TLS termination செய்யவும். மாற்றாக, ingest-ஐ private network அல்லது WireGuard tunnel-க்குள் வைத்திருக்கவும். 5173-ல் இயங்கும் web app, Vite development server ஆகும். அது இணையத்தை நேரடியாக எதிர்கொள்ளக் கூடாது.
அடுத்து agent-ஐப் பாருங்கள். Superlog-ன் நோக்கம் agent, சம்பவத்தை ஆய்வு செய்து fix-ஐ முன்மொழிவதாகும். இதில் முக்கியமான சொல் “முன்மொழிகிறது” என்பதே. சில உண்மையான incidents-ல் அது எவ்வாறு செயல்படுகிறது என்பதைப் பார்ப்பதுவரை, production-க்கு எதிராக அதை read-only நிலையில் வைத்திருக்கவும். Read-only GitHub App, fix branch-ஐ push செய்யவோ pull requests-ஐ திறக்கவோ முடியாது. அந்த workflow-க்கு setup guide, Contents மற்றும் Pull requests-க்கு write permissions-ஐயும், comments-க்கு Issues write permission-ஐயும் கோருகிறது. Telemetry-ஐப் படித்து patch-ஐ எழுதும் agent பயனுள்ளதாக இருக்கும். உங்கள் services-ஐ restart செய்யக்கூடிய agent வேறுபட்ட ஆபத்து நிலையாகும். அதை default-ஆக ஏற்றுக்கொள்வதற்குப் பதிலாக, திட்டமிட்டு நீங்களே அந்த முடிவை எடுக்க வேண்டும். Model-backed runner-ஐ configure செய்யும்போது cost-க்கும் இதே கவனம் தேவை: noisy production system-க்கு அதை பயன்படுத்துவதற்கு முன் VPS-ல் agent செலவுக்கான budget-ஐத் திட்டமிடவும். மேலும் agent உண்மையில் செய்த செயல்களின் பதிவை வைத்திருக்கவும், இதனால் எதிர்பாராத pull request-க்கும் audit trail இருக்கும்.
நீங்கள் எதிர்கொள்ளக்கூடிய தோல்விகளும், அவற்றைக் குறிக்கும் strings-உம்
ERR_PNPM_UNSUPPORTED_ENGINE-இன் போதுpnpm installஏற்பட்டால், engine requirement பொருந்தவில்லை என்று பொருள். pnpm 9.12.0, Node மற்றும் pnpm requirements இரண்டையும் சரிபார்க்கும்; error-ல் காட்டப்படும் தேவையான மற்றும் தற்போதைய versions-ஐப் பார்த்து, பின்னர்node -vமற்றும்pnpm -v-ஐச் சரிபார்க்கவும்.- migration-இன் போது
ECONNREFUSED 127.0.0.1:5434ஏற்பட்டால், compose stack இயங்கவில்லை அல்லதுDATABASE_URLதவறான port-ஐக் குறிப்பிடுகிறது. docker compose logs clickhouseமூலம் ClickHouse மறுதொடக்கம் ஆகிறதா என்பதைச் சரிபார்க்கவும். பின்னர் container-ல்OOMKilled,trueநிலையில் உள்ளதா என்பதைச் சரிபார்க்கவும்.- web app காலியாக இருக்கும்போது exporter வெற்றியைப் புகாரளித்தால், data நேரடியாக 4318-ல் உள்ள collector-க்கு சென்றிருக்கலாம். இதனால் proxy செய்யும் project stamping தவிர்க்கப்படுகிறது.
- 4101-ல் connection refused ஏற்பட்டால், proxy 4000-ல் listening செய்கிறது என்று பொதுவாகப் பொருள். இது அதன் code fallback செய்யும் port; அதன்
.env.exampleஇதையே அமைக்கிறது. unit file-ல் அல்லது app-ன்.env-ல்PORT-ஐ வெளிப்படையாக அமைக்கவும். docker compose ps,0.0.0.0:8123-ஐக் காட்டினால், உங்கள் loopback bindings செயல்பாட்டில் இல்லை என்று பொருள்.docker compose config-ஐ இயக்கி, தீர்மானிக்கப்பட்ட ports-ஐப் பார்க்கவும்.
Flawless, HyperProbe, மற்றும் Superlog இருக்கும் இடம்
இந்த வகை இன்னும் ஆரம்ப நிலையில் உள்ளது. Agent அணுகக்கூடிய பகுதிகளைப் பொறுத்து tools வேறுபடுகின்றன. Flawless repository, PolyForm Noncommercial license-ன் கீழ், Kubernetes மற்றும் cloud infrastructure-க்கான AI SRE (site reliability engineering) platform ஆன CISRE-ஐ தற்போது வழங்குகிறது. HyperProbe, இயங்கிக்கொண்டிருக்கும் process-ன் உள்ளே probes-ஐ வைத்து variable state-ஐ capture செய்கிறது. பின்னர் MCP (model context protocol) மூலம் அந்த state-ஐ assistant-க்கு வழங்குகிறது. Docker Compose மற்றும் license key பயன்படுத்தி self-hosting செய்வது குறித்தும் அது documentation வழங்குகிறது.
Superlog, இந்த இரண்டிற்கும் இடைப்பட்ட நிலையில் உள்ளது. OTLP intake முதல் ClickHouse storage வரை முழு pipeline-ஐ அது நிர்வகிக்கிறது. மேலும், agent-ஐ fix step-ல் அல்லாமல் triage step-ல் பயன்படுத்துகிறது. இதனால் self-hosting என்பது ஒரு infrastructure முடிவு என்பதை அதன் design தெளிவாகக் காட்டுகிறது. அதை மறந்துவிடக்கூடிய ஒரு container போல இதை கருத முடியாது. Superlog-ஐ இயக்கும்போது, ஒரு column store-ஐயும் இயக்குகிறீர்கள். நீங்கள் நிர்வகிக்கும் வேறு எந்த database-க்கும் வழங்கும் அதே பராமரிப்பு இதற்கும் தேவை.
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-க்கு அமைக்க வேண்டும்?
README-ல் http://localhost:4101 port-ல் அமைக்கப்பட்டுள்ள Superlog intake proxy-க்கு அமைக்க வேண்டும். அது /v1/traces, /v1/logs மற்றும் /v1/metrics ஆகியவற்றை வழங்கும். x-api-key header அல்லது authorization: bearer header-ல் உள்ள உங்கள் project-ன் ingest key மூலம் authentication செய்யும். 4318 port என்பது கீழே இயங்கும் OpenTelemetry collector-க்கானது. அங்கு நேரடியாக export செய்தால் proxy தவிர்க்கப்படும். Data-க்கு உங்கள் project id-ஐச் சேர்ப்பது அந்த proxy-யே. PORT unset நிலையில் இருந்தால் proxy port 4000-க்கு fallback ஆகும். அதன் .env.example-உம் 4000-ஐ அமைக்கிறது. ஆகவே 4101 என்று கருதுவதற்கு முன் ss -lntp-ஐ இயக்கி, அது எந்த port-ல் bind செய்துள்ளது என்பதை உறுதிப்படுத்துங்கள்.
Superlog, Uptime Kuma அல்லது Zabbix-ஐ மாற்றுமா?
இல்லை. உங்கள் network-க்கு வெளியிலிருந்து ஒரு endpoint பதிலளிக்கிறதா என்பதை Uptime Kuma தெரிவிக்கும். நீங்கள் அமைக்கும் thresholds-க்கு எதிராக host மற்றும் service metrics-ஐ Zabbix monitor செய்யும். உங்கள் applications வெளியிடும் traces, logs மற்றும் metrics-ஐ Superlog பெறும். மீண்டும் மீண்டும் ஏற்படும் failures-ஐ incidents-ஆக அது குழுவாக்கும். அதனுடன் external uptime probe-ஐயும் வைத்திருங்கள். வேறு இடத்தில் இயங்கும் probe, உங்கள் telemetry pipeline-ஐ வைத்திருக்கும் box செயலிழந்தாலும் அதைத் தெரிவிக்கும்.
Superlog agent எனது production systems-ஐ மாற்ற முடியுமா?
நீங்கள் வழங்கும் permissions மூலம் மட்டுமே மாற்ற முடியும். Default community runner, local incident summary-ஐ பதிவு செய்யும். பிற investigation runtimes, நீங்கள் configure செய்யும் runner-ஐப் பொறுத்தது. Production credentials-ஐ reading-க்கு மட்டும் வரையறுக்கவும். Pull requests திறக்க branches மற்றும் pull requests-க்கான தனியான GitHub write permissions தேவைப்படும். Production-க்கு write access வழங்குவது தனியாகவும் திட்டமிட்டும் எடுக்க வேண்டிய முடிவாகக் கருதுங்கள். Services-ஐ restart செய்யக்கூடிய agent-க்கான பொறுப்பு, telemetry-ஐப் படித்து review-க்கான patch எழுதும் agent-ஐ விட அதிகம்.
Commit-ஐ pin செய்ய வேண்டுமா அல்லது main-ஐ track செய்ய வேண்டுமா?
ஒரு commit-ஐ pin செய்யுங்கள். 13 October 2026 நிலவரப்படி repository-ல் release tags இல்லை. நீங்கள் சோதித்த SHA-ஐ பதிவு செய்து, அதையே deploy செய்யுங்கள். அடுத்த மாற்றத்துக்கு முன் diff-ஐப் படியுங்கள். git log --oneline <old-sha>..main என்பது review ஆகும். ஏதேனும் bump செய்த பிறகு புதிதாகத் தேவைப்படும் variables-க்கு, ஒவ்வொரு app-க்குமான .env.example files-ஐ முதலில் பார்க்க வேண்டும்.