Log Terstruktur yang Dapat Dicari
Kirim log JSON dengan korelasi permintaan.
Log Terstruktur yang Dapat Dicari adalah pelajaran MCP Academy gratis di CoddyKit. Ini adalah pelajaran 2 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar MCP Academy, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus MCP Academy mencakup 4 pelajaran total.
Log yang Benar-Benar Dapat Digunakan
Log teks biasa mudah dibaca manusia, tetapi menyulitkan saat skalanya besar. Log terstruktur menyimpan setiap peristiwa sebagai data, sehingga mesin dapat memfilter dan mencarinya dengan cepat. 🔎
Mengapa JSON Unggul
Keluarkan setiap baris log sebagai objek JSON. Setiap bidang menjadi dapat dicari, sehingga Anda dapat membuat kueri berdasarkan tool, status, atau durasi tanpa mengandalkan penguraian teks yang rapuh.
Anatomi Peristiwa Log
Peristiwa yang baik memuat stempel waktu, tingkat, pesan, dan bidang konteks. Secara bersama-sama, semua itu memberi tahu Anda apa yang terjadi, kapan terjadinya, dan alasannya.
{"ts": "2026-01-01T10:00:00Z",
"level": "info",
"msg": "tool called",
"tool": "search"}Pilih Tingkat yang Tepat
Gunakan tingkat log dengan tujuan yang jelas: debug untuk detail, info untuk alur normal, peringatan untuk masalah, dan error untuk kegagalan. Tingkat memungkinkan Anda menambah atau mengurangi banyaknya informasi.
ID Korelasi
Berikan setiap permintaan ID korelasi yang unik dan bubuhkan ID tersebut pada setiap log yang dihasilkannya. Sekarang, satu pencarian dapat menampilkan keseluruhan cerita dari satu panggilan.
Buat ID
UUID cocok digunakan sebagai ID korelasi: UUID cukup unik sehingga hampir tidak mungkin bertabrakan antarpermintaan.
import uuid
request_id = str(uuid.uuid4())
print(request_id)Catat ke stderr, Bukan stdout
Melalui stdio, stdout membawa protokol MCP itu sendiri. Selalu kirim log ke stderr agar tidak pernah merusak pesan JSON-RPC.
Modul logging Python
Modul bawaan Python, logging, menyediakan tingkat dan pengelola secara langsung. Arahkan pengelola ke stderr dan Anda sudah menyelesaikan setengah pekerjaan.
import logging, sys
logging.basicConfig(stream=sys.stderr,
level=logging.INFO)
log = logging.getLogger("mcp")Tambahkan Bidang, Bukan String
Hindari memasukkan nilai ke dalam teks pesan. Teruskan nilai tersebut sebagai bidang tambahan agar setiap nilai tetap menjadi kolom pencarian tersendiri nantinya.
log.info("tool finished",
extra={"tool": "search",
"ms": 42})Jangan Pernah Mencatat Rahasia
Log berpindah dan disimpan, jadi samarkan token, kunci, dan data pribadi sebelum menulisnya. Rahasia yang bocor dalam log merupakan pelanggaran keamanan yang nyata. 🔒
Pertahankan Satu Baris untuk Setiap Peristiwa
Tulis satu objek JSON per baris. Format yang dibatasi baris ini diharapkan oleh pengirim log dan alat pencarian agar dapat memasukkan data dengan baik.
Pemeriksaan Singkat
Ada satu detail yang sering membuat banyak pembuat MCP keliru.
Rangkuman
Anda telah mempelajari cara mencatat log sebagai JSON yang dapat dicari: satu peristiwa per baris, tingkat yang berguna, ID korelasi, rahasia yang disamarkan, dan keluaran di stderr. 📋
Belajar Python dengan tutor AI — gratis
Tulis dan jalankan kode asli di browser kamu, dapatkan bantuan instan dari tutor AI 24/7, dan lanjutkan di mana kamu tinggalkan di web atau aplikasi.
- Kursus
- 30
- Pelajaran
- 120
Pertanyaan yang Sering Diajukan
Apakah pelajaran “Log Terstruktur yang Dapat Dicari” gratis?
Ya — teks lengkap “Log Terstruktur yang Dapat Dicari” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus MCP Academy, upgrade ke CoddyKit PRO. Kursus MCP Academy mencakup 4 pelajaran total.
Apa yang akan aku pelajari di “Log Terstruktur yang Dapat Dicari”?
Kirim log JSON dengan korelasi permintaan. Kamu berlatih MCP Academy dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.
Apakah aku perlu pengalaman untuk memulai MCP Academy?
Tidak diperlukan pengalaman sebelumnya. MCP Academy di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 2 dari 4.
Berapa lama pelajaran “Log Terstruktur yang Dapat Dicari” memakan waktu?
Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.
Bisakah aku menulis dan menjalankan kode dalam pelajaran MCP Academy ini?
Ya. Setiap pelajaran MCP Academy menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.
Semua pelajaran dalam kursus ini
- Hal yang Perlu Diukur pada Server
- Log Terstruktur yang Dapat Dicari
- Melacak Pemanggilan Alat dari Awal hingga Akhir
- Memberi Peringatan atas Kegagalan dan Penyalahgunaan