Azure Event Grid kavramlarıConcepts in Azure Event Grid

Bu makalede, Azure Event Grid içindeki ana kavramlar açıklanır.This article describes the main concepts in Azure Event Grid.

EventsEvents

Sistemde gerçekleşen bir şey tam olarak açıklayan bilgileri en az miktarda bir olaydır.An event is the smallest amount of information that fully describes something that happened in the system. Her bir olay gibi genel bilgiler yok: olayının kaynağı, olay yerinde ve benzersiz tanımlayıcı geçen süre.Every event has common information like: source of the event, time the event took place, and unique identifier. Her olay, yalnızca belirli olay türü için uygun olan belirli bilgileri de vardır.Every event also has specific information that is only relevant to the specific type of event. Örneğin, bir Azure depolamada oluşturulan yeni bir dosya ile ilgili ayrıntıları dosya hakkında gibi olayda lastTimeModified değeri.For example, an event about a new file being created in Azure Storage has details about the file, such as the lastTimeModified value. Veya, Event Hubs olay yakalama dosyanın URL'si.Or, an Event Hubs event has the URL of the Capture file.

Bir olay boyutu en fazla 64 KB, genel kullanılabilirlik (GA) hizmet düzeyi sözleşmesi (SLA) tarafından alınmıştır.An event of size up to 64 KB is covered by General Availability (GA) Service Level Agreement (SLA). Bir olay boyutu en fazla desteği 1 MB şu anda Önizleme aşamasındadır.The support for an event of size up to 1 MB is currently in preview. Olaylar üzerinde 64 KB, 64 KB'lık artışlarla ücretlendirilir.Events over 64 KB are charged in 64-KB increments.

Bir olayı gönderilir özelliklerini görmek Azure Event Grid olay şeması.For the properties that are sent in an event, see Azure Event Grid event schema.

YayımcılarPublishers

Bir kullanıcı veya olayları Event Grid'e göndermek için karar kuruluş yayımcısıdır.A publisher is the user or organization that decides to send events to Event Grid. Microsoft, çeşitli Azure Hizmetleri için olayları yayımlar.Microsoft publishes events for several Azure services. Kendi uygulamanızı olayları yayımlayabilir.You can publish events from your own application. Azure dışındaki hizmetleri barındıran kuruluşlar için Event Grid aracılığıyla olayları yayımlayabilir.Organizations that host services outside of Azure can publish events through Event Grid.

Olay kaynaklarıEvent sources

Burada olay gerçekleştiğinde bir olay kaynağıdır.An event source is where the event happens. Her bir olay kaynağı, bir veya daha fazla olay türlerini ilgilidir.Each event source is related to one or more event types. Örneğin, Azure depolama blob oluşturulan olayları için olay kaynağı ' dir.For example, Azure Storage is the event source for blob created events. IOT Hub cihaz tarafından oluşturulan olayları için olay kaynağı ' dir.IoT Hub is the event source for device created events. Uygulamanızı tanımlayan özel olayları için olay kaynağı ' dir.Your application is the event source for custom events that you define. Olay kaynakları olayları Event Grid'e göndermek için sorumlu olursunuz.Event sources are responsible for sending events to Event Grid.

Desteklenen Event Grid kaynaklarından herhangi biri uygulama hakkında daha fazla bilgi için bkz: Azure Event Grid olay kaynaklarında.For information about implementing any of the supported Event Grid sources, see Event sources in Azure Event Grid.

Konu başlıklarıTopics

Olay Kılavuzu konusunu burada kaynak olayları gönderen bir uç nokta sağlar.The event grid topic provides an endpoint where the source sends events. Yayımcı olay Kılavuzu konusu oluşturur ve bir olay kaynağı bir konu veya konu birden fazla gerekip gerekmediğini belirler.The publisher creates the event grid topic, and decides whether an event source needs one topic or more than one topic. Bir konu koleksiyonunu ilgili olaylar için kullanılır.A topic is used for a collection of related events. Belirli olay türleri için yanıt vermek için abone olma konuları aboneleri karar verin.To respond to certain types of events, subscribers decide which topics to subscribe to.

Sistem konular, Azure Hizmetleri tarafından sağlanan yerleşik konulardır.System topics are built-in topics provided by Azure services. Azure aboneliğinizde yayımcı konulara sahip, ancak bunlara abone olabilir çünkü sistem konuları görmüyorum.You don't see system topics in your Azure subscription because the publisher owns the topics, but you can subscribe to them. Abone olmak için kaynak, olaylarından almak istediğiniz bilgileri sağlayın.To subscribe, you provide information about the resource you want to receive events from. Kaynağa erişimi olduğu sürece, kendi olaylarına abone olabilirsiniz.As long as you have access to the resource, you can subscribe to its events.

Özel konular şunlardır: uygulama ve üçüncü taraf konuları.Custom topics are application and third-party topics. Oluşturduğunuzda veya bir özel konu için okuma erişimi atanan aboneliğinizde özel konuya bakın.When you create or are assigned access to a custom topic, you see that custom topic in your subscription.

Uygulamanızı tasarlarken oluşturmak için ne kadar konunun verirken esnekliğine sahipsiniz.When designing your application, you have flexibility when deciding how many topics to create. Büyük çözümler için ilgili olay her kategori için özel bir konu oluşturun.For large solutions, create a custom topic for each category of related events. Örneğin, sipariş işleme ve kullanıcı hesaplarını değiştirme ile ilgili olayları gönderen bir uygulama düşünün.For example, consider an application that sends events related to modifying user accounts and processing orders. Her iki olayların kategorilerini herhangi bir olay işleyici istediği düşüktür.It's unlikely any event handler wants both categories of events. İki özel konu oluşturma ve onları ilgilendiren bir abone olay işleyicileri sağlar.Create two custom topics and let event handlers subscribe to the one that interests them. Küçük çözümler için tüm olayları tek bir konu başlığına göndermeyi tercih edebilirsiniz.For small solutions, you might prefer to send all events to a single topic. Etkinlik abonelerinden istedikleri olay türleri için filtre uygulayabilirsiniz.Event subscribers can filter for the event types they want.

Olay abonelikleriEvent subscriptions

Abonelik alma içinde ilginizi çeken bir konuya hangi olayların Event Grid söyler.A subscription tells Event Grid which events on a topic you're interested in receiving. Abonelik oluştururken, olayı işlemek için bir uç nokta sağlar.When creating the subscription, you provide an endpoint for handling the event. Uç noktasına gönderilen olaylar için filtre uygulayabilirsiniz.You can filter the events that are sent to the endpoint. Olay türü veya konu deseni filtreleyebilirsiniz.You can filter by event type, or subject pattern. Daha fazla bilgi için Event Grid aboneliği şema.For more information, see Event Grid subscription schema.

Abonelik oluşturma örnekler için bkz:For examples of creating subscriptions, see:

Geçerli olay Kılavuzu abonelikleri alma hakkında daha fazla bilgi için bkz: Event Grid aboneliklerini sorgulama.For information about getting your current event grid subscriptions, see Query Event Grid subscriptions.

Olay aboneliği süre sonuEvent subscription expiration

Olay aboneliğinin süresi bu tarihte otomatik olarak sona erer.The event subscription is automatically expired after that date. Sınırlı bir süre için yalnızca gerekli olay aboneliklerine yönelik bir sona erme süresini ayarlayabilir ve bu Aboneliklerdeki temizleme hakkında endişelenmeye gerek istemiyorum.Set an expiration for event subscriptions that are only needed for a limited time and you don't want to worry about cleaning up those subscriptions. Örneğin, bir senaryoyu test etmek için bir olay aboneliği oluşturulurken bir sona erme süresini ayarlayabilir isteyebilirsiniz.For example, when creating an event subscription to test a scenario, you might want to set an expiration.

Bir süre sonu ayarlama örneği için bkz: Gelişmiş Filtreler ile abone ol.For an example of setting an expiration, see Subscribe with advanced filters.

Olay işleyicileriEvent handlers

Event Grid açısından bakıldığında, bir olay işleyicisi, burada olay gönderilir yerdir.From an Event Grid perspective, an event handler is the place where the event is sent. Olayı işlemek için bazı başka bir eylem işleyici alır.The handler takes some further action to process the event. Event Grid, çeşitli işleyici türlerini destekler.Event Grid supports several handler types. Desteklenen bir Azure hizmeti veya kendi Web kancası işleyicisi olarak kullanabilirsiniz.You can use a supported Azure service or your own webhook as the handler. İşleyici türüne bağlı olarak, Event Grid olay teslimini garanti etmek için farklı mekanizmalar izler.Depending on the type of handler, Event Grid follows different mechanisms to guarantee the delivery of the event. HTTP Web kancası olay işleyicileri için olay işleyicisi durum kodu dönene kadar yeniden denenir 200 – OK.For HTTP webhook event handlers, the event is retried until the handler returns a status code of 200 – OK. Kuyruk hizmeti başarıyla kuyruğa ileti gönderme işlemleri kadar için Azure depolama kuyruğu, olayları yeniden denenir.For Azure Storage Queue, the events are retried until the Queue service successfully processes the message push into the queue.

Tüm desteklenen Event Grid işleyicilerin uygulanması hakkında daha fazla bilgi için bkz: Azure Event Grid olay işleyicileri.For information about implementing any of the supported Event Grid handlers, see Event handlers in Azure Event Grid.

GüvenlikSecurity

Olay Kılavuzu konularına abone olma ve konuları yayımlama için güvenlik sağlar.Event Grid provides security for subscribing to topics, and publishing topics. Abone olurken, kaynak veya olay Kılavuzu konu üzerinde yeterli izinleri olmalıdır.When subscribing, you must have adequate permissions on the resource or event grid topic. Yayımlama sırasında bir SAS belirteci veya anahtar kimlik doğrulaması için konu olmalıdır.When publishing, you must have a SAS token or key authentication for the topic. Daha fazla bilgi için Event Grid güvenliğini ve kimlik doğrulaması.For more information, see Event Grid security and authentication.

Olay teslimiEvent delivery

Event Grid olay abonenin uç noktası tarafından alındı doğrulayamazsa olay redelivers.If Event Grid can't confirm that an event has been received by the subscriber's endpoint, it redelivers the event. Daha fazla bilgi için Event Grid iletiyi teslim ve yeniden deneme.For more information, see Event Grid message delivery and retry.

Toplu İşlemeBatching

Özel bir konu kullanırken, olayları bir dizide her zaman yayımlanması gerekir.When using a custom topic, events must always be published in an array. Düşük aktarım hızı senaryoları, Bununla birlikte, yüksek hacimli için kullanım örnekleri için bu bir toplu olabilir, birçok batch önerilir başına birlikte olayları yayımlamak daha yüksek verimlilik elde edin.This can be a batch of one for low-throughput scenarios, however, for high volume use cases, it's recommended that you batch several events together per publish to achieve higher efficiency. Toplu iş 1 MB'a kadar olabilir.Batches can be up to 1 MB. Her olay hala 64 KB'lık (Genel kullanım) veya 1 MB (Önizleme) büyük olmamalıdır.Each event should still not be greater than 64 KB (General Availability) or 1 MB (preview).

Not

Bir olay boyutu en fazla 64 KB, genel kullanılabilirlik (GA) hizmet düzeyi sözleşmesi (SLA) tarafından alınmıştır.An event of size up to 64 KB is covered by General Availability (GA) Service Level Agreement (SLA). Bir olay boyutu en fazla desteği 1 MB şu anda Önizleme aşamasındadır.The support for an event of size up to 1 MB is currently in preview. Olaylar üzerinde 64 KB, 64 KB'lık artışlarla ücretlendirilir.Events over 64 KB are charged in 64 KB increments.

Sonraki adımlarNext steps