メニュー経路: ダッシュボード > ログ

ログ

概要

ログは、エンドポイントのすべてのAPIコール記録を1か所で確認できるページです。リクエストの成功/失敗、送信されたペイロード、Webhook配信ステータス、エラーメッセージを確認できます。

サンドボックスと本番環境はタブで分離されているため、テストコールと実運用コールを独立して追跡できます。

このページへのアクセス方法

上部メニューのログ → 一覧からエンドポイントを選択
エンドポイント詳細の右サイドバーにある ログを表示 リンク

エンドポイント一覧

ログエンドポイント一覧

ログページを最初に開くと、エンドポイント一覧が表示されます。エンドポイントごとのログ状況が要約されます。

列	説明
エンドポイント	エンドポイント名
合計ログ数	このエンドポイントの合計コール数
成功率	成功したコールの割合
最終アクティビティ	最新コール時刻（相対表示）

エンドポイントをクリックすると、その詳細ログページに移動します。

詳細ページヘッダー

エンドポイントを選択すると、画面上部に以下の要素が表示されます。

エンドポイント名と説明
API詳細を表示 ボタン — エンドポイント詳細ページへ移動します
サンドボックスデータを消去 ボタン — このエンドポイントのサンドボックスコール記録と使用量統計を完全に削除します
- 協力者がアクセスした場合は 自分のサンドボックスデータを消去 と表示され、本人が生成したレコードのみ削除されます
- 本番データには影響しません
サンドボックス | 本番 環境タブ — 各環境のログを独立して表示します（環境タブについて詳しく見る）

検索フィルター

検索エリアには 期間検索 と フィールド検索 の2つのタブがあります。

期間検索

期間検索フィルター

期間とステータスでログをフィルタリングします。

日付基準 — 処理日時 または 作成日時 を選択します。デフォルトは処理日時です
開始日 / 終了日 — 期間を指定します
ステータス — すべて / 成功 / 失敗 / Webhook 失敗 から選択します
- Webhook 失敗 は、保存は完了したものの Webhook が受信サーバーに届かなかった、または再試行中のコールのみを表示します。この項目を選ぶとリクエストID・内容検索の条件は解除されます
コラボレーションキー — すべて または特定のコラボレーションキー（そのキーで行われたコールのみ表示）

フィールド検索

フィールド検索フィルター

特定の値でログを検索したい場合に使用します。

フィールドの選択:
- リクエストID — レコードIDによる完全一致（前方一致も可）
- コンテンツ検索 — ペイロード全体を対象に、部分一致で値を検索（3文字以上、英字は大文字・小文字を区別しません）
検索値を入力して実行します
コンテンツ検索 を選択した場合、開始日 / 終了日 の入力が表示されます。日付を指定しない場合、デフォルトで直近30日以内を検索します

コンテンツ検索の動作と制限

検索範囲: レコードのペイロード（JSON全体）をテキストとして直列化した結果に対する部分一致
多言語対応: 日本語・英語・韓国語・中国語など問題なく動作（英字は大文字・小文字を区別しません）
数値も検索可能ですが部分一致のため誤マッチに注意: 例えば "32" で検索すると age:32 だけでなく 132、321 なども一致します
JSONキー名もインデックス対象: "name" や "address" のような一般的なキー名で検索すると全レコードが一致します — より具体的な検索語を推奨
未対応: 比較演算子（>、<、=）、完全一致、フィールド単位の検索

ログ一覧

検索フィルターの下に、エンドポイントのコール履歴が表形式で表示されます。

列	説明
リクエストID	レコード識別子
ステータス	成功 · 失敗 · 処理中のバッジ
Webhook	配信が失敗した、または再試行中の場合にのみバッジを表示（下記参照）
コラボレーションキー	このコールに使用されたコラボレーションキー（未指定の場合はデフォルト）
作成日時	APIコール受信時刻
処理日時	保存およびWebhook処理完了時刻

Webhook 列の読み方 — この列は Webhook を設定したエンドポイントにのみ表示されます。

バッジ	意味
⚠ `502`	失敗 — 再試行をすべて使い切り、最後まで配信できませんでした。数字は受信サーバーが返したステータスコードで、応答自体がなかった場合は `タイムアウト` と表示されます
↻ `502 (3/6)`	再試行中 — 括弧は `現在の試行回数 / 合計試行回数` です（本番6回、サンドボックス4回 — 最初の配信が1回目です）。次回の再試行時刻はログ詳細で確認できます
✓ `復旧`	最初は失敗しましたが、再試行の末に配信されました

空欄は成功を意味しません。 記録されるのは失敗した配信だけなので、正常に配信された Webhook は痕跡を残しません。Webhook を設定していないエンドポイントでは、列そのものが表示されません。

1回のコールにオーナー Webhook とコラボレーター Webhook の両方が設定されている場合、一覧にはより深刻な方の1件だけが表示されます。個別に確認するにはログ詳細を開いてください。

任意の行をクリックすると、ログ詳細ページに移動します。

ログ詳細ページ

概要

ログ概要

個別コールの詳細情報を表示します。

リクエストID: レコードの一意の識別子
エンドポイント: コールを受信したエンドポイント
バージョン: コール時点の設定バージョン
処理日時: 保存およびWebhook処理完了時刻
応答時間: ゲートウェイ処理時間（ミリ秒）
コラボレーションキー: 使用されたコラボレーションキーの名前と説明（該当する場合）
エラーメッセージ / エラー詳細: 失敗したコールの場合、エラータイプ、ステータスコード、フィールドエラー、発生時刻
エンドポイントを表示 ボタン — このエンドポイントの詳細ページへ移動します

Webhook 配信

このコールの Webhook が失敗した、または再試行中の場合にのみ表示されるカードです。オーナー Webhook が上、コラボレーター Webhook が下に表示されます。

ステータスバッジと試行回数 — 一覧と同じバッジに加えて N 回試行、ステータスコード、最後のエラー、受信ホストが表示されます
レスポンス — 受信サーバーが返したレスポンス本文の原文（先頭部分）。ファイアウォール（WAF）によるブロックなのか、サーバーには届いたがアプリが拒否したのかを見分けるほぼ唯一の手がかりです。コピーボタンがあります
試行履歴 — 各試行の時刻・ステータスコード（または タイムアウト）・所要時間（ミリ秒）。自動再試行による試行には 自動再試行 と表示されます
次回の再試行 — 試行が残っている場合は次の予定時刻

記録されるのは失敗した配信だけです。 正常に配信された Webhook はここに残らないため、このカードがないことは「失敗が記録されていない」という意味であり、「配信を確認できた」という意味ではありません。

手動での再送は提供していません。 再試行はすべて自動で、使い切った後に再送することはできません。受信サーバーを修正すれば、次回の API コールから正常に配信されます。

この画面を見張り続ける必要はありません。 本番のオーナー Webhook の配信をあきらめた時点で、プランを問わず（無料プランも）メールでお知らせします — 1 エンドポイントにつき 1 日 1 通までです。個々の試行履歴やレスポンス本文を調べる場所は、引き続きこの画面です。

再試行の間隔と、どのレスポンスが再試行の対象かはテスト＆連携ガイドで確認してください。

ペイロード

ペイロードセクション

APIコールで送信された元のJSONデータを表示します。

Danger Zone

ログレコードの削除 — このログレコードを完全に削除します
レコード本体と関連するペイロードが削除されます。この操作は元に戻せません
使用量統計には影響しません

エンドポイント表示のクイックリンク

詳細ページの右側には、現在のログのエンドポイント詳細ページにジャンプできるクイックリンクカードが表示されます。エンドポイントの設定、Webhook、コラボレーションキーなどをすばやく確認できます。

トラブルシューティング

ログが空です: 本番タブは本番デプロイが行われるまでレコードを表示しません。まずサンドボックスタブにテストコールが記録されていることを確認してください
検索結果が出ません: 検索語が3文字未満か、期間内に一致するレコードがない場合です。(1) 検索語をより短く・具体的に調整し（日本語は2〜3文字、英語は単語の一部）、(2) 期間を30日以内で広げてみてください。以前の「検索可能フィールド」の事前設定は廃止され、フィールドごとの設定は不要です。
特定の協力者のコールだけを見たい: 期間検索タブの コラボレーションキー ドロップダウンからコラボレーションキーを選択してください
Webhook 列が空ですが、正常に配信されたということですか?: いいえ。記録されるのは失敗した配信だけなので、空欄は「失敗が記録されていない」という意味です。Webhook が未設定、まだ配信を試みていない、正常に配信された — このすべてが同じ空欄に見えます
Webhook 失敗フィルターを選んだら検索語が消えました: Webhook 失敗 は検索の方向が逆になるため、リクエストID・内容検索と併用できません。期間とコラボレーションキーの条件はそのまま維持されます
サンドボックスの消去は元に戻せますか？: いいえ。消去されたサンドボックスのコール記録と統計は完全に削除されます。慎重にご利用ください

本番コンソール

統計