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
Occorrono autorizzazioni Microsoft.OperationalInsights/workspaces/query/*/read per le aree di lavoro Log Analytics su cui si esegue la query, ad esempio le autorizzazioni fornite dal ruolo predefinito Lettore di Log Analytics.
Ambito delle query
L'ambito della query definisce i record valutati dalla query. Questa definizione include in genere tutti i record in una singola area di lavoro Log Analytics o applicazione di 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.
Il metodo usato per avviare Log Analytics determina l'ambito e, in alcuni casi, è sufficiente fare clic sull'ambito per modificarlo. La tabella seguente elenca i diversi tipi di ambito usati e riporta i dettagli per ognuno di essi.
Importante
Se si usa un'applicazione di Application Insights basata sull'area di lavoro, allora i 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 di più aree di lavoro Log Analytics. | Selezionare Log nel menu del gruppo di risorse. | Non è possibile modificare l'ambito. |
| Abbonamento | Record creati da tutte le risorse della sottoscrizione. Può includere dati di 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 di 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 se l'ambito è una risorsa perché l'ambito della query include già tutte le aree di lavoro con i dati relativi a tale risorsa o set di risorse:
Limiti dell'ambito di query
L'impostazione dell'ambito su una risorsa o su un set di risorse è una funzionalità efficace di Log Analytics perché consente di consolidare automaticamente i dati distribuiti in un'unica 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 cinque o più aree. Verrà comunque eseguita, ma il completamento potrebbe richiedere moltissimo tempo.
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 verrà effettuato un nuovo tentativo di esecuzione della 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.
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 per 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.
Se nella query si imposta un filtro che usa la colonna data e ora standard come illustrato nella tabella precedente, il controllo di selezione di data e ora diventa Imposta nella query e viene disabilitato. 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.
Se si usa il comando workspace o app per recuperare i dati di un'altra applicazione classica o area di lavoro, il controllo di selezione di data e ora potrebbe comportarsi in modo diverso. Se l'ambito è un'area di lavoro Log Analytics e si usa app o se l'ambito è un'applicazione classica di Application Insights e si usa workspace, Log Analytics potrebbe non riconoscere che il filtro temporale deve essere determinato dalla proprietà usata nel filtro.
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. Il controllo di selezione di data e ora diventa Imposta nella query perché rileva un filtro che usa la colonna TimeGenerated prevista.
Se la query usa app per recuperare i dati di un'applicazione classica di Application Insights, Log Analytics non riconosce la proprietà timestamp nel filtro e il controllo di selezione di data e ora rimane invariato. 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.
Passaggi successivi
- Seguire un'esercitazione sull'uso di Log Analytics nel portale di Azure.
- Seguire un'esercitazione sulla scrittura di query.