翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

CloudWatch ログを使用した Step Functions の実行履歴のログ記録

標準ワークフローは実行履歴を に記録しますが AWS Step Functions、オプションで Amazon CloudWatch Logs へのログ記録を設定できます。

Express ワークフローは、標準ワークフローとは異なり AWS Step Functionsに実行履歴を記録しません。Express ワークフローの実行履歴と結果を表示するには、Amazon CloudWatch Logs へのログ記録を設定する必要があります。ログを発行しても、実行がブロックまたは遅くなることはありません。

のログ記録の設定

Step Functions コンソールを使用して標準ワークフローを作成する場合、 CloudWatch ログへのログ記録を有効にするようには設定されません。Step Functions コンソールを使用して作成された Express ワークフローは、デフォルトで CloudWatch ログへのログ記録を有効にするように設定されます。

Express ワークフローの場合、Step Functions は Logs に必要な AWS Identity and Access Management （IAM) CloudWatch ポリシーを持つロールを作成できます。API、、または を使用して標準ワークフローまたは Express ワークフローを作成する場合CLI AWS CloudFormation、Step Functions はデフォルトでログ記録を有効にせず、ロールに必要なアクセス許可があることを確認する必要があります。

コンソールから開始された実行ごとに、Step Functions は CloudWatch Logs へのリンクを提供します。このリンクには、その実行に固有のログイベントを取得するための正しいフィルターが設定されています。

オプションで、ログを暗号化するようにカスタマーマネージド AWS KMS キーを設定できます。詳細とアクセス許可の設定保管中のデータ暗号化については、「」を参照してください。

ログ記録を設定するには、 CreateStateMachineまたは を使用するときに LoggingConfigurationパラメータを渡すことができますUpdateStateMachine。 CloudWatch Logs Insights を使用して CloudWatch 、ログ内のデータをさらに分析できます。詳細については、「Logs Insights を使用した CloudWatchログデータの分析」を参照してください。

CloudWatch ログペイロード

実行履歴イベントは、入力プロパティまたは出力プロパティを定義に含めることができるかもしれません。 CloudWatch ログに送信されたエスケープされた入力またはエスケープされた出力が 248KBを超える場合、 CloudWatch ログのクォータの結果として切り捨てられます。

IAM CloudWatch ログへのログ記録のポリシー

また、次の例に示すように、 CloudWatch ログにログ記録するための適切なアクセス許可を持つようにステートマシンの実行IAMロールを設定する必要があります。

IAM ポリシーの例

以下は、アクセス許可を設定するために使用できるポリシーの例です。次の例に示すように、 CreateLogDelivery や などのアクションは で定義されたリソースタイプAmazon CloudWatch Logsをサポートしていないため CloudWatch API DescribeLogGroups、 Resourceフィールドで * を指定する必要があります。詳細については、「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": "*"
        }
    ]
}

CloudWatch ログにアクセスできない

CloudWatch ログにアクセスできない場合は、次の操作が完了していることを確認してください。