Sintassi del filtro dell'API REST di Monitoraggio di Azure

Molte API di Monitoraggio di Azure accettano un parametro, {filter-expression}, che è possibile usare per filtrare o limitare il set di dati raccolti.

Utilizzo del filtro '*' nella richiesta di più risorse

Importante

Il * filtro in a per più risorse non è un carattere jolly. Si tratta di una stringa letterale utilizzata per richiedere più risorse. Viene * utilizzato per richiedere più risorse in una singola serie temporale.

Nell'esempio seguente $filter=Microsoft.ResourceId eq '*' indica all'API di restituire una serie temporale separata per ogni risorsa della macchina virtuale nella sottoscrizione e nell'area. Senza il filtro l'API restituirà una singola serie temporale aggregando la CPU media per tutte le macchine virtuali. La serie temporale per ogni risorsa è differenziata dal valore dei metadati Microsoft.ResourceId in ogni voce della serie temporale.

Se si utilizza $filter=Microsoft.ResourceId eq '*' e non sono presenti risorse, in questo caso macchine virtuali nella serie temporale specificata, viene restituita la serie timeseries:[] temporale vuota in quanto non sono presenti risultati per il set di dimensioni richiesto che include ResourceId
La stessa query senza il filtro restituirà una singola serie temporale che restituisce una CPU media aggregata = 0 per tutte le macchine virtuali, poiché questa è la somma di tutte le dimensioni richieste.

GET https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/providers/microsoft.Insights/metrics?timespan=2023-06-25T22:20:00.000Z/2023-06-26T22:25:00.000Z&interval=PT5M&metricnames=Percentage CPU&aggregation=average&api-version=2021-05-01&region=eastus&metricNamespace=microsoft.compute/virtualmachines&$filter=Microsoft.ResourceId eq '*'

Esempio di utilizzo $filter

Di seguito sono riportate le possibili stringhe di espressione che è possibile passare come {filter-expression}. Non è consentita alcuna altra sintassi.

• Elencare gli eventi per un gruppo di risorse

  $filter=eventTimestamp ge <Start Time> and eventTimestamp le <End Time> and eventChannels eq 'Admin, Operation' and resourceGroupName eq '<ResourceGroupName>'
  

  Esempio:

  $filter=eventTimestamp ge 2014-12-29T22:00:37Z e eventTimestamp le 2014-12-29T23:36:37Z e eventChannels eq 'Admin, Operation' e resourceGroupName eq 'CloudLab'

• Elencare gli eventi per una risorsa

  $filter=eventTimestamp ge <Start Time> and eventTimestamp le <End Time> and eventChannels eq 'Admin, Operation' and resourceUri eq '<ResourceURI>'
  

  Esempio:

  $filter=eventTimestamp ge 2014-12-29T22:00:37Z e eventTimestamp le 2014-12-29T23:36:37Z e eventChannels eq 'Admin, Operation' e resourceUri eq '/subscriptions/089bd33f-d4ec-47fe-8ba5-0753aa5c5b33/resourcegroups/CloudLab/providers/Microsoft.Web/sites/mytestweb004'

• Elencare gli eventi per una sottoscrizione di Azure

  $filter=eventTimestamp ge <Start Time> and eventTimestamp le <End Time> and eventChannels eq 'Admin, Operation'
  

  Esempio:

  $filter=eventTimestamp ge 2014-12-29T22:00:37Z e eventTimestamp le 2014-12-29T23:36:37Z e eventChannels eq 'Admin, Operation'

• Elencare gli eventi per un provider di risorse di Azure

  $filter=eventTimestamp ge <Start Time> and eventTimestamp le <End Time> and eventChannels eq 'Admin, Operation' and resourceProvider eq '<ResourceProviderName>'
  

  Esempio:

  $filter=eventTimestamp ge 2014-12-29T22:00:37Z e eventTimestamp le 2014-12-29T23:36:37Z e eventChannels eq 'Admin, Operation' e resourceProvider eq 'Microsoft.Web'

• Elencare gli eventi per un ID di correlazione

  api-version=2014-04-01&$filter=eventTimestamp ge 2014-07-16T04:36:37.6407898Z and eventTimestamp le 2014-07-20T04:36:37.6407898Z and eventChannels eq 'Admin, Operation' and correlationId eq '<CorrelationID>'
  

  Esempio: api-version=2014-04-01&$filter=eventTimestamp ge 2014-12-29T22:00:37Z e eventTimestamp le 2014-12-29T23:36:37Z e eventChannels eq 'Admin, Operation' e correlationId eq '07c85493-5e87-4efd-9200-0c64d904d878'