Solucionar problemas do Azure Stream Analytics usando logs de recursos

Ocasionalmente, um trabalho do Stream Analytics do Azure interrompe o processamento de forma inesperada. As falhas podem ser causadas por um resultado de consulta inesperado, pela conexão com dispositivos ou por uma interrupção inesperada do serviço. Os logs de recursos no Azure Stream Analytics podem ajudá-lo a identificar a causa dessas falhas e reduzir o tempo de recuperação.

Habilite os logs de recursos para todos os trabalhos do Stream Analytics para ajudar na depuração e monitoramento.

Tipos de log do Stream Analytics

O Stream Analytics oferece dois tipos de logs:

• Logs de atividade (sempre ativados), que fornecem informações sobre as operações realizadas nas tarefas.

• Logs de recursos (configuráveis), que fornecem informações mais detalhadas sobre tudo o que acontece com um trabalho. Os logs de recursos são iniciados quando o trabalho é criado e terminam quando o trabalho é excluído. Eles abrangem eventos quando o trabalho é atualizado e durante sua execução.

Depurar trabalhos do Stream Analytics usando logs de atividades

Os logs de atividades são ativados por padrão e fornecem insights de alto nível sobre as operações realizadas pelo trabalho do Stream Analytics. As informações presentes nos logs de atividades podem ajudar a encontrar a causa raiz dos problemas que afetam seu trabalho. Para usar logs de atividades no Stream Analytics, siga estas etapas:

1. Entre no portal do Azure e selecione Log de atividades em Visão Geral.

   

2. Você pode ver uma lista das operações que foram executadas. Qualquer operação que fez sua tarefa falhar tem uma bolha de informações vermelha.

3. Selecione uma operação para ver a exibição do respectivo resumo. As informações aqui geralmente são limitadas. Para obter mais detalhes sobre a operação, selecioneJSON.

   

4. Role para baixo até a seção Propriedades do JSON, que fornece os detalhes do erro que causou a operação com falha. Neste exemplo, a falha foi causada por um erro em tempo de execução devido a valores de latitude fora dos limites. Uma discrepância nos dados que um trabalho do Stream Analytics processa causa um erro de dados. Você pode aprender sobre erros de dados de entrada e saída diferentes e por que eles ocorrem.

   

5. Execute ações corretivas com base na mensagem de erro no JSON. Neste exemplo, adicione verificações para garantir que o valor de latitude esteja entre -90 graus e 90 graus.

6. Se a mensagem de erro nos logs de atividades não for útil para identificar a causa raiz, habilite os logs de recursos e use Azure Monitor logs.

Enviar diagnóstico do Stream Analytics para logs de Azure Monitor

Ative os logs de recursos e envie-os para Azure Monitor logs. Os logs de recursos estão desativados por padrão.

1. Crie um espaço de trabalho do Log Analytics se você ainda não tiver um. Coloque seu espaço de trabalho do Log Analytics na mesma região do trabalho do Stream Analytics.

2. Faça login no portal do Azure e navegue até a sua tarefa do Stream Analytics. Em Monitoramento, selecione Logs de diagnóstico. Em seguida, selecione ativar o diagnóstico.

   

3. Forneça um Nome no Nome das configurações de diagnóstico e marque as caixas de Execução e Criação em log e AllMetrics em métrica. Em seguida, selecione Enviar para o Log Analytics e escolha seu espaço de trabalho. Selecione Salvar.

   

4. Quando seu trabalho do Stream Analytics é iniciado, os logs de recursos são encaminhados para seu espaço de trabalho do Log Analytics. Para exibir os logs de recursos para seu trabalho, selecione Logs na seção Monitoramento.

   

5. O Azure Stream Analytics fornece consultas predefinidas que lhe permitem pesquisar facilmente os logs nos quais você estiver interessado. Você pode selecionar qualquer consulta predefinida no painel à esquerda e, em seguida, selecionar Executar. Você verá os resultados da consulta no painel inferior.

   

Categorias de log de recursos do Stream Analytics

O Azure Stream Analytics captura duas categorias de logs de recursos:

• Criação: captura eventos de log relacionados a operações de criação de trabalho, como a criação de trabalho, a adição e exclusão de entradas e saídas, a adição e atualização da consulta e o início e parada do trabalho.

• Execução: captura eventos que ocorrem durante a execução do trabalho.

  • Erros de conectividade
  • Erros de processamento de dados, incluindo:
    • Eventos que não estão em conformidade com a definição de consulta (valores e tipos de campo sem correspondência, campos ausentes e assim por diante)
    • Erros de avaliação da expressão
  • Outros erros e eventos

Todos os logs são armazenados no formato JSON. Para saber mais sobre o esquema de logs de recursos, consulte Esquema de logs de recursos.

Próximas etapas

• Erros de dados do Azure Stream Analytics
• Referência da linguagem de consulta do Stream Analytics