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

ログ

概要

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

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

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

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

エンドポイント一覧

ログエンドポイント一覧

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

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

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

詳細ページヘッダー

詳細ページヘッダー

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

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

検索フィルター

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

期間検索

期間検索フィルター

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

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

フィールド検索

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

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

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

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

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

ログ一覧

ログ一覧

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

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

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


ログ詳細ページ

概要

ログ概要

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

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

ペイロード

ペイロードセクション

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

本番環境では30日経過後にバックアップアーカイブファイルが追加で生成され、ダッシュボード > アーカイブからダウンロードできます(一括エクスポート用)。

Danger Zone

Danger Zone

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

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

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


トラブルシューティング

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