Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Utilizzo di CloudWatch Logs per registrare la cronologia delle esecuzioni in Step Functions

I flussi di lavoro standard registrano la cronologia di esecuzione in AWS Step Functions, sebbene sia possibile configurare facoltativamente la registrazione su Amazon CloudWatch Logs.

A differenza dei flussi di lavoro standard, Express Workflows non registra la cronologia di esecuzione in AWS Step Functions. Per visualizzare la cronologia di esecuzione e i risultati di un Express Workflow, devi configurare la registrazione su Amazon CloudWatch Logs. I log di pubblicazione non bloccano o rallentano le esecuzioni.

Configurazione della registrazione

Quando si crea un flusso di lavoro standard utilizzando la console Step Functions, quella macchina a stati non sarà configurata per inviare log a CloudWatch Logs. Quando si crea un Express Workflow utilizzando la console Step Functions, quella macchina a stati sarà configurata per impostazione predefinita per inviare log a CloudWatch Logs.

Per i flussi di lavoro Express, Step Functions può creare un ruolo con il necessario AWS Identity and Access Management (IAM) politica per i CloudWatch registri. Se si crea un flusso di lavoro standard o un flusso di lavoro Express utilizzando APICLI, o AWS CloudFormation, Step Functions non abilita la registrazione per impostazione predefinita e dovrai assicurarti che il tuo ruolo disponga delle autorizzazioni necessarie.

Per ogni esecuzione avviata dalla console, Step Functions fornisce un collegamento a CloudWatch Logs, configurato con il filtro corretto per recuperare gli eventi di registro specifici per quell'esecuzione.

Facoltativamente, puoi configurare Customer Managed AWS KMS chiavi per crittografare i log. Vedi Crittografia dei dati inattivi per i dettagli e le impostazioni di autorizzazione.

Per configurare la registrazione, puoi passare il LoggingConfigurationparametro quando usi CreateStateMachineo UpdateStateMachine. È possibile analizzare ulteriormente i dati in CloudWatch Logs utilizzando CloudWatch Logs Insights. Per ulteriori informazioni, consulta Analisi dei dati di registro con CloudWatch Logs Insights.

CloudWatch Registra i payload

Gli eventi della cronologia di esecuzione possono contenere proprietà di input o output nelle loro definizioni. Se l'input con escape o l'output con escape inviato a CloudWatch Logs supera i 248 KB, verrà troncato a causa delle quote di log. CloudWatch

IAMPolitiche per la registrazione nei registri CloudWatch

È inoltre necessario configurare il IAM ruolo di esecuzione della macchina a stati per disporre dell'autorizzazione appropriata per accedere ai CloudWatch registri, come mostrato nell'esempio seguente.

IAMesempio di politica

Di seguito è riportata una policy di esempio che è possibile utilizzare per configurare le autorizzazioni. Come illustrato nell'esempio seguente, è necessario specificare * nel Resource campo. CloudWatch APIle azioni, come CreateLogDelivery e DescribeLogGroups, non supportano i tipi di risorse definiti da Amazon CloudWatch Logs. Per ulteriori informazioni, vedere Azioni definite da Amazon CloudWatch Logs.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "logs:CreateLogDelivery",
                "logs:CreateLogStream",
                "logs:GetLogDelivery",
                "logs:UpdateLogDelivery",
                "logs:DeleteLogDelivery",
                "logs:ListLogDeliveries",
                "logs:PutLogEvents",
                "logs:PutResourcePolicy",
                "logs:DescribeResourcePolicies",
                "logs:DescribeLogGroups"
            ],
            "Resource": "*"
        }
    ]
}

Risoluzione dei problemi relativi alla registrazione della macchina a stati nei registri CloudWatch

Se la tua macchina a stati non è in grado di inviare log a CloudWatch Logs, prova i seguenti passaggi:

Livelli di registro per gli eventi di esecuzione di Step Functions

I livelli di registro vanno da ALL ERROR a FATAL aOFF. Tutti i tipi di eventi vengono registratiALL, nessun tipo di evento viene registrato se impostato su. OFF Per ERROR e FATAL, consulta la tabella seguente.

Per ulteriori informazioni sui dati di esecuzione visualizzati per le esecuzioni di Express Workflow basate su questi livelli di registro, vedere. Differenze di esperienza tra console Standard ed Express