As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Solução de problemas do Amazon Kinesis Agent para Microsoft Windows Use as instruções a seguir para diagnosticar e corrigir problemas ao usar o Amazon Kinesis Agent para Microsoft Windows. **Topics** + [Não é feito streaming de dados de desktops nem de servidores para os serviços esperados da AWS](#troubleshooting-no-data) + [Às vezes os dados esperados estão ausentes](#troubleshooting-missing-data) + [Os dados chegam em um formato incorreto](#troubleshooting-bad-format) + [Problemas de desempenho](#troubleshooting-poor-performance) + [Sem espaço em disco](#troubleshooting-out-of-disk-space) + [Ferramentas de solução de problemas](#troubleshooting-tools) ## Não é feito streaming de dados de desktops nem de servidores para os serviços esperados da AWS ### Symptoms Ao analisar logs, eventos e métricas hospedados por vários serviços da AWS que estão configurados para receber streams de dados do Kinesis Agent para Windows, você observa que o streaming de dados não está sendo realizado para o Kinesis Agent para Windows. ### Causes Há várias causas possíveis para esse problema: + Uma origem, um coletor ou um pipe está configurado incorretamente. + A autenticação para o Kinesis Agent para Windows do está configurada incorretamente. + A autorização para o Kinesis Agent para Windows do está configurada incorretamente. + Há um erro em uma expressão regular fornecida em uma declaração `DirectorySource`. + Um diretório inexistente está especificado para uma declaração `DirectorySource`. + Valores inválidos estão sendo fornecidos para os serviços da AWS que, por sua vez, rejeitam solicitações do Kinesis Agent para Windows. + Um coletor está fazendo referência a um recurso que não existe na região da AWS especificada ou implícita da. + Uma consulta inválida está especificada para uma declaração `WindowsEventLogSource`. + Um valor inválido está especificado para o par de chave-valor `InitialPosition` para uma origem. + O arquivo de configuração `appsettings.json` não está em conformidade com o esquema JSON para esse arquivo. + Os dados estão fazendo streaming para uma região diferente da selecionada no AWS Management Console. + Kinesis Agent para Windows não está instalado corretamente ou não está em execução. ### Resolutions Para resolver problemas de streaming de dados, execute as seguintes etapas: 1. Examine os logs do Kinesis Agent para Windows no`%PROGRAMDATA%\Amazon\AWSKinesisTap\logs`Diretório. Procure a string `ERROR`. 1. Se uma origem ou um coletor não foi carregado, faça o seguinte: 1. Examine a mensagem de erro e encontre o `Id` da origem ou do coletor. 1. Verifique a declaração de origem ou de coletor que corresponde a esse `Id` no arquivo de configuração `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json` para todos os erros relacionados à mensagem de erro encontrada. Para obter mais detalhes, consulte [Configurando o Amazon Kinesis Agent para Microsoft Windows](configuring-kinesis-agent-windows.md). 1. Corrija todos os problemas do arquivo de configuração relacionados ao erro. 1. Interrompa e inicie o serviço `AWSKinesisTap`. Depois, verifique o arquivo de log mais recente para ver se os problemas de configuração foram resolvidos. 1. Se a mensagem de erro indicar que um `SourceRef` ou `SinkRef` não foi encontrado para um pipe, faça o seguinte: 1. Anote o `Id` do pipe. 1. Examine a declaração de pipe no arquivo de configuração `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json` correspondente ao `Id` anotado. Certifique-se de que os valores dos pares de chave/valor `SourceRef` e `SinkRef` sejam `Id`s corretamente digitados para as declarações de origem e de coletor que você pretendia referenciar. Corrija todos os erros de digitação ou ortografia. Se uma declaração de origem ou coletor estiver ausente do arquivo de configuração, adicione a declaração. Para obter mais informações, consulte [Configurando o Amazon Kinesis Agent para Microsoft Windows](configuring-kinesis-agent-windows.md). 1. Interrompa e inicie o serviço `AWSKinesisTap`. Depois, verifique o arquivo de log mais recente para ver se os problemas de configuração foram resolvidos. 1. Se a mensagem de erro indicar que um usuário ou função do IAM do não está autorizado a executar determinadas operações, faça o seguinte: 1. Verifique se o usuário ou a função correta do IAM está sendo usado pelo Kinesis Agent para Windows. Se não for, revise[Configuração de segurança do coletor](sink-object-declarations.md#configuring-kinesis-agent-windows-sink-security-configuration)e ajuste o modo como o Kinesis Agent para Windows é autenticado para garantir que o usuário ou a função do IAM correto esteja sendo usado. 1. Se a função ou o usuário correto do IAM estiver sendo usado, com o AWS Management Console, examine as políticas que estão associadas ao usuário ou à função. Verifique se o usuário ou a função tem todas as permissões mencionadas na mensagem de erro para todos os recursos da AWS que o Kinesis Agent para Windows acessa. Para obter mais informações, consulte [Configuração da autorização da](sink-object-declarations.md#configuring-kinesis-agent-windows-authorization). 1. Interrompa e inicie o serviço `AWSKinesisTap`. Depois verifique o arquivo de log mais recente para ver se os problemas de segurança foram resolvidos. 1. Se a mensagem de erro indicar que há um erro de argumento ao analisar uma expressão regular que está contida no arquivo de configuração `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json`, faça o seguinte: 1. Examine a expressão regular no arquivo de configuração. 1. Verifique a sintaxe da expressão regular. Há vários sites que você pode usar para verificar expressões regulares ou use as seguintes linhas de comando para verificar expressões regulares para uma declaração de origem `DirectorySource`: ``` cd /D %PROGRAMFILES%\Amazon\AWSKinesisTap ktdiag.exe /r {{sourceId}} ``` Substitua {{sourceId}} pelo valor do par de chave/valor `Id` da declaração de origem `DirectorySource` com uma expressão regular incorreta. 1. Faça as correções necessárias na expressão regular no arquivo de configuração para que ela seja válida. 1. Interrompa e inicie o serviço `AWSKinesisTap`. Depois, verifique o arquivo de log mais recente para ver se os problemas de configuração foram resolvidos. 1. Se a mensagem de erro indicar que há um erro de argumento ao analisar uma expressão regular que não está contida no arquivo de configuração `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json` e está relacionada a um coletor específico, faça o seguinte: 1. Localize a declaração do coletor no arquivo de configuração. 1. Verifique se os pares de chave-valor que são especificamente relacionados a um serviço da AWS estão usando nomes em conformidade com as regras de validação desse serviço. Por exemplo, nomes de grupos do CloudWatch Logs devem conter apenas um conjunto de caracteres especificado usando a expressão regular`[\.\-_/#A-Za-z0-9]+`. 1. Corrija os nomes inválidos nos pares de chave-valor para a declaração do coletor e garanta que esses recursos estejam configurados corretamente na AWS. 1. Interrompa e inicie o serviço `AWSKinesisTap`. Depois, verifique o arquivo de log mais recente para ver se os problemas de configuração foram resolvidos. 1. Se a mensagem de erro indicar que uma origem ou um coletor não pode ser carregado devido a um parâmetro nulo ou ausente, faça o seguinte: 1. Anote o `Id` da origem ou do coletor. 1. Localize a declaração de origem ou de coletor que corresponda ao `Id` anotado no arquivo de configuração `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json`. 1. Analise os pares de chave-valor que são fornecidos na declaração de origem ou coletor em comparação com os requisitos de tipo de origem ou coletor na documentação [Configurando o Amazon Kinesis Agent para Microsoft Windows](configuring-kinesis-agent-windows.md) relevante para o tipo de coletor. Adicione todos os pares chave-valor ausentes obrigatórios para a declaração de origem ou coletor. 1. Interrompa e inicie o serviço `AWSKinesisTap`. Depois, verifique o arquivo de log mais recente para ver se os problemas de configuração foram resolvidos. 1. Se a mensagem de erro indicar que um nome de diretório é inválido, faça o seguinte: 1. Localize o nome de diretório inválido no arquivo de configuração `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json`. 1. Verifique se esse diretório existe e contém os arquivos de log dos quais deve ser feito streaming. 1. Corrija todos os erros de digitação ou erros no nome do diretório especificado no arquivo de configuração. 1. Interrompa e inicie o serviço `AWSKinesisTap`. Depois, verifique o arquivo de log mais recente para ver se os problemas de configuração foram resolvidos. 1. Se a mensagem de erro indicar que um recurso não existe: 1. Localize a referência do recurso que não existe em uma declaração de coletor no arquivo de configuração `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json`. 1. Use o AWS Management Console para localizar o recurso na região correta da AWS que deve ser usada na declaração de coletor. Compare-o com o que foi especificado no arquivo de configuração. 1. Altere a declaração do coletor no arquivo de configuração para ter o nome de recurso e a região corretos. 1. Interrompa e inicie o serviço `AWSKinesisTap`. Depois, verifique o arquivo de log mais recente para ver se os problemas de configuração foram resolvidos. 1. Se a mensagem de erro indicar que uma consulta é inválida para uma `WindowsEventLogSource`, faça o seguinte: 1. No arquivo de configuração `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json`, localize a declaração `WindowsEventLogSource` com o mesmo `Id` que na mensagem de erro. 1. Verifique se o valor do par de chave-valor `Query` na declaração de origem está em conformidade com as consultas de eventos [ e Event XML](https://msdn.microsoft.com/en-us/library/bb399427(v=vs.90).aspx). 1. Faça as alterações na consulta para que ela fique em conformidade. 1. Interrompa e inicie o serviço `AWSKinesisTap`. Depois, verifique o arquivo de log mais recente para ver se os problemas de configuração foram resolvidos. 1. Se a mensagem de erro indicar que há uma posição inicial inválida, faça o seguinte: 1. No arquivo de configuração `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json`, localize a declaração de origem com o mesmo `Id` que na mensagem de erro. 1. Altere o valor do par de chave-valor `InitialPosition` na declaração de origem para estar em conformidade com os valores permitidos, conforme descrito em [Configuração de marcador](source-object-declarations.md#advanced-source-configuration). 1. Interrompa e inicie o serviço `AWSKinesisTap`. Depois, verifique o arquivo de log mais recente para ver se os problemas de configuração foram resolvidos. 1. Garanta que o arquivo de configuração `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json` cumpra o esquema JSON. 1. Em uma janela do prompt de comando, invoque as seguintes linhas: ``` cd /D %PROGRAMFILES%\Amazon\AWSKinesisTap %PROGRAMFILES%\Amazon\AWSKinesisTap\ktdiag.exe /c ``` 1. Corrija todos os problemas detectados com o arquivo de configuração `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json`. 1. Interrompa e inicie o serviço `AWSKinesisTap`. Depois, verifique o arquivo de log mais recente para ver se os problemas de configuração foram resolvidos. 1. Altere o nível de registro em log para obter informações de registro em log mais detalhadas. 1. Substitua o arquivo de configuração `%PROGRAMFILES%\Amazon\AWSKinesisTap\nlog.xml` pelo seguinte conteúdo: ``` ``` 1. Interrompa e inicie o serviço `AWSKinesisTap`. Depois verifique o arquivo de log mais recente para ver se há mensagens adicionais no log que podem ajudar a diagnosticar e resolver o problema. 1. Verifique se você está examinando os recursos na região correta do no AWS Management Console. 1. Verifique se o Kinesis Agent para Windows está instalado e em execução. 1. No Windows, escolha **Start (Iniciar)** e navegue até **Control Panel (Painel de controle)**, **Administrative Tools (Ferramentas administrativas)**, **Services (Serviço)**. 1. Encontre o serviço **AWSKinesisTap**. 1. Se o serviço AWSKinesisTap não estiver visível, instale o Kinesis Agent para Windows usando as instruções em[Conceitos básicos do Amazon Kinesis Agent para Microsoft Windows](getting-started.md). 1. Se o serviço estiver visível, determine se ele está em execução. Se não estiver em execução, abra o menu de contexto (clique com o botão direito do mouse) do serviço e escolha **Start (Iniciar)**. 1. Verifique se o serviço foi iniciado examinando o arquivo de log mais recente no diretório `%PROGRAMDATA%\Amazon\AWSKinesisTap\logs`. ### Aplica-se a Essas informações se aplicam ao Kinesis Agent para Windows versão 1.0.0.115 e posterior. ## Às vezes os dados esperados estão ausentes ### Symptoms O Kinesis Agent para Windows faz streaming dos dados com êxito na maior parte do tempo, mas ocasionalmente alguns dados ficam ausentes. ### Causes Há várias causas possíveis para esse problema: + O recurso de marcação não está sendo usado. + Os limites de taxa de dados para os serviços da AWS da foram excedidos com base na configuração atual desses serviços. + Os limites de taxas de chamada de API para serviços da AWS da foram excedidos com base no atual`appsettings.json`e os limites da conta da AWS. ### Resolutions Para resolver problemas de ausência de dados, execute as seguintes etapas: 1. Considere usar o recurso de marcação documentado em [Configuração de marcador](source-object-declarations.md#advanced-source-configuration). Ele ajuda a garantir que todos os dados sejam enviados, mesmo quando o Kinesis Agent para Windows é interrompido e iniciado. 1. Use as métricas incorporadas do Kinesis Agent para o Windows para descobrir problemas: 1. Habilite o streaming do Kinesis Agent para Windows, conforme descrito em[Configuração do Kinesis Agent para Pipes Métricos do Windows](pipe-object-declarations.md#kinesis-agent-metric-pipe-configuration). 1. Se houver um número significativo de erros não recuperáveis para um ou mais coletores, determine quantos bytes ou registros estão sendo enviados por segundo. Depois determine se está dentro dos limites configurados para esses serviços da AWS na região e na conta onde está sendo feito streaming dos dados. 1. Quando os limites são excedidos, reduza a taxa ou a quantidade de dados que estão sendo enviados, solicite aumentos de limite ou aumente o estilhaçamento, se aplicável. 1. Depois de fazer ajustes, continue a monitorar as métricas incorporadas do Kinesis Agent para Windows para garantir que a situação tenha sido resolvida. Para obter mais informações sobre os limites do Kinesis Data Streams, consulte[Limites do Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/service-sizes-and-limits.html)no*Kinesis Data Streams*. Para obter mais informações sobre os limites do Kinesis Data Firehose, consulte[Limites do Amazon Kinesis Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/limits.html). ### Aplica-se a Essas informações se aplicam ao Kinesis Agent para Windows versão 1.0.0.115 e posterior. ## Os dados chegam em um formato incorreto ### Symptoms Os dados chegam ao serviço da AWS no formato incorreto. ### Causes Há várias causas possíveis para esse problema: + O valor do par de chave-valor `Format` para uma declaração de coletor no arquivo de configuração `appsettings.json` está incorreto. + O valor para o par de chave-valor `RecordParser` em uma declaração `DirectorySource` está incorreto. + As expressões regulares em uma declaração `DirectorySource` que usa o analisador de registros `Regex` estão incorretas. ### Resolutions Para resolver problemas de formatação incorreta, execute as seguintes etapas: 1. Revise as declarações do coletor no arquivo de configuração `%PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json`. 1. Certifique-se de que o valor correto do par de chave-valor `Format` esteja especificado para cada declaração de coletor. Para obter mais informações, consulte [Declarações de coletor](sink-object-declarations.md). 1. Se as origens com declarações `DirectorySource` estão conectadas por pipes a coletores que especificam valores `xml` ou `json` para o par de chave-valor `Format`, certifique-se de que essas origens especifiquem um dos seguintes valores para o par de chave-valor `RecordParser`: + `SingleLineJson` + `Regex` + `SysLog` + `Delimited` Outros analisadores de registros são apenas baseados em texto e não funcionam corretamente com coletores que exijam a formatação JSON ou XML. 1. Se os registros de log não estiverem sendo corretamente analisados pelo tipo de origem `DirectorySource`, invoque as seguintes linhas em uma janela de prompt de comando para verificar os pares de chave-valor de timestamp e expressão regular especificados na declaração `DirectorySource`: ``` cd /D %PROGRAMFILES%\Amazon\AWSKinesisTap ktdiag.exe /r {{sourceID}} ``` Substitua {{sourceID}} pelo valor do par de chave-valor `Id` da declaração de origem `DirectorySource` que parece não estar funcionando corretamente. Corrija todos os problemas relatados pelo `ktdiag.exe`. ### Aplica-se a Essas informações se aplicam ao Kinesis Agent para Windows versão 1.0.0.115 e posterior. ## Problemas de desempenho ### Symptoms Aplicativos e serviços têm aumento de latência depois que o Kinesis Agent para Windows é instalado e iniciado. ### Causes Há várias causas possíveis para esse problema: + O computador no qual o Kinesis Agent para Windows é executado não tem capacidade suficiente para fazer streaming do volume de dados desejado. + Está sendo feito streaming de dados desnecessários para um ou mais serviços da AWS. + Kinesis Agent para Windows está fazendo streaming de dados para serviços da AWS que não estão configurados para uma taxa de dados tão alta. + O Kinesis Agent para Windows está invocando operações em serviços da AWS em uma conta na qual o limite da taxa de chamadas de APIs é muito baixo. ### Resolutions Para resolver problemas de desempenho, execute as seguintes etapas: 1. Use o aplicativo de monitor de recursos do Windows para verificar o uso de memória, CPU, disco e rede. Se você precisa fazer streaming de grandes quantidades de dados com o Kinesis Agent para Windows, pode ser necessário provisionar um computador com capacidades mais elevadas em algumas dessas áreas, dependendo da configuração. 1. Talvez você consiga reduzir o volume de dados registrados usando a filtragem: + Consulte o par de chave-valor `Query` em [Configuração de WindowsEventLogSource](source-object-declarations.md#window-event-source-configuration). + Consulte a filtragem de pipeline em [Configuração de pipes](pipe-object-declarations.md#kinesis-agent-pipe-configuration). + Consulte a filtragem de métricas do Amazon CloudWatch[Configuração do CloudWatch](sink-object-declarations.md#sink-object-declarations-cloud-watch)). 1. Use o aplicativo de monitor de desempenho do Windows para visualizar as métricas do Kinesis Agent para Windows do ou faça streaming dessas métricas para o CloudWatch (consulte[Origem de métricas incorporadas do Kinesis Agent para Windows](source-object-declarations.md#kinesis-agent-builin-metrics-source)). No aplicativo de monitor de desempenho do Windows, é possível adicionar contadores para coletores e origens do Kinesis Agent para Windows. Eles estão listados nas categorias de contador **AWSKinesisTap Sinks (Coletores do AWSKinesisTap)** e **AWSKinesisTap Sources (Origens do AWSKinesisTap)**. ![Captura de tela do console mostrando as categorias de contador do Kinesis Agent para Windows no aplicativo de monitor de desempenho do Windows.](http://docs.aws.amazon.com/pt_br/kinesis-agent-windows/latest/userguide/images/AddPerformanceCountersScreenshot.png) Por exemplo, para diagnosticar problemas de desempenho do Kinesis Data Firehose, adicione o**Kinesis Firehose**Contadores de desempenho. ![Captura de tela do console mostrando os contadores de desempenho Kinesis Data Firehose.](http://docs.aws.amazon.com/pt_br/kinesis-agent-windows/latest/userguide/images/KinesisFirehosePerformanceCountersScreenshot.png) Se houver um grande número de erros recuperáveis, inspecione os logs mais recentes do Kinesis Agent para Windows no`%PROGRAMDATA%\Amazon\AWSKInesisTap\logs`Diretório. Se a limitação estiver ocorrendo para os coletores `KinesisStream` ou `KinesisFirehose`, faça o seguinte: + Se ocorrer a limitação devido ao streaming muito rápido dos dados, considere aumentar o número de estilhaços para o stream de dados do Kinesis. Para obter mais informações, consulte[Reestilhaçamento, escalabilidade e processamento paralelo](https://docs.aws.amazon.com/streams/latest/dev/kinesis-record-processor-scaling.html)no*Kinesis Data Streams*. + Considere o aumento do limite de chamadas de API para Kinesis Data Streams ou o aumento do tamanho do buffer para o coletor se as chamadas de API estiverem sendo limitadas. Para obter mais informações, consulte[Limites do Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/service-sizes-and-limits.html)no*Kinesis Data Streams*. + Se o streaming dos dados for feito com muita rapidez, considere solicitar um aumento no limite da taxa para o stream de entrega do Kinesis Data Firehose. Ou se as chamadas de API estiverem sendo limitadas, solicite um aumento do limite de chamadas de API (consulte [Limites do Amazon Kinesis Firehose](https://docs.aws.amazon.com/firehose/latest/dev/limits.html)) ou aumente o tamanho do buffer para o coletor. + Depois de aumentar o número de estilhaços em um stream de Kinesis Data Streams ou aumentar o limite de taxa para um stream de entrega do Kinesis Data Firehose, revise o Kinesis Agent para Windows`appsettings.json`Arquivo de configuração para aumentar os registros ou bytes por segundo para o coletor. Caso contrário, o Kinesis Agent para Windows não pode aproveitar o aumento de limites. ### Aplica-se a Essas informações se aplicam ao Kinesis Agent para Windows versão 1.0.0.115 e posterior. ## Sem espaço em disco ### Symptoms O Kinesis Agent para Windows está em execução em uma máquina que tem muito pouco espaço em disco em uma ou mais unidades de disco. ### Causes Há várias causas possíveis para esse problema: + O Kinesis Agent para o Windows Log de configuração do está incorreto. + A fila persistente do Kinesis Agent para Windows do está configurada incorretamente. + Algum outro aplicativo ou serviço está consumindo espaço em disco. ### Resolutions Para resolver problemas de espaço em disco, execute as seguintes etapas: + Se o espaço em disco estiver baixo no disco que contém os arquivos de log do Kinesis Agent para Windows, examine o diretório de arquivos de log (normalmente`%PROGRAMDATA%\Amazon\AWSKinesisTap\logs`). Certifique-se de que um número razoável de arquivos de log esteja sendo mantido e que os arquivos de log tenha um tamanho razoável. Você pode controlar o local, a retenção e o detalhamento dos logs do Kinesis Agent para Windows editando o`%PROGRAMFILES%\Amazon\AWSKinesisTap\Nlog.xml`Arquivo de configuração. + Quando o recurso de enfileiramento do coletor estiver ativado, examine as declarações de coletor que usam esse recurso. Certifique-se de que o par de chave-valor `QueuePath` faça referência a uma unidade de disco com espaço suficiente para conter o número máximo de lotes especificado usando o par de chave-valor `QueueMaxBatches`. Se isso não for possível, reduza o valor do par de chave-valor `QueueMaxBatches` para que os dados se encaixem facilmente no espaço em disco restante da unidade especificada. + Use o Explorador de Arquivos do Windows para localizar os arquivos que consomem o espaço em disco e transfira ou exclua os arquivos em excesso. Altere a configuração do aplicativo ou do serviço que consome grandes quantidades de espaço em disco. ### Aplica-se a Essas informações se aplicam ao Kinesis Agent para Windows versão 1.0.0.115 e posterior. ## Ferramentas de solução de problemas Além de verificar o arquivo de configuração do, é possível usar o`ktdiag.exe`, que fornece vários outros recursos para diagnosticar e resolver problemas ao configurar e usar o Kinesis Agent para Windows. A ferramenta `ktdiag.exe` está localizada no diretório `%PROGRAMFILES%\Amazon\AWSKinesisTap`. + Se você acredita que os arquivos de log com um determinado padrão estão sendo gravados em um diretório, mas não estão sendo processados pelo Kinesis Agent para Windows, use a opção`/w`para verificar se essas alterações estão sendo detectadas. Por exemplo, suponha que os arquivos de log com o nome `*.log` devam ser gravados no diretório `c:\foo`. Você pode usar a opção `/w` ao executar a ferramenta `ktdiag.exe` especificando o diretório e o padrão de arquivo: ``` cd /D %PROGRAMFILES%\Amazon\AWSKinesisTap ktdiag /w c:\foo *.log ``` Se os arquivos de log estiverem sendo gravados, você poderá ver uma saída semelhante à seguinte: ``` 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 nenhuma saída estiver ocorrendo, há um problema de gravação de logs no aplicativo ou no serviço ou há um problema de configuração de segurança e não um problema com o Kinesis Agent para Windows. Se essa saída estiver ocorrendo, mas o Kinesis Agent para Windows ainda não estiver processando os logs, consulte[Não é feito streaming de dados de desktops nem de servidores para os serviços esperados da AWS](#troubleshooting-no-data). + Às vezes, os logs são gravados apenas ocasionalmente, mas seria útil verificar se o Kinesis Agent para Windows está funcionando corretamente. Use a opção `/log4net` para simular um aplicativo gravando logs com a biblioteca `Log4net`; por exemplo: ``` cd /D %PROGRAMFILES%\Amazon\AWSKinesisTap KTDiag.exe /log4net c:\foo\log2.log ``` Isso grava um arquivo de log no estilo `Log4net` no arquivo de log `c:\foo\log2.log` e continua incluindo novas entradas de log até uma tecla ser pressionada. Você pode configurar várias opções usando opções adicionais que podem ser especificadas após o nome do arquivo: Bloqueio: `-lm`, `-li` ou `-le` Você pode especificar uma das seguintes opções de bloqueio que controlam como o arquivo de log é bloqueado: `-lm` A quantidade mínima de bloqueio é usada no arquivo de log permitindo o acesso máximo ao arquivo de log. `-li` Somente threads dentro do mesmo processo podem acessar o log ao mesmo tempo. `-le` Apenas um thread de cada vez pode acessar o log. Esse é o padrão. `-tn:`{{milissegundos}} Especifica o número de {{milissegundos}} entre a gravação de entradas de log. O padrão é 1.000 milissegundos (1 segundo). `-sm:`{{bytes}} Especifica o número de {{bytes}} para cada entrada de log. O padrão é 1.000 bytes. `-bk:`{{número}} Especifica o {{número}} de entradas de log a serem gravadas por vez. O padrão é 1. + Às vezes, é útil simular um aplicativo que grave no log de eventos do Windows. Use a opção `/e` para gravar entradas em um log de eventos do Windows, por exemplo: ``` cd /D %PROGRAMFILES%\Amazon\AWSKinesisTap KTDiag.exe /e Application ``` Isso grava entradas no log de eventos do aplicativo do Windows até uma tecla ser pressionada. Você também pode especificar as seguintes opções adicionais após o nome do log: `-tn:`{{milissegundos}} Especifica o número de {{milissegundos}} entre a gravação de entradas de log. O padrão é 1.000 milissegundos (1 segundo). `-sm:`{{bytes}} Especifica o número de {{bytes}} para cada entrada de log. O padrão é 1.000 bytes. `-bk:`{{número}} Especifica o {{número}} de entradas de log a serem gravadas por vez. O padrão é 1.