AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

Atlas Agent Engine UIでエージェントをモニターする

Atlas エージェント エンジン UIの Monitoring ページには、プロジェクトとそのワークスペースの使用状況と正常性のメトリクスが表示されます。このページを使用して、エージェントの呼び出し、エラー率、トークン使用量、メモリ アクティビティ、リソース消費を時間の経過とともに追跡します。このページには、現在のプロジェクトのデータのみが表示されます。

ページの各セクションには、メトリクスがタイルとトレンドカードとして表示されます。タイルには、選択した期間の単一の値が表示されます。トレンドカードには、選択した期間におけるメトリクスの変化が表示されます。トレンドカードは、データを5期間には1h分単位、24h期間には1時間単位、7dおよび30d期間には1日単位でグループ化します。

ログ、配置イベント、ライブワークスペースの正常性を表示する方法を学ぶには、「エージェントのモニター」ガイドを参照してください。特定のエージェントの実行をデバッグする方法を学ぶには、「エージェント実行トレースの検査」ガイドを参照してください。

プロジェクトのメトリクスを表示するには、次の手順を実行します。

1

Atlas エージェント エンジン UI の左側のナビゲーションバーで、[Monitor] の下にある [Monitoring] をクリックします。

2

1h、24h、7d、または30dを選択して、モニターする期間を選択します。このページには、デフォルトで過去24時間が表示されます。

3

単一のワークスペースのメトリクスを表示するには、ワークスペースフィルターからワークスペースを選択するか、By workspace または Compute by workspace テーブルの行をクリックします。プロジェクト全体のメトリクスに戻るには、All workspaces を選択します。

ページは60秒ごとに自動的にデータを更新します。

単一のワークスペースを表示する場合、ページにはプロジェクト全体のビューと同じセクションがそのワークスペースにスコープされて表示されますが、以下の例外があります。

  • Networking セクションは利用できません。

  • By workspace テーブルと Compute by workspace テーブルは使用できません。

各セクションに表示するトレンド カードは選択でき、デフォルトで非表示になっている Compute セクションと Networking セクションを表示できます。ページは、プロジェクト全体のビューまたは単一のワークスペース ビューでカスタマイズできます。

ページをカスタマイズするには、次の手順を実行します。

1

ページをカスタマイズしている間は、期間セレクターとワークスペースフィルターは非表示になります。

2
  • トレンドカードを表示または非表示にするには、各セクションでカードを切り替えます。

  • Computeセクションを表示するには、Show Computeを選択します。

  • Networkingセクションを表示するには、Show networkingを選択します。

3

変更を破棄するには、[Cancel] をクリックします。

デフォルトでは、Usage、Memory、およびPolicyセクションには、ボリュームが最も大きい4つのメトリクスのトレンドカードが表示されます。Healthトレンドカードはカスタマイズできません。

ブラウザは選択内容を保存するため、同じブラウザであればセッションをまたいでも選択内容は保持されます。選択内容は、他のブラウザや他のデバイスには適用されません。

このセクションでは、Monitoring ページの各セクションのメトリクスについて説明します。各メトリクスには、選択した期間の合計が表示されます。

Healthセクションには、エージェントの実行結果と実行時間が表示されます。このセクションには、InvocationsとErrorsのトレンドカードも含まれています。Errorsトレンドカードは、選択した期間中にエラーが発生した場合にのみ表示されます。

次の表は、セクション内のメトリクスについて説明しています。

メトリクス
説明
単位
Invocations

完了または失敗したエージェントの実行数。承認待ちの実行するはカウントされません。

数

Error rate

失敗数を呼び出し数で割った値。呼び出しがなかった場合、この値はゼロになります。

パーセント

Failures

エラーで終了した実行の数。承認待ちの実行するはカウントされません。

数

Latency p50

実行する開始から完了またはエラーまでの中央値(承認待ち時間を含む)。

ms または s

Latency p95

実行するの開始から完了またはエラーまでの、95パーセントの実行するが終了した時間(承認待ち時間を含む)。

ms または s

レイテンシのメトリクスは、選択した期間のレイテンシデータが利用可能な場合にのみ表示されます。承認の詳細については、「Human-in-the-Loop エージェント Execution」を参照してください。

Usageセクションには、モデル、ツール、およびランタイムの消費量が表示されます。次の表は、このセクションのメトリクスについて説明しています。

メトリクス
説明
単位
LLM calls

言語モデルへの呼び出し回数。

数

Input tokens

言語モデルに送信されたトークンの数。

数

Output tokens

言語モデルによって返されたトークンの数。

数

Tool sandbox calls

ツールサンドボックスへの呼び出し回数。

数

Tool sandboxes

使用されたツールサンドボックスの数。

数

Workload runtime

選択した期間中にエージェントとツールのサンドボックスが実行された合計時間。

duration

Platform uptime

選択した期間中に、オーケストレーションエンジンやメモリサーバーを含む常時稼働のプラットフォームサービスが実行された合計時間。この値にはアイドル時間も含まれます。

duration

ワークロードのランタイムとプラットフォームの稼働時間を組み合わせたPod runtimeトレンドカードは、Customizeから利用できます。

Memory セクションには、エージェントのメモリのアクティビティが表示されます。次の表は、このセクションのメトリクスについて説明しています。

メトリクス
説明
単位
Docs written

選択した期間中にメモリに書き込まれたドキュメントの数。この値は、現在のメモリサイズではありません。

数

Docs retrieved

メモリから検索されたドキュメントの数。

数

Embedding tokens

埋め込みの生成に使用されたトークンの数。

数

Searches

メモリ検索の呼び出し回数。

数

Context tokens

エージェントのコンテキストに追加されたメモリトークンの数。

数

Memories consolidated

統合を通じて追加されたメモリの数。

数

エージェントのメモリについて詳しくは、「Agent Memory」を参照してください。

[Policy] セクションには、Policy エンジン が拒否した呼び出すことをカウントする [Policy denials] メトリクスが表示されます。

このメトリクスは、AUTHORIZED_TOOLS ポリシータイプ、および実行ポリシーとセッション予算ポリシーからの拒否をカウントします。このメトリクスは、AUTHORIZED_MODELS ポリシータイプからの拒否をカウントしません。詳細については、「ポリシータイプ」を参照してください。

Memory latency セクションには、メモリ操作のパフォーマンスが表示されます。各メトリクスは、選択した期間中にエージェントが関連するメモリ操作を実行した場合にのみ表示されます。

次の表は、セクション内のメトリクスについて説明しています。

メトリクス
説明
単位
Context latency p50

メモリコンテキストを検索する中央値。

ms または s

Context latency p95

メモリコンテキスト取得の 95 パーセントが完了するまでの時間。

ms または s

Write latency p95

メモリ書き込み (write)の95パーセントが完了した時間。

ms または s

Retrieval success

メモリ取得が成功した割合。

パーセント

Computeセクションにはリソースの使用状況が表示されます。このセクションはデフォルトで非表示になっています。このセクションを表示するには、Customizeを選択してからShow Computeを選択します。このセクションには、CPUとMemoryのトレンドカードが含まれています。

次の表は、セクション内のメトリクスについて説明しています。

メトリクス
説明
単位
CPU

選択した期間の平均CPU使用率。

Cores

CPU user

ユーザーモードでの平均CPU使用率。

Cores

CPU system

システム モードでの平均 CPU 使用率。

Cores

Memory

現在のメモリ使用量。

バイト

Disk

現在のディスク使用量。

バイト

Processes

現在のプロセス数。

数

Networking セクションには、プロジェクト全体の送信トラフィックが表示されます。このセクションはデフォルトで非表示になっており、プロジェクト全体のビューでのみ利用できます。セクションを表示するには、Customize を選択してから Show networking を選択します。

メトリクス
説明
単位
Egress throughput

平均送信トラフィックレート。

1秒あたりのバイト数

Egress packets

平均送信パケットレート。

1秒あたりのパケット数

Active peers

現在のアクティブなピアリングの数。

数

Peer registrations

登録されているピアリングの数。

数

Peer removals

削除されたピアリングの数。

数

Stale peers reaped

自動的に削除された非アクティブなピアの数。

数

トラフィックが複数のIPファミリーを使用している場合、このセクションには、各ファミリーのスループットとトラフィックのシェアを示すBy IP familyテーブルも表示されます。エグレスについて学ぶには、「ネットワークエグレスポリシーの管理」を参照してください。

Breakdowns セクションでは、使用状況がどのように分散されているかを示します。このセクションには、次の表が含まれています。

  • By model:各モデルのトークン使用量とシェア。

  • By pod type:各ポッドタイプの合計ランタイムと、全ポッドタイプの合計ランタイムに対する割合。オーケストレーションエンジンとメモリサーバーは、アイドル状態であってもランタイムが蓄積されます。

  • By tool: 各ツールの呼び出し回数とエラー率。

  • Compute by workspace各ワークスペースのCPU使用率と共有。この表は、Computeセクションを表示しているプロジェクト全体のビューでのみ利用できます。

  • By workspace: 各ワークスペースのトークン使用量と共有。使用量のない配置するワークスペースには 0 が表示されます。このテーブルは、プロジェクト全体のビューでのみ利用できます。

データが利用できない場合、原因に応じてページに次のメッセージが表示されます。

  • No metrics in this time range1hまたは24hの期間のメトリクスは存在しません。より長い期間を選択するか、エージェントを呼び出してください。

  • No metrics yet7dまたは30dの期間のメトリクスは存在しません。メトリクスは、プロジェクトでエージェントが実行された後に表示されます。

  • No data in this time range:選択した期間のデータがセクションまたはテーブルにありません。より長い期間を選択するか、選択した機能を使用するエージェントを呼び出してください。

  • Monitoring data isn't available in this environment yet: 環境に対してモニタリングが構成されていません。詳しく学ぶには、「エージェントのモニター」を参照してください。

  • Monitoring data couldn't be loaded: ページまたはセクションがデータを読み込めませんでした。ページは自動的に再試行されます。