Monitorare, ricevere e inviare eventi con Hub eventi di Azure e App per la logica di AzureMonitor, receive, and send events with Azure Event Hubs and Azure Logic Apps

Questo articolo illustra come monitorare e gestire gli eventi inviati ad Hub eventi di Azure dall'interno di un'app per la logica con il connettore di Hub eventi di Azure.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. In questo modo, è possibile creare app per la logica in grado di automatizzare attività e flussi di lavoro per il controllo, l'invio e la ricezione di eventi dall'Hub eventi.That way, you can create logic apps that automate tasks and workflows for checking, sending, and receiving events from your Event Hub.

Se non si ha una sottoscrizione di Azure, iscriversi per creare un account Azure gratuito.If you don't have an Azure subscription, sign up for a free Azure account. Se non si ha familiarità con le app per la logica, leggere Informazioni su App per la logica di Azure e Guida introduttiva: Creare la prima app per la logica.If you're new to logic apps, review What is Azure Logic Apps and Quickstart: Create your first logic app. Per informazioni tecniche specifiche per il connettore, vedere le informazioni di riferimento sul connettore di Hub eventi di Azure.For connector-specific technical information, see the Azure Event Hubs connector reference.

prerequisitiPrerequisites

Controllare le autorizzazioni e ottenere la stringa di connessioneCheck permissions and get connection string

Affinché l'app per la logica possa accedere a Hub eventi, verificare le autorizzazioni e ottenere la stringa di connessione per lo spazio dei nomi di Hub eventi.For your logic app to access your Event Hub, check your permissions and get the connection string for your Event Hubs namespace.

  1. Accedere al portale di Azure.Sign in to the Azure portal.

  2. Passare allo spazio dei nomi di Hub eventi, non a un hub eventi specifico.Go to your Event Hubs namespace, not a specific Event Hub. Nella pagina dello spazio dei nomi scegliere Criteri di accesso condivisi in Impostazioni.On the namespace page, under Settings, choose Shared access policies. In Attestazioni controllare di avere le autorizzazioni di gestione per lo spazio dei nomi.Under Claims, check that you have Manage permissions for that namespace.

    Gestire le autorizzazioni per lo spazio dei nomi di Hub eventi

  3. Se si vogliono immettere in un secondo momento le informazioni di connessione manualmente, ottenere la stringa di connessione per lo spazio dei nomi di Hub eventi.If you want to later manually enter your connection information, get the connection string for your Event Hubs namespace.

    1. Sotto Criterio, scegliere RootManageSharedAccessKey.Under Policy, choose RootManageSharedAccessKey.

    2. Trovare la stringa di connessione della chiave primaria.Find your primary key's connection string. Premere il pulsante Copia e salvare la stringa di connessione per un uso successivo.Choose the copy button, and save the connection string for later use.

      Copiare la stringa di connessione dello spazio dei nomi di Hub eventi

      Suggerimento

      Per verificare se la stringa di connessione è associata allo spazio dei nomi di Hub eventi o a un hub eventi specifico, assicurarsi che nella stringa non sia presente il parametro EntityPath.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. Se questo parametro è presente, la stringa di connessione è per un'entità hub eventi specifica e non è la stringa corretta da usare con l'app per la logica.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.

  4. Procedere quindi ad aggiungere un trigger per hub eventi o aggiungere un'azione per hub eventi.Now continue with Add an Event Hubs trigger or Add an Event Hubs action.

Aggiungere un trigger per Hub eventiAdd an Event Hubs trigger

In App per la logica di Azure, ogni app per la logica deve essere avviata con un trigger, che viene attivato quando si verifica un determinato evento o quando viene soddisfatta una condizione specifica.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. Ogni volta che il trigger viene attivato, il motore di App per la logica crea un'istanza dell'app per la logica e avvia l'esecuzione del flusso di lavoro dell'app.Each time the trigger fires, the Logic Apps engine creates a logic app instance and starts running your app's workflow.

Nell'esempio viene illustrato come avviare un flusso di lavoro di app per la logica quando vengono inviati nuovi eventi all'Hub eventi.This example shows how you can start a logic app workflow when new events are sent to your Event Hub.

  1. Nel portale di Azure o in Visual Studio creare un'app per la logica vuota, che apre Progettazione app per la logica.In the Azure portal or Visual Studio, create a blank logic app, which opens Logic Apps Designer. Questo esempio usa il portale di Azure.This example uses the Azure portal.

  2. Nella casella di ricerca immettere "hub eventi" come filtro.In the search box, enter "event hubs" as your filter. Nell'elenco di trigger selezionare il trigger desiderato.From the triggers list, select the trigger you want.

    Nell'esempio viene usato il trigger Event Hubs - When events are available in Event Hub (Hub eventi - Quando sono disponibili eventi nell'hub eventi)This example uses this trigger: Event Hubs - When events are available in Event Hub

    Selezionare il trigger

  3. Se vengono richiesti i dettagli della connessione, creare la connessione ad Hub eventi.If you're prompted for connection details, create your Event Hubs connection now. Se la connessione è già presente, fornire le informazioni necessarie per il trigger.Or, if your connection already exists, provide the necessary information for the trigger.

    1. In Nome hub eventi , selezionare l'hub eventi da monitorare.From the Event Hub name list, select the Event Hub you want to monitor.

      Specificare l'hub eventi o il gruppo di consumer

    2. Selezionare la frequenza e l'intervallo in base a cui si vuole che il trigger controlli l'hub eventi.Select the interval and frequency for how often you want the trigger to check the Event Hub.

    3. Se si vogliono selezionare alcune delle opzioni di trigger avanzate, scegliere Mostra opzioni avanzate.To optionally select some of the advanced trigger options, choose Show advanced options.

      Opzioni avanzate dei trigger

      ProprietàProperty DettagliDetails
      Tipo di contenutoContent type Selezionare il tipo di contenuto dell'evento.Select the event's content type. Per impostazione predefinita, è selezionato "application/octet-stream".The default is "application/octet-stream".
      Content schema (Schema contenuto)Content schema Immettere lo schema contenuto in formato JSON per gli eventi che vengono letti dall'hub eventi.Enter the content schema in JSON for the events that are read from the Event Hub.
      Consumer group name (Nome gruppo di consumer)Consumer group name Immettere il nome gruppo di consumer dell'hub eventi per leggere gli eventi.Enter the Event Hub consumer group name for reading events. Se non specificato, viene usato il gruppo di consumer predefinito.If not specified, the default consumer group is used.
      Minimum partition key (Chiave di partizione minima)Minimum partition key Immettere l'ID di partizione minima da leggere.Enter the minimum partition ID to read. Per impostazione predefinita, vengono lette tutte le partizioni.By default, all partitions are read.
      Maximum partition key (Chiave di partizione massima)Maximum partition key Immettere l'ID di partizione massima da leggere.Enter the maximum partition ID to read. Per impostazione predefinita, vengono lette tutte le partizioni.By default, all partitions are read.
      Maximum events count (Numero massimo di eventi)Maximum events count Immettere un valore per il numero massimo di eventi.Enter a value for the maximum number of events. Il trigger restituisce un valore compreso tra uno e il numero di eventi specificato da questa proprietà.The trigger returns between one and the number of events specified by this property.
  4. Al termine, nella barra degli strumenti della finestra di progettazione scegliere Salva.When you're done, on the designer toolbar, choose Save.

  5. Continuare ad aggiungere una o più azioni all'app per la logica per le attività da eseguire con i risultati del trigger.Now continue adding one or more actions to your logic app for the tasks you want to perform with the trigger results.

Nota

Tutti i trigger dell'hub eventi sono trigger con polling prolungato. Questo significa che, quando un trigger viene attivato, elabora tutti gli eventi e attende 30 secondi che vengano visualizzati altri eventi nell'hub eventi.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. Se non si ricevono eventi per 30 secondi, l'esecuzione del trigger viene ignorata.If no events are received in 30 seconds, the trigger run is skipped. In caso contrario, il trigger continua a leggere gli eventi finché l'hub eventi non è vuoto.Otherwise, the trigger continues reading events until your Event Hub is empty. Il polling successivo si baserà sull'intervallo di ricorrenza specificato nelle proprietà del trigger.The next trigger poll happens based on the recurrence interval that you specify in the trigger's properties.

Aggiungere un'azione per Hub eventiAdd an Event Hubs action

In App per la logica di Azure, un'azione è un passaggio del flusso di lavoro che segue un trigger o un'altra azione.In Azure Logic Apps, an action is a step in your workflow that follows a trigger or another action. In questo esempio, l'app per la logica inizia con un trigger per hub eventi che verifica la presenza di nuovi eventi nell'Hub eventi.For this example, the logic app starts with an Event Hubs trigger that checks for new events in your Event Hub.

  1. Nel portale di Azure o in Visual Studio aprire l'app per la logica in Progettazione app per la logica.In the Azure portal or Visual Studio, open your logic app in Logic Apps Designer. Questo esempio usa il portale di Azure.This example uses the Azure portal.

  2. Nel trigger o nell'azione, scegliere Nuovo passaggio > Aggiungi un'azione.Under the trigger or action, choose New step > Add an action.

    Per aggiungere un'azione tra due passaggi esistenti, posizionare il puntatore del mouse sulla freccia di connessione.To add an action between existing steps, move your mouse over the connecting arrow. Fare clic sul segno più (+) visualizzato e quindi scegliere Aggiungi un'azione.Choose the plus sign (+) that appears, and then choose Add an action.

  3. Nella casella di ricerca immettere "hub eventi" come filtro.In the search box, enter "event hubs" as your filter. Nell'elenco delle azioni scegliere l'azione desiderata.From the actions list, select the action you want.

    Nell'esempio, selezionare l'azione Hub eventi - Invia eventoFor this example, select this action: Event Hubs - Send event

    Selezionare "Hub eventi - Invia evento"

  4. Se vengono richiesti i dettagli della connessione, creare la connessione ad Hub eventi.If you're prompted for connection details, create your Event Hubs connection now. Se la connessione è già presente, fornire le informazioni necessarie per l'azione.Or, if your connection already exists, provide the necessary information for the action.

    ProprietàProperty ObbligatoriaRequired DESCRIZIONEDescription
    Nome dell'hub eventiEvent Hub name Yes Selezionare l'hub eventi a cui inviare l'eventoSelect the Event Hub where you want to send the event
    Contenuto dell'eventoEvent content No No Contenuto dell'evento da inviareThe content for the event you want to send
    PropertiesProperties No No Proprietà dell'app e valori da inviareThe app properties and values to send

    Ad esempio: For example:

    Selezionare il nome dell'hub eventi e specificare il contenuto dell'evento

  5. Al termine, nella barra degli strumenti della finestra di progettazione scegliere Salva.When you're done, on the designer toolbar, choose Save.

Connettersi all'hub eventiConnect to your Event Hub

Per consentire all'app per la logica di accedere a un servizio, è prima necessario creare una connessione tra l'app per la logica e il servizio.Before your logic app can access any service, you must create a connection between your logic app and that service. Se la connessione non è stata creata in precedenza, le informazioni sulla connessione vengono chieste quando si aggiunge un trigger o un'azione per tale servizio all'app per la logica.If you didn't previously create this connection, you're prompted for connection information when you add a trigger or action for that service to your logic app. Progettazione app per la logica consente di creare questa connessione in modo semplice direttamente dall'app per la logica.The Logic Apps Designer provides an easy way for you to create this connection directly from your logic app.

  1. Quando viene chiesto di immettere le informazioni di connessione, specificare questi dettagli:When you're prompted for connection information, provide these details:

    ProprietàProperty ObbligatoriaRequired ValoreValue DESCRIZIONEDescription
    Connection Name (Nome connessione)Connection Name Yes <nome connessione><connection-name> Nome creato per la connessioneThe name to create for your connection
    Spazio dei nomi di Hub eventiEvent Hubs Namespace Yes <spazio dei nomi di hub eventi><event-hubs-namespace> Selezionare lo spazio dei nomi di Hub eventi da usare.Select the Event Hubs namespace you want to use.

    Ad esempio: For example:

    Creare una connessione a Hub eventi

    Per immettere manualmente la stringa di connessione, scegliere Immettere manualmente le informazioni sulla connessione.To manually enter the connection string, choose Manually enter connection information. Leggere come trovare la stringa di connessione.Learn how to find your connection string.

  2. Se del caso, selezionare i criteri di Hub eventi da usare.Select the Event Hubs policy to use, if not already selected. Scegliere Create.Choose Create.

    Creare una connessione a Hub eventi, parte 2

  3. Dopo aver creato la connessione, continuare con Aggiungere un trigger per Hub eventi oppure Aggiungere un'azione per Hub eventi.After you create your connection, continue with Add Event Hubs trigger or Add Event Hubs action.

Informazioni di riferimento sui connettoriConnector reference

Per informazioni tecniche, ad esempio su trigger, azioni e limiti indicati nel file Swagger del connettore, vedere la pagina di riferimento del connettore.For technical details, such as triggers, actions, and limits, as described by the connector's Swagger file, see the connector's reference page.

SupportoGet support

Passaggi successiviNext steps