Ambito e intervallo di tempo delle query su log in Log Analytics di Monitoraggio di Azure

Quando si esegue una query su log in Log Analytics nel portale di Azure, il set di dati valutato dalla query dipende dall'ambito e dall'intervallo di tempo selezionati. Questo articolo descrive l'ambito e l'intervallo di tempo e spiega come impostarli in base alle esigenze. Illustra anche il comportamento dei diversi tipi di ambiti.

Autorizzazioni obbligatorie

È necessario disporre Microsoft.OperationalInsights/workspaces/query/*/read delle autorizzazioni per le aree di lavoro Log Analytics su cui si esegue la query, ad esempio, come specificato dal ruolo predefinito Lettore di Log Analytics.

Ambito delle query

L'ambito della query definisce i record valutati dalla query. Questa definizione includerà in genere tutti i record in un'unica area di lavoro Log Analytics o in un'applicazione Application Insights. Log Analytics consente anche di impostare un ambito per una particolare risorsa di Azure monitorata. In questo modo un proprietario di risorse può concentrarsi solo sui dati, anche se la risorsa scrive in più aree di lavoro.

L'ambito viene sempre visualizzato in alto a sinistra nella finestra di Log Analytics. Un'icona indica se l'ambito è un'area di lavoro Log Analytics o un'applicazione di Application Insights. Non viene visualizzata alcuna icona indica un'altra risorsa di Azure.

Screenshot of scope displayed in portal.

Il metodo usato per avviare Log Analytics determina l'ambito e in alcuni casi è possibile modificare l'ambito facendo clic su di esso. La tabella seguente elenca i diversi tipi di ambito usati e riporta i dettagli per ognuno di essi.

Importante

Se si usa un'applicazione basata sull'area di lavoro in Application Insights, i relativi dati vengono archiviati in un'area di lavoro Log Analytics con tutti gli altri dati di log. Per garantire la compatibilità con le versioni precedenti, si otterrà l'esperienza classica di Application Insights quando si seleziona l'applicazione come ambito. Per visualizzare questi dati nell'area di lavoro Log Analytics, impostare l'ambito sull'area di lavoro.

Ambito delle query Record nell'ambito Modalità di selezione Modifica dell'ambito
Area di lavoro Log Analytics Tutti i record nell'area di lavoro Log Analytics. Selezionare Log nel menu Monitoraggio di Azure oppure il menu Aree di lavoro Log Analytics. È possibile impostare l'ambito su qualsiasi altro tipo di risorsa.
Applicazione di Application Insights Tutti i record nell'applicazione di Application Insights. Selezionare Log dal menu di Application Insights per l'applicazione. È possibile impostare l'ambito solo su un'altra applicazione di Application Insights.
Gruppo di risorse Record creati da tutte le risorse nel gruppo di risorse. Può includere dati da più aree di lavoro Log Analytics. Selezionare Log nel menu del gruppo di risorse. Non è possibile modificare l'ambito.
Subscription Record creati da tutte le risorse della sottoscrizione. Può includere dati da più aree di lavoro Log Analytics. Selezionare Log dal menu della sottoscrizione. Non è possibile modificare l'ambito.
Altre risorse di Azure Record creati dalla risorsa. Può includere dati da più aree di lavoro Log Analytics. Selezionare Log nel menu delle risorse.
OPPURE
Selezionare Log nel menu Monitoraggio di Azure e quindi selezionare un nuovo ambito.
È possibile impostare l'ambito solo sullo stesso tipo di risorsa.

Limitazioni nel caso in cui l'ambito è impostato su una risorsa

Quando l'ambito della query è un'area di lavoro Log Analytics o un'applicazione di Application Insights, sono disponibili tutte le opzioni nel portale e tutti i comandi di query. Se l'ambito è limitato a una risorsa, le opzioni seguenti del portale non sono disponibili perché sono associate a una singola applicazione o area di lavoro:

  • Salva
  • Esplora query
  • Nuova regola di avviso

Non è possibile usare i comandi seguenti in una query quando l'ambito di una risorsa è limitato perché l'ambito della query include già aree di lavoro con dati per tale risorsa o set di risorse:

Limiti dell'ambito di query

L'impostazione dell'ambito su una risorsa o un set di risorse è una funzionalità potente di Log Analytics perché consente di consolidare automaticamente i dati distribuiti in una singola query. Questo comportamento può influire significativamente sulle prestazioni, anche se i dati devono essere recuperati da aree di lavoro in più aree di Azure.

Log Analytics consente di evitare il sovraccarico eccessivo generato da query che interessano aree di lavoro in più aree perché restituisce un avviso o un errore quando si usa un determinato numero di aree. La query riceve un avviso se l'ambito include aree di lavoro in 5 o più aree. verrà comunque eseguito, ma potrebbe richiedere tempo eccessivo per il completamento.

Screenshot of query warning.

L'esecuzione della query verrà bloccata se l'ambito include aree di lavoro in 20 o più aree. In questo caso, verrà richiesto di ridurre il numero di aree dell'area di lavoro e tentare di eseguire di nuovo la query. Nell'elenco a discesa verranno visualizzate tutte le aree incluse nell'ambito della query e sarà necessario ridurne il numero prima di provare a eseguire di nuovo la query.

Screenshot of query failed.

Intervallo di tempo

L'intervallo di tempo consente di specificare il set di record che vengono valutati per la query in base alla data e all'ora di creazione del record. Questo valore viene definito dalla colonna TimeGenerated in ogni record nell'area di lavoro o nell'applicazione, come specificato nella tabella seguente. Per un'applicazione di Application Insights classica, la colonna timestamp viene usata per l'intervallo di tempo.

Per impostare l'intervallo di tempo, selezionarlo dal controllo di selezione di data e ora nella parte superiore della finestra di Log Analytics. È possibile selezionare un periodo predefinito oppure selezionare Personalizzato per indicare un intervallo di tempo specifico.

Screenshot of the time picker.

Se si imposta un filtro nella query che usa la colonna ora solare come illustrato nella tabella precedente, la selezione ora cambia in Imposta nella query e la selezione ora è disabilitata. In questo caso, risulta più efficace inserire il filtro all'inizio della query in modo che qualsiasi operazione di elaborazione successiva venga eseguita solo sui record filtrati.

Screenshot of filtered query.

Se si usa il comando area di lavoro o app per recuperare i dati da un'altra area di lavoro o da un'altra applicazione classica, la selezione ora potrebbe comportarsi in modo diverso. Se l'ambito è un'area di lavoro Log Analytics e si usa l'app oppure se l'ambito è un'applicazione classica di Application Insights e si usa l'area di lavoro, Log Analytics potrebbe non comprendere che la colonna usata nel filtro deve determinare il filtro temporale.

Nell'esempio seguente l'ambito è impostato su un'area di lavoro Log Analytics. La query usa workspace per recuperare i dati di un'altra area di lavoro Log Analytics. La selezione ora viene modificata in Imposta nella query perché visualizza un filtro che usa la colonna TimeGenerated prevista.

Screenshot of query with workspace.

Se tuttavia la query usa l'app per recuperare dati da un'applicazione di Application Insights classica, Log Analytics non riconosce la colonna timestamp nel filtro e la selezione ora rimane invariata. In questo caso vengono applicati entrambi i filtri. Nella query dell'esempio vengono inclusi solo i record creati nelle ultime 24 ore, anche se la clausola where è impostata su 7 giorni.

Screenshot of query with app.

Passaggi successivi