メインコンテンツにスキップ
Administrator Guide
最終更新: 2026-04-03
トラブルシューティング: API を介したカスタム レポート

トラブルシューティング: API を介したカスタム レポート

API呼び出しがタイムアウトしました。

60 秒経過してもAPI呼び出しが処理されない場合、呼び出しはタイムアウトし、エラー ()が表示されます。
原因
ソリューション
データセット間の結合が多すぎます。
データセット間で使用される結合の数を制限します。
20 を超えるフィールドを含むレポートを取得しています。
レポートのフィールド数を、最大 10 ~ 20 フィールドに制限する。フィールド数が 20 を超える場合は、SFTP を使用してレポートを取得します。
データの形式が不規則です。例: 多数のネストされた組織がある。
異常に大きすぎるデータセットを取得しないようにする。
フィルタのないレポートがあります
適切なフィルタを使用して、データ サイズの拡大に対処してください。例:
「前日」
「今日」
など、短い時間枠を定義するフィルタで変更されたデータを取得します。
前回のリクエストから 分以内にリクエストを行いました。特に、大量のデータを返すレポートや、複数の結合があるレポートの場合です。
短い期間内に複数のAPIリクエストを作成しないようにする。
複数ページのデータを含むレポートを取得しています。
レポート API は、ページング データセットを返すように意図的に設計されています。これは、すべての VNDLY HTTP ベース API に対する標準の制約です。この問題を回避するには、次のようにします。
  • 制限 (返す行数) とオフセット(開始行数) を使用して、単一ページのデータを取得します。
  • レポートに含まれるフィールド数を制限する。
  • レポートAPIの代わりに SFTP を使用して、ページングなしで大規模なレポートを取得できます。

実稼働テナントからのデータの取得でパフォーマンスの問題が発生しますが、テスト テナントでは問題が発生します。

テスト テナントでは、データのロードが本稼働テナントよりも少ないため、テスト テナントではパフォーマンスの問題がすぐに示されない可能性があります。
ソリューション:
  • 本番稼働後にレポート パフォーマンスを検証し、結果が "テスト テナント" と似ていることを確認します。
  • 本番稼働ロードのサイズを表すテスト データを "テスト" テナントにロードします。
  • 本番稼働での拡張を計画する。本番稼働データを含むレポートの予想されるロード サイズと複雑性を考慮します。閾値に近い実行値を取得したレポートは、プログラムが成熟するにあたり、または本番稼働後もこの閾値を超える可能性があります。