Usage Summary

API キー設定画面には、直近 30 日の利用状況が表示されます。これは API キーを作るだけで終わらせず、実際にどの連携が使われているかを確認するための画面です。

集計期間

usage summary は rolling な直近 30 日を表示します。画面上部の period badge が現在の集計期間です。

利用がない期間は、empty state が表示されます。

サマリーカードで見えるもの

時刻表示は workspace 上で JST として見られます。

endpoint breakdown

summary card の下には endpoint ごとの内訳が表示されます。

各行で見えるもの:

• endpoint 名
• その endpoint の request 数
• その endpoint の response bytes

この一覧は request 数の多い順に並びます。同率のときは endpoint 名で並びます。

API キー table

同じ画面の API キー table では、キーごとの状態と利用状況を確認できます。

主な列:

• 名前
• プレフィックス
• 状態
• 最終利用
• 直近30日 request
• 直近30日 response bytes
• 有効期限
• 作成日

この table を見ると、どのキーが実際に使われているか、どのキーがもう不要かを判断できます。

この画面で判断すること

• 直近 30 日で未利用のキーは revoke してよいか
• 1 本のキーに利用が集中していないか
• 期待していない endpoint が多く叩かれていないか
• rotate 後に新しいキーへ実際に切り替わったか

よくある見方

利用直後:

• 最終リクエスト が更新されたか
• リクエスト数 が増えたか

運用中:

• 特定 key の 直近30日 request が急に増えていないか
• レスポンス総量 が大きい endpoint が想定どおりか

整理するとき:

• 未利用 のキーを整理する
• 期限付きキーが切れる前に rotate する

初回ユーザーが確認すべきこと

Quick Start のコマンドを一通り実行したあとに、API キー設定画面へ戻って次を確認してください。

• request が 0 ではなくなっている
• companies や profile など、叩いた endpoint が breakdown に見える
• 使ったキーの 最終利用 が更新されている

この確認まで終えると、単にキーを発行しただけではなく、実際に product を使えたことが分かります。