Doručování zpráv event Gridu a opakování

Event Grid poskytuje trvalé doručování. Pokusí se doručit každou zprávu alespoň jednou pro každé odpovídající odběry okamžitě. Pokud koncový bod odběratele nepotvrdí přijetí události nebo pokud dojde k selhání, služba Event Grid opakuje doručení na základě pevného plánu opakování a zásad opakování. Event Grid ve výchozím nastavení doručí jednu událost najednou odběrateli. Datová část je však pole s jednou událostí.

Plán opakování

Když Event Grid obdrží chybu pro pokus o doručení události, Event Grid rozhodne, jestli se má opakovat doručení, nedoručitelnost události nebo událost vypustit na základě typu chyby.

Pokud je chyba vrácená předplaceným koncovým bodem chybou související s konfigurací, která se nedá opravit opakovanými pokusy (například pokud je koncový bod odstraněn), event Grid buď u události provede nedoručené dopisy, nebo událost v případě, že není nakonfigurované nedoručené písmeno.

Následující tabulka popisuje typy koncových bodů a chyb, u kterých se opakování nestane:

Pokud chyba vrácená předplatnou koncovým bodem není mezi výše uvedeným seznamem, služba Event Grid provede opakování pomocí zásad popsaných níže:

Event Grid po doručení zprávy počká 30 sekund na odpověď. Po 30 sekundách, pokud koncový bod neodpověděli, zpráva se zařadí do fronty pro opakování. Event Grid používá pro doručování událostí exponenciální zásady opakování opakování. Event Grid opakuje doručení podle následujícího plánu na základě maximálního úsilí:

• 10 sekund
• 30 sekund
• 1 min.
• 5 minut
• 10 minut
• 30 minut
• 1 hodina
• 3 hodin
• 6 hodin
• Každých 12 hodin až 24 hodin

Pokud koncový bod reaguje do 3 minut, služba Event Grid se pokusí událost odebrat z fronty opakování na základě nejlepšího úsilí, ale duplicitní položky se můžou stále přijímat.

Event Grid přidá do všech kroků opakování malou náhodnost a může oportunisticky přeskočit určité opakování, pokud koncový bod není trvale v pořádku, po dlouhou dobu dolů nebo se zdá být zahlcený.

Zásady opakování

Zásady opakování můžete přizpůsobit při vytváření odběru událostí pomocí následujících dvou konfigurací. Událost se zahodí, pokud dosáhnete některého z limitů zásad opakování.

• Maximální počet pokusů – hodnota musí být celé číslo mezi 1 a 30. Výchozí hodnota je 30.
• Hodnota TTL (Time to Live) události – hodnota musí být celé číslo mezi 1 a 1440. Výchozí hodnota je 1440 minut.

Ukázkové příkazy rozhraní příkazového řádku a PowerShellu pro konfiguraci těchto nastavení najdete v tématu Nastavení zásad opakování.

Dávkování výstupu

Event Grid ve výchozím nastavení odesílá každou událost jednotlivě odběratelům. Odběratel obdrží pole s jednou událostí. Ve scénářích s vysokou propustností můžete službu Event Grid nakonfigurovat na dávkové události pro doručování, abyste zlepšili výkon HTTP. Dávkování je ve výchozím nastavení vypnuté a je možné ho zapnout pro jednotlivá předplatná.

Zásady dávkování

Dávkové doručování má dvě nastavení:

• Maximální počet událostí na dávku – Maximální počet událostí, které Event Grid doručuje na dávku. Toto číslo nebude nikdy překročeno, ale pokud nejsou v době publikování k dispozici žádné jiné události, může se doručovat méně událostí. Event Grid nezpozdí události, aby vytvořily dávku, pokud je k dispozici méně událostí. Musí být mezi 1 a 5 000.
• Upřednostňovaná velikost dávky v kilobajtech – cílový strop pro velikost dávky v kilobajtech. Podobně jako maximální počet událostí může být velikost dávky menší, pokud v době publikování není k dispozici více událostí. Je možné, že dávka je větší než upřednostňovaná velikost dávky, pokud je jedna událost větší než upřednostňovaná velikost. Pokud je například upřednostňovaná velikost 4 kB a událost o velikosti 10 kB se odešle do Event Gridu, bude událost 10 kB stále doručena ve své vlastní dávce a nebude se vyhazovat.

Dávkové doručování v rámci nakonfigurovaného odběru jednotlivých událostí prostřednictvím portálu, rozhraní příkazového řádku, PowerShellu nebo sad SDK

Chování dávkování

• Vše nebo žádný

  Event Grid pracuje s sémantikou typu all-or-none. Nepodporuje částečný úspěch doručení dávky. Předplatitelé by měli být opatrní, aby požádali pouze o tolik událostí na dávku, kolik jich dokáže přiměřeně zpracovat za 30 sekund.

• Optimistické dávkování

  Nastavení zásad dávkování nejsou striktní omezení chování dávkování a jsou respektována na základě maximálního úsilí. Při nízkých mírách událostí často zjistíte, že velikost dávky je menší než požadovaná maximální počet událostí na dávku.

• Výchozí hodnota je nastavená na VYPNUTO.

  Event Grid ve výchozím nastavení přidává do každé žádosti o doručení jenom jednu událost. Způsob, jak zapnout dávkování, je nastavit jedno z nastavení uvedených výše v článku ve formátu JSON odběru událostí.

• Výchozí hodnoty

  Při vytváření odběru událostí není nutné zadávat nastavení (maximální počet událostí na dávku i přibližnou velikost dávky v kilobajtů). Pokud je nastaveno pouze jedno nastavení, Event Grid používá (konfigurovatelné) výchozí hodnoty. Informace o výchozích hodnotách a jejich přepsání najdete v následujících částech.

Azure Portal:

Tato nastavení se zobrazí na kartě Další funkce na stránce Odběr událostí.

Azure CLI

Při vytváření odběru událostí použijte následující parametry:

• max-events-per-batch – maximální počet událostí v dávce. Musí to být číslo od 1 do 5000.
• preferred-batch-size-in-kilobajtů – upřednostňovaná velikost dávky v kilobajtech. Musí to být číslo v rozsahu 1 až 1024.

storageid=$(az storage account show --name <storage_account_name> --resource-group <resource_group_name> --query id --output tsv)
endpoint=https://$sitename.azurewebsites.net/api/updates

az eventgrid event-subscription create \
  --resource-id $storageid \
  --name <event_subscription_name> \
  --endpoint $endpoint \
  --max-events-per-batch 1000 \
  --preferred-batch-size-in-kilobytes 512

Další informace o používání Azure CLI s Event Gridem najdete v tématu Směrování událostí úložiště do webového koncového bodu pomocí Azure CLI.

Zpožděné doručení

Vzhledem k tomu, že u koncového bodu dochází k selhání doručení, služba Event Grid začne zpozdit doručení a opakování událostí do tohoto koncového bodu. Pokud například prvních 10 událostí publikovaných do koncového bodu selže, služba Event Grid předpokládá, že u koncového bodu dochází k problémům, a po určitou dobu zpozdí všechny následné opakování a nové dodávky – v některých případech až několik hodin.

Funkčním účelem zpožděného doručování je ochrana koncových bodů, které nejsou v pořádku, a systému Event Grid. Bez zpětného vypnutí a zpoždění doručení do koncových bodů, které nejsou v pořádku, můžou zásady opakování a možnosti svazku služby Event Grid snadno zahltit systém.

Události nedoručených dopisů

Pokud Event Grid nemůže událost doručovat během určitého časového období nebo po pokusu o doručení události určitou dobu, může odeslat nedoručenou událost do účtu úložiště. Tento proces se označuje jako nedoručených dopisů. Když je splněna jedna z následujících podmínek, eventua event gridu je nedosaděná písmena.

• Událost není doručována během časového období.
• Počet pokusů o doručení události překročil limit.

Pokud jsou splněny některé z podmínek, událost se zahodí nebo nedoručí. Ve výchozím nastavení služba Event Grid nezapne nedoručitelnost. Pokud ho chcete povolit, musíte při vytváření odběru událostí zadat účet úložiště, ve kterém se budou uchovávat nezřetězené události. Události načítáte z tohoto účtu úložiště, abyste vyřešili dodávky.

Event Grid odešle událost do umístění nedoručených dopisů, když se pokusila všechny pokusy o opakování. Pokud Event Grid obdrží kód odpovědi 400 (Chybný požadavek) nebo 413 (příliš velká entita požadavku), okamžitě naplánuje událost pro nedoručitelnost. Tyto kódy odpovědí označují doručení události nikdy neuspěje.

Vypršení časového limitu je zaškrtnuto pouze při příštím plánovaném pokusu o doručení. Takže i v případě, že vyprší platnost času naživo před dalším plánovaným pokusem o doručení, je vypršení platnosti události kontrolováno pouze v době dalšího doručení a následně nedoručené dopisy.

Mezi posledním pokusem o doručení události a doručením do umístění nedoručených dopisů trvá pět minut. Toto zpoždění je určené ke snížení počtu operací úložiště objektů blob. Pokud je nedostupné místo nedoručených dopisů po dobu čtyř hodin, událost se zahodí.

Před nastavením umístění nedoručených dopisů musíte mít účet úložiště s kontejnerem. Při vytváření odběru událostí zadáte koncový bod pro tento kontejner. Koncový bod je ve formátu: /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Storage/storageAccounts/<storage-name>/blobServices/default/containers/<container-name>

Možná budete chtít být upozorněni, když byla událost odeslána do umístění nedoručených dopisů. Pokud chcete službu Event Grid použít k reagování na nedoručené události, vytvořte odběr událostí pro úložiště objektů blob s nedoručenými písmeny. Pokaždé, když úložiště objektů blob nedoručených dopisů obdrží nedoručenou událost, Event Grid upozorní vaši obslužnou rutinu. Obslužná rutina reaguje akcemi, které chcete provést pro obnovení nevyřešených událostí. Příklad nastavení umístění nedoručených dopisů a zásad opakování najdete v tématu Nedoručované písmeno a zásady opakování.

Formáty událostí doručení

Tato část obsahuje příklady událostí a nedoručených událostí v různých formátech schématu doručení (schéma Event Gridu, schéma CloudEvents 1.0 a vlastní schéma). Další informace o těchto formátech najdete v článcích o schématu Event Gridu a událostech cloudu 1.0.

Schéma služby Event Grid

Událost

{
    "id": "93902694-901e-008f-6f95-7153a806873c",
    "eventTime": "2020-08-13T17:18:13.1647262Z",
    "eventType": "Microsoft.Storage.BlobCreated",
    "dataVersion": "",
    "metadataVersion": "1",
    "topic": "/subscriptions/000000000-0000-0000-0000-00000000000000/resourceGroups/rgwithoutpolicy/providers/Microsoft.Storage/storageAccounts/myegteststgfoo",
    "subject": "/blobServices/default/containers/deadletter/blobs/myBlobFile.txt",    
    "data": {
        "api": "PutBlob",
        "clientRequestId": "c0d879ad-88c8-4bbe-8774-d65888dc2038",
        "requestId": "93902694-901e-008f-6f95-7153a8000000",
        "eTag": "0x8D83FACDC0C3402",
        "contentType": "text/plain",
        "contentLength": 0,
        "blobType": "BlockBlob",
        "url": "https://myegteststgfoo.blob.core.windows.net/deadletter/myBlobFile.txt",
        "sequencer": "00000000000000000000000000015508000000000005101c",
        "storageDiagnostics": { "batchId": "cfb32f79-3006-0010-0095-711faa000000" }
    }
}

Událost nedoručených dopisů

{
    "id": "93902694-901e-008f-6f95-7153a806873c",
    "eventTime": "2020-08-13T17:18:13.1647262Z",
    "eventType": "Microsoft.Storage.BlobCreated",
    "dataVersion": "",
    "metadataVersion": "1",
    "topic": "/subscriptions/0000000000-0000-0000-0000-000000000000000/resourceGroups/rgwithoutpolicy/providers/Microsoft.Storage/storageAccounts/myegteststgfoo",
    "subject": "/blobServices/default/containers/deadletter/blobs/myBlobFile.txt",    
    "data": {
        "api": "PutBlob",
        "clientRequestId": "c0d879ad-88c8-4bbe-8774-d65888dc2038",
        "requestId": "93902694-901e-008f-6f95-7153a8000000",
        "eTag": "0x8D83FACDC0C3402",
        "contentType": "text/plain",
        "contentLength": 0,
        "blobType": "BlockBlob",
        "url": "https://myegteststgfoo.blob.core.windows.net/deadletter/myBlobFile.txt",
        "sequencer": "00000000000000000000000000015508000000000005101c",
        "storageDiagnostics": { "batchId": "cfb32f79-3006-0010-0095-711faa000000" }
    },

    "deadLetterReason": "MaxDeliveryAttemptsExceeded",
    "deliveryAttempts": 1,
    "lastDeliveryOutcome": "NotFound",
    "publishTime": "2020-08-13T17:18:14.0265758Z",
    "lastDeliveryAttemptTime": "2020-08-13T17:18:14.0465788Z" 
}

Tady jsou možné hodnoty lastDeliveryOutcome a jejich popisy.

LastDeliveryOutcome: Probation

Odběr událostí se probuje po dobu trvání službou Event Grid, pokud se při doručování událostí do daného cíle nedaří. Doba probace se liší pro různé chyby vrácené cílovým koncovým bodem. Pokud je odběr událostí ve zkušební verzi, můžou se události dostat nedoručené nebo vyřazené, aniž by se dokonce pokoušely doručit v závislosti na kódu chyby, kvůli kterému je v probaci.

Schéma CloudEvents 1.0

Událost

{
    "id": "caee971c-3ca0-4254-8f99-1395b394588e",
    "source": "mysource",
    "dataversion": "1.0",
    "subject": "mySubject",
    "type": "fooEventType",
    "datacontenttype": "application/json",
    "data": {
        "prop1": "value1",
        "prop2": 5
    }
}

Událost nedoručených dopisů

{
    "id": "caee971c-3ca0-4254-8f99-1395b394588e",
    "source": "mysource",
    "dataversion": "1.0",
    "subject": "mySubject",
    "type": "fooEventType",
    "datacontenttype": "application/json",
    "data": {
        "prop1": "value1",
        "prop2": 5
    },

    "deadletterreason": "MaxDeliveryAttemptsExceeded",
    "deliveryattempts": 1,
    "lastdeliveryoutcome": "NotFound",
    "publishtime": "2020-08-13T21:21:36.4018726Z",
}

Vlastní schéma

Událost

{
    "prop1": "my property",
    "prop2": 5,
    "myEventType": "fooEventType"
}

Událost nedoručených dopisů

{
    "id": "8bc07e6f-0885-4729-90e4-7c3f052bd754",
    "eventTime": "2020-08-13T18:11:29.4121391Z",
    "eventType": "myEventType",
    "dataVersion": "1.0",
    "metadataVersion": "1",
    "topic": "/subscriptions/00000000000-0000-0000-0000-000000000000000/resourceGroups/rgwithoutpolicy/providers/Microsoft.EventGrid/topics/myCustomSchemaTopic",
    "subject": "subjectDefault",
  
    "deadLetterReason": "MaxDeliveryAttemptsExceeded",
    "deliveryAttempts": 1,
    "lastDeliveryOutcome": "NotFound",
    "publishTime": "2020-08-13T18:11:29.4121391Z",
    "lastDeliveryAttemptTime": "2020-08-13T18:11:29.4277644Z",
  
    "data": {
        "prop1": "my property",
        "prop2": 5,
        "myEventType": "fooEventType"
    }
}

Stav doručení zprávy

Event Grid používá kódy odpovědí HTTP k potvrzení přijetí událostí.

Kódy úspěchu

Event Grid považuje za úspěšné dodávky pouze následující kódy odpovědí HTTP. Všechny ostatní stavové kódy se považují za neúspěšné dodávky a podle potřeby se budou opakovat nebo zmařit. Když Event Grid obdrží úspěšný stavový kód, považuje doručení za dokončené.

• 200 OK
• 201 Vytvořeno
• 202 Přijato
• 203 Neautoritativní informace
• 204 Chybí obsah

Kódy selhání

Všechny ostatní kódy, které nejsou v sadě (200–204), se považují za selhání a v případě potřeby se budou opakovat. Některé mají specifické zásady opakování svázané sem, všechny ostatní se řídí standardním exponenciálním back-off modelem. Je důležité mít na paměti, že vzhledem k vysoce paralelizované povaze architektury služby Event Grid je chování opakování ne deterministické.

Vlastní vlastnosti doručení

Odběry událostí umožňují nastavit hlavičky HTTP, které jsou součástí doručených událostí. Tato funkce umožňuje nastavit vlastní hlavičky, které jsou požadovány cílem. Při vytváření odběru událostí můžete nastavit až 10 hlaviček. Každá hodnota záhlaví by neměla být větší než 4 096 bajtů (4K). U událostí, které se doručují do následujících cílů, můžete nastavit vlastní hlavičky:

• Webhooky
• Témata a fronty služby Azure Service Bus
• Azure Event Hubs
• Relay Hybrid Connections

Další informace naleznete v tématu Vlastní vlastnosti doručení.

Další kroky

• Pokud chcete zobrazit stav dodávek událostí, přečtěte si téma Monitorování doručení zpráv event Gridu.
• Pokud chcete přizpůsobit možnosti doručování událostí, přečtěte si zásady nedoručených zpráv a opakování.