uip insights

「uip insights」ツールを使用して UiPath Insights ダッシュボードにクエリを実行し、ジョブの実行分析を行うためのコマンドです。

uip insights クエリ UiPath Insights — ジョブの実行データ、アラート、およびデータのフィルター処理に使用するエンティティ (フォルダー、プロセス、キュー、マシン、ユーザー) に対する分析レイヤーです。このツールは、プリセットの Insights ダッシュボードとルックアップ リストをコマンドとして公開します。

uip tools install insightsでインストールするか、uip insights … を呼び出して自動インストールを実行します。基になるパッケージは @uipath/insights-toolです。コマンドプレフィックスは insightsです。インストール モデルについては「ツール (プラグイン)」を、ツールのインストールを管理するコマンドについては「ツール (プラグイン)」を、uip tools をご覧ください。

リソース

リソース	目的
ジョブ	概要、完了および未完了のジョブのタイムライン、上位の失敗、理由別の失敗、プロセスごとの内訳、失敗の詳細のドリルダウン。
アラート	設定されたアラートのリストを取得し、ID で 1 つ取得し、テナントのアラートの権利を確認します。
アラート履歴	アラート トリガーの履歴を一覧表示し、アラート メトリックを取得します。
アラート - 配信	1 つのアラート トリガーの配信の詳細を取得します。
ユーザー	ユーザーのリストを取得 - ジョブとアラートのデータをユーザーごとにフィルター処理します。
ロール	アクティブなテナントで定義されている Insights ロールを読み取ります。
Groups	アクティブなテナントの Insights グループとそのロール名を読み取ります。
filter-folders	リスト フォルダー - --folder-key フィルターで使用します。
フィルター - プロセス	リスト プロセス ( --process-name フィルターで使用)
filter-machines	マシンのリストを取得 ( --machine-name フィルターで使用)
フィルター - キュー	キューのリストを取得します。

概要

uip insights <resource> <verb> [options]

すべての uip insights 動詞は、 グローバル オプション (--output、 --output-filter、 --log-level、 --log-file) と標準の 終了コードに従います。--tenantオプションを使用するリソースはありません。すべての動詞は常に、uip login時に選択したテナントを使用します。

共有フィルター (ジョブ)

すべての insights jobs サブコマンドは、同じフィルターサーフェス(時間範囲、フォルダー、プロセス、マシン)を受け入れます。設定されたフラグは、[ ジョブ ] ページにインラインで記載されます。

時間範囲 が必要です。 --time-range渡すか、 --started-after と --started-before の両方を同時に渡します。ペアの 1 つのみを指定すると、どちらも提供していないものとして扱われます。--time-rangeを絶対ペアと組み合わせることは有効です。Insights バックエンドは、いずれか短い方の間隔に解決されます。その他のフィルターはすべて任意です。

認証

Insights のすべての呼び出しは、uip loginによって確立されたセッションを使用します。セッションが存在しない場合、CLI は Instructions: "Run 'uip login' to authenticate first." を使用してFailureを出力し、1を終了します。

参照

• ツール (プラグイン) — @uipath/insights-tool パッケージをインストール、更新、アンインストールします。
• uip login — Insights のすべての呼び出しに使用されるセッションです。
• uip traces — LLM Observability spans、直交する可観測性曲面。
• グローバル オプション
• 終了コード