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

ログ

概要

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

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

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

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

エンドポイント一覧

ログエンドポイント一覧

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

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

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

詳細ページヘッダー

詳細ページヘッダー

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

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

検索フィルター

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

期間検索

期間検索フィルター

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

  • 日付基準処理日時 または 作成日時 を選択します。デフォルトは処理日時です
  • 開始日 / 終了日 — 期間を指定します
  • ステータスすべて / 成功 / 失敗 から選択します
  • コラボレーションキーすべて または特定のコラボレーションキー(そのキーで行われたコールのみ表示)

フィールド検索

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

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

  • フィールドの選択:
    • リクエストID — レコードIDによる完全一致
    • コンテンツ検索 — エンドポイントの検索可能フィールド内の値を検索(例: order_idcustomer_email、3文字以上)
  • 検索値を入力して実行します
  • コンテンツ検索 を選択した場合、開始日 / 終了日 の入力が表示されます。日付を指定しない場合、デフォルトで直近1ヶ月以内を検索します

ログ一覧

ログ一覧

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

説明
リクエストID レコード識別子
ステータス 成功 · 失敗 · 処理中 のバッジ
コラボレーションキー このコールに使用されたコラボレーションキー(未指定の場合はデフォルト)
作成日時 APIコール受信時刻
処理日時 保存およびWebhook処理完了時刻

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


ログ詳細ページ

概要

ログ概要

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

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

ペイロード

ペイロードセクション

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

本番環境では、30日を超えたペイロードは自動的にアーカイブされ、一覧には直接表示されません。この場合、元のペイロードを読み込む ボタンをクリックして、アーカイブされたペイロードを取得します。

Danger Zone

Danger Zone

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

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

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


トラブルシューティング

  • ログが空です: 本番タブは本番デプロイが行われるまでレコードを表示しません。まずサンドボックスタブにテストコールが記録されていることを確認してください
  • 検索結果が出ません: コンテンツ検索 には、エンドポイントに検索可能フィールド(Searchable)が定義されている必要があります。エンドポイント詳細 > 必須フィールドでSearchableが設定されているか確認してください
  • ペイロードが見えません: 本番環境では、30日を超えたコールのペイロードがアーカイブされます。元のペイロードを読み込む ボタンで取得してください
  • 特定の協力者のコールだけを見たい: 期間検索タブの コラボレーションキー ドロップダウンからコラボレーションキーを選択してください
  • サンドボックスの消去は元に戻せますか?: いいえ。消去されたサンドボックスのコール記録と統計は完全に削除されます。慎重にご利用ください