AgentMeter 利用ガイド¶

AgentMeter は、デスクトップ向けの Agent 使用量ツールです。ローカルマシンでコーディングに使用する Agent のアカウント、クォータ、Token 使用状況を確認できます。AgentMeter をGuanceに接続すると、使用量メトリクスや Agent の実行チェーンを現在のワークスペースに送信し、Agent の使用量、パフォーマンス、呼び出しプロセスを一元分析できます。

AgentMeter は現在、Codex、Claude Code、WorkBuddy に対応しています。Agent によって提供されるデータは異なります。

AgentMeter のインストール¶

インストールする前に、現在のデバイスに確認したい Agent をインストールし、ログインしておいてください。OS とプロセッサアーキテクチャに応じて、対応するインストールパッケージをダウンロードします。

macOS¶

1. ダウンロードした DMG ファイルを開きます。
2. AgentMeter を Applications（アプリケーション） にドラッグします。
3. アプリケーションディレクトリから AgentMeter を起動します。

AgentMeter は起動後、メニューバーに常駐し、Dock アイコンは表示されません。

Windows¶

1. ダウンロードした ZIP ファイルを解凍します。
2. その中のインストーラーを実行します。
3. インストールが完了したら AgentMeter を起動します。

AgentMeter は起動後、システムトレイに常駐します。

Linux¶

Debian または Ubuntu では、次のコマンドで DEB パッケージをインストールします。

sudo apt install ./AgentMeter-latest-linux-<架构>.deb

Fedora または RHEL では、次のコマンドで RPM パッケージをインストールします。

sudo dnf install ./AgentMeter-latest-linux-<架构>.rpm

<架构> は arm64 または amd64 に置き換えます。インストールが完了したら、アプリケーション一覧から AgentMeter を起動します。

Agent の使用量を確認¶

AgentMeter を起動したら、メニューバーまたはシステムトレイの AgentMeter アイコンをクリックしてフローティングパネルを開きます。AgentMeter は現在のデバイスにインストールされている Agent を自動検出し、読み取り可能な使用量情報を表示します。

• 更新をクリックすると、アカウント、クォータ、使用量データがすぐに更新されます。
• Token メトリクスをクリックすると、日別、月別カレンダー、またはトレンドチャートで履歴使用量を確認できます。
• 設定 > Agents を開き、フローティングパネルまたはシステムバーに表示する Agent を選択し、ドラッグして表示順序を調整します。
• 設定 > 一般 を開き、言語、外観、ログイン時の自動起動を設定します。
• 設定 > バージョン情報 を開き、AgentMeter のアップデートを確認してインストールします。

Claude Code を初めてクォータ読み取りに接続した後は、Claude Code のセッションを一度開くか再起動してください。現在のアカウントまたは Claude Code のバージョンがサブスクリプションクォータフィールドを返さない場合でも、AgentMeter はローカルの Token 履歴を表示できます。

Guance への接続¶

Agent データをGuanceに送信するには、設定 > サービス接続を開きます。サービス接続には、次の 2 つの収集レベルがあります。

基本収集は AgentMeter に組み込まれ、拡張収集は AgentMeter が obs-agent-connector を管理します。2 つの収集は Agent ごとに個別に有効にできます。

ステップ 1: 接続を設定¶

Agent モニタリング > サマリー > Agent 接続を開き、接続設定ページで現在のワークスペースの Data Endpoint と X-Token を取得します。次に、設定 > サービス接続 > 接続設定で JSON 設定ファイルをインポートするか、以下の情報を手動で入力します。

インポートするファイルの形式は次のとおりです。

{
  "schemaVersion": 1,
  "ingestEndpoint": "<Data Endpoint>",
  "xToken": "<X-Token>",
  "user_id": "<User ID>",
  "user_name": "<User Name>"
}

設定ファイルは .json 拡張子で、サイズは 64 KB 以下である必要があります。保存後、AgentMeter は X-Token を隠し、インターフェースに完全な値を表示しません。

ステップ 2: 基本収集を有効にする¶

基本収集領域で、使用量メトリクスを送信する Agent のスイッチをオンにします。有効にすると、AgentMeter はすぐにデータを 1 回送信し、以降は 60 秒ごとに最新のスナップショットを送信します。

基本収集データは agent_runtime メジャーメントに書き込まれます。AgentMeter のメトリクスフィールドは agent_meter_ で始まります。基本収集には使用量とアカウントのスナップショットのみが含まれ、Session や Trace データは生成されません。

ステップ 3: 拡張収集を有効にする¶

1. 拡張収集領域でコネクタをインストールをクリックします。
2. インストールが完了したら、実行チェーンを収集する Agent の拡張収集を有効にします。
3. ページの指示に従って設定と検証を完了します。
4. 実行中の Agent セッションを再起動して、収集設定を有効にします。
5. Agent で新しいセッションまたは新しいタスクを開始します。

AgentMeter は、現在のデバイスで検出され、サポートされている Agent のみを管理します。コネクタのインストール後も、サービス接続ページで Agent ごとに統合の有効化、無効化、検証、削除を個別に行えます。

データの検証¶

サービス接続が完了したら、収集レベルごとにデータを検証できます。

• 基本収集: メトリクス分析で agent_runtime メジャーメントを選択し、agent_meter_ で始まるメトリクスフィールドをクエリします。
• 拡張収集: Agent モニタリング > エクスプローラーを開き、Agent タイプ、User、Session、Trace ごとにデータを確認します。
• トレンド分析: Agent モニタリング > 分析ダッシュボードを開き、Agent タイプ、Agent ID、または Agent 名でデータを絞り込みます。

拡張収集を有効にした直後は、Agent で新しいタスクを 1 回完了させてからクエリしてください。収集設定は、有効化前に生成された完全な Trace データを遡って送信しません。

長時間タスクの通知を設定¶

AgentMeter は、Codex の長時間タスク完了時に Lark グループボット経由で通知を送信できます。

1. 設定 > 通知を開きます。
2. 通知と長時間タスク完了通知を有効にします。
3. Lark グループボットの Webhook URL を入力します。
4. ボットで署名検証が有効になっている場合は、署名シークレットも入力します。
5. 長時間タスクのしきい値を設定して保存します。
6. 通知をテストをクリックし、グループチャットでメッセージを受信できることを確認します。

完了通知が送信されるのは、実行時間がしきい値に達した Codex タスクのみです。

よくある質問¶

Agent が検出されない¶

Agent がインストールされ、少なくとも 1 回正常に起動していることを確認し、設定 > Agents で更新をクリックします。Codex はアカウントへのログインも必要です。Linux では現在、WorkBuddy Desktop の検出はサポートされていません。

Claude Code にクォータデータがない¶

Claude Code セッションを一度開くか再起動し、AgentMeter が最初のクォータレスポンスを受信するのを待ちます。一部のアカウントプランや Claude Code バージョンではクォータフィールドが提供されませんが、その場合でも Token 履歴は利用できます。

基本収集でデータがない¶

接続設定が保存され、対象 Agent の基本収集スイッチがオンになっていることを確認し、少なくとも 1 つのレポート間隔待ちます。その後、基本収集の診断を表示をクリックして、最終収集時刻、レポート時刻、エラー情報を確認します。

拡張収集で Trace がない¶

コネクタがインストールされ、対象 Agent の拡張収集スイッチがオンになり、検証が成功していることを確認します。Agent を再起動して新しいタスクを開始し、Agent モニタリングのエクスプローラーでクエリします。それでもデータがない場合は、診断情報を表示をクリックしてコネクタの状態を確認します。

診断ログを表示¶

AgentMeter の診断ログには、タスクの内容、完全な Token、Webhook、署名シークレットは記録されません。デフォルトのログパスは次のとおりです。

履歴ログには .1 から .4 のサフィックスが付きます。問題を報告する際は、AgentMeter のバージョン、OS、Agent タイプ、およびマスク処理した診断ログを併せて提供することをお勧めします。

参考情報¶