アーカイブ

概要

アーカイブは、30日を超えた本番データを日付別にダウンロードできるページです。分析、バックアップ、外部システムへのデータ移行に便利です。

アーカイブポリシー

• 本番環境のみが対象です。 サンドボックスデータはアーカイブされず、30日経過後に自動削除されます
• 本番データはアカウントが有効な間は永続的に保持され、ログページでいつでも確認できます
• 30日を超えた本番データは自動的にアーカイブされ、このページから日付別にダウンロードできます
• アーカイブファイルは日単位で作成されます
• ダウンロード形式はJSONL（.jsonl.gz）とCSVの2種類を提供します
• pandas、DuckDB、jq、Jupyterなどによる分析にすぐ利用できます

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

• 上部メニューのアーカイブ → 一覧からダウンロードしたいエンドポイントを選択

---

エンドポイント一覧

ページ上部には、保持ポリシーとファイル形式をまとめたインフォメーションカードが表示されます。その下の**データスキーマを表示**アコーディオンを展開すると、アーカイブファイルのフィールド構造をプレビューできます（下の「アーカイブファイルのスキーマ」セクションと同じ内容です）。

さらにその下には、アーカイブデータのあるエンドポイントが表形式で一覧表示されます。

列	説明
エンドポイント	エンドポイント名
ファイル数	アーカイブファイル数（日単位）
合計サイズ	すべてのアーカイブファイルの合計
日付範囲	最古から最新までのアーカイブ日付
最新	最新のアーカイブファイルの日付

エンドポイントをクリックすると、アーカイブファイル一覧ページに移動します。

アーカイブファイル一覧

エンドポイントを選択すると、その日単位のアーカイブファイルが表示されます。

列	説明
日付	アーカイブ対象日（UTC）
レコード数	その日に記録されたAPIコール件数
ファイルサイズ	圧縮されたJSONL.gzファイルサイズ
ダウンロード	JSONL / CSV ボタン

2種類のダウンロード形式

JSONL（.jsonl.gz）

• 1日分の本番レコードをgzipで圧縮したものです
• 1行に1件のJSONレコードが格納されます
• 原本形式のまま保持されるため、プログラムによる分析、バックアップ、再処理に適しています
• 例：

  {"id":"rec_...","payload":{"order_id":"ORD-001"},"status":"success","created_at":"..."}
  {"id":"rec_...","payload":{"order_id":"ORD-002"},"status":"success","created_at":"..."}
  

CSV（.csv）

• スプレッドシート向けの形式です
• システムフィールドが先頭に、続いてpayload_プレフィックスが付いたフラット化されたビジネスフィールドが並びます
• 例：payload.customer.name → payload_customer_name
• Excel、Googleスプレッドシートなどですぐに開けます
• ご注意：CSVへの変換はファイルサイズによって時間がかかる場合があり、PCブラウザでのみ動作します（大容量ファイル処理のため）

アーカイブファイルのスキーマ

ダウンロードされたアーカイブファイルの各レコードのフィールド構造です。JSONLでは1行が1レコードです。CSVではシステムフィールドが先頭に、続いてpayload_プレフィックスが付いたフラット化されたビジネスフィールドが並びます。

フィールド	説明
id	レコードID
payload	ビジネスデータ（JSON）
config_version	スキーマバージョン
status	処理結果（success / failed）
error_details	エラー詳細（失敗時）
created_at	作成日時
updated_at	更新日時
endpoint_name	エンドポイント名
endpoint_slug	エンドポイントURLパス
collaboration_key_name	コーラーキー名
gateway_processing_time_ms	処理時間（ms）

---

トラブルシューティング

• アーカイブ一覧が空になっている：本番データは30日を超えた時点でアーカイブされます。より新しいデータはログページでご確認ください
• モバイルでCSVダウンロードが動作しない：CSV変換は重い処理を伴うため、PCブラウザ専用です。JSONLはモバイルでもダウンロードできます
• スプレッドシートでCSVを開くと非英語の文字が文字化けする：CSVファイルはUTF-8でエンコードされています。スプレッドシートで開く際に文字エンコーディングをUTF-8に指定すると文字化けを防げます
• Freeプランでもアーカイブはダウンロードできますか？：アーカイブは有料プランの機能です。Freeプランのエンドポイントは作成から7日後に自動削除されるため、アーカイブは不要です