Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Risoluzione dei problemi di Amazon Kinesis Agent per Microsoft Windows Utilizza le seguenti istruzioni per diagnosticare e risolvere i problemi quando si usa Amazon Kinesis Agent per Microsoft Windows. **Topics** + [Nessun dato viene inviato in streaming da desktop o server ai servizi AWS attesi](#troubleshooting-no-data) + [I dati attesi sono a volte mancanti](#troubleshooting-missing-data) + [I dati arrivano in un formato non corretto](#troubleshooting-bad-format) + [Problematiche di prestazioni](#troubleshooting-poor-performance) + [Spazio su disco esaurito](#troubleshooting-out-of-disk-space) + [Strumenti per la risoluzione dei problemi](#troubleshooting-tools) ## Nessun dato viene inviato in streaming da desktop o server ai servizi AWS attesi ### Symptoms Quando si esaminano i log, gli eventi e i parametri ospitati da vari servizi AWS che vengono configurati per ricevere flussi di dati da Kinesis Agent per Windows, nessun dato viene trasmesso mediante Kinesis Agent per Windows. ### Causes Le cause per questo problema sono diverse: + Un'origine, un sink o una pipe non sono stati configurati correttamente. + L'autenticazione per Kinesis Agent per Windows non è stata impostata correttamente. + L'autorizzazione per Kinesis Agent per Windows non è stata impostata correttamente. + Si è verificato un errore in un'espressione regolare fornita in una dichiarazione `DirectorySource`. + Una directory inesistente viene specificata per una dichiarazione `DirectorySource`. + I valori non validi vengono forniti per i servizi AWS, che quindi respingono le richieste da Kinesis Agent per Windows. + Un sink è un riferimento a una risorsa che non esiste nella regione AWS specificata o implicita. + Una query non valida viene specificata per una dichiarazione `WindowsEventLogSource`. + È stato specificato un valore non valido per la coppia chiave-valore `InitialPosition` per un'origine. + Il file di configurazione `appsettings.json` non è conforme allo schema JSON per quel file. + I dati vengono trasmessi in streaming in una regione diversa rispetto a quello selezionata nella console di gestione AWS. + Kinesis Agent per Windows non è installato correttamente o non è in esecuzione. ### Resolutions Per risolvere i problemi con i dati non in streaming, eseguire i seguenti passaggi: 1. Esaminare i registri di Kinesis Agent per Windows nel`%PROGRAMDATA%\Amazon\AWSKinesisTap\logs`Directory. Cercare la stringa `ERROR`. 1. Se non è stato possibile caricare un'origine o un sink, procedere nel seguente modo: 1. Esaminare il messaggio di errore e individuare il `Id` del sink o dell'origine. 1. Controllare la dichiarazione dell'origine o del sink che corrisponde al `Id` nel file di configurazione `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json` per verificare la presenza di eventuali errori correlati al messaggio di errore trovato. Per ulteriori dettagli, consulta [Configurazione di Amazon Kinesis Agent per Microsoft Windows](configuring-kinesis-agent-windows.md). 1. Correggere eventuali problematiche relative all'errore del file di configurazione. 1. Avviare e arrestare il servizio `AWSKinesisTap`. Quindi verificare il file di log più attuale per verificare che i problemi di configurazione siano stati risolti. 1. Se il messaggio di errore indica che una `SourceRef` o un `SinkRef` non è stato trovato per una pipe, eseguire le operazioni descritte di seguito: 1. Prendere nota della pipe `Id`. 1. Esaminare la dichiarazione della pipe nel file di configurazione `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json` che corrisponde all'`Id` annotato. Verificare che i valori delle coppie chiave-valore `SourceRef` e `SinkRef` abbiano `Id` scritti correttamente per le dichiarazioni di origine e sink a cui si intende fare riferimento. Correggere gli eventuali errori di battitura o di ortografia. Se una dichiarazione di sink oppure origine manca dal file di configurazione, aggiungere la dichiarazione. Per ulteriori informazioni, consulta [Configurazione di Amazon Kinesis Agent per Microsoft Windows](configuring-kinesis-agent-windows.md). 1. Avviare e arrestare il servizio `AWSKinesisTap`. Quindi verificare il file di log più attuale per verificare che i problemi di configurazione siano stati risolti. 1. Se il messaggio di errore indica che un determinato utente o ruolo IAM non è autorizzato a eseguire determinate operazioni, procedere nel seguente modo: 1. Verificare che l'utente o il ruolo IAM corretti vengano utilizzati da Kinesis Agent per Windows. Se non lo è, consulta[Configurazione di sicurezza del sink](sink-object-declarations.md#configuring-kinesis-agent-windows-sink-security-configuration)e regolare come autentica Kinesis Agent per Windows per garantire che venga utilizzato l'utente o il ruolo IAM corretto. 1. Se viene utilizzato l'utente o il ruolo IAM corretto, utilizzando AWS Management Console, esaminare le policy associate all'utente o al ruolo. Verificare che l'utente o il ruolo dispongano di tutte le autorizzazioni menzionate nel messaggio di errore per tutte le risorse AWS a cui Kinesis Agent per Windows accede. Per ulteriori informazioni, consulta [Configurazione dell'autorizzazione](sink-object-declarations.md#configuring-kinesis-agent-windows-authorization). 1. Avviare e arrestare il servizio `AWSKinesisTap`. Quindi verificare il file di log più attuale per verificare che i problemi di sicurezza siano stati risolti. 1. Se il messaggio di errore indica che si è verificato un errore di argomento durante l'analisi di un'espressione regolare contenuta nel file di configurazione `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json`, eseguire le operazioni descritte di seguito: 1. Esaminare l'espressione regolare nel file di configurazione. 1. Verificare la sintassi dell'espressione regolare. Vi sono diversi siti Web che è possibile utilizzare per verificare le espressioni regolari, oppure utilizzare le seguenti righe di comando per verificare la presenza di espressioni regolari per una dichiarazione di origine `DirectorySource`: ``` cd /D %PROGRAMFILES%\Amazon\AWSKinesisTap ktdiag.exe /r sourceId ``` Sostituisci *sourceId* con il valore della coppia chiave-valore `Id` della dichiarazione di origine `DirectorySource` con un'errata espressione regolare. 1. Apportare le correzioni necessarie all'espressione regolare nel file di configurazione in modo che sia valido. 1. Avviare e arrestare il servizio `AWSKinesisTap`. Quindi verificare il file di log più attuale per verificare che i problemi di configurazione siano stati risolti. 1. Se il messaggio di errore indica che si è verificato un errore di argomento durante l'analisi di un'espressione regolare che non è contenuta nel file di configurazione `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json` ed è relativa a un sink specifico, eseguire le operazioni descritte di seguito: 1. Individuare la dichiarazione di sink nel file di configurazione. 1. Verificare che le coppie chiave-valore relative a un servizio AWS stanno utilizzando nomi che rispettino le regole di convalida per quel servizio. Ad esempio, i nomi dei gruppi CloudWatch Logs devono contenere solo un determinato set di caratteri specificato utilizzando l'espressione regolare.`[\.\-_/#A-Za-z0-9]+`: . 1. Correggere gli eventuali nomi non validi nelle coppie chiave-valore per la dichiarazione di sink e verificare che tali risorse siano configurate correttamente in AWS. 1. Avviare e arrestare il servizio `AWSKinesisTap`. Quindi verificare il file di log più attuale per verificare che i problemi di configurazione siano stati risolti. 1. Se il messaggio di errore indica che un'origine o un sink non è in grado di caricare a causa di un parametro nullo o mancante, procedere nel seguente modo: 1. Prendere nota del `Id` dell'origine o del sink. 1. Individuare la dichiarazione dell'origine o del sink corrispondente all'`Id` specificato nel file di configurazione `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json`. 1. Esaminare le coppie chiave-valore che vengono fornite nella dichiarazione di origine o del sink confrontata con i requisiti del tipo di origine o di sink nella documentazione [Configurazione di Amazon Kinesis Agent per Microsoft Windows](configuring-kinesis-agent-windows.md) per il tipo di sink pertinente. Aggiungere qualsiasi coppia chiave-valore obbligatoria mancante alla dichiarazione dell'origine o del sink. 1. Avviare e arrestare il servizio `AWSKinesisTap`. Quindi verificare il file di log più attuale per verificare che i problemi di configurazione siano stati risolti. 1. Se il messaggio di errore indica che un nome di directory non è valido, eseguire le operazioni descritte di seguito: 1. Individuare il nome della directory non valido nel file di configurazione `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json`. 1. Verificare che questa directory esista già e contenga i file di log che devono essere oggetto dello streaming. 1. Correggere gli eventuali refusi o errori nel nome della directory specificato nel file di configurazione. 1. Avviare e arrestare il servizio `AWSKinesisTap`. Quindi verificare il file di log più attuale per verificare che i problemi di configurazione siano stati risolti. 1. Se il messaggio di errore indica che una risorsa non esiste: 1. Individuare il riferimento per la risorsa che non esiste in una dichiarazione di sink nel file di configurazione `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json`. 1. Utilizzare AWS Management Console per individuare la risorsa nella regione AWS corretta che dovrebbe essere utilizzata nella dichiarazione del sink. Confrontarla con ciò che è stato specificato nel file di configurazione. 1. Cambiare la dichiarazione del sink nel file di configurazione per avere il nome della risorsa e della regione corretti. 1. Avviare e arrestare il servizio `AWSKinesisTap`. Quindi verificare il file di log più attuale per verificare che i problemi di configurazione siano stati risolti. 1. Se il messaggio di errore indica che una query non è valida per un particolare `WindowsEventLogSource`, eseguire le operazioni descritte di seguito: 1. Nel file di configurazione `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json`, individuare la dichiarazione `WindowsEventLogSource` con lo stesso `Id` del messaggio di errore. 1. Verificare che il valore della coppia chiave-valore `Query` nella dichiarazione di origine soddisfi le [query di eventi e gli XML di eventi](https://msdn.microsoft.com/en-us/library/bb399427(v=vs.90).aspx). 1. Apportare le modifiche alla query per garantire la conformità. 1. Avviare e arrestare il servizio `AWSKinesisTap`. Quindi verificare il file di log più attuale per verificare che i problemi di configurazione siano stati risolti. 1. Se il messaggio di errore indica che una posizione iniziale non è valida, eseguire le operazioni descritte di seguito: 1. Nel file di configurazione `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json`, individuare la dichiarazione di origine con lo stesso `Id` del messaggio di errore. 1. Cambiare il valore della coppia chiave-valore `InitialPosition` nella dichiarazione di origine per essere conformi ai valori consentiti, come descritto in [Configurazione del segnalibro](source-object-declarations.md#advanced-source-configuration). 1. Avviare e arrestare il servizio `AWSKinesisTap`. Quindi verificare il file di log più attuale per verificare che i problemi di configurazione siano stati risolti. 1. Assicurarsi che il file di configurazione `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json` sia conforme allo schema JSON. 1. In una finestra di prompt dei comandi, invocare i comandi seguenti: ``` cd /D %PROGRAMFILES%\Amazon\AWSKinesisTap %PROGRAMFILES%\Amazon\AWSKinesisTap\ktdiag.exe /c ``` 1. Correggere eventuali problemi rilevati con il file di configurazione `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json`. 1. Avviare e arrestare il servizio `AWSKinesisTap`. Quindi verificare il file di log più attuale per verificare che i problemi di configurazione siano stati risolti. 1. Cambiare il livello di log per cercare di ottenere dati sui log più dettagliati. 1. Sostituire il file di configurazione `%PROGRAMFILES%\Amazon\AWSKinesisTap\nlog.xml` con il contenuto seguente: ``` ``` 1. Avviare e arrestare il servizio `AWSKinesisTap`. Quindi verificare il file di log più recente per vedere se ci sono messaggi aggiuntivi nel log che potrebbero contribuire a diagnosticare e risolvere il problema. 1. Verificare che si stanno esaminando le risorse nella regione corretta nella console di gestione AWS. 1. Verificare che l'agente Kinesis per Windows sia installato e in esecuzione. 1. In Windows, scegliere **Start (Avvia)**, quindi passare a **Control Panel (Pannello di controllo)**, **Administrative Tools (Strumenti di amministrazione)**, **Services (Servizi)**. 1. Trovare il servizio **AWSKinesisTap**. 1. Se il servizio AWSKinesisTap non è visibile, installare Kinesis Agent per Windows seguendo le istruzioni in[Nozioni di base su Amazon Kinesis Agent per Microsoft Windows](getting-started.md): . 1. Se il servizio è visibile, stabilire se il servizio è in esecuzione. Se non è in esecuzione, aprire il menu contestuale (clic con il pulsante destro del mouse) per il servizio e scegliere **Start (Avvia)**. 1. Verificare che il servizio sia stato avviato esaminando il file di log più recente nella directory `%PROGRAMDATA%\Amazon\AWSKinesisTap\logs`. ### Si applica a Questa informazione si applica a Kinesis Agent per Windows versione 1.0.0.0.115 e versione successiva. ## I dati attesi sono a volte mancanti ### Symptoms Nella maggior parte dei casi, Kinesis Agent per Windows esegue lo streaming dei dati correttamente, ma che occasionalmente alcuni dati sono mancanti. ### Causes Le cause per questo problema sono diverse: + La funzione di creazione di un segnalibro non viene utilizzata. + I limiti di velocità dei dati per i servizi AWS vengono superati in base alla configurazione corrente di tali servizi. + I limiti di velocità per le chiamate API per i servizi AWS vengono superati in base al`appsettings.json`e i limiti dell'account AWS. ### Resolutions Per risolvere i problemi con i dati mancanti, eseguire i seguenti passaggi: 1. Valutare la possibilità di utilizzare la funzione di creazione di un segnalibro documentata in [Configurazione del segnalibro](source-object-declarations.md#advanced-source-configuration). Contribuisce a garantire che tutti i dati vengono infine inviati, anche quando Kinesis Agent per Windows viene interrotto e avviato. 1. Utilizza le metriche integrate di Kinesis Agent per Windows per individuare i problemi: 1. Abilitare lo streaming delle metriche di Kinesis Agent per Windows come descritto in[Configurazione dell'agente Kinesis per le pipe metriche di Windows](pipe-object-declarations.md#kinesis-agent-metric-pipe-configuration): . 1. Se c'è un notevole numero di errori non recuperabili per uno o più sink, stabilire il numero di byte o record inviati al secondo. Quindi specificare se questo è entro i limiti configurati per quei servizi AWS nella regione e nell'account verso cui i dati vengono trasmessi. 1. Quando i limiti vengono superati, o si riduce la velocità o la quantità di dati inviati, si richiede un aumento dei limiti oppure si aumenta lo sharding, se applicabile. 1. Dopo aver apportato gli adeguamenti, continuare a monitorare i parametri integrati di Kinesis Agent per Windows per assicurare che il problema sia stato risolto. Per ulteriori informazioni sui limiti di Kinesis Data Streams, consulta[Limiti di Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/service-sizes-and-limits.html)nella*Kinesis Data Streams*: . Per ulteriori informazioni sui limiti di Kinesis Data Firehose, consulta[Limiti di Amazon Kinesis Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/limits.html): . ### Si applica a Questa informazione si applica a Kinesis Agent per Windows versione 1.0.0.0.115 e versione successiva. ## I dati arrivano in un formato non corretto ### Symptoms I dati arrivano al servizio AWS in un formato errato. ### Causes Le cause per questo problema sono diverse: + Il valore della coppia chiave-valore `Format` per una dichiarazione del sink nel file di configurazione `appsettings.json` non è corretto. + Il valore per la coppia chiave-valore `RecordParser` in una dichiarazione `DirectorySource` non è corretto. + Le espressioni regolari in una dichiarazione `DirectorySource` che usa il parser di record `Regex` non sono corrette. ### Resolutions Per risolvere i problemi con una formattazione non corretta, eseguire i seguenti passaggi: 1. Rivedere le dichiarazioni di sink nel file di configurazione `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json`. 1. Verificare che il valore corretto della coppia chiave-valore `Format` venga specificato per ogni dichiarazione sink. Per ulteriori informazioni, consulta [Dichiarazioni dei sink](sink-object-declarations.md). 1. Se le origini con dichiarazioni `DirectorySource` sono collegate da pipe a sink che specificano i valori `xml` o `json` per la coppia chiave-valore `Format`, assicurarsi che tali sorgenti specifichino uno dei seguenti valori per la coppia chiave-valore `RecordParser`: + `SingleLineJson` + `Regex` + `SysLog` + `Delimited` Altri parser di record sono basati solo su testo e non funzionano correttamente con sink che richiedono la formattazione JSON o XML. 1. Se i record di log non vengono analizzati correttamente dal tipo di origine `DirectorySource`, invocare le seguenti righe in una finestra del prompt dei comandi per verificare il timestamp e le coppie chiave-valore di espressioni regolari specificate nella dichiarazione `DirectorySource`: ``` cd /D %PROGRAMFILES%\Amazon\AWSKinesisTap ktdiag.exe /r sourceID ``` Sostituisci il *sourceID* con il valore della coppia chiave-valore `Id` della dichiarazione di origine `DirectorySource` che sembra non funzionare correttamente. Correggere gli eventuali problemi rilevati da `ktdiag.exe`. ### Si applica a Questa informazione si applica a Kinesis Agent per Windows versione 1.0.0.0.115 e versione successiva. ## Problematiche di prestazioni ### Symptoms Le applicazioni e i servizi hanno aumentato le latenze dopo l'installazione e l'avvio di Kinesis Agent per Windows. ### Causes Le cause per questo problema sono diverse: + Il computer in cui viene eseguito Kinesis Agent per Windows non dispone di capacità sufficiente per eseguire lo streaming della quantità di dati desiderata. + I dati non necessari vengono trasmessi a uno o più servizi AWS. + Kinesis Agent per Windows sta eseguendo lo streaming ai servizi AWS che non sono configurati per una velocità dei dati così elevata. + Kinesis Agent per Windows sta chiamando le operazioni sui servizi AWS in un account in cui il limite di velocità delle chiamate API è troppo basso. ### Resolutions Per risolvere i problemi relativi alle prestazioni, eseguire i seguenti passaggi: 1. Utilizzare l'applicazione di monitoraggio delle risorse di Windows per verificare la memoria, la CPU, il disco e l'utilizzo della rete. Se devi trasmettere grandi quantità di dati con Kinesis Agent per Windows, potrebbe essere necessario effettuare il provisioning di una macchina con capacità superiori in alcune di queste aree, a seconda della configurazione. 1. È possibile ridurre la quantità di dati registrati utilizzando il filtraggio: + Consulta la coppia chiave-valore `Query` [Configurazione WindowsEventLogSource](source-object-declarations.md#window-event-source-configuration). + Vedi il filtraggio delle pipeline in [Configurazione di pipe](pipe-object-declarations.md#kinesis-agent-pipe-configuration). + Consulta il filtro dei parametri di Amazon CloudWatch in[Configurazione sink CloudWatch](sink-object-declarations.md#sink-object-declarations-cloud-watch)). 1. Utilizzare l'applicazione di monitoraggio delle prestazioni di Windows per visualizzare i parametri di Kinesis Agent per Windows o eseguire lo streaming di tali parametri a CloudWatch (vedi[Origine dei parametri integrati di Kinesis Agent per Windows](source-object-declarations.md#kinesis-agent-builin-metrics-source)). Nell'applicazione di monitoraggio delle prestazioni di Windows, è possibile aggiungere contatori per sink e origini Kinesis Agent per Windows. Sono elencati sotto le categorie di contatori **AWSKinesisTap Sinks** e **AWSKinesisTap Sources**. ![\[Screenshot della console che mostra le categorie dei contatori Kinesis Agent per Windows nell'applicazione di monitoraggio delle prestazioni di Windows.\]](http://docs.aws.amazon.com/it_it/kinesis-agent-windows/latest/userguide/images/AddPerformanceCountersScreenshot.png) Ad esempio, per diagnosticare i problemi di prestazioni di Kinesis Data Firehose, aggiungere il**Kinesis Firehose Lavello**Contatori di prestazioni. ![\[Screenshot della console che mostra i contatori di prestazioni Kinesis Data Firehose.\]](http://docs.aws.amazon.com/it_it/kinesis-agent-windows/latest/userguide/images/KinesisFirehosePerformanceCountersScreenshot.png) In caso di un numero elevato di errori recuperabili, controllare i log di Kinesis Agent per Windows più recenti nella sezione`%PROGRAMDATA%\Amazon\AWSKInesisTap\logs`Directory. Se per i sink `KinesisStream` o `KinesisFirehose` si verifica il throttling, procedere come segue: + Se si verifica il throttling a causa di uno streaming dei dati troppo veloce, prendere in considerazione la possibilità di aumentare il numero di shard per il flusso di dati Kinesis. Per ulteriori informazioni, consulta[Resharding, dimensionamento ed elaborazione parallela](https://docs.aws.amazon.com/streams/latest/dev/kinesis-record-processor-scaling.html)nella*Kinesis Data Streams*: . + Prendere in considerazione la possibilità di aumentare il limite delle chiamate API per Kinesis Data Streams o di aumentare le dimensioni del buffer per il sink se le chiamate API sono oggetto di throttled. Per ulteriori informazioni, consulta[Limiti di Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/service-sizes-and-limits.html)nella*Kinesis Data Streams*: . + Se lo streaming dei dati viene eseguito troppo rapidamente, è possibile richiedere un aumento del limite concesso per il flusso di distribuzione Kinesis Data Firehose. Oppure, se le chiamate API sono oggetto di throttling, richiedere un aumento del limite delle chiamate API (consulta [Limiti di Amazon Kinesis Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/limits.html)) oppure aumentare le dimensioni del buffer per il sink. + Dopo l'aumento del numero di shard per un Kinesis Data Streams o l'aumento del limite di velocità per un flusso di distribuzione Kinesis Data Firehose, modificare l'agente Kinesis per Windows`appsettings.json`File di configurazione per aumentare i record al secondo o i byte al secondo per il sink. In caso contrario, Kinesis Agent per Windows non è in grado di sfruttare i limiti aumentati. ### Si applica a Questa informazione si applica a Kinesis Agent per Windows versione 1.0.0.0.115 e versione successiva. ## Spazio su disco esaurito ### Symptoms Kinesis Agent per Windows è in esecuzione su una macchina che ha poco spazio su disco a disposizione in uno o più dischi rigidi. ### Causes Le cause per questo problema sono diverse: + Il file di configurazione di registrazione di Kinesis Agent per Windows non è corretto. + La coda persistente di Kinesis Agent per Windows non è stata impostata correttamente. + Alcune altri applicazione o servizi stanno consumando spazio su disco. ### Resolutions Per risolvere i problemi relativi allo spazio su disco, eseguire i seguenti passaggi: + Se lo spazio sul disco che contiene i file di log di Kinesis Agent per Windows è ridotto, esaminare la directory dei file di log (in genere`%PROGRAMDATA%\Amazon\AWSKinesisTap\logs`). Verificare che un numero ragionevole di file di log venga conservato e che i file di log siano di dimensioni ragionevoli. È possibile controllare il percorso, la conservazione e il livello di dettaglio dei log di Kinesis Agent per Windows modificando il`%PROGRAMFILES%\Amazon\AWSKinesisTap\Nlog.xml`File di configurazione. + Quando la funzione di accodamento sink è abilitata, esaminare le dichiarazioni dei sink che usano tale funzionalità. Verificare che la coppia chiave-valore `QueuePath` faccia riferimento a una unità disco con spazio sufficiente per contenere il numero massimo di batch specificato utilizzando la coppia chiave-valore `QueueMaxBatches`. Se questo non è possibile, ridurre il valore della coppia chiave-valore `QueueMaxBatches`, in modo che i dati entrino facilmente nel rimanente spazio su disco per l'unità disco specificato. + Utilizzare Esplora file di Windows per individuare i file che consumano lo spazio su disco e trasferire o eliminare i file in eccesso. Modificare la configurazione dell'applicazione o del servizio che consumano grandi quantità di spazio su disco. ### Si applica a Questa informazione si applica a Kinesis Agent per Windows versione 1.0.0.0.115 e versione successiva. ## Strumenti per la risoluzione dei problemi Oltre che per verificare il file di configurazione, è possibile utilizzare il`ktdiag.exe`, che offre diverse altre caratteristiche per diagnosticare e risolvere i problemi durante la configurazione e l'utilizzo di Kinesis Agent per Windows. Lo strumento `ktdiag.exe` si trova nella directory `%PROGRAMFILES%\Amazon\AWSKinesisTap`. + Se si ritiene che i file di log con un determinato modello di file vengono scritti in una directory, ma non sono in corso di elaborazione da parte di Kinesis Agent per Windows, utilizzare la`/w`per verificare che queste modifiche vengano rilevate. Ad esempio, supponiamo che i file di log con il modello di nome di file `*.log` vengano scritti nella directory `c:\foo`. È possibile utilizzare l'opzione `/w` quando si esegue lo strumento `ktdiag.exe`, specificando la directory e il modello del file: ``` cd /D %PROGRAMFILES%\Amazon\AWSKinesisTap ktdiag /w c:\foo *.log ``` Se vengono scritti i file di log, è possibile visualizzare risultati simili ai seguenti: ``` 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 ``` Se non si verifica l'output, quindi c'è un problema a livello di applicazione o di servizio nello scrivere i log, oppure si è verificato un problema di configurazione di sicurezza piuttosto che un problema con Kinesis Agent per Windows. Se ad esempio si verifica l'output, ma Kinesis Agent per Windows non sta ancora apparentemente elaborando i log, consulta[Nessun dato viene inviato in streaming da desktop o server ai servizi AWS attesi](#troubleshooting-no-data): . + A volte i log vengono scritti solo occasionalmente, ma potrebbe essere utile verificare che Kinesis Agent per Windows funzioni correttamente. Utilizzare l'opzione `/log4net`per simulare i log di scrittura di un'applicazione utilizzando la libreria `Log4net`, ad esempio: ``` cd /D %PROGRAMFILES%\Amazon\AWSKinesisTap KTDiag.exe /log4net c:\foo\log2.log ``` Questo scrive un file di log di stile `Log4net` per il file di log `c:\foo\log2.log` e mantiene l'aggiunta di nuove voci di log finché il tasto viene selezionato. È possibile configurare diverse opzioni utilizzando opzioni aggiuntive che sono facoltativamente specificate dopo il nome del file: Blocco: `-lm`, `-li` o `-le` È possibile specificare una delle seguenti opzioni di blocco che controllano il modo in cui il file di log è bloccato: `-lm` La quantità minima di blocco viene utilizzata nel file di log, consentendo l'accesso massimo al file di log. `-li` Solo i thread all'interno dello stesso processo possono accedere al log nello stesso momento. `-le` Solo un thread alla volta può accedere al log. Questa è l'impostazione predefinita. `-tn:`*millisecondi* Specifica il numero di *millisecondi* tra la scrittura delle voci di registro. Il valore predefinito è 1000 millisecondi (1 secondo). `-sm:`*byte* Specificare il numero di *byte* per ogni voce di log. Il valore predefinito è 1000 byte. `-bk:`*numero* Specifica il *numero* di voci di registro da scrivere alla volta. Il valore predefinito è 1. + Talvolta è utile simulare un'applicazione che scrive nel registro eventi di Windows. Utilizzare l'opzione `/e` per scrivere voci di registro di un evento di registro di Windows, ad esempio: ``` cd /D %PROGRAMFILES%\Amazon\AWSKinesisTap KTDiag.exe /e Application ``` Questo scrive voci di registro al log di eventi di Windows Application fino a quando un tasto è premuto. È anche possibile specificare le seguenti opzioni aggiuntive dopo il nome del registro: `-tn:`*millisecondi* Specifica il numero di *millisecondi* tra la scrittura delle voci di registro. Il valore predefinito è 1000 millisecondi (1 secondo). `-sm:`*byte* Specificare il numero di *byte* per ogni voce di log. Il valore predefinito è 1000 byte. `-bk:`*numero* Specifica il *numero* di voci di registro da scrivere alla volta. Il valore predefinito è 1.