Solucionar problemas do Azure Stream Analytics usando logs de recursos

Ocasionalmente, um trabalho do Azure Stream Analytics deixa de processar inesperadamente. As falhas podem ser provocadas por um resultado de consulta inesperado, pela conectividade aos dispositivos ou por uma falha de serviço repentina. Os registos de recursos no Azure Stream Analytics podem ajudá-lo a identificar a causa destas falhas e reduzir o tempo de recuperação.

Ative os registos de recursos para todos os trabalhos de Stream Analytics para ajudar na depuração e monitorização.

Tipos de registos de Stream Analytics

O Stream Analytics oferece dois tipos de logs:

• Registos de atividade (sempre ativos), que fornecem informações sobre as operações executadas nas tarefas.

• Registos de recursos (configuráveis), que fornecem informações mais pormenorizadas sobre tudo o que acontece com uma tarefa. 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.

Depurar trabalhos de Análise de Fluxos usando registos 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. A informação presente nos registos de atividades pode ajudar a identificar a causa raiz dos problemas que afetam o seu trabalho. Para usar registos de atividade no Stream Analytics, siga estes passos:

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

   

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

3. Selecione uma operação para ver sua exibição de resumo. A informação aqui é frequentemente limitada. Para saber mais detalhes sobre a operação, selecione JSON.

   

4. 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 deveu-se a um erro de execução devido a valores de latitude fora do limite. Uma discrepância nos dados processados por um trabalho de 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.

   

5. Tome medidas corretivas com base na mensagem de erro em JSON. Neste exemplo, adicione verificações para garantir que o valor de latitude está entre -90 e 90 graus.

6. Se a mensagem de erro nos registos de atividade não for útil para identificar a causa raiz, ative os registos de recursos e use os registos do Azure Monitor.

Enviar diagnósticos do Stream Analytics para Azure Monitor logs

Ativa os registos de recursos e envia-os para os registos do Azure Monitor. Os registos de recursos estão desligados por defeito.

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

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

   

3. Introduza um Nome em Diagnostic settings name e selecione as caixas de verificação de Execution e Criação em log, e AllMetrics em metric. Em seguida, selecione Enviar para o Log Analytics e escolha seu espaço de trabalho. Selecione Guardar.

   

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

   

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

Próximos passos

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