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
<a name="troubleshooting-q-logs"></a>

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-access-overview)
+ [Log Ekstensi IDE](#ide-logs)
+ [Log Amazon Q CLI](#cli-logs)
+ [Pola dan Solusi Log Umum](#common-log-patterns)
+ [Mendapatkan Bantuan dengan Analisis Log](#getting-help-with-logs)

## Ikhtisar akses log
<a name="log-access-overview"></a>

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
<a name="ide-logs"></a>

### Mengakses log melalui antarmuka IDE
<a name="ide-logs-ui"></a>

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

1. Klik tombol **Tampilkan Log** di pojok kanan atas panel obrolan

1. Akui peringatan sensitivitas yang muncul

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

### Menganalisis log ekstensi IDE
<a name="ide-logs-analysis"></a>

Saat meninjau log ekstensi IDE, cari:
+ **Pesan kesalahan** - Baris yang berisi “ERROR” atau “FATAL” menunjukkan masalah kritis
+ **Masalah otentikasi** - Cari otentikasi atau kesalahan terkait kredensyal
+ **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
<a name="cli-logs"></a>

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
<a name="cli-log-locations"></a>

Log Amazon Q CLI secara otomatis disimpan di lokasi berikut:


| Sistem Operasi | Log Lokasi | 
| --- | --- | 
| macOS | \$1TMPDIR/qlog/(biasanya/var/folders/.../qlog/) | 
| Linux/WSL | \$1XDG\$1RUNTIME\$1DIR/qlog/atau \$1TMPDIR/qlog/ atau /tmp/qlog/ | 
| Windows | %TEMP%\$1qlog\$1 | 

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
<a name="cli-log-file-differences"></a>

**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
<a name="cli-troubleshooting-workflow"></a>

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\
   ```

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

   ```
   q -vvv chat
   ```

1. Reproduksi masalah yang Anda alami

1. 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
   ```

1. 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
<a name="cli-log-analysis"></a>

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

WARN  
Potensi masalah yang tidak menghentikan fungsionalitas tetapi harus diperhatikan

INFO  
Pesan operasional umum tentang apa yang dilakukan aplikasi

DEBUG  
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.log`analisis - Masalah tingkat aplikasi termasuk:  
+ **ERROR chat\$1cli: :cli: :chat - Pemrosesan obrolan** dan kesalahan manajemen negara
+ **ERROR chat\$1cli: :cli: :agent** - Migrasi dan masalah terkait agen
+ **ERROR chat\$1cli: :telemetri - Validasi telemetri** dan kegagalan transmisi

`chat.log`analisis - Rincian operasional runtime termasuk:  
+ **DEBUG q\$1cli: :cli - Eksekusi dan inisialisasi perintah Amazon** Q CLI
+ **DEBUG aws\$1sdk\$1\$1 - Operasi AWS SDK** dan panggilan layanan
+ **DEBUG rustls: :\$1** - pembentukan TLS/SSL koneksi dan penanganan sertifikat
+ **DEBUG hyper\$1\$1** - Manajemen koneksi HTTP dan operasi jaringan
+ **ERROR fig\$1telemetry - 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 seperti**grep**,**awk**, atau editor teks dengan fungsi pencarian untuk memfilter log untuk pesan atau pola kesalahan tertentu. Misalnya: **grep -i error \$1XDG\$1RUNTIME\$1DIR/qlog/\$1.log**

## Pola dan solusi log umum
<a name="common-log-patterns"></a>

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 \$1tool\$1uses: None\$1”  
**Solusi:** Ini terjadi ketika operasi obrolan dibatalkan oleh pengguna (misalnya, Ctrl\$1C) 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 kredensyal 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 Anda

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
<a name="getting-help-with-logs"></a>

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