SSD Nodes Learn Hosting plans →
Mwongozo Matt ConnorNa Matt Connor · Imeboreshwa 2026-11-06

Jinsi ya kusakinisha Superlog kwenye VPS yako

Jifunze jinsi ya kusanidi Superlog kwa kutumia Docker Compose, Postgres, na ClickHouse. Pata mwongozo wa hatua kwa hatua wa kusimamia OTLP traces na logs zako mwenyewe.

Nini ambacho self-hosting ya Superlog husakinisha kihalisi

Ili kufanya self-hosting ya Superlog, unaclonerepository, unawasha Postgres, ClickHouse na OpenTelemetry collector kwa kutumia Docker Compose, unafanya migration moja ya database, kisha unaanzisha huduma nne za Node kutoka kwenye source code. Programu zako hutuma traces, logs na metrics za OTLP (OpenTelemetry protocol) kwenye port ya intake, Superlog huzifanyia fingerprinting, huzipanga zile zinazojirudia kuwa tukio moja (incident), na agent runner wa kawaida wa jamii hurekodi muhtasari wa tukio hilo ndani ya seva. Usakinishaji huu huchukua mchana mzima. Ukubwa wa rasilimali zinazohitajika na mipaka ya kweli ni mambo yanayostahili kusomwa kabla ya kuanza.

Superlog ina leseni ya Apache 2.0 na inapatikana katika github.com/superloglabs/superlog. Kufikia tarehe 13 Oktoba 2026, ina takriban nyota 1.5k, takriban commits 490 kwenye main, na haina release tags hata moja. Jifungie (pin) commit wewe mwenyewe badala ya kuendesha chochote kile ambacho main kilikuwa wakati wa asubuhi ulipoclone repository hiyo.

Majibu ya Superlog ambayo Uptime Kuma na Langfuse hayatoi

Zana za ufuatiliaji (monitoring tools) unazojiendeshea mwenyewe zinaonekana kufanana kwa nje. Hali si hivyo, na kutumia zana isiyo sahihi kutakugharimu seva bila faida yoyote.

Superlog inashughulikia swali tofauti: kitu kimeharibika, ni nini kimeharibika, na kwa nini. Haina maoni kuhusu miito ya LLM na haikuchunguzi kutoka nje. Inapokea OTLP kutoka kwa msimbo wa programu yako ya kawaida na kuweka wakala (agent) kwenye hatua ya triage, ambayo ndiyo hatua ya kwanza ambayo binadamu aliye zamu angeifanya hata hivyo.

Tofauti muhimu kwa bajeti ya VPS ni hifadhi (storage). Superlog inatumia column store, kwa sababu telemetry huandikwa mara moja na kisha kutafutwa kwa muda kwenye mamilioni ya safu. Hiyo ndiyo kazi ya ClickHouse na si ya Postgres. Postgres bado inabaki kwenye stack, ikihifadhi data ndogo za uhusiano: miradi, watumiaji, matukio na funguo za kupokea data (ingest keys).

Amri ya docker compose up -d inaanza nini hasa?

Kontena tatu, na hakuna hata moja kati ya hizo ni Superlog. Hili huwashangaza watu wanaotarajia usakinishaji wa amri moja.

  • postgres:16, iliyochapishwa kwenye port ya seva ya 5434
  • clickhouse/clickhouse-server:26.1, kwenye 8123 kwa ajili ya HTTP na 9000 kwa ajili ya itifaki asilia
  • otel/opentelemetry-collector-contrib:0.150.1, kwenye 4317 kwa ajili ya gRPC na 4318 kwa ajili ya OTLP kupitia HTTP

Programu za Superlog huendeshwa kwenye seva (host), kutoka kwenye source, na kuanzishwa na pnpm dev. Hakuna faili ya compose ya uzalishaji (production) katika hazina (repository) kufikia tarehe 13 Oktoba 2026, kwa hivyo usakinishaji wa kudumu unamaanisha kutumia systemd units zako mwenyewe, au Dockerfiles za kila programu zinazokuja na mti wa faili. Programu za api, worker na proxy kila moja ina hati ya start kwa ajili ya unit ya kuifunga. Programu ya web haina: ni programu ya Vite, kwa hivyo unaijenga kwa kutumia hati yake ya build na kuhudumia matokeo kama faili tuli (static files) kutoka kwa nginx au Caddy, au unaendesha hati yake ya preview, ambayo ni vite preview.

Kumbuka njia ambayo data hupitia, kwa sababu kila hitilafu hapa chini ni kukatika kwa hatua moja ya njia hiyo. Programu yako hutuma OTLP kwenye wakala wa mapokezi (intake proxy) wa Superlog. Wakala huyo huhakiki ombi hilo kwa kutumia ufunguo wako wa kuingiza data (ingest key), huweka kitambulisho cha mradi (project id) juu yake, na kuliwasilisha kwa mkusanyaji (collector). Mkusanyaji huondoa sifa (attributes) zozote za superlog.* ambazo mteja alijaribu kuweka, huongeza superlog.project_id kutoka kwenye header iliyotolewa na wakala, hufanya batching, na kuandika kwenye ClickHouse. Programu ya web na API kisha husoma telemetry kutoka ClickHouse na kila kitu kingine kutoka Postgres.

Uondoaji huo wa sifa ni udhibiti halisi wa multi-tenancy, si mapambo. Bila hivyo, mtu yeyote aliye na ufunguo mmoja halali wa kuingiza data angeweza kujiwekea superlog.project_id yeye mwenyewe na kuandika kwenye data ya mradi mwingine.

VPS inahitaji kuwa na ukubwa gani?

Panga kuwa na 4 vCPU, 8 GB ya RAM na 40 GB ya SSD kwa ajili ya usakinishaji wa node moja yenye kiasi kidogo cha data inayoingia. Hii ni kiwango cha chini cha kupanga, si kipimo kamili, hivyo itumie kama saizi ya kuanzia na uilinganishe na trafiki yako mwenyewe.

Kumbukumbu hutumika katika maeneo manne. ClickHouse imejengwa kwa ajili ya mashine zenye RAM ya kutosha na mipangilio yake chaguo-msingi huchukulia hivyo. Postgres 16 ni ya wastani hapa, kwa sababu inahifadhi metadata badala ya telemetry. Mkusanyaji (collector) pia ni wa wastani. Michakato minne ya Node inajumuisha seva ya maendeleo ya Vite pamoja na michakato mitatu ya tsx watch; pima matumizi yao ya kumbukumbu kwenye seva yako.

Diski ni tatizo ambalo halionekani haraka. pnpm install kwenye monorepo hii huvuta AWS SDK, mteja wa ClickHouse, OpenTelemetry SDK na React toolchain kabla hata hujapokea span moja. ClickHouse kisha hukua kulingana na trafiki yako. Pima vyote viwili:

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"

Mzigo unaoleta madhara ni ule wa ghafla (burst): deploy moja mbaya inayozalisha maelfu ya makosa yanayofanana kwa dakika. Fingerprinting huunganisha makosa hayo kuwa tukio moja kwa msomaji, lakini ClickHouse bado huandika kila mstari chini yake.

Uhifadhi (retention) ni wako wa kuweka. Kisafirishaji cha ClickHouse cha mkusanyaji huunda majedwali, otel_traces, otel_logs na jedwali moja kwa kila aina ya metric, na hutumia muda wa kuishi (time to live) ikiwa tu usanidi katika infra/collector/config.yaml utauweka. Hakuna kitu kinachoisha chenyewe, hivyo mwezi wenye shughuli nyingi utajaza diski isipokuwa kama utapanga mapema.

Kusakinisha kutoka kwa commit iliyofungiwa (pinned)

git clone https://github.com/superloglabs/superlog.git
cd superlog
git tag -l
git log -1 --format='%H %cs %s'

git tag -l kutotoa matokeo yoyote ndiyo matokeo yanayotarajiwa kufikia tarehe 13 Oktoba 2026. Chagua commit uliyojaribu na ubaki nayo:

git checkout 0d3a6c8bb63eda3493e6ba0003e7c2a70750bc1e

Ifuatayo, toolchain:

node -v
corepack enable
corepack prepare pnpm@9.12.0 --activate
pnpm -v

package.json inatangaza engines.node kama >=20.0.0 na packageManager kama pnpm@9.12.0. Toleo la Node lisiloendana halisimamishi usakinishaji kiotomatiki: utekelezaji wa engine unategemea usanidi, na pnpm 9.12.0 ina njia ya onyo wakati engineStrict imezimwa. Kifurushi cha nodejs katika archive ya Ubuntu 24.04 ni cha zamani kuliko 20, kwa hivyo sakinisha Node 20 au mpya zaidi kutoka NodeSource au nvm. Repository inatoa .nvmrc, kwa hivyo nvm use huchagua toleo linalokusudiwa ikiwa unatumia nvm.

pnpm install
docker compose up -d
docker compose ps

Subiri ukaguzi wa afya (health checks) badala ya kuamini kuwa up -d inamaanisha kuwa iko tayari. Postgres na ClickHouse zote zinatangaza moja kwenye faili ya compose:

curl -sS http://127.0.0.1:8123/ping
pg_isready -h 127.0.0.1 -p 5434 -U postgres

ClickHouse inajibu Ok. na pg_isready inajibu accepting connections. Connection refused kwenye 8123 inamaanisha kuwa container bado inaanza au imekufa. docker compose logs clickhouse inaonyesha ni ipi kati ya hizo, na docker inspect $(docker compose ps -q clickhouse) | grep -i oomkilled inaripoti true wakati kernel imeifunga kwa sababu ya kumbukumbu, jambo linaloashiria kuwa seva ni ndogo sana badala ya kuwa na makosa kwenye usanidi wako.

Kisha uhamiaji (migration) na programu:

pnpm --filter @superlog/db db:migrate
pnpm dev

Zingatia port: 5434, si 5432. Faili ya compose inachapisha Postgres kwenye 5434 ili isigongane na Postgres iliyosakinishwa tayari kwenye host, na faili za .env.example za programu zinalingana, zikiwa na DATABASE_URL=postgres://postgres:postgres@localhost:5434/superlog. Ukielekeza migration kwenye 5432 kwenye seva inayotumia Postgres tayari, utapata connection refused au, mbaya zaidi, migration itatumika kwenye database isiyo sahihi.

pnpm dev inaendesha turbo run dev, ambayo inaanza script ya dev ya kila programu kupitia Turborepo, ikijumuisha api, web, worker na proxy, huku matokeo yake yakichanganywa kwenye terminal moja. Faili ya Procfile ya repository inaorodhesha michakato hiyo minne na kuelekeza matokeo ya kila moja kwenye tmp/logs/. Ianzishe na kimbiaji cha Procfile kama overmind au foreman badala ya pnpm dev ikiwa unataka tail -f tmp/logs/proxy.log iwe mahali unapoangalia ingest. README inaweka web app kwenye http://localhost:5173, API kwenye http://localhost:4100 na OTLP intake kwenye http://localhost:4101.

Thibitisha kile kilichofungwa (bound) kabla ya kuelekeza chochote kwacho:

ss -lntp | grep -E '4000|4100|4101|5173'
curl -sS http://127.0.0.1:4101/health

Hili ni muhimu baadaye. Proxy inasoma port yake kutoka kwa variable ya mazingira ya PORT na kurudi kwenye 4000 wakati PORT haijawekwa, na apps/proxy/.env.example inayopakia pia inaweka PORT=4000, ingawa README inaorodhesha intake kwenye 4101 (zote zilikaguliwa tarehe 13 Oktoba 2026). Tumia port yoyote ambayo ss inaonyesha. Mifano hapa chini inatumia 4101, kwa hivyo badilisha na 4000 ikiwa ndiyo iliyofungwa. Unit ya systemd unayoandika wewe mwenyewe haiweki chochote isipokuwa ukiweka PORT ndani yake, kwa hivyo exporter inayolenga 4101 dhidi ya proxy inayoisikiliza kwenye 4000 itashindwa na connection refused na haitakupa dokezo lingine lolote.

Tuma trace moja, zalisha hitilafu moja, ona tukio moja

Tengeneza mradi katika web app na unakili ingest key yake. Mfumo wa intake huhakiki kila ombi dhidi ya key hiyo, kwa hivyo telemetry inayotumwa bila key haitafika kwenye ClickHouse.

Elekeza OpenTelemetry SDK yoyote kwenye intake kwa kutumia environment variables za kawaida:

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 husoma key kutoka kwenye header ya x-api-key, na pia hukubali authorization: bearer YOUR_INGEST_KEY ikiwa exporter yako ni rahisi kusanidiwa kwa njia hiyo. Inahudumia njia tatu za kawaida za OTLP, /v1/traces, /v1/logs na /v1/metrics, pamoja na /health.

Mtego mmoja unastahili kutajwa. OTEL_EXPORTER_OTLP_ENDPOINT ni base URL na SDK huongeza signal path kwenye URL hiyo. Variable mahususi za signal kama OTEL_EXPORTER_OTLP_TRACES_ENDPOINT hutumiwa kama zilivyoandikwa, bila kuongezewa path yoyote. Ukiweka variable mahususi ya signal kuwa http://127.0.0.1:4101, kila export itatumwa kwenye /, ambayo si route sahihi, kwa hivyo hakuna kitakachofika na SDK itaandika hitilafu ya export kwenye log wakati app yako inaonekana kuwa sawa.

Kwa huduma ya Node, njia ya zero code inatosha kuthibitisha pipeline:

npm install @opentelemetry/api @opentelemetry/auto-instrumentations-node
node --require @opentelemetry/auto-instrumentations-node/register server.js

Sasa haribu kitu kwa makusudi. Route yoyote itakayozalisha exception itafaa:

curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3000/boom

Kagua hops kwa mpangilio, kwa sababu pengo la kwanza litakuambia ni wapi palipofeli:

tail -n 50 tmp/logs/proxy.log
docker compose exec clickhouse clickhouse-client --database superlog --query 'SELECT count() FROM otel_traces'

Idadi inayoongezeka katika otel_traces huku web app ikiwa tupu inaashiria kutolingana kwa mradi, kwa hivyo kagua mradi ambao ingest key hiyo inahusika nao. Idadi isiyobadilika huku kukiwa na shughuli katika proxy log inaashiria tatizo kwenye collector au uandishi wa ClickHouse, kwa hivyo soma docker compose logs collector. Kutokuwepo kwa shughuli yoyote katika proxy log inamaanisha kuwa exporter haikufika kwenye intake: port isiyo sahihi, path isiyo sahihi, au key iliyokataliwa.

Katika web app, hitilafu hizo zinazojirudia hufika kama tukio moja badala ya mstari mmoja kwa kila ombi. Superlog hufanya fingerprinting ya signals zinazoingia na kuzipanga zile zinazolingana, jambo ambalo ni tofauti kati ya inbox iliyojaa hitilafu 4,000 zinazofanana na ukurasa ulio na tukio moja. Default community agent runner kisha hurekodi muhtasari wa tukio la ndani kwa kundi hilo.

Uchunguzi unaotegemea model unahitaji model provider na agent runner inayooana iliyosanidiwa; default community runner hurekodi muhtasari wa ndani. Chukua majina hayo ya variable kutoka kwenye faili la .env.example ndani ya kila saraka ya app ya commit uliyoiweka badala ya maelezo ya nje, kwa sababu hubadilika kulingana na main. Hali hiyo hiyo inatumika kwa GitHub na Sentry integrations, ambazo zina nyaraka zao za usanidi katika docs/github-app-setup.md na docs/sentry-app-setup.md, huku webhook payloads zikiwa zimeandikwa katika docs/webhooks.md.

Weka sehemu ya kuingiza data (intake) ikiwa ya faragha, na wakala (agent) awe na ruhusa ya kusoma pekee

Docker huchapisha (publish) port za container kwenye 0.0.0.0 kwa chaguomsingi, na port hizo zilizochapishwa hupita pembeni ya ufw. Docker huelekeza trafiki ya container kwenye table ya nat, kwa hivyo pakiti inayoelekea kwenye port iliyochapishwa hupindishwa kabla haijafika kwenye chains za INPUT na OUTPUT ambapo sheria za ufw hukaa, na ufw haipati nafasi ya kudhibiti. Kwenye VPS yenye IP ya umma, faili ya compose kama ilivyotolewa huweka ClickHouse HTTP kwenye 8123 na Postgres kwenye 5434 ambapo Internet inaweza kuzifikia. Vitambulisho (credentials) vilivyomo kwenye faili hiyo ni vya maendeleo (development defaults): mtumiaji wa ClickHouse default akiwa na nenosiri tupu, na Postgres akiwa na postgres kama mtumiaji na nenosiri.

Zifunge kwenye loopback. Kila port iliyochapishwa kwenye faili ya compose huchukua upande wake wa host kutoka kwa environment variable, kwa hivyo .env kwenye mzizi wa repository inatosha:

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

Thibitisha matokeo kabla hujaamini, kisha tengeneza upya containers:

docker compose config
docker compose up -d
ss -lntp | grep -E '5434|8123|9000|4317|4318'

docker compose config huchapisha faili iliyosuluhishwa, ili uweze kusoma 127.0.0.1:5434:5432 badala ya kukisia. ss inapaswa kuonyesha 127.0.0.1:5434 na kamwe isionyeshe 0.0.0.0:5434. Kutangaza upya ports kwenye faili ya Compose override hudumisha vifungo vyote viwili wakati IP ya host inatofautiana; Compose 2.24.4 na matoleo ya baadaye huunga mkono ports: !override ili kuchukua nafasi ya orodha hiyo.

Sehemu ya kuingiza data inahitaji uangalifu uleule. Ufunguo wako wa kuingiza data (ingest key) husafiri kwenye header, kwa hivyo inahitaji TLS (transport layer security) mbele yake: malizia TLS kwenye nginx au Caddy mbele ya proxy, au weka ingest ndani ya mtandao wa faragha au WireGuard tunnel. Programu ya wavuti kwenye 5173 ni seva ya maendeleo ya Vite na haina sababu ya kukabili Internet hata kidogo.

Kisha wakala (agent) mwenyewe. Ahadi ya Superlog ni kwamba wakala huchunguza na kupendekeza marekebisho, na neno muhimu ni kupendekeza. Iweke ikiwa na ruhusa ya kusoma pekee (read only) dhidi ya uzalishaji (production) hadi utakapokuwa umeitazama ikifanya kazi kwenye matukio machache halisi. GitHub App yenye ruhusa ya kusoma pekee haiwezi kusukuma (push) branch ya marekebisho au kufungua pull requests: mwongozo wa usanidi unahitaji ruhusa za Contents na Pull requests za kuandika (write) kwa ajili ya workflow hiyo, pamoja na ruhusa ya Issues ya kuandika kwa ajili ya maoni. Wakala anayesoma telemetry na kuandika patch ni muhimu. Wakala anayeweza kuanzisha upya huduma zako ni kiwango tofauti cha hatari, na hilo linapaswa kuwa uamuzi unaoufanya kwa makusudi badala ya chaguomsingi unayorithi. Gharama inastahili uangalifu uleule unaposanidi runner inayotumia modeli: bajeti ya matumizi ya wakala kwenye VPS kabla hujaielekeza kwenye mfumo wa uzalishaji wenye shughuli nyingi, na weka kumbukumbu ya kile wakala alichokifanya hasa ili pull request ya kushangaza iwe na njia ya ukaguzi (audit trail) nyuma yake.

Hitilafu utakazokutana nazo, na misemo inayozitaja

  • ERR_PNPM_UNSUPPORTED_ENGINE wakati wa pnpm install inamaanisha hitaji la injini haliendani. pnpm 9.12.0 hukagua mahitaji ya Node na pnpm; soma matoleo yanayotakiwa na yale ya sasa kwenye ujumbe wa hitilafu, kisha kagua node -v na pnpm -v.
  • ECONNREFUSED 127.0.0.1:5434 wakati wa uhamiaji (migration) inamaanisha kuwa compose stack haijawashwa, au DATABASE_URL inataja port isiyo sahihi.
  • Kagua kuanzishwa upya kwa ClickHouse kwa kutumia docker compose logs clickhouse, kisha kagua container ili kuona kama OOMKilled ni true.
  • Exporter inayoripoti kufanikiwa wakati web app inabaki tupu mara nyingi inamaanisha data ilienda moja kwa moja kwa collector kwenye 4318, jambo linaloruka uwekaji wa alama (stamping) wa mradi ambao proxy huufanya.
  • Connection refused kwenye 4101 mara nyingi inamaanisha kuwa proxy inasikiliza kwenye 4000, port ambayo code yake huirejelea kama mbadala na ile ambayo .env.example yake huiweka. Weka PORT wazi kwenye unit file au .env ya app hiyo.
  • docker compose ps inayoonyesha 0.0.0.0:8123 inamaanisha kuwa loopback bindings zako hazifanyi kazi. Tekeleza docker compose config na usome port zilizotatuliwa.

Flawless, HyperProbe, na mahali ambapo Superlog inakaa

Kategoria hii ni changa, na zana zake hutofautiana kuhusu kile ambacho wakala (agent) anaruhusiwa kukigusa. Hifadhi ya Flawless sasa inawasilisha CISRE, jukwaa la AI SRE (site reliability engineering) kwa ajili ya Kubernetes na miundombinu ya wingu, chini ya leseni ya PolyForm Noncommercial. HyperProbe huweka probe ndani ya mchakato unaoendelea (running process) ili kunasa hali ya vigezo (variable state) na kuifichua hali hiyo kwa msaidizi kupitia MCP (model context protocol); pia inaandika maelekezo ya self-hosting kwa kutumia Docker Compose na license key.

Superlog inakaa katikati ya hizi mbili. Inamiliki pipeline kuanzia mwanzo hadi mwisho, kuanzia upokeaji wa OTLP hadi hifadhi ya ClickHouse, na inaweka wakala kwenye hatua ya triage badala ya hatua ya kurekebisha. Usanifu huo ndio sababu hasa kwa nini kuifanya self-hosting ni uamuzi wa miundombinu na si kontena unalolisahau. Mara tu unapoendesha Superlog, unaendesha column store, na inahitaji uangalizi uleule kama database nyingine yoyote unayomiliki.

FAQ

Superlog inayojiendesha (self-hosted) inahitaji RAM kiasi gani?

Panga kuwa na 8 GB ya RAM, 4 vCPU na 40 GB ya diski kwa node moja yenye kiasi kidogo cha data. Stack hii inajumuisha Postgres, ClickHouse, OpenTelemetry collector na michakato minne ya Node, na ClickHouse inahitaji nafasi ya ziada ya kumbukumbu. Pima takwimu zako mwenyewe kwa kutumia docker stats --no-stream na free -m badala ya kuamini takwimu zozote zilizochapishwa, ikiwemo hii.

Ni port ipi nitaelekeza OTLP exporter yangu?

Elekeza kwenye Superlog intake proxy, ambayo README inaweka kwenye http://localhost:4101. Inahudumia /v1/traces, /v1/logs na /v1/metrics, na inathibitisha utambulisho kwa kutumia ingest key ya mradi wako iliyochukuliwa kutoka kwenye header ya x-api-key au kutoka kwenye header ya authorization: bearer. Port 4318 ni ya OpenTelemetry collector iliyo chini yake, na kusafirisha data huko moja kwa moja kunaruka proxy, ambayo ndiyo sehemu inayoweka kitambulisho cha mradi wako kwenye data. Proxy inarudi kwenye port 4000 wakati PORT haijawekwa, na .env.example yake pia huweka 4000, kwa hivyo endesha ss -lntp na uthibitishe ilichofungua (bound) kabla ya kudhani ni 4101.

Je, Superlog inachukua nafasi ya Uptime Kuma au Zabbix?

Hapana. Uptime Kuma inajibu kama endpoint inajibu kutoka nje ya mtandao wako, na Zabbix inafuatilia metrics za host na huduma dhidi ya vizingiti ulivyoweka. Superlog inachakata traces, logs na metrics ambazo programu zako zinatoa na kupanga makosa yanayojirudia kuwa matukio (incidents). Weka probe ya nje ya uptime pamoja nayo, kwa sababu probe inayofanya kazi mahali pengine bado itatoa taarifa wakati seva inayoshikilia telemetry pipeline yako ndiyo iliyokufa.

Je, Superlog agent inaweza kubadilisha mifumo yangu ya production?

Inaweza tu kupitia ruhusa unazozitoa. Community runner ya kawaida inarekodi muhtasari wa tukio la ndani; runtime nyingine za uchunguzi hutegemea runner unayosanidi. Weka credentials za production zikiwa na uwezo wa kusoma pekee; kufungua pull requests kunahitaji ruhusa tofauti za GitHub za kuandika (write permissions) kwa ajili ya branches na pull requests. Chukulia uwezo wa kuandika kwenye production kama uamuzi tofauti unaofanywa kwa makusudi, kwa sababu agent inayoweza kuanzisha upya huduma ni jukumu kubwa zaidi kuliko agent inayosoma telemetry na kuandika patch kwa ajili ya ukaguzi.

Je, nifunge (pin) commit au nifuatilie main?

Funga commit. Hakukuwa na release tags kwenye repository kufikia 13 October 2026. Rekodi SHA uliyojaribu, deploy hiyo, na usome diff kabla ya kusonga mbele. git log --oneline <old-sha>..main ni mahali pa ukaguzi, na faili za .env.example za kila programu ndiyo mahali pa kwanza pa kuangalia vigezo vipya vinavyohitajika baada ya mabadiliko yoyote.

Je, makala hii ilikusaidia?

#superlog#observability#opentelemetry#clickhouse#ai-sre