Solucionar problemas do Azure Stream Analytics usando logs de recursos
Ocasionalmente, um trabalho do Stream Analytics do Azure interrompe o processamento de forma inesperada. É importante conseguir resolver esse tipo de evento. 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 do Azure Stream Analytics podem ajudá-lo a identificar a causa dos problemas assim que eles ocorrem e reduzir o tempo de recuperação.
É altamente recomendável habilitar os logs de recursos para todos os trabalhos, já que isso ajudará muito na depuração e no monitoramento.
Tipos de logs
O Stream Analytics oferece dois tipos de logs:
Logs de atividades (Always On), que fornecem informações sobre as operações realizadas nos trabalhos.
Logs de recursos (configuráveis), que fornecem informações mais avançadas 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.
Observação
Você pode usar serviços como o Armazenamento do Microsoft Azure, os Hubs de Eventos do Azure e os logs do Azure Monitor para analisar dados que não estão em conformidade. Você é cobrado com base no modelo de preço desses serviços.
Observação
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. Confira as alterações de terminologia do Azure Monitor para obter detalhes.
Depurando com o uso de 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. 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 das operações que foram executadas. As operações que causaram a falha do trabalho têm uma bolha de informações em vermelho.
Selecione uma operação para ver a exibição do respectivo resumo. As informações fornecidas aqui costumam ser limitadas. Para obter mais detalhes sobre a operação, selecioneJSON.
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 ocorreu devido a um erro de runtime de valores de latitude fora do limite. A discrepância nos dados que são processados por um trabalho do Azure Stream Analytics causa um erro de dados. Você pode aprender sobre erros de dados de entrada e saída diferentes e por que eles ocorrem.
Você pode realizar ações corretivas com base na mensagem de erro no JSON. Neste exemplo, será necessário adicionar verificações do valor de latitude entre -90 graus e 90 graus à consulta.
Se a mensagem de erro nos Logs de atividades não ajudar a 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 habilitar os logs de recursos e enviá-los para os logs do Azure Monitor. Eles ficam desativados por padrão. Para habilitá-los, conclua estas etapas:
Crie um espaço de trabalho do Log Analytics se você ainda não tiver um. É recomendável que seu workspace do Log Analytics esteja na mesma região que o seu trabalho no Stream Analytics.
Entre no portal do Azure e navegue até o trabalho do Stream Analytics. Em Monitoramento, selecione Logs de diagnóstico. Em seguida, selecione ativar o diagnóstico.
Forneça um Nome no Nome das configurações de diagnóstico e marque as caixas de Execução e Criação em loge AllMetrics em métrica. Em seguida, selecione Enviar para o Log Analytics e escolha seu espaço de trabalho. Selecione Salvar.
Quando o trabalho do Azure Stream Analytics é iniciado, os logs de recursos são roteados para o seu espaço de trabalho do Log Analytics. Para exibir os logs de recursos para seu trabalho, selecione Logs na seção Monitoramento.
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
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.