Azure Event Hubs ve Azure Logic Apps ile olayları izleyin, alın ve gönderinMonitor, receive, and send events with Azure Event Hubs and Azure Logic Apps

Bu makalede, Azure Event Hubs Bağlayıcısı ile bir mantıksal uygulamanın içinden azure Event Hubs gönderilen olayları nasıl izleyebileceğinizi ve yönetebileceğinizi gösterir.This article shows how you can monitor and manage events sent to Azure Event Hubs from inside a logic app with the Azure Event Hubs connector. Böylece, Olay Hub’ınızdan gelen olayları almaya, bu olayları denetlemeye ve göndermeye yönelik görevleri ve iş akışlarını otomatikleştiren mantıksal uygulamalar oluşturabilirsiniz.That way, you can create logic apps that automate tasks and workflows for checking, sending, and receiving events from your Event Hub. Bağlayıcıya özgü teknik bilgiler için bkz. Azure Event Hubs Bağlayıcısı başvurusu.For connector-specific technical information, see the Azure Event Hubs connector reference.

ÖnkoşullarPrerequisites

İzinleri denetle ve bağlantı dizesi alCheck permissions and get connection string

Mantıksal uygulamanızın Olay Hub 'ınıza erişebildiğinizden emin olmak için, izinlerinizi denetleyin ve Event Hubs ad alanınız için bağlantı dizesini alın.To make sure that your logic app can access your Event Hub, check your permissions and get the connection string for your Event Hubs namespace.

  1. Azure Portal oturum açın.Sign in to the Azure portal.

  2. Belirli bir olay hub 'ına değil Event Hubs ad alanınagidin.Go to your Event Hubs namespace, not a specific Event Hub.

  3. Ad alanı menüsünde, Ayarlaraltında, paylaşılan erişim ilkeleri' ni seçin.On the namespace menu, under Settings, select Shared access policies. Talepleraltında, bu ad alanı Için izinleri yönetme izinlerine sahip olup olmadığınızı kontrol edin.Under Claims, check that you have Manage permissions for that namespace.

    Olay Hub 'ı ad alanınız için izinleri yönetme

  4. Daha sonra bağlantı bilgilerinizi el ile girmek istiyorsanız, Event Hubs ad alanınız için bağlantı dizesini alın.If you want to later manually enter your connection information, get the connection string for your Event Hubs namespace.

    1. İlkealtında RootManageSharedAccessKeyöğesini seçin.Under Policy, choose RootManageSharedAccessKey.

    2. Birincil anahtarınızın bağlantı dizesini bulun.Find your primary key's connection string. Kopyala düğmesini seçin ve daha sonra kullanmak üzere bağlantı dizesini kaydedin.Choose the copy button, and save the connection string for later use.

      Event Hubs ad alanı bağlantı dizesini Kopyala

      İpucu

      Bağlantı dizeniz Event Hubs ad alanınız veya belirli bir olay hub 'ı ile ilişkili olup olmadığını doğrulamak için, bağlantı dizesinin EntityPath  parametreye sahip olmadığından emin olun.To confirm whether your connection string is associated with your Event Hubs namespace or with a specific event hub, make sure the connection string doesn't have the EntityPath parameter. Bu parametreyi bulursanız, bağlantı dizesi belirli bir olay hub 'ı "varlığına" yöneliktir ve mantıksal uygulamanızla kullanılacak doğru dize değildir.If you find this parameter, the connection string is for a specific Event Hub "entity" and is not the correct string to use with your logic app.

  5. Şimdi Event Hubs tetikleyici ekleme veya Event Hubs eylemi eklemeile devam edin.Now continue with Add an Event Hubs trigger or Add an Event Hubs action.

Event Hubs tetikleyicisi EkleAdd Event Hubs trigger

Azure Logic Apps, her mantıksal uygulama, belirli bir olay gerçekleştiğinde veya belirli bir koşul karşılandığında tetiklenen bir tetikleyiciyle başlamalıdır.In Azure Logic Apps, every logic app must start with a trigger, which fires when a specific event happens or when a specific condition is met. Tetikleyici her tetiklendiğinde Logic Apps altyapısı bir mantıksal uygulama örneği oluşturur ve uygulamanızın iş akışını çalıştırmaya başlar.Each time the trigger fires, the Logic Apps engine creates a logic app instance and starts running your app's workflow.

Bu örnek, Olay Hub 'ınıza yeni olaylar gönderildiğinde bir mantıksal uygulama iş akışını nasıl başlatakullanabileceğinizi gösterir.This example shows how you can start a logic app workflow when new events are sent to your Event Hub.

  1. Azure portal veya Visual Studio 'da, Logic Apps tasarımcısını açan boş bir mantıksal uygulama oluşturun.In the Azure portal or Visual Studio, create a blank logic app, which opens Logic Apps Designer. Bu örnek Azure portal kullanır.This example uses the Azure portal.

  2. Arama kutusuna filtreniz olarak "Olay Hub 'ları" yazın.In the search box, enter "event hubs" as your filter. Tetikleyiciler listesinde, bu tetikleyiciyi seçin: Olay Hub 'ında olaylar kullanılabilir olduğunda-Event HubsFrom the triggers list, select this trigger: When events are available in Event Hub - Event Hubs

    Tetikleyici seçin

  3. Bağlantı ayrıntıları istenirse Event Hubs bağlantınızı hemen oluşturun.If you're prompted for connection details, create your Event Hubs connection now.

  4. Tetikleyicide, izlemek istediğiniz olay hub 'ı hakkında bilgi sağlayın.In the trigger, provide information about the Event Hub that you want to monitor. Daha fazla özellik için yeni parametre Ekle listesini açın.For more properties, open the Add new parameter list. Bir parametre seçilmesi, bu özelliği tetikleyici kartına ekler.Selecting a parameter adds that property to the trigger card.

    Tetikleyici özellikleri

    ÖzellikProperty GerekliRequired AçıklamaDescription
    Olay hub'ı adıEvent Hub name EvetYes İzlemek istediğiniz olay hub 'ının adıThe name for the Event Hub that you want to monitor
    İçerik türüContent type HayırNo Olayın içerik türü.The event's content type. Varsayılan, application/octet-stream değeridir.The default is application/octet-stream.
    Tüketici grubu adıConsumer group name HayırNo Olayları okumak için kullanılacak Olay Hub 'ı Tüketici grubu adı .The name for the Event Hub consumer group to use for reading events. Belirtilmemişse, varsayılan Tüketici grubu kullanılır.If not specified, the default consumer group is used.
    En fazla olay sayısıMaximum events count HayırNo En fazla olay sayısı.The maximum number of events. Tetikleyici, bu özellik tarafından belirtilen bir ve olay sayısı arasında döndürülür.The trigger returns between one and the number of events specified by this property.
    AralıkInterval EvetYes İş akışının sıklık temelinde ne sıklıkta çalışacağını açıklayan pozitif bir tamsayıA positive integer that describes how often the workflow runs based on the frequency
    SıklıkFrequency EvetYes Yinelenme için zaman birimiThe unit of time for the recurrence

    Ek özelliklerAdditional properties

    ÖzellikProperty GerekliRequired AçıklamaDescription
    İçerik şemasıContent schema HayırNo Olay Hub 'ından okunan olaylara yönelik JSON içerik şeması.The JSON content schema for the events to read from the Event Hub. Örneğin, içerik şemasını belirtirseniz, mantıksal uygulamayı yalnızca şemayla eşleşen olaylar için tetikleyebilirsiniz.For example, if you specify the content schema, you can trigger the logic app for only those events that match the schema.
    Minimum bölüm anahtarıMinimum partition key HayırNo Okunacak minimum bölüm kimliğini girin.Enter the minimum partition ID to read. Varsayılan olarak, tüm bölümler okunurdur.By default, all partitions are read.
    En büyük bölüm anahtarıMaximum partition key HayırNo Okunacak bölüm kimliği üst sınırını girin.Enter the maximum partition ID to read. Varsayılan olarak, tüm bölümler okunurdur.By default, all partitions are read.
    Saat dilimiTime zone HayırNo Yalnızca bir başlangıç saati belirttiğinizde geçerlidir çünkü bu tetikleyici UTC sapmasını kabul etmez.Applies only when you specify a start time because this trigger doesn't accept UTC offset. Uygulamak istediğiniz saat dilimini seçin.Select the time zone that you want to apply.

    Daha fazla bilgi için bkz. Azure Logic Apps ile yinelenen görevler ve iş akışları oluşturma ve çalıştırma.For more information, see Create and run recurring tasks and workflows with Azure Logic Apps.

    Başlangıç saatiStart time HayırNo Bu biçimde bir başlangıç saati sağlayın:Provide a start time in this format:

    YYYY-MM-DDThh: mm: ss saat dilimi seçersenizYYYY-MM-DDThh:mm:ss if you select a time zone

    -veya--or-

    YYYY-MM-DDThh: mm: ssZ saat dilimi seçmeYYYY-MM-DDThh:mm:ssZ if you don't select a time zone

    Daha fazla bilgi için bkz. Azure Logic Apps ile yinelenen görevler ve iş akışları oluşturma ve çalıştırma.For more information, see Create and run recurring tasks and workflows with Azure Logic Apps.

  5. İşiniz bittiğinde, Tasarımcı araç çubuğunda Kaydet' i seçin.When you're done, on the designer toolbar, choose Save.

  6. Şimdi, tetikleyici sonuçlarıyla gerçekleştirmek istediğiniz görevler için mantıksal uygulamanıza bir veya daha fazla eylem eklemeye devam edin.Now continue adding one or more actions to your logic app for the tasks you want to perform with the trigger results.

    Örneğin, olayları bir kategori gibi belirli bir değere göre filtrelemek için, olay Gönder eyleminin yalnızca koşullarınızı karşılayan olayları göndermesi için bir koşul ekleyebilirsiniz.For example, to filter events based on a specific value, such as a category, you can add a condition so that the Send event action sends only the events that meet your condition.

Not

Tüm Olay Hub 'ı Tetikleyicileri uzun yoklama tetiklerdir, bu da bir tetikleyici tetiklendiğinde tetikleyicinin tüm olayları işlediği ve daha fazla olayın olay hub 'ında görünmesi için 30 saniye bekler.All Event Hub triggers are long-polling triggers, which means that when a trigger fires, the trigger processes all the events and then waits for 30 seconds for more events to appear in your Event Hub. 30 saniye içinde hiçbir olay alınmıyorsa, tetikleyici çalıştırması atlanır.If no events are received in 30 seconds, the trigger run is skipped. Aksi takdirde, tetikleyici olay hub 'ınız boş olana kadar olayları okumaya devam eder.Otherwise, the trigger continues reading events until your Event Hub is empty. Sonraki tetikleyici yoklama, tetikleyicisinin özelliklerinde belirttiğiniz yinelenme aralığına göre yapılır.The next trigger poll happens based on the recurrence interval that you specify in the trigger's properties.

Event Hubs eylem EkleAdd Event Hubs action

Azure Logic Apps bir eylem , iş akışınızda bir tetikleyiciyi veya başka bir eylemi izleyen bir adımdır.In Azure Logic Apps, an action is a step in your workflow that follows a trigger or another action. Bu örnekte, mantıksal uygulama, Olay Hub 'ınızdaki yeni olayları denetleyen Event Hubs tetikleyicisiyle başlar.For this example, the logic app starts with an Event Hubs trigger that checks for new events in your Event Hub.

  1. Azure portal veya Visual Studio 'da mantıksal uygulamanızı Logic Apps tasarımcısında açın.In the Azure portal or Visual Studio, open your logic app in Logic Apps Designer. Bu örnek Azure portal kullanır.This example uses the Azure portal.

  2. Tetikleyici veya eylem altında yeni adım' ı seçin.Under the trigger or action, choose New step.

    Varolan adımlar arasında bir eylem eklemek için farenizi bağlantı oku üzerine taşıyın.To add an action between existing steps, move your mouse over the connecting arrow. Görüntülenen artı işaretini ( + ) seçin ve ardından Eylem Ekle' yi seçin.Choose the plus sign (+) that appears, and then select Add an action.

  3. Arama kutusuna filtreniz olarak "Olay Hub 'ları" yazın.In the search box, enter "event hubs" as your filter. Eylemler listesinden şu eylemi seçin: Olay gönderme-Event HubsFrom the actions list, select this action: Send event - Event Hubs

    "Olay Gönder" eylemini seçin

  4. Bağlantı ayrıntıları istenirse Event Hubs bağlantınızı hemen oluşturun.If you're prompted for connection details, create your Event Hubs connection now.

  5. Eylemde, göndermek istediğiniz olaylar hakkında bilgi sağlayın.In the action, provide information about the events that you want to send. Daha fazla özellik için yeni parametre Ekle listesini açın.For more properties, open the Add new parameter list. Bir parametre seçilmesi bu özelliği eylem kartına ekler.Selecting a parameter adds that property to the action card.

    Olay Hub 'ı adını seçin ve olay içeriğini sağlayın

    ÖzellikProperty GerekliRequired AçıklamaDescription
    Olay hub'ı adıEvent Hub name EvetYes Olayı göndermek istediğiniz olay hub 'ıThe Event Hub where you want to send the event
    İçeriğiContent HayırNo Göndermek istediğiniz olay için içerikThe content for the event you want to send
    ÖzelliklerininProperties HayırNo Gönderilen uygulama özellikleri ve değerlerThe app properties and values to send
    Bölüm anahtarıPartition key HayırNo Olayın gönderileceği bölüm kimliğiThe partition ID for where to send the event

    Örneğin, Event Hubs tetikleyicinizden çıktıyı başka bir olay hub 'ına gönderebilirsiniz:For example, you can send the output from your Event Hubs trigger to another Event Hub:

    Olay örneği gönder

  6. İşiniz bittiğinde, Tasarımcı araç çubuğunda Kaydet' i seçin.When you're done, on the designer toolbar, choose Save.

Olay Hub 'ınıza bağlanınConnect to your Event Hub

Bir hizmete ilk kez erişen bir tetikleyici veya eylem kullandığınızda Logic Apps tasarımcı bu hizmetle bağlantı oluşturmanızı ister.When you use a trigger or action that accesses a service for the first time, the Logic Apps Designer prompts you to create a connection to that service. Daha sonra gerekli bağlantı bilgilerini tasarımcı içindeki mantıksal uygulamanızdan doğrudan sağlayabilirsiniz.You can then provide the necessary connection information directly from your logic app inside the designer.

  1. Bağlantı bilgileri istendiğinde, şu ayrıntıları sağlayın:When you're prompted for connection information, provide these details:

    ÖzellikProperty GerekliRequired ValueValue AçıklamaDescription
    Bağlantı AdıConnection Name EvetYes <bağlantı adı><connection-name> Bağlantınız için oluşturulacak adThe name to create for your connection
    Event Hubs ad alanıEvent Hubs Namespace EvetYes <Olay-Hub 'lar-ad alanı><event-hubs-namespace> Kullanmak istediğiniz Event Hubs ad alanını seçin.Select the Event Hubs namespace you want to use.

    Örneğin:For example:

    Olay Hub 'ı bağlantısı oluştur

    Bağlantı dizesini el ile girmek için bağlantı bilgilerini el ile girin' i seçin.To manually enter the connection string, select Manually enter connection information. Bağlantı dizenizi bulmayıöğrenin.Learn how to find your connection string.

  2. Henüz seçili değilse, kullanılacak Event Hubs ilkesini seçin.Select the Event Hubs policy to use, if not already selected. Oluştur’u seçin.Choose Create.

    Olay Hub 'ı bağlantısı oluşturma, Bölüm 2

  3. Bağlantınızı oluşturduktan sonra Event Hubs tetikleyici Ekle veya Event Hubs eylem Ekle' ye geçin.After you create your connection, continue with Add Event Hubs trigger or Add Event Hubs action.

Bağlayıcı başvurusuConnector reference

Bağlayıcının Openapı (eski adıyla Swagger) dosyasında açıklandığı gibi Tetikleyiciler, Eylemler ve sınırlar gibi teknik ayrıntılar için bağlayıcının başvuru sayfasınabakın.For technical details, such as triggers, actions, and limits, as described by the connector's OpenAPI (formerly Swagger) file, see the connector's reference page.

Sonraki adımlarNext steps

Diğer Logic Apps bağlayıcıları hakkında bilgi edininLearn about other Logic Apps connectors