Glosarium observabilitas dan istilah LogBrew

LogBrew memakai satu istilah untuk setiap konsep produk. Kolom API, flag CLI, nilai enum, nama peristiwa, dan kunci atribut tetap sama di setiap bahasa.

Observabilitas dan pemantauan

Istilah	Arti
Observabilitas	Memahami perilaku aplikasi dari bukti yang dihasilkannya.
Telemetri	Sinyal yang dilaporkan aplikasi, seperti log, trace, dan metrik.
Pemantauan	Memeriksa kondisi yang sudah diketahui, misalnya nilai terukur terhadap ambang batas.
`o11y`	Singkatan dari kata Inggris observability. Angkanya menghitung 11 huruf di antara `o` dan `y`.

Untuk pemilihan sinyal dan contoh lengkap, baca Telemetri.

Agen AI

Istilah	Arti
Server MCP	Server LogBrew yang di-host untuk Model Context Protocol. Agen AI memakainya untuk membaca proyek yang disetujui.
Klien MCP	Aplikasi yang menghubungkan agen AI ke server MCP, misalnya Claude Code.
Proyek yang disetujui	Proyek yang Anda pilih saat memberi akses kepada klien MCP. Klien hanya dapat membaca proyek yang disetujui.
Koneksi	Akses yang Anda berikan kepada 1 klien MCP saat menyetujuinya. Koneksi berakhir setelah 30 hari tidak dipakai, setelah 90 hari, atau saat Anda mencabutnya. CLI menyebutnya “grant”.

Untuk menghubungkan klien, baca Hubungkan agen AI dengan MCP.

Sinyal observabilitas

Masalah

Kendala terkelompok yang dapat berisi beberapa kemunculan. Kemunculan adalah satu kejadian terekam dari masalah tersebut. first_seen_at adalah waktu kemunculan pertama. last_seen_at adalah waktu kemunculan terbaru.

Log

Satu catatan peristiwa yang memiliki stempel waktu. Log dapat membawa tingkat keparahan, layanan, rilis, lingkungan, konteks trace, dan atribut yang dibatasi demi privasi.

Trace dan span

Trace mengikuti pekerjaan di sepanjang satu permintaan atau operasi. Span adalah satu operasi yang diukur waktunya di dalam trace tersebut. Korelasi ke trace adalah bukti adanya konteks bersama, bukan bukti penyebab.

Metrik

Pengukuran runtime dengan satuan, tipe, agregasi, dan rentang waktu yang ditentukan. Titik metrik tidak dapat dipertukarkan dengan jumlah log, trace, atau masalah.

Rilis

Versi aplikasi atau layanan yang di-deploy dan dilaporkan bersama telemetri. Rilis bukan objek yang sama dengan proyek atau repositori.

Aksi

Peristiwa produk yang diklasifikasikan, misalnya pendaftaran, checkout, impor, atau job yang gagal. Analitik mengklasifikasikan aksi sebagai tayangan halaman, tayangan layar, atau interaksi. Aksi bukan perintah otomatis yang dijalankan LogBrew.

Investigasi masalah

Tidak setiap kemunculan berisi semua kolom.

Istilah	Arti
Tingkat keparahan	Tingkat urgensi sinyal: `info`, `warning`, `error`, atau `critical`. Terpisah dari status masalah.
Status masalah	Status alur kerja dari masalah terkelompok: `unresolved`, `resolved`, atau `archived`. Bukan hasil dari satu permintaan.
Masalah yang diarsipkan	Masalah yang dikeluarkan tim dari triase aktif. Respons versi lama menyebut status ini `ignored`.
Prioritas masalah	Urutan triase dari masalah terkelompok: `high`, `medium`, atau `low`. Prioritas mengikuti tingkat keparahan sampai seseorang menetapkannya.
Sumber prioritas	Asal prioritas. `derived` mengikuti tingkat keparahan: `error` dan `critical` menjadi `high`, `warning` menjadi `medium`, dan `info` menjadi `low`. `manual` adalah prioritas yang ditetapkan seseorang.
Penanggung jawab masalah	1 akun atau 1 tim yang bertanggung jawab atas langkah berikutnya pada masalah terkelompok. Akun harus dapat membaca proyek. Tim harus termasuk dalam organisasi proyek.
Tim	Kelompok anggota dalam sebuah organisasi yang punya nama. Masalah bisa ditugaskan ke tim, dan aturan kepemilikan bisa menyebut tim. Tim tidak memberi anggotanya akses ke proyek.
Aturan kepemilikan	Aturan proyek yang menghubungkan path stack frame, modul, rute, layanan, atau tag dengan akun atau tim pemilik masalah yang cocok.
Usulan pemilik	Akun atau tim yang diusulkan LogBrew untuk sebuah masalah, berdasarkan aturan kepemilikan, baris di CODEOWNERS, atau aktivitas terbaru. Ini hanya usulan, bukan penugasan.
Kotak masuk	Daftar masalah yang ditugaskan orang lain kepada Anda atau tim Anda. LogBrew tidak mengirim email untuk daftar ini.
Stack trace	Bukti panggilan fungsi yang terekam untuk sebuah error. Berbeda dari trace terdistribusi.
Stack frame	Satu entri dalam stack trace. Entri ini dapat menunjukkan fungsi, modul, file, baris, atau kolom.
Rantai exception	Exception yang saling terhubung dan dilaporkan bersama, misalnya error dan penyebabnya. Entri yang tidak terekam, disamarkan, atau dipotong membatasi bukti.
Frame aplikasi	Stack frame yang ditandai sebagai kode aplikasi. Frame ini menunjukkan kode yang perlu diperiksa. Frame ini tidak membuktikan letak kesalahannya.
Breadcrumb	Peristiwa singkat yang tercatat sebelum kemunculan masalah. Breadcrumb bukan rekaman lengkap dari sebuah sesi.
Exception yang ditangani	Exception yang dilaporkan aplikasi sebagai sudah ditangani. Ini tidak membuktikan bahwa operasinya berhasil.
Source map	Artefak build yang memetakan lokasi di JavaScript hasil build ke lokasi sumber asli.
Frame yang sudah disimbolkan	Frame yang lokasi hasil build-nya sudah dipetakan ke informasi sumber asli.
Kemunculan acuan	Kemunculan terekam yang dipakai sebagai acuan reproduksi.
Asal penilaian	Sumber sebuah penilaian. `backend_observed` berarti LogBrew mengamatinya. `application_reported` berarti aplikasi melaporkannya dan LogBrew tidak memverifikasinya.
Kesiapan reproduksi	Apakah kemunculan acuan memiliki bukti yang diperlukan untuk mencoba reproduksi. Ini bukan uji reproduksi yang sudah lolos.

Gunakan panduan Investigasi masalah untuk urutan membaca dan kolom respons.

Identitas dan korelasi

Nilai yang tidak terekam tidak membuktikan bahwa aktivitas terkait tidak terjadi.

Istilah	Arti
Konteks trace	ID trace dan ID span yang menghubungkan pekerjaan di berbagai sinyal.
Root span	Span yang memulai trace dan tidak memiliki parent span. Span paling awal yang dikembalikan belum tentu root.
Child span	Span yang memiliki parent span di trace yang sama.
Korelasi	Hubungan persis yang dikembalikan LogBrew, misalnya ID trace yang sama. Korelasi tidak membuktikan penyebab.
Pengguna teridentifikasi	Subjek dari aplikasi dengan ID stabil dan jenis `user`.
Subjek anonim	Subjek dari aplikasi dengan jenis `anonymous`. Penghitungan memisahkannya dari pengguna teridentifikasi.
Jenis identitas tidak dikenal	Subjek tanpa jenis yang dikenal. Subjek ini tidak dihitung sebagai pengguna teridentifikasi.
Subjek tidak terekam	Peristiwa tanpa subjek. Ini berbeda dari subjek dengan jenis yang tidak dikenal.

Jenis identitas menunjukkan cara aplikasi mengklasifikasikan subjeknya. Jenis ini tidak membuktikan bahwa datanya anonim. ID yang stabil tetap dapat menghubungkan aktivitas.

Lingkup dan kualitas data

Istilah	Arti
Proyek	Batas produk utama yang dimiliki. Satu proyek dapat berisi beberapa layanan atau komponen repositori.
Layanan	Runtime atau komponen pelapor di dalam proyek.
Lingkungan	Konteks pelaporan yang persis, misalnya produksi atau staging.
Di-ingest	Diterima oleh kontrak ingest. Tidak menjanjikan penyimpanan tanpa batas waktu.
Diindeks	Tersedia untuk indeks atau kueri tertentu. Bukan sinonim dari di-ingest.
Tersimpan	Ada di dalam rentang waktu data yang dievaluasi.
Disampel	Sebagian telemetri dipilih sebelum atau selama pengumpulan.
Cakupan	Porsi terukur dengan pembilang dan penyebut yang eksplisit.
Dipotong	Respons mencapai batas. Data yang dihilangkan belum tentu tidak ada.
Perkiraan	Diestimasi dengan metode yang terdokumentasi, bukan dihitung secara persis.
Rentang waktu	Periode persis yang dievaluasi kueri.

Pengukuran dan waktu

Istilah	Arti
Titik data	Satu nilai pada waktu yang dilaporkan. Baca nama dan satuan metrik sebelum membandingkan titik data.
Deret waktu	Nilai dari pengukuran yang sama, diurutkan menurut waktu. Celah tidak berarti nilainya nol.
Durasi	Waktu yang berlalu selama operasi. Berbeda dari waktu saat operasi terjadi.
Agregasi	Perhitungan yang ditentukan atas beberapa pengukuran, misalnya jumlah atau rata-rata.
Interval waktu	Satu interval dalam grafik atau hasil terkelompok. Awal dan akhirnya menentukan rentangnya.
Periode belum lengkap	Periode yang belum selesai. Ini bukan periode selesai dengan aktivitas nol.

Jangan menjumlahkan durasi child span yang tumpang-tindih untuk mendapatkan total waktu permintaan. Jangan membandingkan jumlah peristiwa dengan jumlah pengguna teridentifikasi.

Status bukti

Status berikut tidak dapat dipertukarkan:

Terekam: bukti ada.
Tidak terekam: bukti tidak direkam.
Disamarkan: bukti sengaja disembunyikan.
Dipotong: bukti melebihi batas respons atau batas perekaman.
Tidak tersedia: pembacaan tidak dapat menyediakan bukti.

Likely cause (kemungkinan penyebab) dan likely fix area (kemungkinan area perbaikan) menggambarkan bukti diagnostik yang terbatas, bukan akar penyebab yang terbukti. Reported impact (dampak yang dilaporkan) berasal dari aplikasi pelapor, kecuali jika sebuah kontrak secara eksplisit menyebutnya sebagai pengukuran LogBrew.

Analitik produk

Istilah	Arti
Peristiwa	Aktivitas produk yang diklasifikasikan dengan nama stabil yang persis.
Properti	Kunci konteks yang dipakai untuk menjelaskan atau memfilter peristiwa.
Sesi	Kunjungan atau sesi aplikasi, bukan orang.
Kohort	Kelompok pengguna terbatas yang ditentukan dengan kriteria persis.
Funnel	Langkah berurutan untuk mengukur kemajuan atau konversi.
Retensi	Perilaku kembali yang diukur dengan periode dan penyebut yang eksplisit.
Jalur	Perjalanan sesi sebelum atau sesudah peristiwa yang dipilih.
Siklus hidup	Mengelompokkan subjek teridentifikasi di setiap periode sebagai baru dalam riwayat yang diamati, tetap aktif, aktif kembali, atau tidak aktif.
Baru dalam riwayat yang diamati	Aktif tanpa peristiwa terpilih sebelumnya dalam rentang riwayat yang dibatasi. Ini tidak berarti pelanggan yang baru pertama kali.

Periode belum lengkap, identitas yang tidak terekam, perekaman properti yang tidak lengkap, pengambilan sampel, dan pemotongan membatasi arti hasil. LogBrew menampilkan batasan itu, bukan mengubahnya menjadi nol atau kepastian. Baca Analitik produk untuk aturan penghitungan. Gunakan Perekaman peristiwa produk untuk mengirim aktivitas yang diklasifikasikan dan identitas bertipe.

​Observabilitas dan pemantauan

​Agen AI

​Sinyal observabilitas

​Investigasi masalah

​Identitas dan korelasi

​Lingkup dan kualitas data

​Pengukuran dan waktu

​Status bukti

​Analitik produk