Griglia di eventi in Kubernetes - Filtro eventi per le sottoscrizioni

  • Articolo

Griglia di eventi in Kubernetes consente di specificare filtri in qualsiasi proprietà nel payload json. Questi filtri vengono modellati come set di condizioni AND, con ogni condizione esterna con condizioni OR interne facoltative. Per ogni condizione AND, specificare i valori seguenti:

  • OperatorType: tipo di confronto.
  • Chiave: percorso json della proprietà in cui applicare il filtro.
  • Valore: valore di riferimento in base al quale viene eseguito il filtro (o) Valori : set di valori di riferimento in base al quale viene eseguito il filtro.

Importante

Griglia di eventi in Kubernetes con Azure Arc è attualmente in anteprima pubblica. Questa versione di anteprima viene messa a disposizione senza contratto di servizio e non è consigliata per i carichi di lavoro di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero presentare funzionalità limitate. Per altre informazioni, vedere Condizioni supplementari per l'utilizzo delle anteprime di Microsoft Azure.

Filtrare in base al tipo di evento

Per impostazione predefinita, tutti i tipi di evento (type attributo) per l'origine evento vengono inviati all'endpoint. È possibile decidere di inviare all'endpoint solo determinati tipi di evento. La sintassi JSON per l'applicazione di un filtro in base al tipo di evento è la seguente:

"filter": {
  "includedEventTypes": [
    "orderCreated",
    "orderUpdated"
  ]
}

Nell'esempio precedente vengono inviati solo gli eventi di tipo orderCreated ed orderUpdated eventi all'endpoint del sottoscrittore.

Ecco un evento di esempio:

[{
      "specVersion": "1.0",
      "type" : "orderCreated",
      "source": "myCompanyName/us/webCommerceChannel/myOnlineCommerceSiteBrandName",
      "id" : "eventId-n",
      "time" : "2020-12-25T20:54:07+00:00",
      "subject" : "account/acct-123224/order/o-123456",
      "dataSchema" : "1.0",
      "data" : {
         "orderId" : "123",
         "orderType" : "PO",
         "reference" : "https://www.myCompanyName.com/orders/123"
      }
}]

Filtrare in base all'oggetto

Per applicare un filtro semplice in base all'oggetto, specificare un valore iniziale o finale per l'oggetto. La sintassi JSON per l'applicazione di un filtro in base all'oggetto è la seguente:

"filter": {
  "subjectBeginsWith": "/account/acct-123224/"
}

Ad esempio, il filtro configurato in precedenza invierà tutti gli ordini associati all'account acct-123224 all'endpoint del sottoscrittore.

Quando si pubblicano eventi in argomenti, creare argomenti per gli eventi in modo che semplificano la conoscenza dei sottoscrittori se sono interessati all'evento. I sottoscrittori usano la proprietà subject per filtrare e instradare gli eventi. È consigliabile aggiungere il percorso in cui si è verificato l'evento, in modo che i sottoscrittori possano filtrare per segmenti di tale percorso. Il percorso consente ai sottoscrittori di filtrare gli eventi a seconda della dimensione. Se si specifica un percorso di tre segmenti come /A/B/C nell'oggetto, i sottoscrittori possono filtrare per il primo segmento /A per ottenere un ampio set di eventi. Questi sottoscrittori ottengono eventi con soggetti come /A/B/C o /A/D/E. Altri sottoscrittori possono filtrare in base a /A/B per ottenere un set più stretto di eventi.

Filtrare in base ai valori nei dati dell'evento

Vedere La sezione Filtro avanzato nell'articolo Griglia di eventi in Azure per informazioni dettagliate sul filtro avanzato. Le funzionalità e gli operatori seguenti non sono supportati da Griglia di eventi in Kubernetes.

  • Filtro sui dati della matrice nelle chiavi degli eventi in ingresso
  • Consenti il filtro sugli attributi di contesto delle estensioni cloudEvents.
  • Operatori seguenti
    • StringNotContains
    • StringNotBeginsWith
    • StringNotEndsWith
    • NumberInRange
    • NumberNotInRange
    • IsNullOrUndefined
    • IsNotNull

Passaggi successivi

Per informazioni sulle destinazioni e i gestori supportati da Griglia di eventi in Azure Arc per Kubernetes, vedere Griglia di eventi in Kubernetes - Gestori eventi.