アプリケーション > アプリケーション > アプリケーションの監視

アプリケーションの監視¶

アプリケーションを継続的に監視することで、問題の事前検知、パフォーマンスのボトルネックのトラブルシューティング、サービス中断への迅速な対応が可能になります。これにより、ダウンタイムを最小限に抑え、ユーザーエクスペリエンス全体を向上させることができます。監視情報にアクセスするには、アプリケーションページに移動し、表示したいアプリをクリックします。

ここから、以下の監視オプションにアクセスできます。

サービスの正常性：メモリー、CPU、およびネットワークの使用状況を表示するダッシュボードを提供します。
アクティビティログ：アクセス、ランタイム、ビルド、およびバージョン履歴のログを表示します。
トレース：モデルまたはエージェントワークフローからのトレースが表示されます。トレースの検索やフィルター、所要時間やトークン使用量の確認、スパンの展開による属性、ログ、入力、出力の表示ができます。

リソースの使用状況¶

サービスの正常性を確認する権限

アプリケーションのオーナー権限を持つユーザーとDataRobot管理者のみがサービスの正常性にアクセスできます。

サービスの正常性タブでは、個々のアプリケーションの使用状況、サービスの正常性、およびリソースの消費量を監視できます。リソース消費の監視は、コスト管理に不可欠であり、リソースが効率的に使用されるため、コストの最適化に役立ちます。

アプリケーションの監視機能にアクセスするには、アプリケーションページで、表示したいアプリをクリックし、サービスの正常性を選択します。ここから、次のことができます。

	要素	説明
1	時間の範囲/単位	チャートに表示する時間の範囲と単位を調整します。単位ドロップダウンのオプションは、選択した範囲に基づいています。
2	表示を更新	使用状況に関する情報を即座に更新します。この情報は1分ごとに自動的に更新されます。
3	リソースの使用状況	指定された時間範囲におけるCPU使用率、メモリー使用量、ネットワーク使用量の各平均値と、リアルタイムの使用状況を表示します。タイルをクリックすると、下のグラフで使用状況に関する情報を視覚的に確認できます。
4	使用状況チャート	選択された使用状況タイルおよび指定された時間範囲について、時間経過に伴う使用情報を視覚的に表示します。 CPU使用率については、平均使用率を表す線を表示することもできます。

アクティビティログ¶

ログの閲覧権限

アプリケーションのアクティビティログにアクセスするには、アプリケーションのオーナーまたはエディター権限が必要です。アプリケーションソースを共有しても、アクティビティログへのアクセス権は付与されません。

DataRobotでは、カスタムアプリケーションに対して以下のアクティビティログを記録します。

アクティビティログ	説明
アクセスログ	どのユーザーがいつアプリケーションにアクセスしたかを表示します。
ランタイムログ	実行中のアプリケーションのタスクのリアルタイムの記録を表示します。
ビルドログ	アプリケーションのデプロイプロセスの履歴を表示します。
バージョン履歴ログ	タイムスタンプが付与された、アプリケーションのバージョンの時系列の記録を表示します。

これらのアクティビティログにアクセスするには、アプリケーションページから、表示したいアプリをクリックし、アクティビティログを選択します。

ビルドログとランタイムログ¶

ビルドログおよびランタイムログタブでは、カスタムアプリケーションのコンパイル、構築、および実行の履歴を詳細に示すログを閲覧できます。これには、依存関係のチェック、パッケージ化、および発生した警告やエラーが含まれます。

アクセスログ¶

アクセスログタブから、カスタムアプリケーションを開いたり操作したりしたユーザーの履歴を監視できます。

また、アプリケーションソースから直接アクセスログを表示することもできます。 レジストリ > アプリケーションのソースに移動して、カスタムアプリケーションのアプリケーションソースを見つけ、ドロップダウンを展開して、ソースから構築されたアプリケーションを表示します。次に、アクセスログを表示したいカスタムアプリケーションをクリックし、詳細表示にアクセスします。

概要タブで、アクセスログセクションまでスクロールダウンします。

アクセスログには、メールアドレス、ユーザーID、アクセス日時、アプリケーションに対するユーザーのロールなど、ユーザーによるアプリケーションへのアクセスの詳細が記録されます。

利用状況のロギング間隔

最初のアクセスイベントに加えて、アプリケーションへのアクセスまたは使用が、24時間ごとに個別のアクセスとして記録されます。たとえば、ユーザーがアプリケーションを開くとアクセスイベントがログに記録され、そのユーザーセッションが24時間を超えて継続的にアクセスまたは使用されると、別のアクセスイベントがログに記録されます。これにより、カスタムアプリケーションを24時間1分アクセスすると、2つのアクセスイベントが記録されます。セルフマネージドAIプラットフォーム環境では、この間隔はアプリケーション設定のCUSTOM_APP_USAGE_METRIC_PUBLISH_MAX_FREQによって変更可能です。

トレース¶

トレースを表示するために必要な権限

トレースタブへのアクセスには、アプリケーションのオーナーまたはエディター権限が必要です。アプリケーションソースを共有しても、アプリケーショントレースへのアクセス権は付与されません。

アプリケーションのトレースタブには、モデルまたはエージェントワークフローからのトレースが表示されます。各トレースには、スパンリストとタイムラインが組み合わされたものが含まれ、モデルまたはエージェントによって実行されたアクションの順序と所要時間が示されます。検索行を使用して、最新のタイムスタンプ、ステータス（成功またはアラート）、および生成タイプ（オペレーションスパンまたは生成固有のスパン）を含むタイプでトレースを絞り込むことができます。アプリケーションのトレースでは、デプロイのトレースと同じインターフェイスが使用されます。

ローカルでエージェントを開発している間、カスタムのOpenTelemetryスパンと属性（たとえば、ランタイム設定値）を追加できます。これにより、デプロイ後にトレースに表示されるようになります。セットアップ手順とコード例については、エージェントにカスタムトレースを追加するを参照してください。

トレースは、モデルまたはエージェントのワークフローに対するリクエストがたどった経路を表します。 DataRobotでは、トレースにOpenTelemetryフレームワークを使用しています。 トレースは、起点から解決まで、リクエストのエンドツーエンドの経路全体を追跡します。各トレースには、ルートスパンから始まる1つ以上のスパンが含まれます。 ルートスパンはリクエストの経路全体を表し、プロセスの各ステップの子スパンが含まれます。ルート（または親）スパンと各子スパンは、同じトレースIDを共有します。

アクセスと保持

トレースは、カスタムアプリケーション、カスタムおよび外部モデルのデプロイ、ワークロードで利用可能です。アプリケーション、デプロイ、およびワークロードは、同じトレースインターフェイスを共有しています。

保持期間は、システム管理者が組織レベルで設定し、その組織内のすべてのユーザーに適用されます。ポリシーが明示的に設定されていない場合、トライアル版利用の組織には14日間のポリシーが、有料版利用の組織には30日間のポリシーが適用されます。管理者は、シグナルタイプ（トレース、ログ、メトリクス）ごとに、保持期間を14、30、60、90、180、または360日に設定できます。

組織の保持期間設定を確認または変更するには、OTelの保持期間の設定を参照してください。

トレースは、ルートスパン名ごとにリストに表示されます。各エントリーには、トレースのステータスとタイムスタンプが表示されます。トレースを選択すると、詳細ペインが開き、リクエストの概要メタデータ、および統合されたスパンリストとタイムラインが表示されます。

リクエストに応じて、リストおよび詳細ペインには以下のフィールドが含まれる場合があります。

フィールド	説明
ルートスパン名	トレースのルートスパンの名前。
タイムスタンプ	トレースの日付と時刻。
ステータス	すべてのスパンを含む、トレースの全体的なステータス（例：成功）。依存タスクが失敗した場合、ステータスはエラーになります。
トレースID	トレースの一意の識別子。
ユーザーID	リクエストに関連付けられたユーザー（存在する場合）。
待ち時間	トレースが完了するまでにかかった時間。この値はルートスパンの継続時間と等しく、子スパンによって表されるすべてのアクションが含まれます。
トークン	トレースにおけるトークンの使用量。
スパン	トレースに含まれる完了したスパン（アクション）の数。
エラー	エラーが記録されたトレース内のスパン数。
コスト	コストデータが指定されている場合は、トレースの総コスト。
プロンプト	トレースに関連するユーザープロンプト。
補完	トレースのプロンプトに関連付けられているエージェントまたはモデルの回答（補完）。
ツール	トレースで表されたリクエスト中に呼び出されるツールまたはツール群。

トレースの検索とフィルター¶

トレースを検索するには、トレースリストの上にある検索行を使用します。

フィルター	説明
最新のタイムスタンプ	トレース内の最新のアクティビティの時刻に基づいてトレースを絞り込みます。
ステータス	成功またはアラートのステータスに基づいてトレースを絞り込みます。
タイプ	生成タイプを含むタイプに基づいてトレースを絞り込み、運用スパンと生成固有のスパンを区別します。

スパンの確認¶

トレースを選択すると、そのスパンを確認できます。スパンリストとタイムラインが一緒に表示されます。各行にはスパン名、継続時間、トークンの使用量が表示され、タイムラインチャートでは、トレース全体の中でそのスパンがいつ実行されたかが示されます。親スパンを展開すると、その子スパンが表示されます。スパンに関連付けられたデプロイまたはサービスへのアクセス権がない場合、制限付きスパンと表示されます。

スパンビューでは、継続時間、トークン、名前、ステータスコードでスパンをフィルターしたり、同一のスパンを抽出したりできます。

スパンを選択すると、概要メタデータ、ログ、入力、出力、およびその他のメタデータが同じページで確認できます。スパン内のフォーマット済みテキストは、属性と並んで表示されます。スパンサービスまたはモデル名をクリックすると、デプロイまたはリソースにアクセスできます（アクセス権がある場合）。

スパンを展開すると、スパン属性、入力、出力とともにログが表示されます。表示される結果は、完全なデプロイログの一部です。

トレーステーブルのOTel属性¶

コスト、プロンプト、補完、およびツールについては、DataRobotはトレースに属するすべてのスパンにわたる特定のスパン属性を読み取ります。その他のフィールド（タイムスタンプ、レイテンシー、トークンなど）は、これらの属性ではなく、トレースおよびスパンのメタデータから取得されます。

列	OpenTelemetryのマッピング
コスト	トレース内のスパンにある `datarobot.moderation.cost`属性の数値を合計します（その属性が存在する場合）。
プロンプト	`gen_ai.prompt`属性を使用します。複数のスパンに`gen_ai.prompt`が含まれている場合、トレース順で最初に検出された値が表示されます。
補完	`gen_ai.completion`属性を使用します。複数のスパンに`gen_ai.completion`が含まれている場合、トレース順で最後に検出された値が表示されます。
ツール	トレース内のスパンで検出された`tool_name`属性の一意の値をすべて収集し、それらのツール名を列に一覧表示します。

属性キーは完全に一致する必要があります（gen_ai内のアンダースコアも含みます）。 genai.promptやGenAI.promptといった名前は、プロンプトおよび補完列では読み込まれません。

自動計装（DataRobotのエージェントテンプレートを含む）では、多くの場合、gen_ai.prompt、gen_ai.completion、そして場合によってはtool_nameが設定されます。カスタムモデルや外部モデルの場合、フレームワークが異なります。ツールが実行されても（たとえば、一部のLangGraphコールバックフロー）、実行時にtool_nameが出力されない場合があります。その場合、プロンプトと補完には値を設定できますが、ツールについては、ツール内で実行されるスパンにtool_nameが設定されるまでは空のままになります。トレースの実装を参照してください。