Solução de problemas do Amazon Kinesis Agent para Microsoft Windows - Agente do Amazon Kinesis do Microsoft Windows

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.

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\logsDiretó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.

      2. 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.

      3. Corrija todos os problemas do arquivo de configuração relacionados ao erro.

      4. 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.

    2. 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.

      2. 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 Ids 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.

      3. 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.

    3. 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, reviseConfiguração de segurança do coletore 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.

      2. 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 .

      3. 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.

    4. 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.

      2. 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.

      3. Faça as correções necessárias na expressão regular no arquivo de configuração para que ela seja válida.

      4. 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.

    5. 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.

      2. 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]+.

      3. 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.

      4. 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.

    6. 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.

      2. Localize a declaração de origem ou de coletor que corresponda ao Id anotado no arquivo de configuração %PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json.

      3. 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 relevante para o tipo de coletor. Adicione todos os pares chave-valor ausentes obrigatórios para a declaração de origem ou coletor.

      4. 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.

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

      2. Verifique se esse diretório existe e contém os arquivos de log dos quais deve ser feito streaming.

      3. Corrija todos os erros de digitação ou erros no nome do diretório especificado no arquivo de configuração.

      4. 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.

    8. 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.

      2. 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.

      3. Altere a declaração do coletor no arquivo de configuração para ter o nome de recurso e a região corretos.

      4. 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.

    9. 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.

      2. 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.

      3. Faça as alterações na consulta para que ela fique em conformidade.

      4. 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.

    10. 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.

      2. 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.

      3. 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.

  2. 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
    2. Corrija todos os problemas detectados com o arquivo de configuração %PROGRAMFILES%\Amazon\AWSKinesisTap\appsettings.json.

    3. 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.

  3. 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:

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

  4. Verifique se você está examinando os recursos na região correta do no AWS Management Console.

  5. 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).

    2. Encontre o serviço AWSKinesisTap.

    3. Se o serviço AWSKinesisTap não estiver visível, instale o Kinesis Agent para Windows usando as instruções emConceitos básicos do Amazon Kinesis Agent para Microsoft Windows.

    4. 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).

    5. 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 atualappsettings.jsone 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. Ele ajuda a garantir que todos os dados sejam enviados, mesmo quando o Kinesis Agent para Windows é interrompido e iniciado.

  2. 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 emConfiguração do Kinesis Agent para Pipes Métricos do Windows.

    2. 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.

    3. 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.

    4. 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, consulteLimites do Kinesis Data StreamsnoKinesis Data Streams. Para obter mais informações sobre os limites do Kinesis Data Firehose, consulteLimites do Amazon Kinesis Data Firehose.

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.

  2. 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.

  3. 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.

  4. 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.

  2. Talvez você consiga reduzir o volume de dados registrados usando a filtragem:

  3. 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 (consulteOrigem de métricas incorporadas do Kinesis Agent para Windows). 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.

    Por exemplo, para diagnosticar problemas de desempenho do Kinesis Data Firehose, adicione oKinesis FirehoseContadores de desempenho.

    Captura de tela do console mostrando os contadores de desempenho Kinesis Data Firehose.

    Se houver um grande número de erros recuperáveis, inspecione os logs mais recentes do Kinesis Agent para Windows no%PROGRAMDATA%\Amazon\AWSKInesisTap\logsDiretó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, consulteReestilhaçamento, escalabilidade e processamento paralelonoKinesis 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, consulteLimites do Kinesis Data StreamsnoKinesis 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) 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 Windowsappsettings.jsonArquivo 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.xmlArquivo 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 oktdiag.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/wpara 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, consulteNão é feito streaming de dados de desktops nem de servidores para os serviços esperados da AWS.

  • À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.