Condividi tramite


Controllare lo stato del flusso di lavoro, visualizzare la cronologia di esecuzione e configurare gli avvisi in Azure Logic Apps

Si applica a: Azure Logic Apps (Consumo + Standard)

Dopo aver eseguito un flusso di lavoro dell'app per la logica, è possibile controllare lo stato di esecuzione del flusso di lavoro, la cronologia dei trigger, la cronologia di esecuzione del flusso di lavoro e le prestazioni.

Questa guida illustra come eseguire le attività seguenti:

Per il monitoraggio degli eventi in tempo reale e il debug più completo, è possibile configurare la registrazione diagnostica per il flusso di lavoro dell'app per la logica usando Azure Monitor logs. Questo servizio Azure consente di monitorare gli ambienti cloud e locali in modo che sia possibile mantenere più facilmente la disponibilità e le prestazioni. È quindi possibile trovare e visualizzare eventi, ad esempio eventi di attivazione, eventi di esecuzione ed eventi di azione. Archiviando queste informazioni nei log Azure Monitor è possibile creare query log che consentono di trovare e analizzare queste informazioni. È anche possibile usare questi dati di diagnostica con altri servizi di Azure, ad esempio Azure Storage e Azure Event Hubs. Per ulteriori informazioni, consultare Monitorare le app logiche utilizzando Azure Monitor.

Esaminare la cronologia dei trigger

Ogni esecuzione del flusso di lavoro inizia con un trigger, che viene attivato in base a una pianificazione o attende una richiesta o un evento in ingresso. La cronologia dei trigger elenca tutti i tentativi di trigger effettuati dal flusso di lavoro e le informazioni sugli input e sugli output per ogni tentativo di trigger.

  1. Nel portale di Azure, apri la risorsa e il flusso di lavoro dell'app per la logica di consumo nella finestra di progettazione.

  2. Selezionare Panoramica dal menu dell'app per la logica. Nella pagina Panoramica selezionare Cronologia trigger.

    Screenshot mostra Azure Portal, flusso di lavoro Consumo e pagina Panoramica con la scheda selezionata denominata Cronologia Trigger.

    In Cronologia trigger vengono visualizzati tutti i tentativi di trigger. Ogni volta che il trigger viene attivato correttamente, Azure Logic Apps crea una singola istanza del flusso di lavoro ed esegue tale istanza. Per impostazione predefinita, ogni istanza viene eseguita in parallelo, in modo che nessun flusso di lavoro debba attendere prima di avviare un'esecuzione. Se il flusso di lavoro si attiva per più eventi o elementi contemporaneamente, viene visualizzata una voce di trigger per ogni elemento con la stessa data e ora.

    Screenshot che mostra la pagina Panoramica con il flusso di lavoro a consumo e più tentativi di trigger per elementi diversi.

    La tabella seguente elenca i possibili stati del trigger:

    Stato del trigger Descrizione
    Non riuscito Si è verificato un errore. Per esaminare i messaggi di errore generati per un trigger non riuscito, selezionare il tentativo di trigger e scegliere Output. Ad esempio, si potrebbero trovare input che non sono validi.
    Ignorato Il trigger ha controllato l'endpoint ma non ha trovato dati che soddisfano i criteri specificati.
    Riuscito Il trigger ha controllato l'endpoint e ha trovato dati disponibili. In genere compare anche lo stato Attivato accanto a questo stato. In caso contrario, la definizione del trigger potrebbe avere una condizione non soddisfatta o la splitOn proprietà impostata su un valore.

    Questo stato può essere associato a un trigger manuale, un trigger basato su ricorrenza o un trigger di polling. Un trigger può essere eseguito correttamente, ma l'esecuzione stessa potrebbe comunque non riuscire quando le azioni generano errori non gestiti.

    Suggerimento

    È possibile ricontrollare il trigger senza attendere la successiva ricorrenza. Sulla barra degli strumenti della pagina Panoramica o sulla barra degli strumenti della finestra di progettazione selezionare Esegui, Esegui.

  3. Per visualizzare informazioni su un tentativo di trigger specifico, seleziona l'evento di trigger.

    Screenshot che mostra la Cronologia trigger del flusso di lavoro a consumo e la voce selezionata.

    Se l'elenco mostra molti tentativi di trigger e non si trova la voce desiderata, provare a filtrare l'elenco. Se non si trovano i dati previsti, provare a selezionare Aggiorna sulla barra degli strumenti.

    Ora è possibile esaminare le informazioni sull'evento trigger selezionato, ad esempio:

    Screenshot che mostra le informazioni sulla Cronologia trigger del flusso di lavoro a consumo selezionato.

Esaminare la cronologia di esecuzione del flusso di lavoro

Ogni volta che un trigger viene attivato correttamente, Azure Logic Apps crea un'istanza del flusso di lavoro ed esegue tale istanza. Per impostazione predefinita, ogni istanza viene eseguita in parallelo, in modo che nessun flusso di lavoro debba attendere prima di avviare un'esecuzione. È possibile esaminare ciò che è successo durante ogni esecuzione, inclusi lo stato, gli input e gli output per ogni passaggio del flusso di lavoro.

  1. Nel portale di Azure, apri la risorsa e il flusso di lavoro dell'app per la logica di consumo nella finestra di progettazione.

  2. Selezionare Panoramica dal menu dell'app per la logica. Nella pagina Panoramica selezionare Cronologia esecuzioni.

    In Cronologia esecuzioni vengono visualizzate tutte le esecuzioni passate, attuali e quelle in attesa. Se il trigger viene attivato per più eventi o elementi contemporaneamente, viene visualizzata una voce per ogni elemento con la stessa data e ora.

    Suggerimento

    Se lo stato dell'esecuzione non viene visualizzato, provare ad aggiornare la pagina Panoramica selezionando Aggiorna. Non si verifica alcuna esecuzione per un trigger ignorato a causa di criteri non soddisfatti o di mancanza di dati.

    Screenshot che mostra il flusso di lavoro a consumo e la pagina Panoramica con la scheda selezionata denominata Cronologia esecuzioni.

    La tabella seguente elenca i possibili stati di esecuzione:

    Stato di esecuzione Descrizione
    interrotto L'esecuzione è stata arrestata o non è stata completata a causa di problemi esterni, ad esempio un'interruzione di sistema o una sottoscrizione Azure scaduta.
    Operazione annullata L'esecuzione è stata attivata e avviata, ma ha ricevuto una richiesta di annullamento.
    Non riuscito Almeno un'azione nell'esecuzione non è riuscita. Nessuna azione successiva nel flusso di lavoro è stata configurata per gestire l'errore.
    In esecuzione L'esecuzione è stata attivata ed è in corso. Tuttavia, questo stato può essere visualizzato anche per un'esecuzione soggetta a restrizioni a causa dei limiti di azione o del piano tariffario attuale.

    Suggerimento: se si configura la registrazione diagnostica, è possibile ottenere informazioni su tutti gli eventi di limitazione che si verificano.
    Riuscito Esecuzione completata. Se un'azione non è riuscita, un'azione successiva nel flusso di lavoro ha gestito tale errore.
    Tempo scaduto L'esecuzione è scaduta perché la durata corrente ha superato il limite di durata dell'esecuzione, controllato dall'impostazione chiamata Conservazione cronologia di esecuzione in giorni. La durata dell'esecuzione viene calcolata usando l'ora di inizio dell'esecuzione e il limite di durata dell'esecuzione all'ora di inizio.

    Nota: se la durata dell'esecuzione supera anche il limite di conservazione della cronologia di esecuzione corrente, controllato anche dall'impostazione Conservazione cronologia di esecuzione in giorni, l'esecuzione viene cancellata dalla cronologia di esecuzione da un processo di pulizia giornaliero. Indipendentemente dal timeout o dal completamento dell'esecuzione, il periodo di conservazione viene sempre calcolato usando l'ora di inizio dell'esecuzione e limite di conservazione corrente. Quindi, se si riduce il limite di durata per un'esecuzione in corso, si verifica il timeout. Tuttavia, l'esecuzione rimane o viene cancellata dalla cronologia di esecuzione a seconda se la durata dell'esecuzione supera il limite di conservazione o meno.
    In attesa L'esecuzione non è ancora stata avviata o è sospesa, ad esempio a causa di un'istanza del flusso di lavoro precedente ancora in esecuzione.
  3. Per esaminare i passaggi e altre informazioni di un'esecuzione specifica, selezionare tale esecuzione in Cronologia esecuzioni. Se l'elenco mostra molte esecuzioni e non si trova la voce che si desidera, provare a filtrare l'elenco.

    Screenshot che mostra un flusso di lavoro a consumo selezionato.

    Viene aperta la pagina della cronologia di esecuzione e viene visualizzato lo stato per ogni passaggio dell'esecuzione selezionata, ad esempio:

    Screenshot che mostra la cronologia di esecuzione del flusso di lavoro a consumo con ogni azione nell'esecuzione.

    La tabella seguente illustra i possibili stati che ogni azione del flusso di lavoro può avere e visualizzare nel portale:

    Stato dell'azione Icona Descrizione
    interrotto Icona di interruzione L'azione è stata arrestata o non è stata completata a causa di problemi esterni, ad esempio, un'interruzione del sistema o una sottoscrizione Azure scaduta.
    Operazione annullata Icona annullata L'azione era in esecuzione ma ha ricevuto una richiesta di annullamento.
    Non riuscito Icona non riuscita L'azione non è riuscita.
    In esecuzione Icona in esecuzione L'azione è attualmente in esecuzione.
    Ignorato Icona ignorata L'azione è stata ignorata perché le condizioni runAfter non sono state soddisfatte, ad esempio un'azione precedente non è riuscita. Ogni azione ha un oggetto runAfter in cui è possibile configurare condizioni che devono essere soddisfatte prima che l'azione corrente possa essere eseguita.
    Riuscito Icona riuscita L'azione è riuscita.
    Operazione riuscita in più tentativi Succeeded-with-retries-icon L'azione ha avuto esito positivo ma solo dopo un singolo tentativo o più tentativi. Per esaminare la cronologia dei tentativi, nella pagina cronologia di esecuzione selezionare l'azione in modo che sia possibile visualizzare gli input e gli output.
    Tempo scaduto Icona di esaurimento del tempo L'azione è stata arrestata a causa del limite di timeout specificato dalle impostazioni dell'azione.
    In attesa Icona in attesa Si applica a un'azione webhook in attesa di una richiesta in ingresso da un chiamante.
  4. Per visualizzare le informazioni in formato elenco, nella barra degli strumenti della cronologia delle esecuzioni, selezionare Dettagli esecuzione.

    Il riquadro Dettagli dell'esecuzione dell'applicazione logica elenca ogni passaggio, il relativo stato e altre informazioni.

    Screenshot che mostra i dettagli dell'esecuzione per ogni passaggio nel flusso di lavoro a consumo.

    È ad esempio possibile ottenere la proprietà ID di correlazione dell'esecuzione, che potrebbe essere necessario quando si usa l'API REST per App per la logica.

  5. Per ottenere altre informazioni su un passaggio specifico, selezionare una delle opzioni seguenti:

    • Nella pagina cronologia di esecuzione selezionare un passaggio per aprire un riquadro che mostra gli input, gli output e gli eventuali errori che si sono verificati in tale passaggio.

      Si supponga, ad esempio, di avere un flusso di lavoro con un passaggio non riuscito. Si vogliono esaminare gli input che potrebbero aver causato l'esito negativo del passaggio.

      In questo scenario, l'errore è dovuto a una connessione non valida o mancante a un account di posta elettronica usato per inviare un messaggio di posta elettronica.

      Screenshot che mostra la pagina Cronologia di esecuzione del flusso di lavoro a consumo, con il passaggio di esempio non riuscito selezionato, oltre a input, output ed errori relativi al passaggio non riuscito.

    • Nella barra degli strumenti della pagina Cronologia di esecuzione selezionare Dettagli esecuzione. Nel riquadro Dettagli esecuzione dell'app per la logica visualizzato, selezionare il passaggio che si desidera, ad esempio:

      Screenshot che mostra il flusso di lavoro a consumo e il riquadro denominato Dettagli esecuzione dell'app per la logica. Il riquadro mostra il passaggio selezionato di esempio non riuscito.

    Nota

    Tutti i dettagli e gli eventi di runtime vengono crittografati all'interno di Azure Logic Apps e vengono decrittografati solo quando un utente richiede di visualizzare tali dati. È possibile nascondere gli input e gli output nella cronologia delle esecuzioni del flusso di lavoro o controllare l'accesso utente utilizzando il controllo degli accessi basato sui ruoli di Azure (Azure RBAC).

Rieseguire un flusso di lavoro con gli stessi input

È possibile rieseguire un flusso di lavoro completato in precedenza con gli stessi input usati in precedenza nel modo seguente:

  • Rieseguire l'intero flusso di lavoro.

  • Rieseguire il flusso di lavoro a partire da un'azione specifica. L'azione di reinvio e tutte le azioni successive vengono eseguite come di consueto.

Il completamento di questa attività crea e aggiunge una nuova esecuzione del flusso di lavoro alla cronologia di esecuzione del flusso di lavoro.

Limitazioni e considerazioni

  • Per impostazione predefinita, sono supportati solo i flussi di lavoro A consumo e i flussi di lavoro con stato Standard che registrano e archiviano la cronologia di esecuzione. Per usare queste funzionalità con un flusso di lavoro Standard senza stato, abilitare la modalità con stato. Per altre informazioni, vedere Abilita la cronologia delle esecuzioni per i workflow senza stato e Abilita la modalità con stato per i connettori senza stato.

  • L'esecuzione nuovamente inviata esegue la stessa versione del flusso di lavoro dell'esecuzione originale, anche se è stata aggiornata la definizione del flusso di lavoro.

  • È possibile rieseguire solo azioni da flussi di lavoro sequenziali. I flussi di lavoro con percorsi paralleli non sono attualmente supportati.

  • Il flusso di lavoro deve avere uno stato completato, ad esempio Riuscito, Non riuscito o Annullato.

  • Il flusso di lavoro deve contenere 40 azioni o meno per poter essere rieseguito a partire da un'azione specifica.

  • Se il flusso di lavoro dispone di operazioni come le operazioni di creazione o eliminazione, un nuovo reinvio di un'esecuzione potrebbe creare dati duplicati o dare luogo a un tentativo di eliminazione di dati che non esistono più, generando un errore.

  • Queste funzionalità non sono attualmente disponibili con codice Visual Studio o Azure CLI.

Rieseguire l'intero flusso di lavoro

  1. Nel portale di Azure, apri la risorsa e il flusso di lavoro dell'app per la logica di consumo nella finestra di progettazione.

  2. Selezionare Panoramica dal menu dell'app per la logica. Nella pagina Panoramica selezionare Cronologia esecuzioni.

    In Cronologia esecuzioni vengono visualizzate tutte le esecuzioni passate, attuali e quelle in attesa. Se il trigger viene attivato per più eventi o elementi contemporaneamente, viene visualizzata una voce per ogni elemento con la stessa data e ora.

  3. Nella pagina Cronologia esecuzioni, selezionare l'esecuzione che si vuole rieseguire e quindi selezionare Invia nuovamente.

    La scheda Cronologia esecuzioni aggiunge l'esecuzione ripresentata all'elenco delle esecuzioni.

    Suggerimento

    Se l'esecuzione riesemessa non viene visualizzata, nella barra degli strumenti della pagina Cronologia esecuzioni selezionare Aggiorna. Non si verifica alcuna esecuzione per un trigger ignorato a causa di criteri non soddisfatti o di mancanza di dati.

  4. Per esaminare gli input e gli output dopo il termine dell'esecuzione rinviata, nella scheda Cronologia esecuzioni selezionare quell'esecuzione.

Rieseguire a partire da un'azione specifica

La funzionalità di riesecuzione dell'azione è disponibile per la maggior parte delle azioni, ad eccezione dei flussi di lavoro non sequenziali, degli scenari di concorrenza complessi e delle limitazioni seguenti:

Azioni Inviare di nuovo la disponibilità e le limitazioni
Azione di condizione e azioni nei percorsi True e False - Sì per l'azione di Condizione
- No per le azioni nei percorsi True e False
Per ogni azione, più tutte le azioni all'interno del ciclo e dopo il ciclo Non per tutte le azioni
Azione di Cambio e tutte le azioni nel percorsoDefault e nei percorsi Case - Sì per l'azione Cambia
- No per le azioni nel percorso predefinito e nei percorsi case
azione Until più tutte le azioni all'interno del loop e dopo il loop Non per tutte le azioni
  1. Nel portale di Azure, apri la risorsa dell'app per la logica Consumption.

  2. Nel menu risorsa app logica, selezionare Panoramica. Nella pagina Panoramica selezionare Cronologia esecuzioni, nella quale viene mostrata la cronologia di esecuzione per il flusso di lavoro.

  3. Nella scheda Cronologia esecuzioni, selezionare l'elemento che contiene l'azione da cui si desidera rieseguire il flusso di lavoro.

    Viene visualizzata la pagina della cronologia di esecuzione che mostra lo stato per ogni passaggio dell'esecuzione selezionata.

  4. Per rieseguire il flusso di lavoro a partire da un'azione specifica, scegliere una delle opzioni seguenti:

    • Trovare l'azione da cui iniziare a eseguire nuovamente il flusso di lavoro, aprire il menu di scelta rapida e selezionare Invia da questa azione.

    • Selezionare l'azione da cui avviare la riesecuzione del flusso di lavoro. Nel riquadro visualizzato, sotto il nome dell'azione, selezionare Invia da questa azione.

    La pagina della cronologia di esecuzione viene aggiornata e mostra l'esecuzione nuovamente inviata. Tutte le operazioni che precedono l'azione di reinvio mostrano un'icona di stato di colore più chiaro che rappresenta input e output riutilizzati. L'azione nuovamente inviata e le azioni successive mostrano le icone di stato colorate. Per altre informazioni, vedere Esaminare la cronologia di esecuzione del flusso di lavoro.

    Suggerimento

    Se l'esecuzione reinviata non viene completata completamente, nella barra degli strumenti della pagina dei dettagli esecuzione selezionare Aggiorna.

Configurare gli avvisi relativi al monitoraggio

Per ottenere avvisi in base a metriche specifiche o soglie superate nel tuo flusso di lavoro, configura la risorsa di app di logica con alerts in Azure Monitor. Per altre informazioni, vedere Metrics in Azure.

Per configurare gli avvisi senza usare Azure Monitoraggio, seguire questa procedura, che si applicano alle risorse dell'app per la logica a consumo e standard:

  1. Nel menu delle risorse dell'app per la logica, in Monitoraggio selezionare Avvisi. Nella barra degli strumenti selezionare Crea>Regola di avviso.

  2. Nella pagina Crea una regola di avviso selezionare il segnale per il quale si vuole ricevere un avviso dall'elenco Nome segnale.

    Nota

    I segnali di avviso differiscono tra app per la logica a consumo e Standard. Ad esempio, le app per la logica a consumo hanno molti segnali correlati al trigger, ad esempio trigger completati e trigger non riusciti, mentre i flussi di lavoro standard hanno i segnali numero di trigger completati del flusso di lavoro e frequenza di errore dei trigger del flusso di lavoro.

    Ad esempio, per inviare un avviso quando un trigger non riesce in un flusso di lavoro a consumo, seguire i seguenti passaggi:

    1. Nell'elenco Nome segnale selezionare il segnale Trigger non riusciti.

    2. In Logica di avviso configurare la condizione, ad esempio:

      Proprietà Valore di esempio
      Threshold Static
      Tipo di aggregazione Conteggio
      Operatore Maggiore o uguale a
      Unità Conteggio
      Valore di soglia 1

      La sezione Anteprima mostra ora la condizione configurata, ad esempio:

      Ogni volta che il numero di trigger non riusciti è maggiore o uguale a 1

    3. Alla voce Quando valutare, impostare il programma per verificare la condizione:

      Proprietà Valore di esempio
      Controllo ogni 1 minuto
      Periodo di retrospettiva 5 minuti

      Ad esempio la condizione completata è simile all'esempio seguente e la pagina Crea una regola di avviso mostra ora il costo per l'esecuzione dell'avviso:

      Screenshot che mostra la risorsa dell'app per la logica a consumo con condizione di avviso.

  3. Quando sei pronto, selezionare Rivedi e crea.

Per informazioni generali, vedere Creare una regola di alert da una risorsa specifica - Azure Monitor.

Risoluzione dei problemi

I log esportati sono mancanti o eliminati

Se i log esportati tramite le impostazioni di diagnostica sono mancanti o eliminati, controllare se il nome per il trigger, l'azione o l'esecuzione del flusso di lavoro contiene caratteri Unicode, che non sono consentiti.