Âmbito da consulta de registo e intervalo de tempo no Log Analytics do Azure Monitor

Quando executa uma consulta de registo no Log Analytics no portal do Azure, o conjunto de dados avaliados pela consulta depende do âmbito e do intervalo de tempo que selecionar. Este artigo descreve o âmbito e o intervalo de tempo e como pode definir cada um consoante os seus requisitos. Também descreve o comportamento de diferentes tipos de âmbitos.

Âmbito de consulta

O âmbito da consulta define os registos que são avaliados pela consulta. Normalmente, isto incluirá todos os registos numa única área de trabalho do Log Analytics ou numa aplicação do Application Insights. O Log Analytics também lhe permite definir um âmbito para um recurso do Azure monitorizado específico. Isto permite que um proprietário de recursos se concentre apenas nos respetivos dados, mesmo que esse recurso escreva em várias áreas de trabalho.

O âmbito é sempre apresentado no canto superior esquerdo da janela do Log Analytics. Um ícone indica se o âmbito é uma área de trabalho do Log Analytics ou uma aplicação do Application Insights. Nenhum ícone indica outro recurso do Azure.

Âmbito apresentado no portal

O âmbito é determinado pelo método que utiliza para iniciar o Log Analytics e, em alguns casos, pode alterar o âmbito clicando no mesmo. A tabela seguinte lista os diferentes tipos de âmbito utilizados e detalhes diferentes para cada um.

Importante

Se estiver a utilizar uma aplicação baseada em áreas de trabalho no Application Insights, os respetivos dados são armazenados numa área de trabalho do Log Analytics com todos os outros dados de registo. Para retrocompatibilidade, obterá a experiência clássica do Application Insights quando selecionar a aplicação como âmbito. Para ver estes dados na área de trabalho do Log Analytics, defina o âmbito para a área de trabalho.

Âmbito de consulta Registos no âmbito Como selecionar Alterar Âmbito
Área de trabalho do Log Analytics Todos os registos na área de trabalho do Log Analytics. Selecione Registos no menu do Azure Monitor ou no menu áreas de trabalho do Log Analytics . Pode alterar o âmbito para qualquer outro tipo de recurso.
Aplicação application Insights Todos os registos na aplicação Application Insights. Selecione Registos no menu do Application Insights para a aplicação. Só é possível alterar o âmbito para outra aplicação do Application Insights.
Grupo de recursos Registos criados por todos os recursos no grupo de recursos. Pode incluir dados de várias áreas de trabalho do Log Analytics. Selecione Registos no menu do grupo de recursos. Não é possível alterar o âmbito.
Subscrição Registos criados por todos os recursos na subscrição. Pode incluir dados de várias áreas de trabalho do Log Analytics. Selecione Registos no menu de subscrição. Não é possível alterar o âmbito.
Outros recursos do Azure Registos criados pelo recurso. Pode incluir dados de várias áreas de trabalho do Log Analytics. Selecione Registos no menu de recursos.
OU
Selecione Registos no menu do Azure Monitor e, em seguida, selecione um novo âmbito.
Só é possível alterar o âmbito para o mesmo tipo de recurso.

Limitações quando confinadas a um recurso

Quando o âmbito da consulta é uma área de trabalho do Log Analytics ou uma aplicação do Application Insights, todas as opções no portal e todos os comandos de consulta estão disponíveis. No entanto, quando está no âmbito de um recurso, as seguintes opções no portal não estão disponíveis porque estão associadas a uma única área de trabalho ou aplicação:

  • Guardar
  • Explorador de consultas
  • Nova regra de alerta

Não pode utilizar os seguintes comandos numa consulta quando estiver no âmbito de um recurso, uma vez que o âmbito da consulta já incluirá quaisquer áreas de trabalho com dados para esse recurso ou conjunto de recursos:

Limites de âmbito de consulta

Definir o âmbito para um recurso ou conjunto de recursos é uma funcionalidade particularmente poderosa do Log Analytics, uma vez que lhe permite consolidar automaticamente os dados distribuídos numa única consulta. No entanto, pode afetar significativamente o desempenho se os dados precisarem de ser obtidos a partir de áreas de trabalho em várias regiões do Azure.

O Log Analytics ajuda a proteger contra sobrecarga excessiva contra consultas que abrangem áreas de trabalho em várias regiões ao emitir um aviso ou erro quando um determinado número de regiões está a ser utilizado. A consulta receberá um aviso se o âmbito incluir áreas de trabalho em 5 ou mais regiões. continuará a ser executado, mas pode demorar demasiado tempo a concluir.

Aviso de consulta

A consulta será impedida de ser executada se o âmbito incluir áreas de trabalho em 20 ou mais regiões. Neste caso, ser-lhe-á pedido para reduzir o número de regiões da área de trabalho e tentar executar a consulta novamente. A lista pendente apresentará todas as regiões no âmbito da consulta e deverá reduzir o número de regiões antes de tentar executar novamente a consulta.

Falha na consulta

Intervalo de tempo

O intervalo de tempo especifica o conjunto de registos que são avaliados para a consulta com base no momento em que o registo foi criado. Isto é definido pela coluna TimeGenerated em todos os registos na área de trabalho ou na aplicação, conforme especificado na tabela seguinte. Para uma aplicação clássica do Application Insights, a coluna de carimbo de data / hora é utilizada para o intervalo de tempo.

Defina o intervalo de tempo ao selecioná-lo a partir do seletor de horas na parte superior da janela do Log Analytics. Pode selecionar um período predefinido ou selecionar Personalizado para especificar um intervalo de tempo específico.

Seletor de horas

Se definir um filtro na consulta que utiliza a coluna de hora padrão, conforme mostrado na tabela acima, o seletor de tempo muda para Definir na consulta e o seletor de tempo é desativado. Neste caso, é mais eficiente colocar o filtro na parte superior da consulta para que qualquer processamento subsequente só precise de funcionar com os registos filtrados.

Consulta filtrada

Se utilizar a área de trabalho ou o comando da aplicação para obter dados de outra área de trabalho ou aplicação clássica, o seletor de tempo poderá ter um comportamento diferente. Se o âmbito for uma área de trabalho do Log Analytics e utilizar a aplicação ou se o âmbito for uma aplicação clássica do Application Insights e utilizar a área de trabalho, o Log Analytics poderá não compreender que a coluna utilizada no filtro deve determinar o filtro de tempo.

No exemplo seguinte, o âmbito está definido como uma área de trabalho do Log Analytics. A consulta utiliza a área de trabalho para obter dados de outra área de trabalho do Log Analytics. O seletor de tempo muda para Definir na consulta porque vê um filtro que utiliza a coluna TimeGenerated esperada.

Consulta com a área de trabalho

No entanto, se a consulta utilizar a aplicação para obter dados de uma aplicação clássica do Application Insights, o Log Analytics não reconhece a coluna de carimbo de data/hora no filtro e o seletor de tempo permanece inalterado. Neste caso, ambos os filtros são aplicados. No exemplo, apenas os registos criados nas últimas 24 horas são incluídos na consulta, embora especifique 7 dias na cláusula where .

Consultar com a aplicação

Passos seguintes