SSD Nodes Learn Hosting plans →
Panduan Matt ConnorOleh Matt Connor · Dikemas kini 2026-11-06

Cara Self-host Superlog untuk AI-triaged Logs

Ketahui cara memasang Superlog menggunakan Docker Compose untuk mengurus log dan trace OTLP. Ketahui keperluan sistem dan risiko menggunakan kod sumber tanpa tag release.

Perkara yang sebenarnya dipasang oleh Superlog untuk self-hosting

Untuk melakukan self-hosting Superlog, anda perlu mengklon repositori, menjalankan Postgres, ClickHouse dan pengumpul OpenTelemetry menggunakan Docker Compose, melaksanakan satu migrasi pangkalan data, kemudian memulakan empat servis Node daripada kod sumber. Aplikasi anda menghantar trace, log dan metrik OTLP (OpenTelemetry protocol) ke port penerimaan, Superlog akan melakukan fingerprint pada data tersebut, mengumpulkan data yang berulang menjadi satu insiden, dan ejen komuniti lalai akan merekodkan ringkasan insiden setempat. Pemasangan ini mengambil masa satu petang. Jejak penggunaan dan had sebenar adalah bahagian yang perlu dibaca sebelum anda bermula.

Superlog dilesenkan di bawah Apache 2.0 dan boleh didapati di github.com/superloglabs/superlog. Sehingga 13 Oktober 2026, ia mempunyai kira-kira 1.5k bintang, lebih kurang 490 commit pada main, dan tiada tag release langsung. Tetapkan commit anda sendiri (pin) daripada menjalankan apa sahaja main yang kebetulan ada pada pagi anda mengklonnya.

Perkara yang dijawab oleh Superlog yang tidak dijawab oleh Uptime Kuma dan Langfuse

Alat pemantauan yang dihoskan sendiri kelihatan boleh ditukar ganti dari luar. Hakikatnya tidak, dan menjalankan alat yang salah akan merugikan pelayan anda tanpa sebarang manfaat.

Superlog menjawab soalan yang berbeza: sesuatu telah rosak, apa yang rosak, dan mengapa. Ia tidak mempunyai pendapat tentang panggilan LLM dan ia tidak memeriksa anda dari luar. Ia menyerap OTLP daripada kod aplikasi biasa anda dan meletakkan ejen pada langkah triaj, iaitu langkah pertama yang akan dilakukan oleh manusia yang bertugas (on-call).

Perbezaan yang penting bagi bajet VPS ialah storan. Superlog membawa storan lajur (column store), kerana telemetri ditulis sekali dan kemudian disoal mengikut julat masa merentasi berjuta-juta baris. Itulah tujuan ClickHouse dan bukan tujuan Postgres. Postgres masih berada dalam tindanan (stack), menyimpan data hubungan yang kecil: projek, pengguna, insiden dan kunci serapan (ingest keys).

Apakah yang sebenarnya dimulakan oleh docker compose up -d?

Tiga kontena, dan tiada satu pun daripadanya ialah Superlog. Ini mengejutkan mereka yang menjangkakan pemasangan satu arahan.

  • postgres:16, diterbitkan pada port hos 5434
  • clickhouse/clickhouse-server:26.1, pada 8123 untuk HTTP dan 9000 untuk protokol natif
  • otel/opentelemetry-collector-contrib:0.150.1, pada 4317 untuk gRPC dan 4318 untuk OTLP melalui HTTP

Aplikasi Superlog berjalan pada hos, daripada kod sumber, dimulakan oleh pnpm dev. Tiada fail compose pengeluaran dalam repositori setakat 13 Oktober 2026, jadi pemasangan jangka panjang bermakna anda perlu menggunakan unit systemd sendiri, atau Dockerfiles bagi setiap aplikasi yang disertakan dalam pepohon direktori. Aplikasi api, worker dan proxy masing-masing mempunyai skrip start untuk unit tersebut dibalut. Aplikasi web tidak mempunyai skrip sedemikian: ia adalah aplikasi Vite, jadi anda membinanya dengan skrip build dan menghidangkan output sebagai fail statik daripada nginx atau Caddy, atau menjalankan skrip preview miliknya, iaitu vite preview.

Ingat laluan yang diambil oleh span, kerana setiap kegagalan di bawah adalah gangguan pada salah satu hopnya. Aplikasi anda menghantar OTLP ke proksi pengambilan Superlog. Proksi mengesahkan permintaan dengan kunci pengambilan anda, mengecap id projek padanya, dan memajukannya ke pengumpul. Pengumpul membuang sebarang atribut superlog.* yang cuba ditetapkan oleh klien, menambah superlog.project_id daripada pengepala yang disediakan oleh proksi, melakukan pemprosesan kelompok, dan menulis ke ClickHouse. Aplikasi web dan API kemudian membaca telemetri kembali daripada ClickHouse dan segala yang lain daripada Postgres.

Pembuangan atribut itu merupakan kawalan berbilang penyewa (multi-tenancy) yang sebenar, bukan sekadar hiasan. Tanpanya, sesiapa yang memegang satu kunci pengambilan yang sah boleh menetapkan superlog.project_id sendiri dan menulis ke dalam data projek lain.

Berapa besar saiz VPS yang diperlukan?

Rancang untuk 4 vCPU, 8 GB RAM dan 40 GB SSD bagi pemasangan nod tunggal dengan volum ingest yang rendah. Ini adalah tahap perancangan minimum, bukan ukuran tetap, jadi anggap ia sebagai saiz permulaan dan semak semula berdasarkan trafik anda sendiri.

Memori digunakan untuk empat bahagian. ClickHouse dibina untuk mesin dengan RAM yang banyak dan tetapan lalainya mengandaikan perkara tersebut. Postgres 16 adalah sederhana di sini, kerana ia menyimpan metadata dan bukannya telemetri. Pengumpul (collector) juga sederhana. Empat proses Node merangkumi pelayan pembangunan Vite serta tiga proses tsx watch; ukur penggunaan memori pada mesin anda sendiri.

Cakera adalah masalah yang lebih senyap. pnpm install pada monorepo ini menarik AWS SDK, klien ClickHouse, OpenTelemetry SDK dan rantaian alat React sebelum anda melakukan ingest pada satu span pun. ClickHouse kemudian akan berkembang mengikut trafik anda. Ukur kedua-duanya:

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"

Beban yang memudaratkan ialah lonjakan (burst): satu deployment yang bermasalah menghasilkan beribu-ribu ralat yang sama dalam seminit. Fingerprinting akan menggabungkan ralat tersebut menjadi satu insiden untuk pembaca, tetapi ClickHouse tetap menulis setiap baris di bahagian belakang.

Pengekalan (retention) adalah tanggungjawab anda untuk menetapkannya. Pengeksport ClickHouse bagi pengumpul mencipta jadual, otel_traces, otel_logs dan satu jadual bagi setiap jenis metrik, dan ia hanya menggunakan tempoh hayat (time to live) jika konfigurasi dalam infra/collector/config.yaml menetapkannya. Tiada apa-apa yang tamat tempoh dengan sendirinya, jadi bulan yang sibuk akan menyebabkan cakera penuh melainkan anda merancang untuknya.

Memasang daripada commit yang dipin

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

git tag -l tidak mencetak apa-apa adalah hasil yang dijangkakan setakat 13 Oktober 2026. Pilih commit yang telah anda uji dan kekal pada commit tersebut:

git checkout 0d3a6c8bb63eda3493e6ba0003e7c2a70750bc1e

Seterusnya, toolchain:

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

package.json mengisytiharkan engines.node sebagai >=20.0.0 dan packageManager sebagai pnpm@9.12.0. Versi Node yang tidak serasi tidak menghentikan pemasangan secara automatik: penguatkuasaan enjin bergantung pada konfigurasi, dan pnpm 9.12.0 mempunyai laluan amaran apabila engineStrict dinyahdayakan. Pakej nodejs dalam arkib Ubuntu 24.04 adalah lebih lama daripada 20, jadi pasang Node 20 atau lebih baharu daripada NodeSource atau nvm. Repositori tersebut membekalkan .nvmrc, jadi nvm use akan memilih versi yang disasarkan jika anda mempunyai nvm.

pnpm install
docker compose up -d
docker compose ps

Tunggu pemeriksaan kesihatan (health checks) selesai dan jangan hanya mempercayai up -d sebagai tanda ia sudah sedia. Postgres dan ClickHouse masing-masing mengisytiharkannya dalam fail compose:

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

ClickHouse menjawab Ok. dan pg_isready menjawab accepting connections. Connection refused pada 8123 bermakna kontena masih dalam proses memulakan atau telah mati. docker compose logs clickhouse menunjukkan punca sebenar, dan docker inspect $(docker compose ps -q clickhouse) | grep -i oomkilled melaporkan true apabila kernel mematikannya kerana masalah memori, yang menunjukkan pelayan anda terlalu kecil dan bukannya masalah pada konfigurasi anda.

Kemudian migrasi dan aplikasi:

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

Perhatikan port: 5434, bukan 5432. Fail compose menerbitkan Postgres pada 5434 supaya ia tidak bertembung dengan Postgres yang sudah dipasang pada hos, dan fail .env.example aplikasi sepadan dengan DATABASE_URL=postgres://postgres:postgres@localhost:5434/superlog. Jika anda menghalakan migrasi ke 5432 pada mesin yang sudah menjalankan Postgres, anda akan mendapat ralat sambungan ditolak atau lebih buruk lagi, migrasi digunakan pada pangkalan data yang salah.

pnpm dev menjalankan turbo run dev, yang memulakan skrip dev setiap aplikasi melalui Turborepo, termasuk api, web, worker dan proxy, dengan outputnya digabungkan dalam satu terminal. Procfile dalam repositori menyenaraikan empat proses yang sama dan menyalurkan output setiap satu ke dalam tmp/logs/. Mulakannya dengan pelari Procfile seperti overmind atau foreman dan bukannya pnpm dev jika anda mahu tail -f tmp/logs/proxy.log menjadi tempat anda memantau ingest. README meletakkan aplikasi web pada http://localhost:5173, API pada http://localhost:4100 dan intake OTLP pada http://localhost:4101.

Sahkan apa yang sebenarnya terikat (bound) sebelum anda menghalakan apa-apa kepadanya:

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

Ini penting kemudian. Proxy membaca portnya sendiri daripada pemboleh ubah persekitaran PORT dan kembali kepada 4000 apabila PORT tidak ditetapkan, dan apps/proxy/.env.example yang dimuatkannya juga menetapkan PORT=4000, walaupun README menyenaraikan intake pada 4101 (kedua-duanya disemak pada 13 Oktober 2026). Gunakan mana-mana port yang ditunjukkan oleh ss. Contoh di bawah menggunakan 4101, jadi tukar kepada 4000 jika itu port yang terikat. Unit systemd yang anda tulis sendiri tidak menetapkan apa-apa melainkan anda meletakkan PORT di dalamnya, jadi pengeksport yang disasarkan ke 4101 terhadap proxy yang mendengar pada 4000 akan gagal dengan ralat connection refused tanpa memberikan petunjuk lain.

Hantar satu surih, hasilkan satu ralat, lihat satu insiden

Cipta projek dalam aplikasi web dan salin kunci ingest miliknya. Intake mengesahkan setiap permintaan berdasarkan kunci tersebut, jadi telemetri yang dihantar tanpa kunci tidak akan sampai ke ClickHouse.

Halakan mana-mana SDK OpenTelemetry ke intake menggunakan pemboleh ubah persekitaran standard:

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 membaca kunci daripada header x-api-key, dan turut menerima authorization: bearer YOUR_INGEST_KEY jika pengeksport anda lebih mudah dikonfigurasikan dengan cara tersebut. Ia menyediakan tiga laluan OTLP standard, /v1/traces, /v1/logs dan /v1/metrics, serta /health.

Satu perangkap perlu diberi perhatian. OTEL_EXPORTER_OTLP_ENDPOINT ialah URL asas dan SDK akan menambah laluan isyarat kepadanya. Pemboleh ubah khusus isyarat seperti OTEL_EXPORTER_OTLP_TRACES_ENDPOINT digunakan tepat seperti yang ditulis, tanpa sebarang laluan ditambah. Tetapkan pemboleh ubah khusus isyarat kepada http://127.0.0.1:4101 dan setiap eksport akan dihantar ke /, yang bukan merupakan laluan yang sah, jadi tiada data yang sampai dan SDK akan mencatat kegagalan eksport sementara aplikasi anda kelihatan sihat.

Bagi servis Node, laluan tanpa kod (zero code) sudah memadai untuk membuktikan talian paip (pipeline):

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

Sekarang, rosakkan sesuatu dengan sengaja. Mana-mana laluan yang menghasilkan ralat (throw) sudah memadai:

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

Periksa setiap hop mengikut urutan, kerana jurang pertama akan memberitahu anda bahagian mana yang gagal:

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

Kiraan yang meningkat dalam otel_traces dengan aplikasi web yang kosong bermaksud ketidakpadanan projek, jadi periksa projek mana yang dimiliki oleh kunci ingest tersebut. Kiraan yang mendatar dengan aktiviti dalam log proksi menunjukkan masalah pada pengumpul (collector) atau penulisan ClickHouse, jadi baca docker compose logs collector. Tiada aktiviti langsung dalam log proksi bermaksud pengeksport tidak pernah sampai ke intake: port salah, laluan salah, atau kunci ditolak.

Dalam aplikasi web, kegagalan berulang tersebut tiba sebagai satu insiden dan bukannya satu baris bagi setiap permintaan. Superlog melakukan fingerprint pada isyarat masuk dan mengumpulkan isyarat yang sepadan, yang merupakan perbezaan antara peti masuk yang mengandungi 4,000 ralat serupa dengan halaman yang hanya mengandungi satu insiden. Pelari ejen komuniti lalai kemudian merekodkan ringkasan insiden tempatan untuk kumpulan tersebut.

Siasatan yang disokong model memerlukan penyedia model dan pelari ejen yang serasi dikonfigurasikan; pelari komuniti lalai merekodkan ringkasan tempatan. Ambil nama pemboleh ubah tersebut daripada fail .env.example di dalam setiap direktori aplikasi bagi komit yang anda pin dan bukannya daripada mana-mana penulisan luaran, kerana ia berubah mengikut main. Perkara yang sama terpakai bagi integrasi GitHub dan Sentry, yang membawa dokumen persediaan masing-masing di docs/github-app-setup.md dan docs/sentry-app-setup.md, dengan payload webhook didokumentasikan dalam docs/webhooks.md.

Pastikan input bersifat peribadi dan ejen hanya boleh dibaca

Docker menerbitkan port kontena pada 0.0.0.0 secara lalai, dan port yang diterbitkan itu memintas ufw. Docker menghalakan trafik kontena dalam jadual nat, jadi paket yang menuju ke port yang diterbitkan akan dilencongkan sebelum ia sampai ke rantaian INPUT dan OUTPUT tempat peraturan ufw berada, dan ufw tidak mempunyai kawalan ke atasnya. Pada VPS dengan IP awam, fail compose yang dibekalkan meletakkan HTTP ClickHouse pada 8123 dan Postgres pada 5434 di mana internet boleh mencapainya. Kredensial dalam fail tersebut adalah lalai pembangunan: pengguna ClickHouse default dengan kata laluan kosong, Postgres dengan postgres sebagai pengguna dan kata laluan.

Ikat port tersebut pada loopback. Setiap port yang diterbitkan dalam fail compose mengambil bahagian hos daripada pemboleh ubah persekitaran, jadi .env dalam root repositori sudah memadai:

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

Sahkan hasilnya sebelum anda mempercayainya, kemudian cipta semula kontena tersebut:

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

docker compose config mencetak fail yang telah diselesaikan, supaya anda boleh membaca 127.0.0.1:5434:5432 dan bukannya meneka. ss sepatutnya menunjukkan 127.0.0.1:5434 dan tidak sekali-kali 0.0.0.0:5434. Hanya dengan mengisytiharkan semula ports dalam fail ganti Compose akan mengekalkan kedua-dua ikatan apabila IP hos berbeza; Compose 2.24.4 dan versi terbaharu menyokong ports: !override untuk menggantikan senarai tersebut.

Input memerlukan penjagaan yang sama. Kunci ingest anda bergerak dalam header, jadi ia memerlukan TLS (transport layer security) di hadapannya: tamatkan TLS dalam nginx atau Caddy sebelum proksi, atau pastikan ingest berada dalam rangkaian peribadi atau terowong WireGuard. Aplikasi web pada 5173 ialah pelayan pembangunan Vite dan tidak sepatutnya terdedah kepada internet sama sekali.

Kemudian ejen itu sendiri. Kelebihan Superlog ialah ejen menyiasat dan mencadangkan pembetulan, dan perkataan penting di sini ialah mencadangkan. Pastikan ia hanya boleh dibaca (read-only) terhadap pengeluaran sehingga anda melihat ia berfungsi pada beberapa insiden sebenar. GitHub App yang hanya boleh dibaca tidak boleh menolak (push) cawangan pembetulan atau membuka pull request: panduan persediaan memerlukan kebenaran tulis Contents dan Pull requests untuk aliran kerja tersebut, serta kebenaran tulis Issues untuk komen. Ejen yang membaca telemetri dan menulis patch adalah berguna. Ejen yang boleh memulakan semula servis anda adalah tahap risiko yang berbeza, dan itu harus menjadi keputusan yang anda buat dengan sengaja dan bukannya lalai yang anda warisi. Kos juga memerlukan perhatian yang sama apabila anda mengkonfigurasi runner berasaskan model: belanjawan untuk perbelanjaan ejen pada VPS sebelum anda menghalakannya ke sistem pengeluaran yang sibuk, dan simpan rekod tentang apa yang ejen sebenarnya lakukan supaya pull request yang mengejutkan mempunyai jejak audit di belakangnya.

Kegagalan yang akan anda temui, dan rentetan yang menamakannya

  • ERR_PNPM_UNSUPPORTED_ENGINE semasa pnpm install bermaksud keperluan enjin tidak serasi. pnpm 9.12.0 menyemak keperluan Node dan pnpm; baca versi yang dikehendaki dan versi semasa dalam ralat tersebut, kemudian semak node -v dan pnpm -v.
  • ECONNREFUSED 127.0.0.1:5434 semasa migrasi bermaksud tindanan (stack) compose tidak berjalan, atau DATABASE_URL menamakan port yang salah.
  • Semak but semula ClickHouse dengan docker compose logs clickhouse, kemudian periksa bekas (container) untuk OOMKilled yang bernilai true.
  • Pengeksport yang melaporkan kejayaan sementara aplikasi web kekal kosong biasanya bermaksud data terus dihantar ke pengumpul pada 4318, yang melangkau pengecapan projek yang dilakukan oleh proksi.
  • Connection refused pada 4101 biasanya bermaksud proksi sedang mendengar pada 4000, iaitu port laluan balik kodnya dan port yang ditetapkan oleh .env.example. Tetapkan PORT secara eksplisit dalam fail unit atau .env aplikasi tersebut.
  • docker compose ps yang menunjukkan 0.0.0.0:8123 bermaksud pengikatan loopback anda tidak berkesan. Jalankan docker compose config dan baca port yang telah diselesaikan.

Flawless, HyperProbe, dan kedudukan Superlog

Kategori ini masih baharu, dan alatan di dalamnya terbahagi berdasarkan skop capaian yang dibenarkan kepada ejen. Repositori Flawless kini menawarkan CISRE, iaitu platform AI SRE (site reliability engineering) untuk Kubernetes dan infrastruktur awan, di bawah lesen PolyForm Noncommercial. HyperProbe meletakkan probe di dalam proses yang sedang berjalan untuk menangkap keadaan pemboleh ubah dan mendedahkan keadaan tersebut kepada pembantu melalui MCP (model context protocol); ia juga mendokumentasikan self-hosting menggunakan Docker Compose dan kunci lesen.

Superlog berada di antara kedua-duanya. Ia mengawal keseluruhan pipeline, bermula daripada pengambilan OTLP sehingga storan ClickHouse, dan ia meletakkan ejen pada langkah triaj dan bukannya pada langkah pembaikan. Reka bentuk tersebut adalah sebab mengapa self-hosting Superlog merupakan keputusan infrastruktur dan bukannya sekadar kontena yang boleh diabaikan. Sebaik sahaja anda menjalankan Superlog, anda sebenarnya menjalankan storan lajur (column store), dan ia memerlukan penjagaan yang sama seperti mana-mana pangkalan data lain yang anda miliki.

FAQ

Berapakah jumlah RAM yang diperlukan oleh Superlog yang dihoskan sendiri?

Rancang untuk 8 GB RAM, 4 vCPU dan 40 GB cakera bagi satu nod pada volum kemasukan rendah. Stak ini terdiri daripada Postgres, ClickHouse, pengumpul OpenTelemetry dan empat proses Node, dan ClickHouse memerlukan ruang tambahan (headroom). Ukur angka anda sendiri dengan docker stats --no-stream dan free -m dan jangan hanya bergantung pada angka yang diterbitkan, termasuk angka ini.

Port manakah yang perlu saya halakan pengeksport OTLP saya?

Proksi kemasukan Superlog, yang diletakkan oleh README pada http://localhost:4101. Ia menyediakan /v1/traces, /v1/logs dan /v1/metrics, serta melakukan pengesahan menggunakan kunci kemasukan projek anda yang diambil daripada pengepala x-api-key atau daripada pengepala authorization: bearer. Port 4318 adalah pengumpul OpenTelemetry di bawahnya, dan mengeksport terus ke sana akan melangkau proksi, iaitu komponen yang mencap ID projek anda pada data tersebut. Proksi akan kembali ke port 4000 apabila PORT tidak ditetapkan, dan .env.example miliknya juga menetapkan 4000, jadi jalankan ss -lntp dan sahkan port yang terikat sebelum menganggap ia adalah 4101.

Adakah Superlog menggantikan Uptime Kuma atau Zabbix?

Tidak. Uptime Kuma menjawab sama ada titik akhir (endpoint) bertindak balas dari luar rangkaian anda, dan Zabbix memantau metrik hos dan servis berdasarkan ambang yang anda tetapkan. Superlog menggunakan trace, log dan metrik yang dikeluarkan oleh aplikasi anda serta mengumpulkan kegagalan berulang menjadi insiden. Kekalkan probe uptime luaran bersamanya, kerana probe yang berjalan di tempat lain masih akan melaporkan apabila kotak yang menempatkan talian paip telemetri anda adalah perkara yang mati.

Bolehkah ejen Superlog mengubah sistem pengeluaran (production) saya?

Hanya melalui kebenaran yang anda berikan. Pelari komuniti lalai merekodkan ringkasan insiden tempatan; runtime penyiasatan lain bergantung pada pelari yang anda konfigurasikan. Pastikan kelayakan pengeluaran dihadkan kepada bacaan sahaja; membuka pull request memerlukan kebenaran tulis GitHub yang berasingan untuk cawangan dan pull request. Anggap akses tulis ke pengeluaran sebagai keputusan berasingan yang dibuat secara sengaja, kerana ejen yang boleh memulakan semula servis adalah komitmen yang jauh lebih besar daripada ejen yang membaca telemetri dan menulis patch untuk semakan.

Patutkah saya menyematkan (pin) commit atau menjejaki main?

Sematkan commit. Tiada tag keluaran dalam repositori setakat 13 Oktober 2026. Rekodkan SHA yang anda uji, gunakan versi tersebut, dan baca diff sebelum anda bergerak ke hadapan. git log --oneline <old-sha>..main adalah semakan, dan fail .env.example bagi setiap aplikasi adalah tempat pertama untuk melihat pemboleh ubah yang baru diperlukan selepas sebarang peningkatan versi.

Adakah artikel ini berguna?