View a markdown version of this page

Mengakses dan menggunakan log Pengembang Amazon Q - Amazon Q Developer
Ikhtisar akses logLog ekstensi IDELog Amazon Q CLIPola log umum dan solusiMendapatkan bantuan dengan analisis log

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Mengakses dan menggunakan log Pengembang Amazon Q

Amazon Q Developer 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

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

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

  • Command Line Interface (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, keluaran perintah, ID akun, 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 header panel obrolan

  3. Mengakui 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 otentikasi - Cari otentikasi atau kesalahan terkait kredensi

  • Konektivitas jaringan - Batas waktu koneksi atau kesalahan terkait jaringan

  • Feature-specific kesalahan - 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, sementara flag verbositas hanya mengontrol apa yang muncul di output terminal.

Lokasi dan file log Amazon Q CLI

Log Amazon Q CLI disimpan secara otomatis di lokasi berikut:

Sistem Operasi Lokasi Log
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 (HTTP/TLS koneksi, penanganan sertifikat)

  • Low-level operasi sistem (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

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

  • Application-level masalah migrasi

  • Gangguan interaksi pengguna dan kegagalan pemrosesan obrolan

  • Higher-level kesalahan logika aplikasi

mcp.log- Log server Protokol Konteks Model (diisi saat menggunakan server MCP)
translate.log- Bahasa alami ke log terjemahan shell (diisi saat menggunakan fitur terjemahan)

Perbedaan utama antara file log

Lingkup dan perbedaan 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: Internal AWS SDK, 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 mesin lokal Anda dan tidak dikirim ke AWS. Semua file log dibuat secara otomatis saat Anda pertama kali menggunakan CLI, bahkan tanpa flag verbose.

Alur kerja pemecahan masalah Amazon Q CLI

Ikuti pendekatan ini untuk mengumpulkan informasi diagnostik dari log.

  1. Identifikasi direktori log untuk sistem Anda:

    Pada 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. Mereproduksi 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:

    Pada 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 real-time selama pemecahan masalah, gunakan:

    Pantau semua file log secara bersamaan:

    tail -f $XDG_RUNTIME_DIR/qlog/*.log

    Memantau 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 pencatatan standar untuk mengkategorikan informasi berdasarkan kepentingan:

ERROR

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

WARN

Potensi masalah yang tidak menghentikan fungsionalitas tetapi harus diperhatikan

INFO

Pesan operasional umum tentang apa yang dilakukan aplikasi

DEBUG

Informasi teknis terperinci berguna untuk penyelidikan lebih dalam

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

qchat.loganalisis - Application-level masalah termasuk:

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

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

  • ERROR chat_cli: :telemetry - 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 gemerisik: :* - pembentukan TLS/SSL koneksi dan penanganan sertifikat

  • DEBUG hyper_* - Manajemen koneksi HTTP dan operasi jaringan

  • ERROR fig_telemetry - Telemetri sistem dan masalah koneksi soket

Kiat analisis umum:

  • Stempel waktu - Korelasikan entri log dengan kapan masalah terjadi

  • Pola kesalahan - Cari kesalahan berulang atau kaskade kesalahan

  • ID Per mintaan - 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 log umum dan solusi

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

Kesalahan koneksi server MCP

Pola log (di qchat.log): “Utas mendengarkan latar belakang untuk klien [nama-server]: RecvError (Ditutup)” atau “Semua pengirim dijatuhkan untuk lapisan transportasi”

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

Gangguan pemrosesan obrolan

Pola log (di qchat.log): “Terjadi kesalahan saat memproses status saat ini ERR=terputus {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 (di qchat.log): “Gagal mengirim peristiwa telemetri cw err= ValidationError [ValidationException]: Permintaan yang dibentuk dengan tidak 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 terkait dengan migrasi konfigurasi dan biasanya dapat diabaikan.

Kegagalan otentikasi

Pola log (di chat.log): Authentication-related kesalahan dalam operasi AWS SDK

Solusi: J alankan q login untuk mengotentikasi ulang atau memeriksa kredenSIAL AWS Anda

Masalah konektivitas jaringan

Pola log (di chat.log): “Waktu habis koneksi”, “Jaringan tidak dapat dijangkau”, atau koneksi HTTP gagal

Solusi: Periksa koneksi internet dan pengaturan firewall Anda

Kegagalan operasi AWS SDK

Pola log (di chat.log): Operasi Identitas Cognito Gagal atau kesalahan pengambilan kredensi

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

Mendapatkan bantuan dengan analisis log

Jika Anda memerlukan bantuan 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