【ITニュース解説】🎯 When Failure Isn’t Final: Meet failure-retry-executor

ITシステムを開発し運用していく上で、プログラムが常に完璧に動作することは難しい。ネットワークの一時的な不調や、外部サービスの応答遅延、あるいはデータベースの瞬間的な負荷など、さまざまな原因で処理が予期せず失敗することがある。しかし、一度の失敗で処理全体を止めてしまうのは、システムの信頼性を大きく損なうことにつながる。多くの場合、これらの失敗は一時的なものであり、少し時間をおいてもう一度試せば、問題なく成功することが珍しくない。このような「一時的な失敗」に対して、自動的に再試行を促し、システムの安定性を高めるためのツールが「failure-retry-executor」である。

このツールがなぜ重要なのかを考えてみよう。例えば、あなたが書いたプログラムが、インターネット経由で別の会社のサーバー（これを外部APIと呼ぶ）から最新の天気情報を取得しようとしているとする。しかし、その外部APIのサーバーが一時的に混雑していたり、あなたのインターネット回線が一瞬だけ不安定になったりすることがある。もしプログラムが一度失敗しただけで処理を中断してしまったら、正確な天気情報を取得できず、ユーザーは不便を感じるだろう。このような状況で、プログラムが自動的に数回再試行してくれれば、ほとんどの場合、最終的には天気情報を取得できるようになる。

failure-retry-executorは、このような再試行のロジックを開発者が一つ一つ手作業で書く手間を省き、よりシンプルで堅牢なシステムを構築するための仕組みを提供する。使い方は非常に直感的だ。まず、失敗する可能性がある処理、つまり「コマンド」を、このツールのexecute()という特別な命令の中に記述する。例えば、execute(fn() => …)のように、実行したい処理の内容を関数として指定するのだ。

もしこの指定された処理が実行中にエラーになったり、期待通りの結果（例えば、成功を示す「真」の値）を返さなかったりした場合、failure-retry-executorはすぐに処理を諦めることなく、自動的にそのコマンドを再実行する。これは、まるで「おや、うまくいかなかったな。もう一度やってみよう」とシステムが自ら考えるようなものだ。再試行の回数はデフォルトで3回に設定されているが、開発者はこの回数を自由に設定できる。例えば、最大で5回まで試す、というように指定が可能だ。

そして、再試行を繰り返した結果、最終的に処理が成功した場合には、onSuccessという別の処理が自動的に呼び出される。これは、成功した時に実行したい内容をあらかじめ登録しておく仕組みだ。例えば、「データの取得に成功しました！」というメッセージを表示したり、取得したデータを使って次のステップに進んだりする、といったことをここに記述する。

しかし、指定された全ての試行回数が尽きても、最終的に処理が成功しなかった場合はどうなるだろうか。その際には、onFailureという処理が呼び出される。これは、全ての再試行が失敗に終わった時に、その後の対処を行うためのものだ。例えば、「残念ながらデータを取得できませんでした。エラーログに詳しい情報を記録します」といった処理をここで行う。エラーログには、なぜ失敗したのかという詳しい情報（プログラミングの世界では「例外」と呼ばれる、プログラムが遭遇した問題の詳細）を記録することが一般的だ。これにより、後から問題の原因を調査しやすくなる。

failure-retry-executorは、特に外部の不安定なサービスと連携するシステムにおいて、その真価を発揮する。前述の外部APIからの情報取得はもちろん、クラウドサービス上のストレージへのファイル書き込み、リモートのデータベースへのアクセスなど、一時的なネットワークの遅延やサービスの不安定さによって失敗しやすい操作には全て適用できる。また、開発者が自分で再試行のロジックを複雑なループ文（例えばwhile (retries--) { ... }のような形）で書く必要がなくなるため、コードが非常にシンプルになり、読みやすく、メンテナンスしやすくなるという大きなメリットがある。これにより、開発者は本来のビジネスロジック、つまり「何をするか」という本質的な部分に集中できるようになり、システムの信頼性を向上させながら開発効率も高めることができるのだ。

具体的なコード例を見てみよう。PHPというプログラミング言語での利用例では、次のように記述されている。 Zarganwar\FailureRetryExecutor\FailureRetryExecutor::execute( command: fn() => $client->get('https://api.example.com/data'), maxAttempts: 5, onSuccess: fn($response) => print("Hooray, we got the data!"), onFailure: fn(Throwable $e) => error_log("Ugh, still failing: {$e->getMessage()}") ); このコードは、https://api.example.com/dataというURLからデータを取得する処理を、最大で5回まで再試行するように設定している。commandの部分には、実際にデータを取得する処理が書かれている。maxAttempts: 5は、最大試行回数が5回であることを示している。もし5回以内にデータ取得が成功した場合、onSuccessに書かれているprint("Hooray, we got the data!")というメッセージが表示される。しかし、5回試してもデータが取得できなかった場合、onFailureに書かれているerror_log("Ugh, still failing: {$e->getMessage()}")が実行され、エラーメッセージがシステムログに記録される。ここで$eは、失敗の原因となったエラー（例外）の情報を指しており、そのメッセージをログに出力することで、後から何が問題だったのかを確認できるようにしている。

このように、failure-retry-executorは、システムの「失敗」を単なる終わりとしてではなく、もう一度試す機会と捉えるための非常に有効なツールである。一時的な問題によってプログラムの実行が不必要に中断されることを防ぎ、システムをより安定して動作させるためのシンプルかつ効果的な方法を提供する。システムエンジニアを目指す上で、このような障害に強く、信頼性の高いシステムを設計・構築する考え方は非常に重要であり、このツールはその一助となるだろう。クリーンで賢い解決策を求めるなら、ぜひこのfailure-retry-executorを試してみるべきだ。