Aucune donnée n'est diffusée à partir d'ordinateurs de bureaux ou de serveurs vers les services AWS attendus Des données prévues peuvent être manquantes Le format des données reçues est incorrect Problèmes de performance Manque d'espace sur le disque Outils de dépannage

Dépannage d'Amazon Kinesis Agent pour Microsoft Windows

Utilisez les instructions suivantes pour diagnostiquer et corriger les problèmes liés à l'utilisation d'Amazon Kinesis Agent pour Microsoft Windows.

Rubriques

Aucune donnée n'est diffusée à partir d'ordinateurs de bureaux ou de serveurs vers les services AWS attendus
Des données prévues peuvent être manquantes
Le format des données reçues est incorrect
Problèmes de performance
Manque d'espace sur le disque
Outils de dépannage

Aucune donnée n'est diffusée à partir d'ordinateurs de bureaux ou de serveurs vers les services AWS attendus

Symptoms

Lorsque vous examinez les journaux, les événements et les métriques hébergés par différents services AWS qui sont configurés pour recevoir des flux de données de Kinesis Agent for Windows, aucune donnée n'est diffusée par Kinesis Agent for Windows.

Causes

Plusieurs causes possibles peuvent entraîner ce problème :

Une source, un récepteur ou un canal n'est pas configuré correctement.
L'authentification pour Kinesis Agent pour Windows n'est pas configurée correctement.
L'autorisation pour Kinesis Agent pour Windows n'est pas configurée correctement.
Une expression régulière fournie dans une déclaration DirectorySource comporte une erreur.
Un répertoire qui n'existe pas est spécifié pour une déclaration DirectorySource.
Des valeurs non valides sont fournies à des services AWS, qui rejette ainsi les demandes provenant de Kinesis Agent pour Windows.
Un récepteur référence une ressource qui n'existe pas dans la région AWS spécifiée ou implicite.
Une requête non valide est spécifiée pour une déclaration WindowsEventLogSource.
Une valeur non valide est spécifiée pour la paire clé-valeur InitialPosition pour une source.
Le fichier de configuration appsettings.json n'est pas conforme au schéma JSON pour ce fichier.
Les données sont diffusées vers une région différente de celle sélectionnée dans AWS Management Console.
Kinesis Agent pour Windows n'est pas installé correctement ou n'est pas en cours d'exécution.

Resolutions

Pour résoudre les problèmes de données non diffusées, procédez de la manière suivante :

Examinez les journaux Kinesis Agent for Windows dans la%PROGRAMDATA%\Amazon\AWSKinesisTap\logsRépertoire. Recherchez la chaîne ERROR.
1. Si le chargement d'une source ou d'un récepteur n'a pas eu lieu, procédez comme suit :
  1. Examinez le message d'erreur et identifiez la valeur Id de la source ou du récepteur.
  2. Vérifiez que la déclaration de source ou de récepteur correspondant à cet Id dans le fichier de configuration %PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json afin d'identifier les erreurs liées au message d'erreur trouvé. Pour en savoir plus, consultez Configuration d'Amazon Kinesis Agent pour Microsoft Windows.
  3. Corrigez les problèmes du fichier de configuration liés à l'erreur.
  4. Arrêtez et démarrez le service AWSKinesisTap. Vérifiez ensuite le fichier journal le plus récent afin de vous assurer que les problèmes de configuration ont été résolus.
2. Si le message d'erreur indique qu'une référence SourceRef ou SinkRef n'a pas été trouvée pour un canal, procédez comme suit :
  1. Notez l'Id du canal.
  2. Examinez la déclaration de canal dans le fichier de configuration %PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json qui correspond à la valeur Id indiquée. Assurez-vous que les valeurs des paires clé-valeur SourceRef et SinkRef sont des Id correctement orthographiées pour les déclarations de source et de récepteur que vous avez prévu de référencer. Corrigez les fautes d'orthographe ou de frappe. Si une déclaration de source ou de récepteur ne figure pas dans le fichier de configuration, ajoutez-la. Pour plus d'informations, consultez Configuration d'Amazon Kinesis Agent pour Microsoft Windows.
  3. Arrêtez et démarrez le service AWSKinesisTap. Vérifiez ensuite le fichier journal le plus récent afin de vous assurer que les problèmes de configuration ont été résolus.
3. Si le message d'erreur indique qu'un utilisateur ou un rôle IAM n'est pas autorisé à effectuer certaines opérations, procédez comme suit :
  1. Vérifiez que l'utilisateur ou le rôle IAM utilisé par Kinesis Agent pour Windows est correct. Si ce n'est pas le cas, passez en revueConfiguration de la sécurité des récepteurset modifiez l'authentification de Kinesis Agent pour Windows pour vous assurer que l'utilisateur ou le rôle IAM utilisé est correct.
  2. Si l'utilisateur ou le rôle IAM utilisé est correct, utilisez AWS examiner les stratégies qui sont associées à l'utilisateur ou au rôle. Assurez-vous que l'utilisateur ou le rôle dispose de toutes les autorisations mentionnées dans le message d'erreur pour toutes les ressources AWS auxquelles accède Kinesis Agent for Windows. Pour plus d'informations, consultez Configuration de l'autorisation.
  3. Arrêtez et démarrez le service AWSKinesisTap. Vérifiez ensuite le fichier journal le plus récent afin de vérifier que les problèmes de sécurité ont été résolus.
4. Si le message d'erreur indique une erreur d'argument lors de l'analyse d'une expression régulière qui se trouve dans le fichier de configuration %PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json, procédez comme suit :
  1. Examinez l'expression régulière dans le fichier de configuration.
  2. Vérifiez la syntaxe de l'expression régulière. Plusieurs sites web peuvent vous permettre de vérifier les expressions régulières. Vous pouvez également utiliser les lignes de commande suivantes pour vérifier les expressions régulières pour une déclaration de source DirectorySource :
    
    cd /D %PROGRAMFILES%\Amazon\AWSKinesisTap ktdiag.exe /r sourceId
    
    Remplacez sourceId par la valeur de la paire clé-valeur Id de la déclaration de source DirectorySource comportant une expression régulière incorrecte.
  3. Apportez toutes les corrections nécessaires à l'expression régulière dans le fichier de configuration afin qu'il devienne valide.
  4. Arrêtez et démarrez le service AWSKinesisTap. Vérifiez ensuite le fichier journal le plus récent afin de vous assurer que les problèmes de configuration ont été résolus.
5. Si le message d'erreur indique une erreur d'argument lors de l'analyse d'une expression régulière qui ne se trouve pas dans le fichier de configuration %PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json et qui est liée à un récepteur particulier, procédez comme suit :
  1. Recherchez la déclaration de récepteur dans le fichier de configuration.
  2. Vérifiez que les paires clé-valeur qui sont spécifiquement liées à un service AWS utilisent des noms conformes aux règles de validation pour ce service. Par exemple, les noms des groupes CloudWatch Logs doivent uniquement contenir un ensemble de caractères spécifié à l'aide de l'expression régulière[\.\-_/#A-Za-z0-9]+.
  3. Corrigez les noms non valides dans les paires clé-valeur pour la déclaration de récepteur, et assurez-vous que ces ressources sont correctement configurées dans AWS.
  4. Arrêtez et démarrez le service AWSKinesisTap. Vérifiez ensuite le fichier journal le plus récent afin de vous assurer que les problèmes de configuration ont été résolus.
6. Si le message d'erreur indique que le chargement d'une source ou d'un récepteur échoue en raison d'un paramètre manquant ou null, procédez comme suit :
  1. Notez la valeur Id de la source ou du récepteur.
  2. Recherchez la déclaration de source ou de récepteur correspondant à la valeur Id relevée dans le fichier de configuration %PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json.
  3. Vérifiez les paires clé-valeur qui sont fournies dans la déclaration de source ou de récepteur par rapport aux exigences de type de récepteur dans la documentation Configuration d'Amazon Kinesis Agent pour Microsoft Windows du type de récepteur concerné. Ajoutez les paires clé-valeur manquantes à la déclaration de source ou de récepteur.
  4. Arrêtez et démarrez le service AWSKinesisTap. Vérifiez ensuite le fichier journal le plus récent afin de vous assurer que les problèmes de configuration ont été résolus.
7. Si le message d'erreur indique qu'un nom de répertoire n'est pas valide, procédez comme suit :
  1. Localisez le nom de répertoire non valide dans le fichier de configuration %PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json.
  2. Vérifiez que ce répertoire existe et contient les fichiers journaux qui doivent être diffusés.
  3. Corrigez les fautes de frappe ou les erreurs dans le nom du répertoire spécifié dans le fichier de configuration.
  4. Arrêtez et démarrez le service AWSKinesisTap. Vérifiez ensuite le fichier journal le plus récent afin de vous assurer que les problèmes de configuration ont été résolus.
8. Si le message d'erreur indique qu'une ressource n'existe pas :
  1. Localisez la référence de ressource pour la ressource qui n'existe pas dans une déclaration de récepteur dans le fichier de configuration %PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json.
  2. Utilisez AWS Management Console pour localiser la ressource dans la région AWS devant être utilisée dans la déclaration de récepteur. Comparez-la aux éléments spécifiés dans le fichier de configuration.
  3. Modifiez la déclaration de récepteur dans le fichier de configuration afin que le nom de la ressource et la région soient corrects.
  4. Arrêtez et démarrez le service AWSKinesisTap. Vérifiez ensuite le fichier journal le plus récent afin de vous assurer que les problèmes de configuration ont été résolus.
9. Si le message d'erreur indique qu'une requête n'est pas valide pour un WindowsEventLogSource spécifique, procédez comme suit :
  1. Dans le fichier de configuration %PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json, localisez la déclaration WindowsEventLogSource ayant le même Id que dans le message d'erreur.
  2. Vérifiez que la valeur de la paire clé-valeur Query dans la déclaration de source correspond aux informations indiquées dans Event queries and Event XML.
  3. Apportez toutes les modifications nécessaires pour que la requête soit conforme.
  4. Arrêtez et démarrez le service AWSKinesisTap. Vérifiez ensuite le fichier journal le plus récent afin de vous assurer que les problèmes de configuration ont été résolus.
10. Si le message d'erreur indique une position initiale non valide, procédez comme suit :
  1. Dans le fichier de configuration %PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json, localisez la déclaration de source ayant le même Id que dans le message d'erreur.
  2. Modifiez la valeur de la paire clé-valeur InitialPosition dans la déclaration de source de manière à ce qu'elle respecte les valeurs autorisées, comme décrit dans Configuration des signets.
  3. Arrêtez et démarrez le service AWSKinesisTap. Vérifiez ensuite le fichier journal le plus récent afin de vous assurer que les problèmes de configuration ont été résolus.
Vérifiez que le fichier de configuration %PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json est conforme au schéma JSON.
1. Dans une fenêtre d'invite de commande, appelez les lignes suivantes :
```
cd /D %PROGRAMFILES%\Amazon\AWSKinesisTap
%PROGRAMFILES%\Amazon\AWSKinesisTap\ktdiag.exe /c
```
2. Corrigez les problèmes détectés avec le fichier de configuration %PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json.
3. Arrêtez et démarrez le service AWSKinesisTap. Vérifiez ensuite le fichier journal le plus récent afin de vous assurer que les problèmes de configuration ont été résolus.

Modifiez le niveau de journalisation pour essayer d'obtenir des informations de journalisation plus détaillées.

Remplacez le fichier de configuration %PROGRAMFILES%\Amazon\AWSKinesisTap\nlog.xml par le contenu suivant :


<?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>

Arrêtez et démarrez le service AWSKinesisTap. Vérifiez ensuite les fichiers journaux les plus récents pour vérifier la présence de messages supplémentaires dans le journal, susceptibles d'aider à diagnostiquer et résoudre le problème.

Vérifiez que vous consultez les ressources dans la bonne région dans AWS Management Console.
Vérifiez que l'agent Kinesis Agent pour Windows est installé et en cours d'exécution.
1. Dans Windows, choisissez Démarrer, puis accédez à Panneau de configuration, Outils d'administration, Services.
2. Recherchez le service AWSKinesisTap.
3. Si le service AWSKinesisTap n'est pas visible, installez Kinesis Agent pour Windows en suivant les instructions deDémarrez avec l'agent Amazon Kinesis.
4. Si le service est visible, déterminez s'il est en cours d'exécution. Si ce n'est pas le cas, ouvrez le menu contextuel (clic droit) pour le service et choisissez Démarrer.
5. Vérifiez que le service a démarré en examinant le dernier fichier journal dans le répertoire %PROGRAMDATA%\Amazon\AWSKinesisTap\logs.

S'applique à

Cette information s'applique à Kinesis Agent pour Windows version 1.0.0.0.0.0.115 et aux versions ultérieures.

Des données prévues peuvent être manquantes

Symptoms

Kinesis Agent pour Windows diffuse correctement les données la plupart du temps, mais, occasionnellement, certaines données sont manquantes.

Causes

Plusieurs causes possibles peuvent entraîner ce problème :

La fonctionnalité de signets n'est pas utilisée.
Les limites de débit de données pour les services AWS sont dépassées par rapport à la configuration actuelle de ces services.
Les limites de taux d'appels d'API pour les services AWS sont dépassées par rapport à laappsettings.jsonet les limites de compte AWS.

Resolutions

Pour résoudre les problèmes de données manquantes, procédez comme suit :

Envisagez d'utiliser la fonctionnalité de signets documentée dans Configuration des signets. Elle permet de s'assurer que toutes les données sont finalement envoyées, même lorsque Kinesis Agent pour Windows s'arrête et démarre.
Utilisez les mesures intégrées de Kinesis Agent pour Windows pour détecter les problèmes :
1. Activez la diffusion des métriques Kinesis Agent pour Windows, comme décrit dansConfiguration de Kinesis Agent pour les canaux métriques Windows.
2. Si le nombre d'erreurs non récupérables est significatif pour un ou plusieurs récepteurs, déterminez le nombre d'octets ou d'enregistrements envoyés par seconde. Déterminez ensuite si ce nombre respecte la limite configurée pour ces services AWS dans la région et le compte dans lesquels les données sont diffusées.
3. En cas de dépassement des limites, réduisez le débit ou la quantité de données envoyées, demandez une augmentation des limites ou augmentez le partitionnement, le cas échéant.
4. Après les ajustements, continuez à surveiller les métriques intégrées de l'Agent Kinesis pour Windows afin de vous assurer que la situation est résolue.

Pour de plus amples informations sur les limites Kinesis Data Streams, consultezLimites Kinesis Data Streamsdans leKinesis Data Streams - Guide du développeur. Pour de plus amples informations sur les limites Kinesis Data Firehose, veuillez consulterLimites d'Amazon Kinesis Data Firehose.

S'applique à

Cette information s'applique à Kinesis Agent pour Windows version 1.0.0.0.0.0.115 et aux versions ultérieures.

Le format des données reçues est incorrect

Symptoms

Les données arrivent dans le service AWS dans un format incorrect.

Causes

Plusieurs causes possibles peuvent entraîner ce problème :

La valeur de la paire clé-valeur Format d'une déclaration de récepteur dans le fichier de configuration appsettings.json est incorrecte.
La valeur de la paire clé-valeur RecordParser dans une déclaration DirectorySource est incorrecte.
Les expressions régulières dans une déclaration DirectorySource qui utilise l'analyseur d'enregistrement Regex sont incorrectes.

Resolutions

Pour résoudre les problèmes de mise en forme incorrecte, procédez comme suit :

Vérifiez les déclarations de récepteur dans le fichier de configuration %PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json.
Assurez-vous que la valeur correcte de la paire clé-valeur Format est spécifiée pour chaque déclaration de récepteur. Pour plus d'informations, consultez Déclarations de récepteurs.
Si les sources avec des déclarations DirectorySource sont connectées par des canaux aux récepteurs qui spécifient des valeurs xml ou json pour la paire clé-valeur Format, assurez-vous que ces sources spécifient l'une des valeurs suivantes pour la paire clé-valeur RecordParser :
- SingleLineJson
- Regex
- SysLog
- Delimited
D'autres analyseurs d'enregistrements sont à base de texte uniquement et ne fonctionnent pas correctement avec les récepteurs nécessitant un format XML ou JSON.
Si des enregistrements de journaux ne sont pas correctement analysés par le type de source DirectorySource, appelez les lignes suivantes dans une fenêtre d'invite de commande afin de vérifier les paires clé-valeur d'horodatage et d'expression régulière spécifiées dans la déclaration DirectorySource :
```
cd /D %PROGRAMFILES%\Amazon\AWSKinesisTap
ktdiag.exe /r sourceID
```
Remplacez sourceID par la valeur de la paire clé-valeur Id de la DirectorySource déclaration de source qui ne semble pas fonctionner correctement. Corrigez les éventuels problèmes signalés par ktdiag.exe.

S'applique à

Cette information s'applique à Kinesis Agent pour Windows version 1.0.0.0.0.0.115 et aux versions ultérieures.

Problèmes de performance

Symptoms

Les latences des applications et des services ont augmenté depuis l'installation et le démarrage de Kinesis Agent pour Windows.

Causes

Plusieurs causes possibles peuvent entraîner ce problème :

La capacité de l'ordinateur dans lequel s'exécute Kinesis Agent pour Windows n'a pas une capacité suffisante pour diffuser la quantité de données souhaitée.
Des données inutiles sont diffusées vers un ou plusieurs services AWS.
Kinesis Agent pour Windows diffuse des données vers des services AWS qui ne sont pas configurés pour un débit de données aussi élevé.
Kinesis Agent pour Windows appelle des opérations sur des services AWS dans un compte dans lequel la limite de débit d'appels d'API est trop faible.

Resolutions

Pour résoudre les problèmes de performance, procédez comme suit :

Utilisez l'application de surveillance des ressources Windows pour vérifier l'utilisation de la mémoire, de l'UC, du disque et du réseau. Si vous avez besoin de diffuser de grandes quantités de données avec Kinesis Agent for Windows, vous aurez peut-être besoin de mettre en service une machine dotée de plus grandes capacités dans certains de ces domaines, en fonction de la configuration.
Le filtrage peut vous aider à réduire la quantité de données consignées :
- Consultez les informations relatives à la paire clé-valeur Query dans Configuration de WindowsEventLogSource.
- Consultez les informations relatives au filtrage de pipeline dans Configuration des canaux.
- Consultez le filtrage des métriques Amazon CloudWatch dansConfiguration du récepteur CloudWatch Sink).
Utilisez l'application de surveillance des performances Windows pour afficher les métriques Kinesis Agent for Windows ou diffuser ces métriques vers CloudWatch (consultezSource des métriques prédéfinies de Kinesis Agent pour Windows). Dans l'application de surveillance des performances Windows, vous pouvez ajouter des compteurs pour Kinesis Agent pour les récepteurs et les sources Windows. Ils sont répertoriés sous les catégories de compteurs AWSKinesisTap Sinks (Récepteurs AWSKinesisTap) et AWSKinesisTap Sources (Sources AWSKinesisTap).

Par exemple, pour diagnostiquer les problèmes de performances Kinesis Data Firehose, ajoutez l'Kinesis FirehoseCompteurs de performance.

Si le nombre d'erreurs récupérables est important, consultez les derniers journaux Kinesis Agent pour Windows dans%PROGRAMDATA%\Amazon\AWSKInesisTap\logsRépertoire. Si une limitation se produit pour les récepteurs KinesisStream ou KinesisFirehose, procédez comme suit :
- Si la limitation est due à une diffusion trop rapide des données, envisagez d'augmenter le nombre de partitions pour le flux de données Kinesis. Pour de plus amples informations, veuillez consulterRepartitionnement, mise à l'échelle et traitement parallèledans leKinesis Data Streams - Guide du développeur.
- Envisagez d'augmenter la Kinesis Data Streams API ou d'augmenter la taille du tampon pour le récepteur si les appels d'API sont limités. Pour de plus amples informations, veuillez consulterLimites Kinesis Data Streamsdans leKinesis Data Streams - Guide du développeur.
- Si les données sont diffusées trop rapidement, envisagez de demander une augmentation de limite de débit pour le flux de diffusion Kinesis Data Firehose. Ou, si les appels d'API sont limités, demandez une augmentation de la limite d'appels d'API (consultez Limites d'Amazon Kinesis Data Firehose) ou augmentez la taille du tampon pour le récepteur.
- Après avoir augmenté le nombre de partitions d'un Kinesis Data Streams ou la limite de débit d'un flux de diffusion de Kinesis Data Firehose, modifiez l'Agent Kinesis pour Windowsappsettings.jsonPour augmenter les enregistrements par seconde ou les octets par seconde pour le récepteur. Sinon, Kinesis Agent pour Windows ne peut pas tirer profit de l'augmentation des limites.

S'applique à

Cette information s'applique à Kinesis Agent pour Windows version 1.0.0.0.0.0.115 et aux versions ultérieures.

Manque d'espace sur le disque

Symptoms

Kinesis Agent pour Windows s'exécute sur une machine dont l'espace disque est très faible sur un ou plusieurs lecteurs de disque.

Causes

Plusieurs causes possibles peuvent entraîner ce problème :

Le fichier de configuration de journalisation Kinesis Agent pour Windows n'est pas correct.
La file d'attente persistante Kinesis Agent pour Windows n'est pas configurée correctement.
Une autre application ou un autre service utilise de l'espace disque.

Resolutions

Pour résoudre les problèmes d'espace disque, procédez comme suit :

Si l'espace disque est faible sur le disque qui contient les fichiers journaux de l'Agent Kinesis pour Windows, examinez le répertoire du fichier journal (généralement%PROGRAMDATA%\Amazon\AWSKinesisTap\logs). Assurez-vous de la conservation d'un nombre raisonnable de fichiers journaux et de la taille raisonnable de ces fichiers journaux. Vous pouvez contrôler l'emplacement, la conservation et la description des journaux Kinesis Agent pour Windows en modifiant l'%PROGRAMFILES%\Amazon\AWSKinesisTap\Nlog.xmlFichier de configuration.
Lorsque la fonctionnalité de mise en file d'attente du récepteur est activée, examinez les déclarations du récepteur qui utilisent cette fonctionnalité. Assurez-vous que la paire clé-valeur QueuePath fait référence à un disque disposant de suffisamment d'espace disque pour contenir le nombre maximal de lots spécifié à l'aide de la paire clé-valeur QueueMaxBatches. Si ce n'est pas possible, réduisez la valeur de la paire clé-valeur QueueMaxBatches afin que les données s'intègrent facilement dans l'espace disque restant pour le disque spécifié.
Utilisez l'explorateur de fichiers Windows pour rechercher les fichiers qui utilisent l'espace disque, puis transférez ou supprimez les fichiers en trop. Modifiez la configuration de l'application ou du service utilisant de grandes quantités d'espace disque.

S'applique à

Cette information s'applique à Kinesis Agent pour Windows version 1.0.0.0.0.0.115 et aux versions ultérieures.

Outils de dépannage

En plus de vérifier le fichier de configuration, vous pouvez utiliser l'ktdiag.exe, qui fournit plusieurs autres fonctionnalités pour diagnostiquer et résoudre les problèmes lors de la configuration et de l'utilisation de Kinesis Agent pour Windows. L'outil ktdiag.exe se trouve dans le répertoire %PROGRAMFILES%\Amazon\AWSKinesisTap.

Si vous pensez que les fichiers journaux reposant sur un modèle de fichier spécifique sont écrits dans un répertoire, mais qu'ils ne sont pas traités par l'Agent Kinesis pour Windows, utilisez l'outil/wpour vérifier que ces modifications sont détectées. Supposons par exemple que vous vous attendez à ce que les fichiers journaux reposant sur le modèle de nom de fichier *.log soient écrits dans le répertoire c:\foo. Vous pouvez utiliser le commutateur /w lorsque vous exécutez l'outil ktdiag.exe, en spécifiant le répertoire et le modèle de fichier :
```
cd /D %PROGRAMFILES%\Amazon\AWSKinesisTap
ktdiag /w c:\foo *.log
```
Si les fichiers journaux sont écrits, vous pouvez voir un résultat similaire à ce qui suit :
```
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
```
Si ce n'est pas le cas, il s'agit d'un problème au niveau de l'application ou du service lors de l'écriture des journaux, ou d'un problème de configuration de la sécurité plutôt que d'un problème avec l'Agent Kinesis pour Windows. Si vous obtenez ce résultat, mais que Kinesis Agent pour Windows ne semble toujours pas traiter les journaux, consultezAucune donnée n'est diffusée à partir d'ordinateurs de bureaux ou de serveurs vers les services AWS attendus.
Parfois, les journaux ne sont écrits qu'occasionnellement, mais il serait utile de vérifier que l'Agent Kinesis pour Windows fonctionne correctement. Utilisez le commutateur /log4net pour simuler une application qui écrit des journaux à l'aide de la bibliothèque Log4net, par exemple :
```
cd /D %PROGRAMFILES%\Amazon\AWSKinesisTap
KTDiag.exe /log4net c:\foo\log2.log
```
Cette opération écrit un fichier journal de style Log4net dans le fichier journal c:\foo\log2.log et continue d'ajouter de nouvelles entrées de journal jusqu'à ce qu'une touche soit enfoncée. Vous pouvez configurer plusieurs options à l'aide de commutateurs supplémentaires qui peuvent être spécifiés après le nom de fichier :

Verrouillage : -lm, -li ou -le

Vous pouvez spécifier l'un des commutateurs de verrouillage suivants qui contrôlent la façon dont le fichier journal est verrouillé :

-lm

Un verrouillage minimum est utilisé sur le fichier journal, ce qui permet un accès maximal au fichier journal.

-li

Seuls les threads d'un même processus peuvent accéder au journal en même temps.

-le

Un seul thread à la fois peut accéder au journal. Il s'agit de l'option par défaut.

-tn:millisecondes

Spécifie le nombre de millisecondes entre chaque écriture des entrées de journal. La valeur par défaut est de 1 000 millisecondes (1 seconde).

-sm:octets

Spécifie le nombre d'octets pour chaque entrée de journal. La valeur par défaut est 1 000 octets.

-bk:number

Spécifie le nombre d'entrées de journal à écrire à la fois. La valeur par défaut est 1.
Parfois, il est utile de simuler une application qui écrit dans le journal des événements Windows. Utilisez le commutateur /e pour écrire des entrées de journal dans un journal des événements Windows, par exemple :
```
cd /D %PROGRAMFILES%\Amazon\AWSKinesisTap
KTDiag.exe /e Application
```
Cette opération écrit des données de journal dans le journal d'événements de l'application Windows jusqu'à ce qu'une touche soit enfoncée. Vous pouvez spécifier les options supplémentaires suivantes après le nom du journal :

-tn:millisecondes

Spécifie le nombre de millisecondes entre chaque écriture des entrées de journal. La valeur par défaut est de 1 000 millisecondes (1 seconde).

-sm:octets

Spécifie le nombre d'octets pour chaque entrée de journal. La valeur par défaut est 1 000 octets.

-bk:number

Spécifie le nombre d'entrées de journal à écrire à la fois. La valeur par défaut est 1.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Étape 3 : Interroger les données de journal dans Amazon S3

Création de plug-ins