SFNリトライ確認 - 開発者ブログ

AWS Step FunctionsでlistCommandInvocationsタスクのリトライ設定を確認するためには、以下の手順を踏むことができます。これにより、リトライ設定が正しく適用されているかを確認できます。

1. Step Functionsの状態マシンを作成する

まず、listCommandInvocationsタスクにリトライ設定を追加した状態マシンを作成します。以下はその例です：

{
  "Comment": "State machine with retry policy for listCommandInvocations task",
  "StartAt": "Invoke ListCommandInvocations",
  "States": {
    "Invoke ListCommandInvocations": {
      "Type": "Task",
      "Resource": "arn:aws:states:::aws-sdk:ssm:listCommandInvocations",
      "Parameters": {
        "CommandId": "YOUR_COMMAND_ID",
        "Details": true
      },
      "Retry": [
        {
          "ErrorEquals": [
            "ThrottlingException",
            "NetworkingError",  // AWS SDK networking error (e.g., network timeout)
            "ServiceUnavailable",
            "States.TaskFailed"
          ],
          "IntervalSeconds": 2,
          "MaxAttempts": 3,
          "BackoffRate": 2
        }
      ],
      "Catch": [
        {
          "ErrorEquals": ["States.ALL"],
          "Next": "HandleNetworkError"
        }
      ],
      "End": true
    },
    "HandleNetworkError": {
      "Type": "Fail",
      "Error": "NetworkError",
      "Cause": "The command invocation failed due to a network error and exceeded the retry limit."
    }
  }
}

2. 状態マシンを実行する

AWS Management Console、AWS CLI、またはSDKを使用して状態マシンを実行します。以下はAWS CLIを使用した例です：

aws stepfunctions start-execution --state-machine-arn arn:aws:states:YOUR_REGION:YOUR_ACCOUNT_ID:stateMachine:YOUR_STATE_MACHINE_NAME

3. 実行結果を確認する

状態マシンの実行結果を確認するために、AWS Management ConsoleのStep Functionsダッシュボードにアクセスします。実行履歴を確認し、listCommandInvocationsタスクがリトライされたかどうかを確認します。

Execution History: 実行履歴を確認し、Invoke ListCommandInvocationsステートがリトライされた回数を確認します。
Graph View: グラフビューで各ステートの実行状況を視覚的に確認します。

4. ログを確認する

Step FunctionsのログをCloudWatch Logsに出力するように設定している場合、CloudWatch Logsで詳細なログを確認できます。これにより、リトライが発生したタイミングやエラーの詳細を確認できます。

5. ネットワークエラーをシミュレートする

実際のネットワークエラーをシミュレートするために、以下のような方法を試すことができます：

一時的なネットワーク障害を発生させる: ネットワーク設定を変更して一時的にネットワーク障害を発生させる。
モックエラーを使用する: Failステートを使用して意図的にネットワークエラーを発生させる。

以下は、Failステートを使用してネットワークエラーをシミュレートする例です：

{
  "Comment": "State machine to simulate network error for listCommandInvocations task",
  "StartAt": "MockNetworkError",
  "States": {
    "MockNetworkError": {
      "Type": "Fail",
      "Error": "NetworkingError",
      "Cause": "Simulated network error for testing retry logic."
    }
  }
}

この状態マシンを実行することで、ネットワークエラーが発生した場合のリトライ設定が正しく動作するかを確認できます。

6. 実行結果の確認

再度、AWS Management ConsoleのStep Functionsダッシュボードで実行結果を確認し、リトライが正しく行われたかどうかを確認します。

これらの手順を踏むことで、listCommandInvocationsタスクのリトライ設定が正しく適用されているかを確認できます。