

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

# `AWSSupport-TroubleshootWindowsPerformance`
<a name="awssupport-troubleshoot-windows-performance"></a>

 **Deskripsi** 

 Runbook `AWSSupport-TroubleshootWindowsPerformance` membantu memecahkan masalah performa yang sedang berlangsung di instans Windows Amazon Elastic Compute Cloud (Amazon EC2). Runbook menangkap log dari instance target dan menganalisis CPU, memori, disk, dan metrik kinerja jaringan. Secara opsional, otomatisasi dapat menangkap dump proses untuk membantu Anda menentukan potensi penyebab penurunan kinerja. Otomatisasi juga menangkap log peristiwa dan sistem dengan menggunakan [https://docs.aws.amazon.com//AWSEC2/latest/WindowsGuide/Windows-Server-EC2Rescue.html](https://docs.aws.amazon.com//AWSEC2/latest/WindowsGuide/Windows-Server-EC2Rescue.html)alat terbaru, jika Anda mengizinkan runbook ini untuk menginstalnya. 

 **Bagaimana cara kerjanya?** 

 Runbook melakukan langkah-langkah berikut: 
+ Memeriksa instans Amazon EC2 untuk prasyarat.
+ Menghasilkan log kinerja di disk root instans Amazon EC2 Windows
+ Menyimpan log yang ditangkap di folder `C:\ProgramData\Amazon\SSM\TroubleshootWindowsPerformance`
+ Jika bucket Amazon Simple Storage Service (Amazon S3) disediakan, dan peran asumsi otomatisasi memiliki izin yang diperlukan, log yang diambil akan diunggah ke bucket Amazon S3.
+ Menginstal `EC2Rescue` alat terbaru ke instans Windows Amazon EC2 untuk menangkap peristiwa dan log sistem jika Anda memilih untuk menginstalnya, tetapi tidak menganalisis dump proses dan log yang ditangkap oleh. `EC2Rescue`

**penting**  
Untuk menjalankan runbook ini, instans Windows Amazon EC2 harus dikelola oleh. AWS Systems Manager Untuk informasi selengkapnya, lihat [Mengapa instans Amazon EC2 saya tidak ditampilkan sebagai node terkelola](https://repost.aws/knowledge-center/systems-manager-ec2-instance-not-appear).
Untuk menjalankan runbook ini, instans Amazon EC2 Windows harus berjalan pada versi Windows 8.1/Windows Server 2012 R2 (6.3) atau yang lebih baru dengan 4.0 atau lebih baru PowerShell . Untuk informasi selengkapnya, lihat [Versi Sistem Operasi Windows](https://learn.microsoft.com/en-us/windows/win32/sysinfo/operating-system-version).
Untuk pembuatan log kinerja, setidaknya 10 GB ruang kosong pada perangkat root diperlukan. Jika disk root lebih besar dari 100 GB, ruang kosong harus lebih besar dari 10% dari ukuran disk. Jika Anda membuang proses selama eksekusi, ruang kosong harus lebih besar dari 10 GB ditambah ukuran memori total yang dikonsumsi oleh proses ketika proses mengkonsumsi lebih dari 10 GB memori.
Log yang dihasilkan pada perangkat root tidak dihapus secara otomatis.
Runbook tidak menghapus alat. `EC2Rescue` Untuk informasi selengkapnya, lihat [Menggunakan `EC2Rescue` untuk Windows Server](https://docs.aws.amazon.com//AWSEC2/latest/WindowsGuide/Windows-Server-EC2Rescue.html).
Ini adalah praktik terbaik untuk menjalankan otomatisasi ini selama dampak kinerja. Anda juga dapat menjalankannya secara berkala menggunakan asosiasi AWS Systems Manager State Manager atau dengan menjadwalkan AWS Systems Manager Pemeliharaan Windows.

 [Jalankan Otomasi ini (konsol)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-TroubleshootWindowsPerformance) 

**Jenis dokumen**

Otomatisasi

**Pemilik**

Amazon

**Platform**

Windows

**Parameter**

**Izin IAM yang diperlukan**

`AutomationAssumeRole`Parameter memerlukan tindakan berikut untuk menggunakan runbook dengan sukses.
+ `ec2:DescribeInstances`
+ `ssm:DescribeAutomationExecutions`
+ `ssm:DescribeInstanceInformation`
+ `ssm:GetAutomationExecution`
+ `ssm:ListCommands`
+ `ssm:ListCommandInvocations`
+ `ssm:SendCommand`
+ `s3:ListBucket`
+ `s3:GetEncryptionConfiguration`
+ `s3:GetBucketPublicAccessBlock`
+ `s3:GetBucketPolicyStatus`
+ `s3:PutObject`
+ `s3:GetBucketAcl`
+ `s3:GetAccountPublicAccessBlock`

 *(Opsional) Peran IAM yang dilampirkan pada profil instans atau pengguna IAM yang dikonfigurasi pada instance memerlukan tindakan berikut untuk mengunggah log ke bucket Amazon S3 yang ditentukan untuk parameter: `LogUploadBucketName`* 
+ `s3:PutObject`
+ `s3:GetObject`
+ `s3:ListBucket`

 **Instruksi** 

Ikuti langkah-langkah ini untuk mengonfigurasi otomatisasi:

1. Arahkan ke [https://console.aws.amazon.com/systems-manager/documents/AWSSupport-TroubleshootWindowsPerformance/description](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-TroubleshootWindowsPerformance/description)Systems Manager di bawah Documents.

1. Pilih Jalankan otomatisasi.

1. Untuk parameter input, masukkan yang berikut ini:
   + **AutomationAssumeRole (Opsional):**

     Nama Sumber Daya Amazon (ARN) dari peran AWS AWS Identity and Access Management (IAM) yang memungkinkan Otomasi Systems Manager untuk melakukan tindakan atas nama Anda. Jika tidak ada peran yang ditentukan, Systems Manager Automation menggunakan izin pengguna yang memulai runbook ini.
   + **InstanceId (Diperlukan):**

     ID instans Windows Amazon EC2 target tempat Anda ingin menjalankan otomatisasi. Instans harus dikelola oleh Systems Manager untuk menjalankan otomatisasi.
   + **CaptureProcessDump (Opsional):**

     Jenis dump proses untuk menangkap. Otomatisasi dapat menangkap satu proses dump untuk proses yang berpotensi menyebabkan dampak kinerja di awal otomatisasi. Volume root instance membutuhkan setidaknya 10 GB ruang kosong (lebih besar dari 10% dari ukuran disk ketika ukuran volume root lebih besar dari 100 GB, dan 10 GB ditambah ukuran memori total yang dikonsumsi oleh proses ketika proses mengkonsumsi lebih dari 10 GB memori).
   + **LogCaptureDuration (Opsional):**

     Jumlah menit, antara `1` dan`15`, otomatisasi ini akan menangkap log saat masalah ada. Default-nya adalah `5`.
   + **LogUploadBucketName (Opsional):**

     Bucket Amazon S3 di akun Anda tempat Anda ingin mengunggah log. Bucket harus dikonfigurasi dengan enkripsi sisi server (SSE), dan kebijakan bucket tidak boleh memberikan read/write izin yang tidak perlu kepada pihak yang tidak memerlukan akses ke log yang diambil. Instans Windows Amazon EC2 harus memiliki akses ke bucket Amazon S3.
   + **Instal EC2 RescueTool (Opsional):**

     Setel `Yes` untuk memungkinkan runbook menginstal versi terbaru `EC2Rescue` alat untuk menangkap Windows Events dan log Sistem. Default-nya adalah `No`.
   + **Pengakuan (Diperlukan):**

     Baca detail lengkap tindakan yang dilakukan oleh runbook otomatisasi ini dan jika Anda setuju, ketik`Yes, I understand and acknowledge`.  
![\[Input parameters form for troubleshooting Amazon EC2 Windows instance performance issues.\]](http://docs.aws.amazon.com/id_id/systems-manager-automation-runbooks/latest/userguide/images/awssupport-troubleshoot-windows-performance_input_parameters.png)

1. Pilih Jalankan.

1. Otomatisasi dimulai.

1. Dokumen melakukan langkah-langkah berikut:
   + **`CheckConcurrency:`**

     Memastikan bahwa hanya ada satu eksekusi runbook ini yang menargetkan instance. Jika runbook menemukan eksekusi lain yang menargetkan instance yang sama, ia mengembalikan kesalahan dan berakhir.
   + **`AssertInstanceIsWindows:`**

     Menegaskan bahwa instans Amazon EC2 berjalan pada Sistem Operasi Windows. Jika tidak, otomatisasi berakhir.
   + **`AssertInstanceIsManagedInstance:`**

     Menegaskan bahwa instans Amazon EC2 dikelola oleh. AWS Systems Manager Jika tidak, otomatisasi berakhir.
   + **`VerifyPrerequisites:`**

     Memverifikasi PowerShell versi pada OS instance dan memastikan bahwa instance dapat dihubungkan melalui Systems Manager untuk menjalankan PowerShell perintah. Otomatisasi ini mendukung PowerShell 4.0 dan di atasnya berjalan pada versi Windows 8.1/Server 2012 R2 (6.3) atau yang lebih baru. Jika versinya lebih tua, otomatisasi gagal. Saat Anda memilih untuk mengunggah log ke bucket Amazon S3, otomatisasi ini Memeriksa apakah AWS Alat untuk PowerShell modul tersedia. Jika tidak, otomatisasi berakhir.
   + **`BranchOnProcessDump:`**

     Cabang berdasarkan jika Anda mengaturnya untuk menangkap dump proses yang memengaruhi kinerja.
   + **`CaptureProcessDump:`**

     Memeriksa apakah instance memiliki cukup ruang untuk menjalankan otomatisasi ini (saat Anda memilih CPU/Memori Tertinggi).
   + **`CapturePerformanceLogs:`**

     Memeriksa ruang disk lagi dan menjalankan PowerShell skrip pada instance untuk membuat penghitung perfmon dan memulai Performance Monitor dan Windows Performance Recorder logging. Skrip berhenti setelah yang `LogCaptureDuration` ditentukan terpenuhi.
   + **`SummarizePerformanceLogs:`**

     Merangkum laporan XHTML yang dihasilkan pada langkah sebelumnya,`CapturePerformanceLogs`, untuk menemukan proses yang bertanggung jawab mengkonsumsi paling banyak WorkingSet 64 (Memori) dan% Processor Time (CPU) ditampilkan sebagai output pada otomatisasi. Ini menghasilkan informasi serupa untuk penggunaan LogicalDisk, Antarmuka Jaringan, Memori TCPv4 IPv4,,, UDPv4 dan menyimpannya ke `analysis_output.log` dalam folder output.
   + **`BranchOnInstallEC2Rescue:`**

     Cabang jika Anda mengaturnya untuk menginstal `EC2Rescue` alat terbaru di instans Amazon EC2. 
   + **`InstallEC2RescueTool:`**

     Menginstal `EC2Rescue` alat di OS instance untuk menangkap `EC2Rescue` log menggunakan`AWS-ConfigureAWSPackage`.
   + **`RunEC2RescueTool:`**

     Menjalankan `EC2Rescue` alat di OS instance untuk menangkap semua log yang dibutuhkan. `EC2Rescue`menangkap hanya log yang diperlukan untuk menghemat ruang.
   + **`BranchOnIfS3BucketProvided:`**

     Cabang berdasarkan masukan pengguna `LogUploadBucketName` untuk melihat apakah ada nama bucket yang tersedia untuk mengunggah log.
   + **`GetS3BucketPublicStatus:`**

     Menentukan apakah bucket Amazon S3 disediakan, dan jika demikian, mengonfirmasi bahwa bucket Amazon S3 tidak bersifat publik dan dikonfigurasi dengan SSE.
   + **`UploadLogResult:`**

     Mengunggah log ke bucket Amazon S3 yang disediakan. Jika PowerShell versi 5.0 atau lebih tinggi, itu memampatkan log ke arsip ZIP dan mengunggahnya. Ini menghapus file ZIP setelah upload selesai. Jika PowerShell versi di bawah 5.0, itu mengunggah file langsung ke folder.
   + **`CleanUpLogsOnFailure:`**

     Membersihkan semua log yang dihasilkan oleh `CapturePerformanceLogs` langkah ketika gagal. `CleanUpLogsOnFailure`Langkah ini mungkin gagal atau batas waktu jika Agen SSM tidak berfungsi dengan benar, atau sistem Windows tidak responsif.

1. Setelah selesai, tinjau bagian Output untuk hasil eksekusi yang terperinci:

   Eksekusi dimana instance target memiliki semua prasyarat yang diperlukan.  
![\[Output logs showing performance capture process, EC2Rescue completion, and top CPU/memory usage processes.\]](http://docs.aws.amazon.com/id_id/systems-manager-automation-runbooks/latest/userguide/images/awssupport-troubleshoot-windows-performance_outputs_all_prerequisites_met.png)

   Eksekusi dimana instance target berada di platform Linux dan eksekusi gagal. Anda akan memilih ID langkah untuk melihat detail kegagalan.  
![\[Execution status showing failed overall status with 2 executed steps, 1 succeeded and 1 failed.\]](http://docs.aws.amazon.com/id_id/systems-manager-automation-runbooks/latest/userguide/images/awssupport-troubleshoot-windows-performance_outputs_failed_linux_instance.png)

   Rincian kegagalan langkah`AssertInstanceIsWindows`.  
![\[Failure details showing verification error for Linux property value instead of Windows.\]](http://docs.aws.amazon.com/id_id/systems-manager-automation-runbooks/latest/userguide/images/awssupport-troubleshoot-windows-performance_outputs_assert_windows_fail.png)

 **Referensi** 

Otomatisasi Systems Manager
+ [Jalankan Otomasi ini (konsol)](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-TroubleshootWindowsPerformance/description)
+ [Jalankan otomatisasi](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-working-executing.html)
+ [Menyiapkan Otomasi](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-setup.html)
+ [Support Automation Workflow landing page](https://aws.amazon.com/premiumsupport/technology/saw/)