Mengakses dan menggunakan log Pengembang Amazon Q

Pengembang Amazon Q menghasilkan log terperinci yang dapat membantu Anda mendiagnosis dan menyelesaikan masalah. Panduan ini menunjukkan cara mengakses log untuk antarmuka Amazon Q yang berbeda dan mengonfigurasi level logging untuk mendapatkan informasi yang Anda butuhkan untuk pemecahan masalah.

Navigasi Cepat:

• Ikhtisar Akses Log

• Log Ekstensi IDE

• Log Amazon Q CLI

• Pola dan Solusi Log Umum

• Mendapatkan Bantuan dengan Analisis Log

Ikhtisar akses log

Ada dua cara utama untuk mengakses log Pengembang Amazon Q, tergantung pada bagaimana Anda menggunakan layanan ini:

• Ekstensi IDE - Kode VS dan JetBrains IDEs memiliki tombol “Tampilkan Log” untuk mengakses log khusus Amazon Q

• Antarmuka Baris Perintah (Amazon Q CLI) - Log disimpan secara lokal di direktori sementara dengan tingkat detail yang dapat dikonfigurasi

penting

File log mungkin berisi informasi sensitif dari percakapan dan interaksi Anda dengan Amazon Q, termasuk jalur file, cuplikan kode, output perintah, akun IDs, dan nama sumber daya. Berhati-hatilah saat berbagi file log dengan orang lain.

Log ekstensi IDE

Mengakses log melalui antarmuka IDE

1. Buka panel obrolan Amazon Q di IDE Anda (Kode VS atau JetBrains)

2. Klik tombol Tampilkan Log di pojok kanan atas panel obrolan

3. Akui peringatan sensitivitas yang muncul

4. Lokasi file log akan terbuka di pengelola file sistem Anda untuk ditinjau

Menganalisis log ekstensi IDE

Saat meninjau log ekstensi IDE, cari:

• Pesan kesalahan - Baris yang berisi “ERROR” atau “FATAL” menunjukkan masalah kritis

• Masalah autentikasi - Cari otentikasi atau kesalahan terkait kredensional

• Konektivitas jaringan - Batas waktu koneksi atau kesalahan terkait jaringan

• Kesalahan khusus fitur - Masalah yang terkait dengan saran kode, obrolan, atau fitur spesifik lainnya

Log Amazon Q CLI

Amazon Q CLI secara otomatis menghasilkan log komprehensif untuk semua operasi, terlepas dari pengaturan verbositas. Log selalu ditulis ke file, sedangkan tanda verbositas hanya mengontrol apa yang muncul di output terminal.

Lokasi dan file log Amazon Q CLI

Log Amazon Q CLI secara otomatis disimpan di lokasi berikut:

Sistem Operasi	Log Lokasi
macOS	$TMPDIR/qlog/(biasanya/var/folders/.../qlog/)
Linux/WSL	$XDG_RUNTIME_DIR/qlog/atau $TMPDIR/qlog/ atau /tmp/qlog/
Windows	%TEMP%\qlog\

Amazon Q CLI membuat beberapa file log khusus secara otomatis:

chat.log- Log pembungkus Amazon Q CLI utama termasuk:

• Inisialisasi Amazon Q CLI dan operasi startup

• Panggilan AWS SDK (Identitas Cognito, alur otentikasi)

• Operasi jaringan (koneksi HTTP/TLS, penanganan sertifikat)

• Operasi sistem tingkat rendah (telemetri, koneksi soket)

• Resolusi titik akhir layanan AWS dan pengumpulan koneksi

• Informasi debugging terperinci untuk komponen infrastruktur

qchat.log- Log khusus aplikasi obrolan termasuk:

• Kesalahan aplikasi obrolan dan masalah pemrosesan status

• MCP (Model Context Protocol) manajemen server dan kesalahan koneksi

• Masalah migrasi tingkat aplikasi

• Gangguan interaksi pengguna dan kegagalan pemrosesan obrolan

• Kesalahan logika aplikasi tingkat tinggi

mcp.log- Log server Model Context Protocol (diisi saat menggunakan server MCP)

translate.log- Bahasa alami ke log terjemahan shell (diisi saat menggunakan fitur terjemahan)

Perbedaan utama antara file log

Perbedaan ruang lingkup dan detail:

• chat.log: Pencatatan tingkat sistem komprehensif yang mencakup seluruh infrastruktur Q CLI

• qchat.log: Pencatatan tingkat aplikasi terfokus khusus untuk fungsionalitas obrolan

Perbedaan fokus konten:

• chat.log: AWS SDK internal, protokol jaringan, alur otentikasi, operasi sistem

• qchat.log: Logika obrolan, siklus hidup server MCP, masalah pengalaman pengguna, kesalahan aplikasi

catatan

File log disimpan hanya di komputer lokal Anda dan tidak dikirim ke AWS. Semua file log dibuat secara otomatis ketika Anda pertama kali menggunakan CLI, bahkan tanpa bendera verbose.

Alur kerja pemecahan masalah Amazon Q CLI

Ikuti pendekatan ini untuk mengumpulkan informasi diagnostik dari log.

1. Identifikasi direktori log untuk sistem Anda:

   Di Linux/WSL:

   echo $XDG_RUNTIME_DIR/qlog/

   Di macOS:

   echo $TMPDIR/qlog/

   Di Windows:

   echo %TEMP%\qlog\

2. Jalankan perintah Amazon Q CLI dengan verbositas maksimum untuk melihat output terperinci di terminal Anda:

   q -vvv chat

3. Reproduksi masalah yang Anda alami

4. Keluar dari Amazon Q CLI dan periksa file log yang relevan. Untuk sebagian besar masalah, periksa kedua file log utama:

   Di MacOS/Linux:

   less -r $XDG_RUNTIME_DIR/qlog/qchat.log
   less -r $XDG_RUNTIME_DIR/qlog/chat.log

   Alternatif di macOS:

   less -r $TMPDIR/qlog/qchat.log
   less -r $TMPDIR/qlog/chat.log

   Di Windows:

   type %TEMP%\qlog\qchat.log
   type %TEMP%\qlog\chat.log

5. Untuk pemantauan log waktu nyata selama pemecahan masalah, gunakan:

   Pantau semua file log secara bersamaan:

   tail -f $XDG_RUNTIME_DIR/qlog/*.log

   Pantau file tertentu:

   tail -f $XDG_RUNTIME_DIR/qlog/qchat.log

   tail -f $XDG_RUNTIME_DIR/qlog/chat.log

Menganalisis log Amazon Q CLI

Log Amazon Q CLI menggunakan tingkat logging standar untuk mengkategorikan informasi berdasarkan kepentingan:

ERROR

Masalah kritis yang mencegah operasi normal - mulai di sini saat pemecahan masalah

PERINGATAN

Potensi masalah yang tidak menghentikan fungsionalitas tetapi harus diperhatikan

INFO

Pesan operasional umum tentang apa yang dilakukan aplikasi

AWAKUTU

Informasi teknis terperinci yang berguna untuk penyelidikan lebih dalam

Saat memeriksa log Amazon Q CLI, fokuslah pada area utama ini di file log yang berbeda:

qchat.loganalisis - Masalah tingkat aplikasi termasuk:

• ERROR chat_cli: :cli: :chat - Pemrosesan obrolan dan kesalahan manajemen negara

• ERROR chat_cli: :cli: :agent - Migrasi dan masalah terkait agen

• ERROR chat_cli: :telemetri - Validasi telemetri dan kegagalan transmisi

chat.loganalisis - Rincian operasional runtime termasuk:

• DEBUG q_cli: :cli - Eksekusi dan inisialisasi perintah Amazon Q CLI

• DEBUG aws_sdk_* - Operasi AWS SDK dan panggilan layanan

• DEBUG rustls: :* - pembentukan TLS/SSL koneksi dan penanganan sertifikat

• DEBUG hyper_* - Manajemen koneksi HTTP dan operasi jaringan

• ERROR fig_telemetry - Masalah telemetri sistem dan koneksi soket

Kiat analisis umum:

• Stempel waktu - Korelasikan entri log dengan saat masalah terjadi

• Pola kesalahan - Cari kesalahan berulang atau kaskade kesalahan

• Permintaan IDs - Lacak panggilan API tertentu dan hasilnya

• Status koneksi - Memantau konektivitas jaringan dan status otentikasi

Tip

Gunakan alat sepertigrep,awk, atau editor teks dengan fungsi pencarian untuk memfilter log untuk pesan atau pola kesalahan tertentu. Misalnya: grep -i error $XDG_RUNTIME_DIR/qlog/*.log

Pola dan solusi log umum

Berikut adalah beberapa masalah umum yang mungkin Anda temukan di log dan solusi khasnya:

Kesalahan koneksi server MCP

Pola log (di qchat.log): “Thread mendengarkan latar belakang untuk klien [server-name]: RecvError (Closed)” atau “Semua pengirim dijatuhkan untuk lapisan transport”

Solusi: Proses server MCP telah berhenti berjalan. Ini biasanya perilaku yang diharapkan saat keluar dari Amazon Q CLI atau ketika server dimatikan secara normal.

Gangguan pemrosesan obrolan

Pola log (dalam qchat.log): “Terjadi kesalahan saat memproses status saat ini ERR=Interrupted {tool_uses: None}”

Solusi: Ini terjadi ketika operasi obrolan dibatalkan oleh pengguna (misalnya, Ctrl+C) dan merupakan perilaku yang diharapkan.

Kesalahan validasi telemetri

Pola log (dalam qchat.log): “Gagal mengirim acara telemetri cw err= ValidationError [ValidationException]: Permintaan yang tidak terbentuk dengan benar”

Solusi: Ini biasanya masalah transmisi telemetri non-kritis yang tidak memengaruhi fungsionalitas inti.

Peringatan migrasi

Pola log (di qchat.log): “Migrasi tidak terjadi karena alasan berikut: Membatalkan migrasi”

Solusi: Ini biasanya merupakan peringatan non-kritis yang terkait dengan migrasi konfigurasi dan biasanya dapat diabaikan.

Kegagalan otentikasi

Pola log (di chat.log): Kesalahan terkait otentikasi dalam operasi AWS SDK

Solusi: Jalankan q login untuk mengautentikasi ulang atau memeriksa kredensi AWS Anda

Masalah konektivitas jaringan

Pola log (dalam chat.log): “Batas waktu koneksi”, “Jaringan tidak dapat dijangkau”, atau koneksi HTTP yang gagal

Solusi: Periksa koneksi internet dan pengaturan firewall

Kegagalan operasi AWS SDK

Pola log (dalam chat.log): Operasi Identitas Cognito Gagal atau kesalahan pengambilan kredenal

Solusi: Periksa kredensi AWS dan konektivitas jaringan Anda. Mungkin memerlukan otentikasi ulang

Mendapatkan bantuan dengan analisis log

Jika Anda memerlukan bantuan untuk menganalisis log atau menyelesaikan masalah:

• Saat menghubungi dukungan, sertakan kutipan log yang relevan (dengan informasi sensitif dihapus)

• Berikan konteks tentang kapan masalah terjadi dan langkah-langkah untuk mereproduksinya