Diagnosticar e Solucionar Problemas do Pipeline de Processamento de Log

Após a ingestão de seus dados de log no Logging Analytics, o processamento dos dados começa de forma assíncrona. Durante o processamento de dados, se for encontrado um erro relacionado à análise ou interpretação dos dados de log, a mensagem de erro será exibida junto com os dados de log no Log Explorer.

Para detectar o erro e diagnosticar e solucionar problemas de seu pipeline de processamento de log identificando o tipo de erro, use a métrica Processando Erros. Para ver as etapas de acesso à métrica Erros de Processamento, consulte Monitorar Métricas de Serviço do Logging Analytics.

Quando erros são detectados, a métrica Erros de Processamento exibe uma linha para cada tipo de coleta ativado na tenancy ou no compartimento. Passe o cursor sobre os pontos de dados do gráfico para exibir mais detalhes sobre o erro. Siga estas etapas para exibir as métricas por tipo de erro:

  1. Clique no menu Opções no canto superior direito da métrica Erros de Processamento e selecione Exibir no Explorador de Métricas.

    A métrica agora é exibida no Explorador de Métricas. Aqui, você pode exibir o gráfico com mais detalhes.

  2. Clique em Editar Consultas e selecione Nome da Dimensão como errorType e Valor da Dimensão como o tipo de erro que você observou no Log Explorer, por exemplo, LogParserMismatch.

    Clique em Atualizar Gráfico para atualizar a visualização do gráfico. O gráfico agora exibirá as métricas do errorType.

    Você pode alternar para a view Tabela de Dados e ver uma representação tabular dos pontos de dados de erro coletados.

A seguir estão os vários tipos de erros reportados por meio desta métrica para processamento de log:

Tipo de Erro Descrição Correção Recomendada

LogParserMismatch

Os parsers definidos na origem não correspondem ao registro de log. Por exemplo,

  • A expressão regular não corresponde aos dados de log.
  • A expressão XPath não existe no registro de log json ou XML.

Certifique-se de que exista pelo menos um parser correspondente para fazer parsing dos dados.

LogFieldParserMismatch

Os analisadores definidos na origem não correspondem ao campo do registro de log. Por exemplo, a expressão regular não corresponde ao campo dos dados de log ou a expressão XPath não existe no campo do registro de log json ou XML.

  • A expressão regular não corresponde ao campo dos dados de log.
  • A expressão XPath não existe no campo do registro de log json ou XML.

Certifique-se de que exista pelo menos um analisador de campo correspondente para analisar os dados no campo.

LogParsingTookTooLong

Um dos parsers definidos na origem sofreu timeout porque a execução da expressão regular levou mais de 3 segundos. A expressão regular pode ser complexa ou o registro de log é muito longo para a expressão regular.

Se isso ocorrer três vezes para um pacote de dados (um pacote é um arquivo zip de alguns registros de log), o restante dos registros de log no pacote não será analisado e será sinalizado com esse tipo de erro de parsing com a mensagem excedeu o timeout máximo de regex do parser base: 3.

Use expressões regulares mais rápidas no(s) parser(es) da origem para que o parsing não expire. Consulte Gravar Expressões Regulares de Executantes.

LogFieldParsingTookTooLong

O parser definido para o campo sofreu timeout porque a execução da expressão regular levou mais de 3 segundos. A expressão regular pode ser complexa ou o registro de log é muito longo para a expressão regular.

Se isso ocorrer três vezes para um pacote de dados (um pacote é um arquivo zip de alguns registros de log), o restante dos registros de log no pacote não será analisado e será sinalizado com esse tipo de erro de parsing com a mensagem Falha de análise: excedeu o timeout máximo de regex do parser de campo: 3, parser: baseparser, level1fieldparser, level2fieldparser.

Use expressões regulares mais rápidas no(s) parser(es) de campo da origem para que a análise não expire. Consulte Gravar Expressões Regulares de Executantes.

LogParsingInvalidStructure

Há uma incompatibilidade entre os dados identificados para coleta e a definição do parser.

Por exemplo,

  • A expressão inicial de entrada não tem correspondência no arquivo JSON ou XML fornecido, resultando em entradas de log ZERO coletadas
  • Quando a origem tem um tipo de parser Regex, mas um arquivo JSON está disponível para coleta

Se isso ocorrer para um pacote de dados, o restante dos registros de log no pacote não será analisado e será sinalizado com esse tipo de erro de análise com a mensagem: Falha de análise: número máximo excedido de entradas estruturadas inválidas do parser base: 3.

Verifique sua definição de parser e certifique-se de que os dados de entrada estejam de acordo com a definição fornecida. Criar um Parser

LogFieldParsingInvalidStructure

Há uma incompatibilidade entre os dados identificados para coleta e a definição do analisador de campo.

Por exemplo,

  • A expressão inicial de entrada não tem correspondência no arquivo JSON ou XML fornecido, resultando em entradas de log ZERO coletadas
  • Quando a origem tem um tipo de parser Regex, mas um arquivo JSON está disponível para coleta

Se isso ocorrer três vezes para um pacote de dados, o restante dos registros de log no pacote não será analisado e será sinalizado com esse tipo de erro de análise com a mensagem: Falha de análise: excedeu o número máximo de entradas estruturadas inválidas do parser de campo: 3, parser: baseparser, fieldparser.

Verifique sua definição de parser de campo e certifique-se que os dados de entrada estejam em conformidade com a definição fornecida. Criar um Parser