Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memecahkan masalah AWS Toolkit for Visual Studio
Bagian berikut berisi informasi pemecahan masalah umum tentang AWS Toolkit for Visual Studio dan bekerja dengan AWS layanan dari toolkit.
**catatan**
Informasi set-up-specific penginstalan dan pemecahan masalah tersedia di topik [Masalah penginstalan Pemecahan Masalah](https://docs.aws.amazon.com//toolkit-for-visual-studio/latest/user-guide/setup-troubleshoot.html), yang terdapat di Panduan Pengguna ini.
**Topics**
+ [Memecahkan masalah praktik terbaik](#general-troubleshoot-best-practice)
+ [Melihat dan memfilter pemindaian keamanan Amazon Q](#general-troubleshoot-Q-securityscan)
+ [AWS Toolkit tidak diinstal dengan benar](#general-troubleshoot-component-initilization)
+ [Pengaturan firewall dan proxy](#general-troubleshoot-firewall)
## Memecahkan masalah praktik terbaik
Berikut ini adalah praktik terbaik yang disarankan saat memecahkan masalah AWS Toolkit for Visual Studio .
+ Perbaiki Visual Studio dan restart sistem Anda
+ Cobalah untuk membuat ulang masalah atau kesalahan Anda sebelum mengirim laporan.
+ Buat catatan rinci dari setiap langkah, pengaturan, dan pesan kesalahan selama proses rekreasi.
+ Kumpulkan AWS Log Toolkit. Untuk penjelasan rinci tentang cara menemukan log AWS Toolkit Anda, lihat prosedur [Cara menemukan AWS log Anda](#general-troubleshoot-procedure-logs), yang terletak di topik panduan ini.
+ Periksa permintaan terbuka, solusi yang diketahui, atau laporkan masalah Anda yang belum terselesaikan di bagian [AWS Toolkit for Visual Studio Masalah](https://github.com/aws/aws-toolkit-visual-studio/issues) di AWS Toolkit for Visual Studio GitHub repositori.
**Perbaiki Visual Studio dan Restart sistem Anda**
1. Tutup semua instance Visual Studio yang sedang berjalan.
1. Dari menu mulai Windows, Luncurkan **Visual Studio Installer**.
1. Jalankan Perbaikan pada instalasi Visual Studio yang terpengaruh. Ini memungkinkan Visual Studio untuk membangun kembali indeks ekstensi yang diinstal.
1. Mulai ulang Windows sebelum meluncurkan kembali Visual Studio.
**Cara menemukan log AWS Toolkit Anda**
1. Dari menu utama Visual Studio, perluas **Ekstensi**.
1. Pilih **AWS Toolkit** untuk memperluas menu AWS Toolkit, lalu pilih **View Toolkit** Logs.
1. Saat folder log AWS Toolkit terbuka di Sistem Operasi Anda, urutkan file berdasarkan tanggal dan temukan file log apa pun yang berisi informasi yang relevan dengan masalah Anda saat ini.
## Melihat dan memfilter pemindaian keamanan Amazon Q
Untuk melihat pemindaian keamanan Amazon Q Anda di Visual Studio, buka **Daftar Kesalahan** Visual Studio dengan memperluas judul **Tampilan** di menu utama Visual Studio dan memilih **Daftar Kesalahan**.
Secara default, **Daftar Kesalahan** Visual Studio menampilkan semua peringatan dan kesalahan untuk basis kode Anda. Untuk memfilter temuan pemindaian keamanan Amazon Q Anda dari **Daftar Kesalahan** Visual Studio, buat filter dengan menyelesaikan prosedur berikut.
**catatan**
Temuan pemindaian keamanan Amazon Q hanya terlihat setelah pemindaian keamanan berjalan dan mendeteksi masalah.
Temuan pemindaian keamanan Amazon Q muncul sebagai peringatan di Visual Studio. Untuk melihat temuan pemindaian keamanan Amazon Q dari **Daftar Kesalahan** Anda, opsi **Peringatan** di judul **Daftar Kesalahan** harus dipilih.
1. Dari menu utama Visual Studio, perluas judul **Tampilan** dan pilih **Daftar Kesalahan** untuk membuka panel **Daftar Kesalahan**.
1. Dari panel **Daftar Kesalahan**, klik kanan baris header untuk membuka menu konteks.
1. Dari menu konteks, perluas **Tampilkan Kolom**, lalu pilih **Alat** di menu yang diperluas.
1. Kolom **Alat** ditambahkan ke **Daftar Kesalahan** Anda.
1. Dari header kolom **Alat**, pilih ikon **Filter** dan pilih Amazon Q untuk memfilter temuan pemindaian keamanan Amazon Q.
## AWS Toolkit tidak diinstal dengan benar
**Masalah:**
Dalam satu menit setelah memulai Visual Studio, pesan berikut muncul di panel output dan bilah info, masing-masing: AWS Toolkit for Visual Studio
`Some Toolkit components could not be initialized. Some functionality may not work during this IDE session.`
`The AWS Toolkit is not properly installed.`
**Solusi:**
Ada kemungkinan bahwa memperbarui atau menginstal ekstensi menyebabkan beberapa file cache internal Visual Studio pergi out-of-sync. Prosedur berikut menjelaskan cara membuat file-file ini dibangun kembali saat Anda meluncurkan Visual Studio berikutnya.
**catatan**
Ada kemungkinan bahwa solusi ini dapat mempengaruhi kustomisasi Visual Studio Anda. Setelah menyelesaikan prosedur ini, ekstensi AWS Toolkit harus terdaftar sebagai diinstal dan tidak lagi melaporkan pesan kesalahan. Jika Anda terus mengalami masalah ini setelah menyelesaikan langkah-langkah berikut, silakan lihat [Masalah \$1452](https://github.com/aws/aws-toolkit-visual-studio/issues/452) di AWS Toolkit for Visual Studio GitHub repositori untuk informasi tambahan.
1. Instal versi terbaru Visual Studio 2022.
**catatan**
Versi minimum yang diperlukan adalah 17.11.5.
1. Tutup semua instance Visual Studio yang sedang berjalan.
1. Dari Windows, buka **Prompt Perintah Pengembang** sebagai Administrator.
1. Dari **Developer Command Prompt**, jalankan perintah berikut:`devenv /updateconfiguration /resetExtensions`, lalu tunggu sampai perintah selesai.
1. Setelah perintah selesai, restart Visual Studio.
1. Di Visual Studio AWS ekstensi sekarang terdaftar sebagai diinstal dan tidak lagi melaporkan pesan kesalahan yang tercantum di bagian atas masalah ini.
## Pengaturan firewall dan proxy
### Memecahkan masalah firewall dan pengaturan proxy
Perangkat lunak pemindaian keamanan dapat mengganggu kemampuan Anda untuk mengunduh file dari server bahasa AWS Toolkit dengan menghapus file dari unduhan atau mencegah unduhan sama sekali.
Untuk memeriksa pengaturan firewall dan proxy Anda, navigasikan ke [https://aws-toolkit-language-servers.amazonaws.com/codewhisperer/0/manifest.json](https://aws-toolkit-language-servers.amazonaws.com/codewhisperer/0/manifest.json) dari browser internet yang diinstal pada sistem yang sama dengan instance Visual Studio Anda. Jika Anda mengalami kesalahan atau halaman tidak dapat dimuat, maka mungkin ada firewall atau filter proxy yang mencegah Anda menjangkau`aws-toolkit-language-servers.amazonaws.com`.
### Sertifikat kustom
AWS Toolkit for Visual Studio Menggunakan server bahasa yang berjalan pada runtime Node.js. Untuk informasi terperinci tentang cara memeriksa apakah jaringan Anda menggunakan sertifikat kustom, lihat [pengaturan Konfigurasi dan file kredensi dalam AWS CLI](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-files.html#cli-config-ca_bundle) topik di Panduan *AWS Command Line Interface*Pengguna untuk Versi 1.
Untuk mengonfigurasi pengaturan proxy Anda dan menentukan sertifikat, Anda harus mengonfigurasi variabel `HTTPS_PROXY` env Anda dan membuat Variabel Lingkungan Windows untuk `NODE_EXTRA_CA_CERTS` kunci `NODE_OPTIONS` dan.
Untuk mengonfigurasi variabel `HTTPS_PROXY` env Anda, selesaikan langkah-langkah berikut.
1. Dari menu utama Visual Studio, pilih **Tools**, lalu pilih **Options**.
1. Dari menu **Opsi**, perluas **AWS Toolkit**, lalu pilih **Proxy**.
1. Dari menu **Proxy**, tentukan **Host** dan **Port** Anda.
**catatan**
Untuk informasi tentang mengonfigurasi `HTTPS_PROXY` dari AWS CLI, lihat [Menggunakan proxy HTTP untuk AWS CLI topik di](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-proxy.html) Panduan *AWS Command Line Interface*Pengguna.
Buat Variabel Lingkungan Windows untuk kunci berikut.
+ `NODE_OPTIONS = --use-openssl-ca`
+ `NODE_EXTRA_CA_CERTS = Path/To/Corporate/Certs`
**catatan**
Untuk informasi selengkapnya tentang mengekstrak sertifikat akar perusahaan, lihat artikel [Ekspor sertifikat dengan kunci privatnya](https://learn.microsoft.com/en-us/windows-server/identity/ad-cs/export-certificate-private-key) di *learn.microsoft.com*. *Untuk informasi rinci tentang kunci Variabel Lingkungan Windows, lihat [dokumentasi Node.js v23.3.0](https://nodejs.org/api/cli.html#cli_node_extra_ca_certs_file) di nodejs.org.*
### Izinkan daftar dan langkah-langkah tambahan
Selain mengganggu server bahasa AWS Toolkit, pengaturan firewall dapat mencegah Amazon Q mengunggah ke Amazon S3 dan memanggil API layanan. Untuk meminimalkan potensi kesalahan ini, sebaiknya izinkan akses internet keluar pada **port 443 (HTTPS) untuk titik** akhir berikut:
+ `https://codewhisperer.us-east-1.amazonaws.com/`
+ `https://amazonq-code-transformation-us-east-1-c6160f047e0.s3.amazonaws.com/`
+ `https://aws-toolkit-language-servers.amazonaws.com/`
+ `https://q.us-east-1.amazonaws.com`
+ `https://client-telemetry.us-east-1.amazonaws.com`
+ `https://cognito-identity.us-east-1.amazonaws.com`
+ `https://oidc.us-east-1.amazonaws.com`
Untuk daftar titik akhir yang terperinci, lihat topik [Memperbarui firewall dan gateway untuk mengizinkan akses](https://docs.aws.amazon.com/toolkit-for-visual-studio/latest/user-guide/endpoints.html) dalam Panduan Pengguna ini. Untuk informasi terperinci tentang mengonfigurasi proxy perusahaan untuk Amazon Q, lihat topik [Mengonfigurasi proxy perusahaan di Amazon Q](https://docs.aws.amazon.com//amazonq/latest/qdeveloper-ug/firewall.html#corp-proxy) di *Panduan Pengguna Pengembang Amazon Q*. Jika Anda terus mengalami masalah firewall dan proxy, kumpulkan Log AWS Toolkit Anda dan hubungi AWS Toolkit for Visual Studio tim melalui bagian [AWS Toolkit for Visual Studio masalah](https://github.com/aws/aws-toolkit-visual-studio/issues) di AWS Toolkit for Visual Studio GitHub repositori. Untuk detail tentang mengumpulkan Log AWS Toolkit Anda, tinjau informasi di bagian **Pemecahan Masalah praktik terbaik** dari topik Panduan Pengguna ini.