> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arya.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Cronologia esecuzioni

> Log dettagliato di ogni run, debug, ritenta, esporta.

Ogni esecuzione di un workflow è tracciata in **Cronologia esecuzioni**. Qui debuggiamo problemi, vediamo performance, ritentiamo falliti.

<Frame>
  <img src="https://mintcdn.com/agevole/BUuJGD62nuns4mJL/images/automazioni/it/run-history.svg?fit=max&auto=format&n=BUuJGD62nuns4mJL&q=85&s=af3f283536371601487e431ab1cc0719" alt="Tabella cronologia con timestamp, stato, durata di ogni run" width="1200" height="720" data-path="images/automazioni/it/run-history.svg" />
</Frame>

## Dove si trova

**Automazioni → \[seleziona workflow] → tab Cronologia**.

## Colonne della tabella

| Colonna         | Contenuto                              |
| --------------- | -------------------------------------- |
| Data/ora        | Timestamp avvio esecuzione             |
| Trigger         | Record o evento che ha attivato        |
| Stato           | Success / Failed / Cancelled / Running |
| Durata          | Tempo totale di esecuzione             |
| Azioni eseguite | X su Y totali (se fallito a metà)      |
| Utente          | Chi ha lanciato (per trigger manuali)  |

## Filtri

* **Stato**: solo success, solo failed, ecc.
* **Periodo**: oggi, settimana, mese, range custom
* **Trigger**: per record specifico o tipo evento

## Dettaglio di una run

Click su una riga apre il dettaglio:

<AccordionGroup>
  <Accordion title="Timeline azioni">
    Elenco cronologico di ogni azione eseguita, con durata e output.
  </Accordion>

  <Accordion title="Input/output per azione">
    Espandi ogni azione per vedere: input ricevuto (da trigger o azione precedente), parametri compilati, output generato.

    Utile per debug: capisci quale azione riceve dati sbagliati.
  </Accordion>

  <Accordion title="Variabili risolte">
    Vedi come sono state risolte `{{variabili}}` al momento dell'esecuzione (valori effettivi).
  </Accordion>

  <Accordion title="Error stack trace">
    Se una run è fallita, Arya mostra:

    * Azione che ha fallito
    * Tipo di errore (timeout, API error, validation)
    * Stack trace dettagliato
    * Suggerimento di risoluzione
  </Accordion>
</AccordionGroup>

## Ritenta esecuzione

Per run fallite:

<Steps>
  <Step title="Apri dettaglio run">Click sulla riga failed.</Step>

  <Step title="Ritenta">
    Click **Ritenta**. Opzioni:

    * **Intero workflow**: rierun da zero
    * **Da azione X**: riparti dall'azione fallita (utile se le azioni precedenti hanno già fatto effetto reale)
  </Step>

  <Step title="Monitora">Nuova run compare in cronologia. Se ancora fallisce, Arya ti avvisa.</Step>
</Steps>

## Cancella esecuzione

Per run in **Running** ma bloccate (es. aspettando webhook che non arriva):

**⋯ → Cancella** → interrompe la run e libera risorse.

## Metriche aggregate

Tab **Metriche** del workflow mostra statistiche:

<CardGroup cols={2}>
  <Card title="Volume">Run al giorno/settimana/mese.</Card>
  <Card title="Success rate">% di successi su totale.</Card>
  <Card title="Durata media">Tempo di esecuzione tipico.</Card>
  <Card title="Errori top">Tipi di errori più frequenti (per debug priorità).</Card>
</CardGroup>

## Alert su failure rate

Configura da impostazioni workflow:

* Se failure rate > X% negli ultimi N run → notifica admin
* Se tempo di esecuzione medio aumenta del Y% → notifica
* Se 0 esecuzioni in un periodo atteso → "workflow silente" alert

## Esportazione log

Per audit o analisi offline:

* **Esporta CSV**: tabella run con metadati
* **Esporta JSON**: log dettagliato con input/output (dati sensibili mascherati secondo policy)

Retention log:

* 30 giorni su piani Standard
* 180 giorni su Premium
* Illimitata (archiviazione) su Enterprise

## Domande frequenti

<AccordionGroup>
  <Accordion title="I log includono dati sensibili come password?">No. Arya maschera automaticamente campi riconosciuti come sensibili (password, token, IBAN, codici fiscali).</Accordion>
  <Accordion title="Posso correlare log tra workflow diversi?">Ogni run ha un `correlation_id` che può essere propagato ai sistemi esterni (via webhook) per tracciare flussi cross-sistema.</Accordion>
  <Accordion title="Come monitoro workflow critici?">Attiva **Alert su failure** e aggiungi il workflow alla **dashboard SLA** (Impostazioni → Monitoring).</Accordion>
</AccordionGroup>
