Monitorare lo stato, configurare la registrazione diagnostica e attivare gli avvisi per App per la logica di AzureMonitor status, set up diagnostics logging, and turn on alerts for Azure Logic Apps

Dopo avere creato ed eseguito un'app per la logica, è possibile controllarne la cronologia delle esecuzioni, la cronologia dei trigger, lo stato e le prestazioni.After you create and run a logic app, you can check its runs history, trigger history, status, and performance. Per il monitoraggio degli eventi in tempo reale e il debug avanzato, configurare la registrazione diagnostica per l'app per la logica.For real-time event monitoring and richer debugging, set up diagnostics logging for your logic app. In questo modo è possibile trovare e visualizzare gli eventi, ad esempio eventi di attivazione, eventi di esecuzione ed eventi di azione.That way, you can find and view events, like trigger events, run events, and action events. È anche possibile usare questi dati diagnostici con altri servizi, ad esempio Archiviazione di Azure e Hub eventi di Azure.You can also use this diagnostics data with other services, like Azure Storage and Azure Event Hubs.

Per ottenere notifiche sugli errori o su altri possibili problemi, configurare gli avvisi.To get notifications about failures or other possible problems, set up alerts. È ad esempio possibile creare un avviso che rileva "quando più di cinque esecuzioni in un'ora hanno esito negativo".For example, you can create an alert that detects "when more than five runs fail in an hour." È anche possibile configurare il monitoraggio, la verifica e la registrazione a livello di codice usando impostazioni e proprietà degli eventi di Diagnostica di Azure.You can also set up monitoring, tracking, and logging programmatically by using Azure Diagnostics event settings and properties.

Visualizzare la cronologia di esecuzioni e trigger per l'app per la logicaView runs and trigger history for your logic app

  1. Per trovare l'app per la logica nel portale di Azure scegliere Altri servizi dal menu principale di Azure.To find your logic app in the Azure portal, on the main Azure menu, choose More services. Nella casella di ricerca cercare "app per la logica" e scegliere App per la logica.In the search box, find "logic apps", and choose Logic apps.

    Trovare l'app per la logica

    Il portale di Azure visualizza tutte le app per la logica associate alla sottoscrizione di Azure.The Azure portal shows all the logic apps that are associated with your Azure subscription.

  2. Selezionare l'app per la logica, quindi scegliere Panoramica.Select your logic app, then choose Overview.

    Il portale di Azure visualizza la cronologia delle esecuzioni e la cronologia dei trigger per l'app per la logica,The Azure portal shows the runs history and trigger history for your logic app. ad esempio:For example:

    Cronologia delle esecuzioni e cronologia dei trigger delle app per la logica

    • Cronologia esecuzioni visualizza tutte le esecuzioni per l'app per la logica.Runs history shows all the runs for your logic app.
    • Cronologia trigger visualizza tutte le attività dei trigger per l'app per la logica.Trigger History shows all the trigger activity for your logic app.

    Per le descrizioni degli stati, vedere Risolvere i problemi relativi all'app per la logica.For status descriptions, see Troubleshoot your logic app.

    Suggerimento

    Se non si trovano i dati previsti, scegliere Aggiorna sulla barra degli strumenti.If you don't find the data that you expect, on the toolbar, choose Refresh.

  3. Per visualizzare i passaggi da una specifica esecuzione, selezionarla in Cronologia esecuzioni.To view the steps from a specific run, under Runs history, select that run.

    La vista di monitoraggio mostra ogni passaggio di tale esecuzione,The monitor view shows each step in that run. ad esempio:For example:

    Azioni per una specifica esecuzione

  4. Per ottenere altri dettagli sull'esecuzione, scegliere Dettagli esecuzione.To get more details about the run, choose Run Details. Queste informazioni riepilogano i passaggi, lo stato, gli input e gli output per l'esecuzione.This information summarizes the steps, status, inputs, and outputs for the run.

    Scegliere "Dettagli esecuzione"

    È ad esempio possibile ottenere l'ID di correlazione dell'esecuzione, che potrebbe essere necessario quando si usa l'API REST per App per la logica.For example, you can get the run's Correlation ID, which you might need when you use the REST API for Logic Apps.

  5. Per ottenere informazioni dettagliate su un passaggio specifico, scegliere il passaggio.To get details about a specific step, choose that step. È ora possibile esaminare dettagli come input, output ed eventuali errori verificatisi per tale passaggio,You can now review details like inputs, outputs, and any errors that happened for that step. ad esempio:For example:

    Dettagli del passaggio

    Nota

    Tutti i dettagli ed eventi di runtime vengono crittografati nel servizio App per la logica.All runtime details and events are encrypted within the Logic Apps service. Vengono decrittografati solo quando un utente richiede di visualizzare i dati.They are decrypted only when a user requests to view that data. È anche possibile controllare l'accesso a questi eventi con il controllo degli accessi in base al ruolo di Azure.You can also control access to these events with Azure Role-Based Access Control (RBAC).

  6. Per ottenere informazioni dettagliate su un evento di attivazione specifico, tornare al riquadro Panoramica.To get details about a specific trigger event, go back to the Overview pane. In Cronologia trigger selezionare l'evento di attivazione.Under Trigger history, select the trigger event. È ora possibile esaminare dettagli come input e output, ad esempio:You can now review details like inputs and outputs, for example:

    Dettagli dell'output dell'evento di attivazione

Attivare la registrazione diagnostica per l'app per la logicaTurn on diagnostics logging for your logic app

Per il debug avanzato con dettagli ed eventi di runtime, è possibile configurare la registrazione diagnostica con Azure Log Analytics.For richer debugging with runtime details and events, you can set up diagnostics logging with Azure Log Analytics. Log Analytics è un servizio di Operations Management Suite (OMS) che consente di monitorare gli ambienti cloud e locali per garantirne la disponibilità e le prestazioni.Log Analytics is a service in Operations Management Suite (OMS) that monitors your cloud and on-premises environments to help you maintain their availability and performance.

Prima di iniziare, è necessario avere un'area di lavoro di OMS.Before you start, you need to have an OMS workspace. Informazioni su come creare un'area di lavoro di OMS.Learn how to create an OMS workspace.

  1. Nel portale di Azure trovare e selezionare l'app per la logica.In the Azure portal, find and select your logic app.

  2. Nel menu del pannello dell'app per la logica, in Monitoraggio scegliere Diagnostica > Impostazioni di diagnostica.On the logic app blade menu, under Monitoring, choose Diagnostics > Diagnostic Settings.

    Andare a Monitoraggio, Diagnostica, Impostazioni di diagnostica

  3. In Impostazioni di diagnostica scegliere .Under Diagnostics settings, choose On.

    Attivare i log di diagnostica

  4. Selezionare ora l'area di lavoro di OMS e la categoria di eventi per la registrazione, come indicato:Now select the OMS workspace and event category for logging as shown:

    1. Selezionare Invia a Log Analytics.Select Send to Log Analytics.
    2. In Log Analytics scegliere Configura.Under Log Analytics, choose Configure.
    3. In Aree di lavoro OMS selezionare l'area di lavoro di OMS da usare per la registrazione.Under OMS Workspaces, select the OMS workspace to use for logging.
    4. In Log selezionare la categoria WorkflowRuntime.Under Log, select the WorkflowRuntime category.
    5. Scegliere l'intervallo di metrica.Choose the metric interval.
    6. Al termine dell'operazione, scegliere Salva.When you're done, choose Save.

    Selezionare l'area di lavoro di OMS e i dati per la registrazione

È ora possibile trovare eventi e altri dati per eventi di attivazione, eventi di esecuzione ed eventi di azione.Now, you can find events and other data for trigger events, run events, and action events.

Trovare eventi e dati per l'app per la logicaFind events and data for your logic app

Per trovare e visualizzare gli eventi nell'app per la logica, ad esempio eventi di attivazione, eventi di esecuzione ed eventi di azione, seguire questa procedura.To find and view events in your logic app, like trigger events, run events, and action events, follow these steps.

  1. Nel portale di Azure scegliere Altri servizi.In the Azure portal, choose More Services. Cercare "Log Analytics", quindi scegliere Log Analytics, come illustrato qui:Search for "log analytics", then choose Log Analytics as shown here:

    Scegliere "Log Analytics"

  2. In Log Analytics trovare e selezionare l'area di lavoro di OMS.Under Log Analytics, find and select your OMS workspace.

    Selezionare l'area di lavoro di OMS

  3. In Gestione scegliere Portale di OMS.Under Management, choose OMS Portal.

    Scegliere "Portale di OMS"

  4. Nella home page di OMS scegliere Ricerca log.On your OMS home page, choose Log Search.

    Nella home page di OMS scegliere "Ricerca log"

    -oppure--or-

    Dal menu di OMS scegliere "Ricerca log"

  5. Nella casella di ricerca specificare un campo che si vuole trovare e premere INVIO.In the search box, specify a field that you want to find, and press Enter. Quando si inizia a digitare, OMS visualizza le possibili corrispondenze e operazioni che è possibile usare.When you start typing, OMS shows you possible matches and operations that you can use.

    Per trovare, ad esempio, i primi 10 eventi che si sono verificati, immettere e selezionare questa query di ricerca: Category=WorkflowRuntime |top 10For example, to find the top 10 events that happened, enter and select this search query: Category=WorkflowRuntime |top 10

    Immettere la stringa di ricerca

    Altre informazioni su come trovare i dati in Log Analytics.Learn more about how to find data in Log Analytics.

  6. Nella barra a sinistra della pagina dei risultati scegliere l'intervallo di tempo che si vuole visualizzare.On the results page, in the left bar, choose the timeframe that you want to view. Per affinare la query aggiungendo un filtro, scegliere +Aggiungi.To refine your query by adding a filter, choose +Add.

    Scegliere l'intervallo di tempo per i risultati della query

  7. In Aggiungi filtri immettere il nome del filtro per trovare quello desiderato.Under Add Filters, enter the filter name so you can find the filter you want. Selezionare il filtro e scegliere +Aggiungi.Select the filter, and choose +Add.

    L'esempio usa la parola "status" per trovare gli eventi non riusciti in AzureDiagnostics.This example uses the word "status" to find failed events under AzureDiagnostics. Qui il filtro per status_s è già selezionato.Here the filter for status_s is already selected.

    Selezionare il filtro

  8. Nella barra a sinistra selezionare il valore del filtro che si vuole usare e scegliere Applica.In the left bar, select the filter value that you want to use, and choose Apply.

    Selezionare il valore del filtro, scegliere "Applica"

  9. Tornare ora alla query che si sta creando.Now return to the query that you're building. La query viene aggiornata con il filtro e il valore selezionati.Your query is updated with your selected filter and value. Vengono ora filtrati anche i risultati precedenti.Your previous results are now filtered too.

    Tornare alla query con i risultati filtrati

  10. Per salvare la query per un uso futuro, scegliere Salva.To save your query for future use, choose Save. Informazioni su come salvare la query.Learn how to save your query.

Estendere l'uso dei dati di diagnostica con altri serviziExtend how and where you use diagnostic data with other services

Con Azure Log Analytics, è possibile usare in modo diverso i dati di diagnostica dell'app per la logica con altri servizi di Azure, ad esempio:Along with Azure Log Analytics, you can extend how you use your logic app's diagnostic data with other Azure services, for example:

È quindi possibile eseguire il monitoraggio in tempo reale usando i dati di telemetria e l'analisi da altri servizi, ad esempio Analisi di flusso di Azure e Power BI,You can then get real-time monitoring by using telemetry and analytics from other services, like Azure Stream Analytics and Power BI. ad esempio:For example:

In base alle opzioni che si vuole configurare, assicurarsi prima di tutto di creare un account di archiviazione di Azure o di creare un hub eventi di Azure.Based on the options that you want set up, make sure that you first create an Azure storage account or create an Azure event hub. Selezionare quindi le opzioni per la posizione a cui si vogliono inviare i dati di diagnostica:Then select the options for where you want to send diagnostic data:

Inviare i dati all'hub di eventi o all'account di archiviazione di Azure

Nota

I periodi di conservazione si applicano solo quando si sceglie di usare un account di archiviazione.Retention periods apply only when you choose to use a storage account.

Configurare gli avvisi per l'app per la logicaSet up alerts for your logic app

Per monitorare metriche specifiche o le soglie superate per l'app per la logica, configurare gli avvisi in Azure.To monitor specific metrics or exceeded thresholds for your logic app, set up alerts in Azure. Informazioni sulle metriche in Azure.Learn about metrics in Azure.

Per configurare gli avvisi senza Azure Log Analytics, seguire questa procedura.To set up alerts without Azure Log Analytics, follow these steps. Per azioni e criteri di avviso più avanzati, configurare anche Log Analytics.For more advanced alerts criteria and actions, set up Log Analytics too.

  1. Nel menu del pannello dell'app per la logica, in Monitoraggio scegliere Diagnostica > Regole di avviso > Aggiungi avviso, come illustrato qui:On the logic app blade menu, under Monitoring, choose Diagnostics > Alert rules > Add alert as shown here:

    Aggiungere un avviso per l'app per la logica

  2. Nel pannello Aggiungi una regola di avviso creare l'avviso come indicato:On the Add an alert rule blade, create your alert as shown:

    1. In Risorsa selezionare l'app per la logica, se non è già selezionata.Under Resource, select your logic app, if not already selected.
    2. Specificare un nome e una descrizione per l'avviso.Give a name and description for your alert.
    3. Selezionare una metrica o un evento di cui si vuole tenere traccia.Select a Metric or event that you want to track.
    4. Selezionare una condizione, specificare una soglia per la metrica e selezionare il periodo per il monitoraggio di questa metrica.Select a Condition, specify a Threshold for the metric, and select the Period for monitoring this metric.
    5. Scegliere se inviare posta per l'avviso.Select whether to send mail for the alert.
    6. Specificare eventuali altri indirizzi di posta elettronica a cui inviare l'avviso.Specify any other email addresses for sending the alert. È anche possibile specificare l'URL di un webhook a cui si vuole inviare l'avviso.You can also specify a webhook URL where you want to send the alert.

    Questa regola, ad esempio, invia un avviso quando cinque o più esecuzioni in un'ora hanno esito negativo:For example, this rule sends an alert when five or more runs fail in an hour:

    Creare una regola di avviso per la metrica

Suggerimento

Per eseguire un'app per la logica da un avviso, è possibile includere il trigger della richiesta nel flusso di lavoro, che consente di eseguire attività come le seguenti:To run a logic app from an alert, you can include the request trigger in your workflow, which lets you perform tasks like these examples:

Impostazioni e dettagli degli eventi di Diagnostica di AzureAzure Diagnostics event settings and details

Ogni evento di diagnostica ha dettagli sull'app per la logica e sull'evento stesso, ad esempio lo stato, l'ora di inizio, l'ora di fine e così via.Each diagnostic event has details about your logic app and that event, for example, the status, start time, end time, and so on. Per configurare a livello di codice il monitoraggio, la verifica e la registrazione, è possibile usare questi dettagli con l'API REST per App per la logica di Azure e l'API REST per Diagnostica di Azure.To programmatically set up monitoring, tracking, and logging, ou can use these details with the REST API for Azure Logic Apps and the REST API for Azure Diagnostics.

L'evento ActionCompleted, ad esempio, ha le proprietà clientTrackingId e trackedProperties che è possibile usare per la verifica e il monitoraggio:For example, the ActionCompleted event has the clientTrackingId and trackedProperties properties that you can use for tracking and monitoring:

{
    "time": "2016-07-09T17:09:54.4773148Z",
    "workflowId": "/SUBSCRIPTIONS/<subscription-ID>/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.LOGIC/WORKFLOWS/MYLOGICAPP",
    "resourceId": "/SUBSCRIPTIONS/<subscription-ID>/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.LOGIC/WORKFLOWS/MYLOGICAPP/RUNS/08587361146922712057/ACTIONS/HTTP",
    "category": "WorkflowRuntime",
    "level": "Information",
    "operationName": "Microsoft.Logic/workflows/workflowActionCompleted",
    "properties": {
        "$schema": "2016-06-01",
        "startTime": "2016-07-09T17:09:53.4336305Z",
        "endTime": "2016-07-09T17:09:53.5430281Z",
        "status": "Succeeded",
        "code": "OK",
        "resource": {
            "subscriptionId": "<subscription-ID>",
            "resourceGroupName": "MyResourceGroup",
            "workflowId": "cff00d5458f944d5a766f2f9ad142553",
            "workflowName": "MyLogicApp",
            "runId": "08587361146922712057",
            "location": "westus",
            "actionName": "Http"
        },
        "correlation": {
            "actionTrackingId": "e1931543-906d-4d1d-baed-dee72ddf1047",
            "clientTrackingId": "<my-custom-tracking-ID>"
        },
        "trackedProperties": {
            "myTrackedProperty": "<value>"
        }
    }
}
  • clientTrackingId: se non specificata, Azure genera automaticamente questo ID e correla gli eventi in un'esecuzione dell'app per la logica, inclusi eventuali flussi di lavoro annidati chiamati dall'app per la logica.clientTrackingId: If not provided, Azure automatically generates this ID and correlates events across a logic app run, including any nested workflows that are called from the logic app. È possibile specificare manualmente questo ID da un trigger passando un'intestazione x-ms-client-tracking-id con il valore dell'ID personalizzato nella richiesta del trigger.You can manually specify this ID from a trigger by passing a x-ms-client-tracking-id header with your custom ID value in the trigger request. È possibile usare un trigger di richiesta, un trigger HTTP o un trigger webhook.You can use a request trigger, HTTP trigger, or webhook trigger.

  • trackedProperties: per tenere traccia degli input o degli output nei dati di diagnostica, è possibile aggiungere le proprietà rilevate alle azioni nella definizione JSON dell'app per la logica.trackedProperties: To track inputs or outputs in diagnostics data, you can add tracked properties to actions in your logic app's JSON definition. Le proprietà rilevate possono tenere traccia solo di singoli input e output di azioni, ma è possibile usare le proprietà correlation degli eventi per correlare più azioni in un'esecuzione.Tracked properties can track only a single action's inputs and outputs, but you can use the correlation properties of events to correlate across actions in a run.

    Per tenere traccia di una o più proprietà, aggiungere la sezione trackedProperties e le proprietà desiderate alla definizione dell'azione.To track one or more properties, add the trackedProperties section and the properties you want to the action definition. Si supponga, ad esempio, di voler tenere traccia di dati come un "ID ordine" nella telemetria:For example, suppose you want to track data like an "order ID" in your telemetry:

    "myAction": {
      "type": "http",
      "inputs": {
          "uri": "http://uri",
          "headers": {
              "Content-Type": "application/json"
          },
          "body": "@triggerBody()"
      },
      "trackedProperties": {
          "myActionHTTPStatusCode": "@action()['outputs']['statusCode']",
          "myActionHTTPValue": "@action()['outputs']['body']['<content>']",
          "transactionId": "@action()['inputs']['body']['<content>']"
      }
    }
    

Passaggi successiviNext steps