# Pemecahan Masalah Amazon Kinesis Agent for Microsoft Windows
<a name="troubleshooting-kinesis-agent-windows"></a>

Gunakan petunjuk berikut untuk mendiagnosis dan memperbaiki masalah saat menggunakan Amazon Kinesis Agent for Microsoft Windows.

**Topics**
+ [Tidak Ada Data yang Dialirkan dari Desktop atau Server ke Layanan AWS yang Diinginkan](#troubleshooting-no-data)
+ [Data yang Diharapkan Terkadang Hilang](#troubleshooting-missing-data)
+ [Data Tiba dalam Format yang Salah](#troubleshooting-bad-format)
+ [Masalah Performa](#troubleshooting-poor-performance)
+ [Ruang Disk Habis](#troubleshooting-out-of-disk-space)
+ [Alat Pemecahan Masalah](#troubleshooting-tools)

## Tidak Ada Data yang Dialirkan dari Desktop atau Server ke Layanan AWS yang Diinginkan
<a name="troubleshooting-no-data"></a>

### Symptoms
<a name="troubleshooting-no-data-symptoms"></a>

Ketika Anda memeriksa log, peristiwa, dan metrik yang dihosting oleh berbagai layanan AWS yang dikonfigurasi untuk menerima aliran data dari Kinesis Agent for Windows, tidak ada data yang dialirkan oleh Kinesis Agent for Windows.

### Causes
<a name="troubleshooting-no-data-causes"></a>

Ada beberapa kemungkinan penyebab masalah ini:
+ Sumber, sink, atau alur dikonfigurasi dengan tidak tepat.
+ Autentikasi untuk Kinesis Agent for Windows dikonfigurasi dengan tidak tepat.
+ Otorisasi untuk Kinesis Agent for Windows dikonfigurasi dengan tidak tepat.
+ Ada kesalahan dalam ekspresi reguler yang disediakan dalam deklarasi `DirectorySource`.
+ Direktori yang ditentukan untuk deklarasi `DirectorySource` tidak ada.
+ Layanan AWS diberi nilai yang tidak valid, sehingga permintaan dari Kinesis Agent for Windows ditolak.
+ Sink mereferensikan sumber daya yang tidak ada dalam Wilayah AWS yang ditentukan atau implisit.
+ Kueri yang dimasukkan untuk deklarasi `WindowsEventLogSource` tidak valid.
+ Nilai pasangan kunci-nilai `InitialPosition` yang dimasukkan untuk sumber tidak valid.
+ File konfigurasi `appsettings.json` tidak sesuai dengan skema JSON untuk file tersebut.
+ Data mengalir ke Wilayah yang berbeda dari yang dipilih di Konsol Manajemen AWS.
+ Kinesis Agent for Windows tidak diinstal dengan benar atau tidak berjalan.

### Resolutions
<a name="troubleshooting-no-data-resolutions"></a>

Untuk mengatasi masalah dengan data yang tidak mengalir, lakukan langkah-langkah berikut:

1. Periksa log Kinesis Agent for Windows di direktori `%PROGRAMDATA%\Amazon\AWSKinesisTap\logs`. Cari string `ERROR`.

   1. Jika sumber atau sink tidak bisa dimuat, lakukan hal berikut:

      1. Periksa pesan kesalahan, dan temukan `Id` sumber atau sink.

      1. Periksa deklarasi sumber atau sink yang sesuai dengan `Id` di file konfigurasi `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json` untuk setiap kesalahan yang berkaitan dengan pesan kesalahan yang ditemukan. Untuk rincian selengkapnya, lihat [Mengonfigurasi Amazon Kinesis Agent for Microsoft Windows](configuring-kinesis-agent-windows.md). 

      1. Perbaiki semua masalah file konfigurasi terkait kesalahan tersebut.

      1. Hentikan dan mulai layanan `AWSKinesisTap`. Kemudian periksa berkas log terbaru untuk memverifikasi bahwa masalah konfigurasi telah diselesaikan.

   1. Jika pesan kesalahan menunjukkan bahwa `SourceRef` atau `SinkRef` tidak ditemukan untuk sebuah alur, lakukan hal berikut:

      1. Catat `Id` alur.

      1. Periksa deklarasi alur di file konfigurasi `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json` yang sesuai dengan `Id` yang dicatat. Pastikan bahwa nilai `SourceRef` dan pasangan kunci-nilai `SinkRef` berisi `Id` untuk deklarasi sumber dan sink yang ingin Anda rujuk dan dieja dengan benar. Perbaiki semua kesalahan ketik atau ejaan. Jika deklarasi sumber atau sink hilang dari file konfigurasi, tambahkan deklarasi. Untuk informasi lebih lanjut, lihat [Mengonfigurasi Amazon Kinesis Agent for Microsoft Windows](configuring-kinesis-agent-windows.md).

      1. Hentikan dan mulai layanan `AWSKinesisTap`. Kemudian periksa berkas log terbaru untuk memverifikasi bahwa masalah konfigurasi telah diselesaikan.

   1. Jika pesan kesalahan menunjukkan bahwa pengguna atau peran IAM tertentu tidak berwenang untuk melakukan operasi tertentu, lakukan hal berikut:

      1. Pastikan bahwa Kinesis Agent for Windows menggunakan pengguna atau peran IAM yang benar. Jika pengguna atau peran salah, tinjau [Konfigurasi Keamanan Sink](sink-object-declarations.md#configuring-kinesis-agent-windows-sink-security-configuration), dan sesuaikan cara autentikasi Kinesis Agent for Windows untuk memastikan bahwa pengguna atau peran IAM yang digunakan sudah benar.

      1. Jika pengguna atau peran IAM yang digunakan benar, dengan menggunakan Konsol Manajemen AWS, periksa kebijakan yang terkait dengan pengguna atau peran tersebut. Pastikan bahwa pengguna atau peran tersebut memiliki semua izin yang disebutkan dalam pesan kesalahan untuk semua sumber daya AWS yang diakses Kinesis Agent for Windows. Untuk informasi lebih lanjut, lihat [Mengonfigurasi Otorisasi](sink-object-declarations.md#configuring-kinesis-agent-windows-authorization).

      1. Hentikan dan mulai layanan `AWSKinesisTap`. Kemudian periksa berkas log terbaru untuk memverifikasi bahwa masalah keamanan telah diselesaikan.

   1. Jika pesan kesalahan menunjukkan bahwa ada kesalahan argumen ketika mengurai ekspresi reguler yang terkandung dalam file konfigurasi `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json`, lakukan hal berikut:

      1. Periksa ekspresi reguler dalam file konfigurasi.

      1. Verifikasi sintaks dari ekspresi reguler. Ada beberapa situs web yang dapat Anda gunakan untuk memverifikasi ekspresi reguler, atau gunakan baris perintah berikut untuk memeriksa ekspresi reguler untuk deklarasi sumber `DirectorySource`:

         ```
         cd /D %PROGRAMFILES%\Amazon\AWSKinesisTap
         ktdiag.exe /r sourceId
         ```

         Ganti *sourceId* dengan nilai pasangan kunci-nilai `Id` deklarasi sumber `DirectorySource` dengan ekspresi reguler yang salah.

      1. Lakukan koreksi yang diperlukan pada ekspresi reguler dalam file konfigurasi supaya valid.

      1. Hentikan dan mulai layanan `AWSKinesisTap`. Kemudian periksa berkas log terbaru untuk memverifikasi bahwa masalah konfigurasi telah diselesaikan.

   1. Jika pesan kesalahan menunjukkan bahwa ada kesalahan argumen ketika mengurai ekspresi reguler yang tidak terkandung dalam file konfigurasi `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json`, dan ekspresi itu berkaitan dengan sink tertentu, lakukan hal berikut:

      1. Cari deklarasi sink dalam file konfigurasi.

      1. Verifikasi bahwa pasangan kunci-nilai yang secara khusus terkait dengan layanan AWS menggunakan nama yang sesuai dengan aturan validasi untuk layanan itu. Misalnya, nama grup CloudWatch Logs harus berisi hanya serangkaian karakter tertentu yang ditentukan menggunakan ekspresi reguler `[\.\-_/#A-Za-z0-9]+`.

      1. Perbaiki nama yang tidak valid dalam pasangan kunci-nilai untuk deklarasi sink, dan pastikan bahwa sumber daya tersebut dikonfigurasi dengan benar di AWS.

      1. Hentikan dan mulai layanan `AWSKinesisTap`. Kemudian periksa berkas log terbaru untuk memverifikasi bahwa masalah konfigurasi telah diselesaikan.

   1. Jika pesan kesalahan menunjukkan bahwa sumber atau sink tidak dapat dimuat karena parameter null atau hilang, lakukan hal berikut:

      1. Catat `Id` sumber atau sink.

      1. Cari deklarasi sumber atau sink yang cocok dengan `Id` yang dicatat dalam file konfigurasi `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json`.

      1. Tinjau pasangan kunci-nilai yang disediakan dalam deklarasi sumber atau sink yang dibandingkan dengan persyaratan tipe sumber atau sink dalam dokumentasi [Mengonfigurasi Amazon Kinesis Agent for Microsoft Windows](configuring-kinesis-agent-windows.md) untuk tipe sink yang relevan. Tambahkan pasangan kunci-nilai yang diperlukan tapi hilang ke deklarasi sumber atau sink.

      1. Hentikan dan mulai layanan `AWSKinesisTap`. Kemudian periksa berkas log terbaru untuk memverifikasi bahwa masalah konfigurasi telah diselesaikan.

   1. Jika pesan kesalahan menunjukkan bahwa nama direktori tidak valid, lakukan hal berikut:

      1. Cari nama direktori yang tidak valid di file konfigurasi `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json`.

      1. Verifikasi bahwa direktori ini ada dan berisi berkas log yang mestinya dialirkan.

      1. Perbaiki semua kesalahan ketik atau kesalahan dalam nama direktori yang disebutkan dalam file konfigurasi.

      1. Hentikan dan mulai layanan `AWSKinesisTap`. Kemudian periksa berkas log terbaru untuk memverifikasi bahwa masalah konfigurasi telah diselesaikan.

   1. Jika pesan kesalahan menunjukkan bahwa sumber daya tidak ada:

      1. Cari referensi sumber daya untuk sumber daya yang tidak ada dalam deklarasi sink di file konfigurasi `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json`.

      1. Gunakan Konsol Manajemen AWS untuk mencari sumber daya di Wilayah AWS benar yang mestinya digunakan dalam deklarasi sink. Bandingkan dengan yang disebutkan dalam file konfigurasi.

      1. Ubah deklarasi sink dalam file konfigurasi sehingga nama sumber daya Wilayahnya benar.

      1. Hentikan dan mulai layanan `AWSKinesisTap`. Kemudian periksa berkas log terbaru untuk memverifikasi bahwa masalah konfigurasi telah diselesaikan.

   1. Jika pesan kesalahan menunjukkan bahwa kueri tidak valid untuk `WindowsEventLogSource` tertentu, lakukan hal berikut:

      1. Di file konfigurasi `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json`, cari deklarasi `WindowsEventLogSource` dengan `Id` yang sama seperti dalam pesan kesalahan.

      1. Verifikasi bahwa nilai pasangan kunci-nilai `Query` dalam deklarasi sumber sesuai dengan [Kueri peristiwa dan XML peristiwa](https://msdn.microsoft.com/en-us/library/bb399427(v=vs.90).aspx). 

      1. Ubah kueri agar sesuai.

      1. Hentikan dan mulai layanan `AWSKinesisTap`. Kemudian periksa berkas log terbaru untuk memverifikasi bahwa masalah konfigurasi telah diselesaikan.

   1. Jika pesan kesalahan menunjukkan bahwa ada posisi awal yang tidak valid, lakukan hal berikut:

      1. Di file konfigurasi `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json`, cari deklarasi sumber dengan `Id` yang sama seperti dalam pesan kesalahan.

      1. Ubah nilai pasangan kunci-nilai `InitialPosition` dalam deklarasi sumber agar sesuai dengan nilai yang diizinkan, seperti yang dijelaskan dalam [Konfigurasi Bookmark](source-object-declarations.md#advanced-source-configuration).

      1. Hentikan dan mulai layanan `AWSKinesisTap`. Kemudian periksa berkas log terbaru untuk memverifikasi bahwa masalah konfigurasi telah diselesaikan.

1. Pastikan file konfigurasi `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json` sesuai dengan skema JSON. 

   1. Di jendela command prompt, jalankan baris berikut:

      ```
      cd /D %PROGRAMFILES%\Amazon\AWSKinesisTap
      %PROGRAMFILES%\Amazon\AWSKinesisTap\ktdiag.exe /c
      ```

   1. Perbaiki semua masalah yang terdeteksi dalam file konfigurasi `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json`.

   1. Hentikan dan mulai layanan `AWSKinesisTap`. Kemudian periksa berkas log terbaru untuk memverifikasi bahwa masalah konfigurasi telah diselesaikan.

1. Ubah tingkat pencatatan untuk mencoba mendapatkan informasi pencatatan yang lebih terperinci.

   1. Ganti file konfigurasi `%PROGRAMFILES%\Amazon\AWSKinesisTap\nlog.xml` dengan konten berikut:

      ```
      <?xml version="1.0" encoding="utf-8" ?>
      <nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xsi:schemaLocation="http://www.nlog-project.org/schemas/NLog.xsd NLog.xsd"
            autoReload="true"
            throwExceptions="false"
            internalLogLevel="Off" internalLogFile="c:\temp\nlog-internal.log" >
      
        <!-- 
        See https://github.com/nlog/nlog/wiki/Configuration-file 
        for information on customizing logging rules and outputs.
         -->
        <targets>
          <!-- 
          add your targets here 
          See https://github.com/nlog/NLog/wiki/Targets for possible targets.
          See https://github.com/nlog/NLog/wiki/Layout-Renderers for the possible layout renderers.
          -->
          
          <target name="logfile"
                  xsi:type="File"
                  layout="${longdate} ${logger} ${uppercase:${level}} ${message}"
                  fileName="${specialfolder:folder=CommonApplicationData}/Amazon/KinesisTap/logs/KinesisTap.log"
      	    maxArchiveFiles="90"
      	    archiveFileName="${specialfolder:folder=CommonApplicationData}/Amazon/KinesisTap/logs/Archive-{################}.log"
      	    archiveNumbering="Date"
      	    archiveDateFormat="yyyy-MM-dd"
      	    archiveEvery="Day"
      	    />
        </targets>
      
        <rules>
          <logger name="*" minlevel="Debug" writeTo="logfile" />
        </rules>
      </nlog>
      ```

   1. Hentikan dan mulai layanan `AWSKinesisTap`. Kemudian periksa berkas log terbaru untuk melihat apakah ada pesan tambahan di log yang dapat membantu mendiagnosis dan menyelesaikan masalah.

1. Verifikasi bahwa Anda melihat sumber daya di Wilayah yang benar di Konsol Manajemen AWS.

1. Verifikasi bahwa Kinesis Agent for Windows telah diinstal dan dijalankan.

   1. Di Windows, pilih **Start**, lalu masuk ke **Control Panel**, **Administrative Tools**, **Services**.

   1. Temukan layanan **AWSKinesisTap**.

   1. Jika layanan AWSKinesisTap tidak terlihat, instal Kinesis Agent for Windows menggunakan petunjuk di [Memulai dengan Amazon Kinesis Agent for Microsoft Windows](getting-started.md).

   1. Jika layanan tersebut terlihat, tentukan apakah layanan berjalan. Jika tidak berjalan, buka menu konteks (klik kanan) untuk layanan tersebut, dan pilih **Start**.

   1. Verifikasi bahwa layanan telah dijalankan dengan memeriksa berkas log terbaru dalam direktori `%PROGRAMDATA%\Amazon\AWSKinesisTap\logs`.

### Berlaku untuk
<a name="troubleshooting-no-data-applies-to"></a>

Informasi ini berlaku untuk Kinesis Agent for Windows versi 1.0.0.115 dan yang lebih baru.

## Data yang Diharapkan Terkadang Hilang
<a name="troubleshooting-missing-data"></a>

### Symptoms
<a name="troubleshooting-missing-data-symptoms"></a>

Kinesis Agent for Windows umumnya berhasil mengalirkan data, tetapi terkadang beberapa data hilang.

### Causes
<a name="troubleshooting-missing-data-casues"></a>

Ada beberapa kemungkinan penyebab masalah ini:
+ Fitur bookmark tidak sedang digunakan.
+ Batas laju data untuk layanan AWS terlampaui berdasarkan konfigurasi layanan tersebut saat ini.
+ Batas laju panggilan API untuk layanan AWS terlampaui berdasarkan file konfigurasi `appsettings.json` dan batas akun AWS saat ini.

### Resolutions
<a name="troubleshooting-missing-data-resolutions"></a>

Untuk mengatasi masalah data yang hilang, lakukan langkah berikut:

1. Pertimbangkan untuk menggunakan fitur bookmark yang didokumentasikan di [Konfigurasi Bookmark](source-object-declarations.md#advanced-source-configuration). Langkah ini membantu memastikan semua data akhirnya dikirim, bahkan ketika Kinesis Agent for Windows dihentikan dan dijalankan lagi.

1. Gunakan metrik bawaan Kinesis Agent for Windows untuk menemukan masalah:

   1. Aktifkan streaming metrik Kinesis Agent for Windows seperti yang dijelaskan di [Mengonfigurasi Alur Metrik Kinesis Agent for Windows](pipe-object-declarations.md#kinesis-agent-metric-pipe-configuration).

   1. Jika ada sejumlah besar kesalahan yang tidak dapat dipulihkan untuk satu atau beberapa sink, tentukan jumlah byte atau catatan yang dikirim per detik. Kemudian tentukan apakah angka ini berada dalam batas yang dikonfigurasi untuk layanan AWS di Wilayah dan akun di mana data sedang dialirkan.

   1. Ketika batas terlampaui, kurangi laju atau jumlah data yang dikirim, ajukan peningkatan batas, atau tingkatkan sharding jika berlaku.

   1. Setelah melakukan penyesuaian, terus pantau metrik bawaan Kinesis Agent for Windows untuk memastikan situasi telah teratasi.

Untuk informasi selengkapnya tentang batas Kinesis Data Streams, lihat [Batas Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/service-sizes-and-limits.html) dalam *Panduan Developer Kinesis Data Streams*. Untuk informasi selengkapnya tentang batas Kinesis Data Firehose, lihat [Batas Amazon Kinesis Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/limits.html).

### Berlaku untuk
<a name="troubleshooting-missing-data-applies-to"></a>

Informasi ini berlaku untuk Kinesis Agent for Windows versi 1.0.0.115 dan yang lebih baru.

## Data Tiba dalam Format yang Salah
<a name="troubleshooting-bad-format"></a>

### Symptoms
<a name="troubleshooting-bad-format-symptoms"></a>

Data tiba di layanan AWS dalam format yang salah.

### Causes
<a name="troubleshooting-bad-format-causes"></a>

Ada beberapa kemungkinan penyebab masalah ini:
+ Nilai untuk pasangan kunci-nilai `Format` untuk deklarasi sink di file konfigurasi `appsettings.json` tidak tepat.
+ Nilai untuk pasangan kunci-nilai `RecordParser` untuk deklarasi `DirectorySource` tidak tepat.
+ Ekspresi reguler dalam deklarasi `DirectorySource` yang menggunakan pengurai catatan `Regex` tidak tepat.

### Resolutions
<a name="troubleshooting-bad-format-resolutions"></a>

Untuk mengatasi masalah format yang salah, lakukan langkah berikut:

1. Cari deklarasi sink dalam file konfigurasi `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json`.

1. Pastikan bahwa nilai pasangan kunci-nilai `Format` yang benar ditentukan untuk setiap deklarasi sink. Untuk informasi lebih lanjut, lihat [Deklarasi Sink](sink-object-declarations.md).

1. Jika sumber dengan deklarasi `DirectorySource` dihubungkan oleh alur ke sink yang menggunakan nilai `xml` atau `json` untuk pasangan kunci-nilai `Format`, pastikan bahwa sumber tersebut menggunakan salah satu nilai berikut untuk pasangan kunci-nilai `RecordParser`-nya:
   + `SingleLineJson`
   + `Regex`
   + `SysLog`
   + `Delimited`

   Pengurai catatan lainnya berbasis teks saja dan tidak bekerja dengan benar pada sink yang memerlukan format XML atau JSON.

1. Jika catatan log tidak diurai dengan benar oleh tipe sumber `DirectorySource`, jalankan baris berikut di jendela command prompt untuk memverifikasi stempel waktu dan ekspresi reguler pasangan kunci-nilai yang ditentukan dalam deklarasi `DirectorySource`:

   ```
   cd /D %PROGRAMFILES%\Amazon\AWSKinesisTap
   ktdiag.exe /r sourceID
   ```

   Ganti *sourceID* dengan nilai pasangan kunci-nilai `Id` deklarasi sumber `DirectorySource` yang tampaknya tidak bekerja dengan benar. Perbaiki semua masalah yang dilaporkan oleh `ktdiag.exe`.

### Berlaku untuk
<a name="troubleshooting-bad-format-applies-to"></a>

Informasi ini berlaku untuk Kinesis Agent for Windows versi 1.0.0.115 dan yang lebih baru.

## Masalah Performa
<a name="troubleshooting-poor-performance"></a>

### Symptoms
<a name="troubleshooting-poor-performance-symptoms"></a>

Aplikasi dan layanan telah meningkatkan latensi setelah Kinesis Agent for Windows diinstal dan dijalankan.

### Causes
<a name="troubleshooting-poor-performance-causes"></a>

Ada beberapa kemungkinan penyebab masalah ini:
+ Mesin tempat Kinesis Agent for Windows berjalan tidak memiliki kapasitas yang cukup untuk mengalirkan jumlah data yang diinginkan.
+ Data yang tidak perlu sedang dialirkan ke satu atau beberapa layanan AWS.
+ Kinesis Agent for Windows sedang melakukan streaming data ke layanan AWS yang tidak dikonfigurasi untuk laju data setinggi itu.
+ Kinesis Agent for Windows sedang menjalankan operasi pada layanan AWS di akun di mana batas laju panggilan API terlalu rendah.

### Resolutions
<a name="troubleshooting-poor-performance-resolutions"></a>

Untuk mengatasi masalah performa, lakukan langkah berikut:

1. Gunakan aplikasi pemantauan sumber daya Windows untuk memeriksa penggunaan memori, CPU, disk, dan jaringan. Jika Anda perlu melakukan streaming data dalam jumlah besar dengan Kinesis Agent for Windows, Anda mungkin perlu menyediakan mesin dengan kapasitas lebih tinggi di beberapa area ini, tergantung konfigurasinya.

1. Anda mungkin dapat mengurangi jumlah data yang dicatat menggunakan filter:
   + Lihat pasangan kunci-nilai `Query` dalam [Konfigurasi WindowsEventLogSource](source-object-declarations.md#window-event-source-configuration).
   + Lihat filter alur di [Mengonfigurasi Alur](pipe-object-declarations.md#kinesis-agent-pipe-configuration).
   + Lihat filter metrik Amazon CloudWatch di [Konfigurasi Sink CloudWatch](sink-object-declarations.md#sink-object-declarations-cloud-watch)).

1. Gunakan aplikasi pemantau performa Windows untuk melihat metrik Kinesis Agent for Windows atau mengalirkan metrik tersebut ke CloudWatch (lihat [Sumber Metrik Bawaan Kinesis Agent for Windows](source-object-declarations.md#kinesis-agent-builin-metrics-source)). Pada aplikasi pemantau performa Windows, Anda dapat menambahkan penghitung untuk sink dan sumber Kinesis Agent for Windows. Penghitung ini terdaftar dalam kategori penghitung **Sink AWSKinesisTap** dan **Sumber AWSKinesisTap**.  
![\[Tangkapan layar konsol yang menampilkan kategori penghitung Kinesis Agent for Windows di aplikasi pemantau performa Windows.\]](http://docs.aws.amazon.com/id_id/kinesis-agent-windows/latest/userguide/images/AddPerformanceCountersScreenshot.png)

   Misalnya, untuk mendiagnosis masalah performa Kinesis Data Firehose, tambahkan pengukur performa **Sink Kinesis Firehose**.  
![\[Tangkapan layar konsol yang menampilkan pengukur performa Kinesis Data Firehose.\]](http://docs.aws.amazon.com/id_id/kinesis-agent-windows/latest/userguide/images/KinesisFirehosePerformanceCountersScreenshot.png)

   Jika terdapat sejumlah besar kesalahan yang dapat dipulihkan, periksa log Kinesis Agent for Windows terbaru di direktori `%PROGRAMDATA%\Amazon\AWSKInesisTap\logs`. Jika terjadi throttling untuk sink `KinesisStream` atau `KinesisFirehose`, lakukan hal berikut: 
   + Jika terjadi throttling karena streaming data terlalu cepat, pertimbangkan untuk meningkatkan jumlah serpihan untuk aliran data Kinesis. Untuk informasi selengkapnya, lihat [Sharding Ulang, Penskalaan, dan Pemrosesan Paralel](https://docs.aws.amazon.com/streams/latest/dev/kinesis-record-processor-scaling.html) dalam *Panduan Developer Kinesis Data Streams*.
   + Pertimbangkan untuk menaikkan batas panggilan API untuk Kinesis Data Streams, atau meningkatkan ukuran buffer untuk sink jika panggilan API mengalami throttling. Untuk informasi selengkapnya, lihat [Batas Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/service-sizes-and-limits.html) dalam *Panduan Developer Kinesis Data Streams*.
   + Jika streaming data terlalu cepat, pertimbangkan untuk meminta kenaikan batas laju untuk aliran pengiriman Kinesis Data Firehose. Atau jika panggilan API mengalami throttling, ajukan peningkatan batas panggilan API (lihat [Batas Amazon Kinesis Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/limits.html)) atau tingkatkan ukuran buffer untuk sink.
   + Setelah meningkatkan jumlah serpihan untuk aliran Kinesis Data Streams, atau meningkatkan batas laju untuk aliran pengiriman Kinesis Data Firehose, revisi file konfigurasi `appsettings.json` Kinesis Agent for Windows guna meningkatkan catatan per detik atau byte per detik untuk sink. Jika tidak, Kinesis Agent for Windows tidak dapat memanfaatkan peningkatan batas tersebut.

### Berlaku untuk
<a name="troubleshooting-poor-performance-applies-to"></a>

Informasi ini berlaku untuk Kinesis Agent for Windows versi 1.0.0.115 dan yang lebih baru.

## Ruang Disk Habis
<a name="troubleshooting-out-of-disk-space"></a>

### Symptoms
<a name="troubleshooting-out-of-disk-space-symptoms"></a>

Kinesis Agent for Windows berjalan pada mesin dengan kapasitas ruang disk sangat kecil pada satu atau beberapa drive disk.

### Causes
<a name="troubleshooting-out-of-disk-space-causes"></a>

Ada beberapa kemungkinan penyebab masalah ini:
+ File konfigurasi pencatatan Kinesis Agent for Windows tidak tepat.
+ Antrean tetap Kinesis Agent for Windows dikonfigurasi dengan tidak tepat.
+ Beberapa aplikasi atau layanan lain memakan ruang disk.

### Resolutions
<a name="troubleshooting-out-of-disk-space-resolutions"></a>

Untuk mengatasi masalah ruang disk, lakukan langkah berikut:
+ Jika ruang disk pada disk yang berisi berkas log Kinesis Agent for Windows kecil, periksa direktori berkas log (biasanya `%PROGRAMDATA%\Amazon\AWSKinesisTap\logs`). Pastikan bahwa berkas log yang sedang dipertahankan ada dalam jumlah wajar dan ukuran berkas log juga wajar. Anda dapat mengendalikan lokasi, penyimpanan, dan verbositas log Kinesis Agent for Windows dengan mengedit file konfigurasi `%PROGRAMFILES%\Amazon\AWSKinesisTap\Nlog.xml`.
+ Ketika fitur antrean sink diaktifkan, periksa deklarasi sink yang menggunakan fitur tersebut. Pastikan bahwa pasngan kunci-nilai `QueuePath` mereferensikan drive disk dengan ruang yang cukup untuk menampung jumlah maksimum batch yang ditentukan menggunakan pasangan kunci-nilai `QueueMaxBatches`. Jika hal ini tidak memungkinkan, maka kurangi nilai pasangan kunci-nilai `QueueMaxBatches` sehingga data cukup ditampung dalam ruang disk yang tersisa untuk drive disk yang ditentukan.
+  Gunakan file explorer Windows untuk menemukan file yang memakan ruang disk dan mentransfer atau menghapus kelebihan file. Ubah konfigurasi aplikasi atau layanan yang memakan sejumlah besar ruang disk. 

### Berlaku untuk
<a name="troubleshooting-out-of-disk-space-applies-to"></a>

Informasi ini berlaku untuk Kinesis Agent for Windows versi 1.0.0.115 dan yang lebih baru.

## Alat Pemecahan Masalah
<a name="troubleshooting-tools"></a>

Selain memverifikasi file konfigurasi, Anda dapat menggunakan alat `ktdiag.exe`, yang menyediakan beberapa kemampuan lain untuk mendiagnosis dan menyelesaikan masalah saat mengonfigurasi dan menggunakan Kinesis Agent for Windows. Alat `ktdiag.exe` terletak di direktori `%PROGRAMFILES%\Amazon\AWSKinesisTap`.
+ Jika Anda berpikir bahwa berkas log dengan pola file tertentu sedang ditulis ke direktori tetapi tidak diproses oleh Kinesis Agent for Windows, gunakan tombol `/w` untuk memverifikasi bahwa perubahan ini dideteksi. Misalnya, anggaplah Anda menginginkan berkas log dengan pola nama file `*.log` ditulis ke direktori `c:\foo`. Anda dapat menggunakan tombol `/w` ketika menjalankan alat `ktdiag.exe`, dengan menyebutkan direktori dan pola file:

  ```
  cd /D %PROGRAMFILES%\Amazon\AWSKinesisTap
  ktdiag /w c:\foo *.log
  ```

   Jika berkas log sedang ditulis, Anda dapat melihat output yang serupa dengan yang berikut: 

  ```
  Type any key to exit this program...
  File: c:\foo\log1.log ChangeType: Created
  File: c:\foo\log1.log ChangeType: Deleted
  File: c:\foo\log1.log ChangeType: Created
  File: c:\foo\log1.log ChangeType: Changed
  File: c:\foo\log1.log ChangeType: Changed
  File: c:\foo\log1.log ChangeType: Changed
  File: c:\foo\log1.log ChangeType: Changed
  ```

  Jika tidak ada output seperti itu, maka ada masalah aplikasi atau layanan dalam penulisan log, atau ada masalah konfigurasi keamanan alih-alih masalah pada Kinesis Agent for Windows. Jika output tersebut ada, tetapi Kinesis Agent for Windows tampaknya masih belum memproses log, lihat [Tidak Ada Data yang Dialirkan dari Desktop atau Server ke Layanan AWS yang Diinginkan](#troubleshooting-no-data).
+ Kadang-kadang log hanya ditulis sesekali, tetapi ada baiknya Anda memverifikasi bahwa Kinesis Agent for Windows beroperasi dengan benar. Gunakan tombol `/log4net` untuk menyimulasikan aplikasi menulis log menggunakan pustaka `Log4net`; misalnya:

  ```
  cd /D %PROGRAMFILES%\Amazon\AWSKinesisTap
  KTDiag.exe /log4net c:\foo\log2.log
  ```

  Langkah ini menulis sebuah berkas log gaya `Log4net` ke berkas log `c:\foo\log2.log` dan terus menambahkan entri log baru sampai kunci ditekan. Anda dapat mengonfigurasi beberapa opsi menggunakan tombol tambahan yang secara opsional dituliskan setelah nama file:  
Mengunci: `-lm`, `-li`, atau `-le`  
Anda dapat menentukan salah satu tombol penguncian berikut yang mengendalikan cara mengunci berkas log:    
`-lm`  
Jumlah minimum penguncian digunakan pada berkas log, memungkinkan akses maksimum ke berkas log.  
`-li`  
Hanya utas dalam proses yang sama yang dapat mengakses log pada waktu bersamaan.  
`-le`  
Hanya satu utas dapat mengakses log dalam satu kesempatan. Ini adalah pengaturan default.  
`-tn:`*milidetik*  
Menentukan jumlah *milidetik* antara penulisan entri log. Defaultnya adalah 1.000 milidetik (1 detik).  
`-sm:`*byte*  
Menentukan jumlah *byte* untuk setiap entri log. Defaultnya adalah 1.000 byte.  
`-bk:`*jumlah*  
Menentukan *jumlah* entri log yang akan ditulis dalam satu kesempatan. Defaultnya adalah 1.
+ Kadang-kadang, ada baiknya Anda menyimulasikan aplikasi yang menulis ke log peristiwa Windows. Gunakan tombol `/e` untuk menulis sebuah entri log peristiwa Windows; misalnya:

  ```
  cd /D %PROGRAMFILES%\Amazon\AWSKinesisTap
  KTDiag.exe /e Application
  ```

  Langkah ini menulis entri log ke log peristiwa Aplikasi Windows sampai kunci ditekan. Anda dapat menentukan opsi tambahan berikut setelah nama log:  
`-tn:`*milidetik*  
Menentukan jumlah *milidetik* antara penulisan entri log. Defaultnya adalah 1.000 milidetik (1 detik).  
`-sm:`*byte*  
Menentukan jumlah *byte* untuk setiap entri log. Defaultnya adalah 1.000 byte.  
`-bk:`*jumlah*  
Menentukan *jumlah* entri log yang akan ditulis dalam satu kesempatan. Defaultnya adalah 1.