다음을 통해 공유


Azure Monitor REST API 필터 구문

많은 Azure Monitor API는 수집된 데이터 집합을 필터링하거나 제한하는 데 사용할 수 있는 매개 변수 {filter-expression}를 사용합니다.

여러 리소스 요청에 필터 '*' 사용

중요

* 여러 리소스에 대한 필터의 은 와일드카드가 아닙니다. 여러 리소스를 요청하는 데 사용되는 리터럴 문자열입니다. 는 * 단일 시계열에서 여러 리소스를 요청하는 데 사용됩니다.

아래 $filter=Microsoft.ResourceId eq '*' 샘플에서는 구독 및 지역의 가상 머신 리소스당 별도의 시계열을 반환하도록 API에 지시합니다. 필터가 없으면 API는 모든 VM의 평균 CPU를 집계하는 단일 시계열을 반환합니다. 각 리소스에 대한 시계열은 각 시계열 항목의 Microsoft.ResourceId 메타데이터 값으로 구분됩니다.

를 사용하고 $filter=Microsoft.ResourceId eq '*' 리소스가 없는 경우, 이 경우 지정된 시계열의 VM이 포함된 요청된 차원 집합에 대한 결과가 없으므로 빈 타이머 timeseries:[] 가 반환됩니다. ResourceId
필터가 없는 동일한 쿼리는 요청된 모든 차원의 합계이므로 모든 VM에 대해 집계된 평균 CPU = 를 0 반환하는 단일 시계열을 반환합니다.

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 '*'

사용 예제 $filter

다음은 로 전달할 수 있는 식 문자열입니다 {filter-expression}. 다른 구문은 사용할 수 없습니다.

  • 리소스 그룹의 이벤트 목록 표시

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

    예제:

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

  • 리소스의 이벤트 목록 표시

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

    예제:

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

  • Azure 구독의 이벤트 표시

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

    예제:

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

  • Azure 리소스 공급자의 이벤트 표시

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

    예제:

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

  • 상관 관계 ID에 대한 이벤트 나열

    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>'
    

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