Event Grid abonelikleri için olay filtrelemeyi anlayın

Makale
06/07/2021
Okumak için 12 dakika

Bu makalede, hangi olayların uç noktanıza gönderileceğini filtrelemeye yönelik farklı yollar açıklanmaktadır. Bir olay aboneliği oluştururken filtreleme için üç seçeneğiniz vardır:

Olay türleri
Konu şununla başlıyor veya şununla bitiyor
Gelişmiş alanlar ve işleçler

Olay türü filtreleme

Varsayılan olarak, olay kaynağı için tüm olay türleri uç noktaya gönderilir. Uç noktanıza yalnızca belirli olay türlerini gönderilmeye karar verebilirsiniz. Örneğin, kaynaklarınız için güncelleştirmeler hakkında bildirim alabilir, ancak silme işlemleri gibi diğer işlemlere yönelik bilgilendirilirsiniz. Bu durumda, olay türüne göre filtreleyin Microsoft.Resources.ResourceWriteSuccess . Olay türlerine sahip bir dizi sağlayın veya All olay kaynağı için tüm olay türlerini almak üzere belirtin.

Olay türüne göre filtreleme için JSON sözdizimi şöyledir:

"filter": {
  "includedEventTypes": [
    "Microsoft.Resources.ResourceWriteFailure",
    "Microsoft.Resources.ResourceWriteSuccess"
  ]
}

Konu filtreleme

Konuya göre basit filtreleme için, konu için bir başlangıç veya bitiş değeri belirtin. Örneğin, konunun bittiğini .txt yalnızca bir metin dosyasını depolama hesabına yüklemeyle ilgili olayları almak üzere belirtebilirsiniz. Ya da, /blobServices/default/containers/testcontainer o kapsayıcının tüm olaylarını almak için, depolama hesabındaki diğer kapsayıcıları değil, konunun ile başlayan bir filtre uygulayabilirsiniz.

Olayları özel konulara yayımlarken, etkinliklerinizin etkinlikleri oluşturun ve bu da abonelerin olayla ilgilenip ilgilenmediğini bilmesini kolaylaştırır. Aboneler olayları filtrelemek ve yönlendirmek için Subject özelliğini kullanır. Örneğin, abonelerin bu yolun segmentlerine göre filtreleyebilmesi için olayın gerçekleştiği yolu eklemeyi göz önünde bulundurun. Yol, abonelerin olayları en dar veya genel olarak filtrelemesine olanak sağlar. Konu içinde üç segment yolu sağlarsanız /A/B/C , aboneler /A çok sayıda olayı almak için ilk kesime göre filtreleyebilirsiniz. Bu aboneler, veya gibi konularla olayları /A/B/C alır /A/D/E . Diğer aboneler, daha /A/B dar bir olay kümesi almak için tarafından filtreleyebilirler.

Konuya göre filtrelemeye yönelik JSON sözdizimi şöyledir:

"filter": {
  "subjectBeginsWith": "/blobServices/default/containers/mycontainer/log",
  "subjectEndsWith": ".jpg"
}

Gelişmiş filtreleme

Veri alanlarındaki değerlere göre filtrelemek ve karşılaştırma işlecini belirtmek için Gelişmiş filtreleme seçeneğini kullanın. Gelişmiş filtreleme ' de şunları belirtirsiniz:

işleç türü-karşılaştırma türü.
anahtar-filtreleme için kullanmakta olduğunuz olay verileri alanı. Bir sayı, Boolean, dize veya dizi olabilir.
Values-anahtarla karşılaştırılacak değer veya değerler.

Anahtar

Anahtar, filtreleme için kullanmakta olduğunuz olay verilerinde yer alan alandır. Aşağıdaki türlerden biri olabilir:

Sayı
Boole
Dize

Dizide. enableAdvancedFilteringOnArraysBu özelliği kullanmak için özelliği true olarak ayarlamanız gerekir.

"filter":
{
    "subjectBeginsWith": "/blobServices/default/containers/mycontainer/log",
    "subjectEndsWith": ".jpg",
    "enableAdvancedFilteringOnArrays": true
}

Event Grid şemasındaki olaylar için, anahtar: ID ,,,, Topic Subject EventType DataVersion veya olay verileri (gibi data.key1 ) için aşağıdaki değerleri kullanın.

Bulut olayları şemasındaki olaylar için, anahtar: eventid , source ,, eventtype eventtypeversion veya olay verileri (gibi data.key1 ) için aşağıdaki değerleri kullanın.

Özel giriş şeması için, olay verileri alanlarını (gibi) kullanın data.key1 . Veri bölümündeki alanlara erişmek için . (nokta) gösterimini kullanın. Örneğin, data.sitename ,, data.appEventTypeDetail.action sitename veya action Aşağıdaki örnek olaya erişmek için.

    "data": {
        "appEventTypeDetail": {
            "action": "Started"
        },
        "siteName": "<site-name>",
        "clientRequestId": "None",
        "correlationRequestId": "None",
        "requestId": "292f499d-04ee-4066-994d-c2df57b99198",
        "address": "None",
        "verb": "None"
    },

Değerler

Değerler: sayı, dize, Boole veya dizi olabilir

İşleçler

Rakamlar için kullanılabilir işleçler şunlardır:

Numberın

Anahtar değeri belirtilen filtre değerlerinden biri ise, numberin işleci true olarak değerlendirilir. Aşağıdaki örnekte, counter bölümündeki öznitelik değerinin data 5 veya 1 olup olmadığını denetler.

"advancedFilters": [{
    "operatorType": "NumberIn",
    "key": "data.counter",
    "values": [
        5,
        1
    ]
}]

Anahtar bir diziyse, dizideki tüm değerler filtre değerlerinin dizisine karşı denetlenir. Anahtar: ve filtresi ile birlikte sahte kod aşağıda verilmiştir: [v1, v2, v3] [a, b, c] . Filtrenin veri türüyle eşleşmeyen veri türlerine sahip herhangi bir anahtar değer yok sayılır.

FOR_EACH filter IN (a, b, c)
    FOR_EACH key IN (v1, v2, v3)
        IF filter == key
            MATCH

Numbernotın

Anahtar değeri belirtilen filtre değerlerinden herhangi biri değilse numbernotın doğru olarak değerlendirilir. Aşağıdaki örnekte, counter bölümündeki öznitelik değerinin data 41 ve 0 olmadığını kontrol eder.

"advancedFilters": [{
    "operatorType": "NumberNotIn",
    "key": "data.counter",
    "values": [
        41,
        0
    ]
}]

FOR_EACH filter IN (a, b, c)
    FOR_EACH key IN (v1, v2, v3)
        IF filter == key
            FAIL_MATCH

NumberLessThan

Anahtar değeri belirtilen filtre değerinden küçükse numberlessthan işleci true olarak değerlendirilir. Aşağıdaki örnekte, counter bölümündeki öznitelik değerinin 100 ' den küçük olup olmadığını denetler data .

"advancedFilters": [{
    "operatorType": "NumberLessThan",
    "key": "data.counter",
    "value": 100
}]

Anahtar bir diziyse, dizideki tüm değerler filtre değerine göre denetlenir. Şu anahtara sahip sözde kod aşağıda verilmiştir: [v1, v2, v3] . Filtrenin veri türüyle eşleşmeyen veri türlerine sahip herhangi bir anahtar değer yok sayılır.

FOR_EACH key IN (v1, v2, v3)
    IF key < filter
        MATCH

NumberGreaterThan

Anahtar değeri belirtilen filtre değerinden daha büyükse , NumberGreaterThan işleci true olarak değerlendirilir. Aşağıdaki örnekte, counter bölümündeki öznitelik değerinin 20 ' den büyük olup olmadığını denetler data .

"advancedFilters": [{
    "operatorType": "NumberGreaterThan",
    "key": "data.counter",
    "value": 20
}]

FOR_EACH key IN (v1, v2, v3)
    IF key > filter
        MATCH

Numberlessals

Anahtar değeri belirtilen filtre değerinden küçük veya bu değere eşitse, numberlessals okarşılandığından işleci true olarak değerlendirilir. Aşağıdaki örnekte, counter bölümündeki öznitelik değerinin data 100 değerinden küçük veya ona eşit olup olmadığını denetler.

"advancedFilters": [{
    "operatorType": "NumberLessThanOrEquals",
    "key": "data.counter",
    "value": 100
}]

FOR_EACH key IN (v1, v2, v3)
    IF key <= filter
        MATCH

NumberGreaterThanOrEquals

Anahtar değeri belirtilen filtre değerinden büyük veya bu değere eşitse, NumberGreaterThanOrEquals işleci true olarak değerlendirilir. Aşağıdaki örnekte, counter bölümündeki öznitelik değerinin data 30 ' a eşit veya daha büyük olup olmadığını denetler.

"advancedFilters": [{
    "operatorType": "NumberGreaterThanOrEquals",
    "key": "data.counter",
    "value": 30
}]

FOR_EACH key IN (v1, v2, v3)
    IF key >= filter
        MATCH

Numberınrange

Anahtar değeri belirtilen filtre aralıklarından birinde ise numberınrange işleci true olarak değerlendirilir. Aşağıdaki örnekte, key1 bölümündeki özniteliğin değerinin data iki aralıklardan birinde olup olmadığını denetler: 3,14159-999,95, 3000-4000.

{
    "operatorType": "NumberInRange",
    "key": "data.key1",
    "values": [[3.14159, 999.95], [3000, 4000]]
}

valuesÖzelliği bir Aralık dizisidir. Önceki örnekte, bu iki aralığın bir dizisidir. Burada, denetlenecek tek aralıklı dizi örneği verilmiştir.

Tek aralıklı dizi:

{
    "operatorType": "NumberInRange",
    "key": "data.key1",
    "values": [[3000, 4000]]
}

Anahtar bir diziyse, dizideki tüm değerler filtre değerlerinin dizisine karşı denetlenir. Anahtar: [v1, v2, v3] ve filtre: bir Aralık dizisi olan sahte kod aşağıda verilmiştir. Bu sahte kodda, a b dizideki her bir aralığın düşük ve yüksek değerleri vardır. Filtrenin veri türüyle eşleşmeyen veri türlerine sahip herhangi bir anahtar değer yok sayılır.

FOR_EACH (a,b) IN filter.Values
    FOR_EACH key IN (v1, v2, v3)
       IF key >= a AND key <= b
           MATCH

NumberNotInRange

Anahtar değeri belirtilen filtre aralıklarından hiçbirinde değilse , NumberNotInRange işleci true olarak değerlendirilir. Aşağıdaki örnekte, key1 bölümündeki özniteliğin değerinin data iki aralıklardan birinde olup olmadığını denetler: 3,14159-999,95, 3000-4000. Eğer ise, işleç false döndürür.

{
    "operatorType": "NumberNotInRange",
    "key": "data.key1",
    "values": [[3.14159, 999.95], [3000, 4000]]
}

valuesÖzelliği bir Aralık dizisidir. Önceki örnekte, bu iki aralığın bir dizisidir. Burada, denetlenecek tek aralıklı dizi örneği verilmiştir.

Tek aralıklı dizi:

{
    "operatorType": "NumberNotInRange",
    "key": "data.key1",
    "values": [[3000, 4000]]
}

FOR_EACH (a,b) IN filter.Values
    FOR_EACH key IN (v1, v2, v3)
        IF key >= a AND key <= b
            FAIL_MATCH

Boole değerleri için kullanılabilir işleç:

BoolEquals

Anahtar değeri belirtilen Boolean değer filtresi ise, BoolEquals işleci true olarak değerlendirilir. Aşağıdaki örnekte, bölümünde özniteliği değeri olup olmadığını denetler isEnabled data true .

"advancedFilters": [{
    "operatorType": "BoolEquals",
    "key": "data.isEnabled",
    "value": true
}]

Anahtar bir diziyse, dizideki tüm değerler filtre Boole değeri ile denetlenir. Şu anahtara sahip sözde kod aşağıda verilmiştir: [v1, v2, v3] . Filtrenin veri türüyle eşleşmeyen veri türlerine sahip herhangi bir anahtar değer yok sayılır.

FOR_EACH key IN (v1, v2, v3)
    IF filter == key
        MATCH

Dizeler için kullanılabilir işleçler şunlardır:

StringContains

Anahtar değeri belirtilen filtre değerlerinden herhangi birini içeriyorsa (alt dizeler olarak) stringcontains true olarak değerlendirilir. Aşağıdaki örnekte, key1 bölümündeki öznitelik değerinin data belirtilen alt dizelerin birini içerip içermediğini denetler: microsoft veya azure . Örneğin, azure data factory içinde bulunur azure .

"advancedFilters": [{
    "operatorType": "StringContains",
    "key": "data.key1",
    "values": [
        "microsoft", 
        "azure"
    ]
}]