Solucionar problemas do Azure Stream Analytics usando logs de recursos
Ocasionalmente, o processamento dos trabalhos do Azure Stream Analytics para inesperadamente. É importante conseguir resolver este tipo de evento. As falhas podem ser provocadas por um resultado de consulta inesperado, pela conectividade aos dispositivos ou por uma falha de serviço repentina. Os logs de recursos no Stream Analytics podem ajudá-lo a identificar a causa dos problemas quando eles ocorrem e reduzir o tempo de recuperação.
É altamente recomendável habilitar logs de recursos para todos os trabalhos, pois isso ajudará muito na depuração e no monitoramento.
Tipos de log
O Stream Analytics oferece dois tipos de logs:
Logs de atividades (sempre ativados), que fornecem informações sobre as operações executadas em trabalhos.
Logs de recursos (configuráveis), que fornecem informações mais detalhadas sobre tudo o que acontece com um trabalho. Os logs de recursos começam quando o trabalho é criado e terminam quando o trabalho é excluído. Eles cobrem eventos quando o trabalho é atualizado e enquanto está em execução.
Nota
Você pode usar serviços como o Armazenamento do Azure, Hubs de Eventos do Azure e logs do Azure Monitor para analisar dados não conformes. Você é cobrado com base no modelo de preços desses serviços.
Nota
Este artigo foi atualizado recentemente para usar o termo logs do Azure Monitor em vez de Log Analytics. Os dados de log ainda são armazenados em um espaço de trabalho do Log Analytics e ainda são coletados e analisados pelo mesmo serviço do Log Analytics. Estamos atualizando a terminologia para refletir melhor a função dos logs no Azure Monitor. Consulte Alterações de terminologia do Azure Monitor para obter detalhes.
Depuração usando logs de atividade
Os logs de atividades são ativados por padrão e fornecem informações de alto nível sobre as operações executadas pelo seu trabalho do Stream Analytics. As informações presentes nos registros de atividades podem ajudar a encontrar a causa raiz dos problemas que afetam seu trabalho. Execute as seguintes etapas para usar os logs de atividades no Stream Analytics:
Entre no portal do Azure e selecione Log de atividades em Visão geral.
Você pode ver uma lista de operações que foram executadas. Qualquer operação que tenha causado a falha do seu trabalho tem uma bolha de informação vermelha.
Selecione uma operação para ver sua exibição de resumo. As informações aqui são muitas vezes limitadas. Para saber mais detalhes sobre a operação, selecione JSON.
Role para baixo até a seção Propriedades do JSON, que fornece detalhes do erro que causou a operação com falha. Neste exemplo, a falha foi devido a um erro de tempo de execução de valores de latitude fora do limite. A discrepância nos dados processados por um trabalho do Stream Analytics causa um erro de dados. Você pode aprender sobre diferentes erros de dados de entrada e saída e por que eles ocorrem.
Você pode tomar ações corretivas com base na mensagem de erro em JSON. Neste exemplo, verificações para garantir que o valor de latitude esteja entre -90 graus e 90 graus precisam ser adicionadas à consulta.
Se a mensagem de erro nos logs de atividade não for útil para identificar a causa raiz, habilite os logs de recursos e use os logs do Azure Monitor.
Enviar diagnósticos para logs do Azure Monitor
É altamente recomendável ativar os logs de recursos e enviá-los para os logs do Azure Monitor. Eles estão desativados por padrão. Para ativá-los, conclua estas etapas:
Crie um espaço de trabalho do Log Analytics se ainda não tiver um. É recomendável ter seu espaço de trabalho do Log Analytics na mesma região do trabalho do Stream Analytics.
Entre no portal do Azure e navegue até seu trabalho do Stream Analytics. Em Monitoramento, selecione Logs de diagnóstico. Em seguida, selecione Ativar diagnóstico.
Forneça um Nome no nome das configurações de diagnóstico e marque as caixas 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 Guardar.
Quando o trabalho do Stream Analytics é iniciado, os logs de recursos são roteados para o espaço de trabalho do Log Analytics. Para exibir os logs de recursos do seu trabalho, selecione Logs na seção Monitoramento.
O Stream Analytics fornece consultas predefinidas que lhe permitem pesquisar facilmente os registos em que está interessado. Você pode selecionar quaisquer consultas predefinidas no painel esquerdo e, em seguida, selecionar Executar. Você verá os resultados da consulta no painel inferior.
Categorias de log de recursos
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 criação de trabalho, adição e exclusão de entradas e saídas, adição e atualização da consulta e início ou interrupção 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 (tipos e valores de campo incompatíveis, campos ausentes e assim por diante)
- Erros de avaliação de expressão
- Outros eventos e erros
Todos os logs são armazenados no formato JSON. Para saber mais sobre o esquema para logs de recursos, consulte Esquema de logs de recursos.