インテグレーションエラーとランタイムエラーを解決する
学習の目的
この単元を完了すると、次のことができるようになります。
- インテグレーションエラーの症状と原因を特定する。
- ランタイムエラーの症状と原因を特定する。
- 各カテゴリに適したトラブルシューティングの手順とベストプラクティスを適用する。
インテグレーションエラーを解決する
インテグレーションエラーは、ほかのエラーとは異なる形で現れます。エージェントが AWS、Slack、またはカスタム API などの外部システムに接続できない場合や、401 Unauthorized (許可されていません) や 500 Internal Server Error (内部サーバーエラー) などのエラーが表示される場合、あるいは応答が遅かったりタイムアウトが発生したりする場合があります。よくある原因としては、期限切れの OAuth トークンや無効な API キー、Salesforce 側で更新されていないエンドポイント URL の変更、または正しく設定されていない指定ログイン情報などが挙げられます。
順番に確認していきましょう。まず、指定ログイン情報を検証します。[Setup (設定)] | [Security (セキュリティ)] | [Named Credentials (指定ログイン情報)] に移動し、有効になっていること、正しいエンドポイントを指していることを確認します。
- 指定ログイン情報を検証します。指定ログイン情報が有効で、正しいエンドポイントを指していることを確認します。
- API ログを確認します。ログは [Event Monitoring (イベントモニタリング)] | [API Usage Logs (API 利用状況ログ)] で参照できます。失敗したコールと返された HTTP 状況を確認します。
- 認証トークンを更新します。OAuth の更新トークンを使用するか、接続アプリケーションを再承認します。
- Salesforce の外部で接続をテストします。Postman などのツールを使用すると、問題がエンドポイント自体にあるのか、Salesforce 側にあるのかを切り分けられます。
一般的なエラーコードをおさらいしておきましょう。
- 401 は OAuth トークンの更新が必要であることを示します。
- 403 は権限の確認が必要であることを示します。
- 404 はエンドポイント URL またはレコード ID が誤っていることを示します。
- 429 はレート制限が適用されていることを示します (再試行/バックオフロジックを追加してください)。
- 500 が返された場合は、ログを確認するか、Salesforce サポートにお問い合わせください。
今後のインテグレーションでは、再試行ロジックと監視アラートをフローに直接組み込んでおくことをお勧めします。そうすれば、一時的な障害がサポートチケットに発展するのを防げます。どのような方法で問題を解決する場合でも、まず Sandbox で問題を再現してください。データやインテグレーションの問題を本番環境で直接デバッグしないでください。
ランタイムエラーを解決する
ランタイムエラーには、完了前に停止するプロセス、Null Pointer Exception (Null ポインター例外) などの例外、いつまでも終わらない自動化のループなどがあります。これらは通常、初期化されていない変数、再帰的なトリガー、またはガバナ制限の超過が原因で発生します。ランタイムエラーは、複雑な自動化が実行途中で失敗したときに発生します。
よくある原因としては、フローロジックの誤りや初期化されていない変数、再帰的なトリガーや循環依存 (互いに繰り返しトリガーし合うステップ)、またはガバナ制限 (Salesforce が 1 つのトランザクションに許可するリソースの上限) の超過などが挙げられます。
次の手順に従ってトラブルシューティングします。
- デバッグモードでフローをステップ実行し、失敗しているノードや変数を特定します。
- Apex デバッグログでスタックトレースを確認します。
- SOQL クエリ、DML 操作、CPU 時間のガバナ制限の利用状況を確認します。
- 複雑なフローを小さく再利用可能なサブフローにリファクタリングします。
ベストプラクティス: フローがランタイム例外を適切に処理できるよう、常に障害パスを設定してください。
エージェントのトラブルシューティングは、調べるべき点が多く、難しい作業になることがあります。確認すべきさまざまな領域と、それらを正しく動作するように設定する方法について、理解が深まりました。学習をさらに深めるために、下記のリソースもご確認ください。