uipath-insights について
uipath-insightsは、UiPathのジョブ、キュー、マシン、アラートを監視し、Insights RBACやMaestroプロセスダッシュボードを確認するスキルです。uip insightsコマンドで読み取り専用の調査やダッシュボード管理を行います。
主な機能
- 01ジョブの状態、傾向、失敗理由の監視
- 02キューの処理量、滞留、SLAリスクの分析
- 03マシンの状態、ランタイム、可用性の確認
- 04アラート履歴とアクセス権の読み取り
- 05Maestroプロセスダッシュボードの参照と管理
活用シーン
- 01期間ごとのジョブ実績の比較
- 02繰り返すプロセス失敗理由の特定
- 03キュー滞留とSLAリスクの確認
- 04アラート履歴やプロセスダッシュボードの確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ uipath/ skills --skill uipath-insightsインストール後、Claude Code で/uipath-insightsを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/alerts-reads-guide.mddashboard-reads-guide.mddashboard-writes-guide.mdexport-configurations-guide.mdfilter-discovery-guide.mdinvestigation-playbook-guide.mdjobs-commands-guide.mdlooker-dashboards-guide.mdmachine-monitoring-guide.mdqueue-monitoring-guide.mdrbac-reads-guide.md詳細
推論の予算
- ステップの難易度に応じて推論量を調整し、実行を優先します。機械的なステップでは、コマンドで処理できるなら、再度導き出すのではなく、コマンドを実行して出力を確認します。
- 深く掘り下げた推論は、コマンドでは判断できない点に使います。つまり、データがユーザーにとって何を意味するのか、失敗率が重要かどうか、そして証拠からは何が証明できないのかを考えることです。
- これを理由に回答を短くしてはいけません。タスクで求められたすべてのステップを最後まで完了してください。予算のルールと完全性が相反する場合は、完全性を優先します。これらのルールはやり直しを減らすためのものであり、必要な作業を省くためのものではありません。
作業スタイル
- まず理解し、それから判断します。 作業を始める前に、この SKILL.md と Shared Workflow のサブコマンド表を読み、推測ではなく、コマンドが実際に行う処理をもとに計画します。
- 最初に全工程を計画します。 コマンドを実行する前に、全体の手順を整理します。Critical Rule 2 では、1 つのシェル行で
uip insightsのサブコマンドを連結することが禁止されています。そのため、各コマンドを順番に実行するのではなく、質問全体をカバーできる 1 つのコマンドを選んでまとめて実行します。 - 入力を確認するのは 1 回だけです。 ガイドや応答を 1 度読んだら、その内容をもとに作業します。ファイルの項目ごとに再度開いたり、出力がすでにコンテキストにあるコマンドを再実行したりしてはいけません。
- 作業を繰り返しません。 入力と関連する状態に変更がない場合は、コマンドを再実行しません。また、すでにコンテキストにある変更されていないガイドや SKILL.md を読み直しません。
- コードは 1 度だけ書いて再利用します。 サブコマンドがすでに返す値を計算するために、ほとんど同じ
python3 -cやjqをインラインで複数回貼り付けてはいけません。 - 出力は小さく保ちます。 生のエンベロープではなく、必要な項目だけを抽出した結果を優先します。大きな読み取り結果の本文全体が必要な場合は、ファイルに保存してから確認します。
- 不要なことはしません。 今すぐ必要でない限り、ツールを呼び出したり、ガイドを読んだり、結果をコンテキストに取り込んだりしてはいけません。これは、実行すべきコマンドの選択ではなく、読む内容に適用されます。
UiPath Insights
uip insights は、ジョブ、キュー、マシンの監視、監視対象範囲の特定、読み取り専用のアラート確認、Insights の RBAC 読み取り、Maestro プロセスダッシュボードの読み取り、作成、更新、削除、コピーに使用します。コマンドを実行する前に、タスクに対応するガイドを読んでください。
このスキルを使用する場面
- テナント、フォルダー、プロセス全体におけるジョブの健全性、成功率、失敗数、処理時間
- 時間の経過に伴うジョブの傾向、または 2 つの期間の比較
- 失敗が最も多いプロセスと、繰り返し発生する失敗理由
- ジョブが停止しているか、保留中か、実行中かどうか
- クエリの対象を指定するための正確なフォルダーキー、プロセス名、キュー名、マシン名の特定
- キューアイテムの処理量、バックログ、SLA リスク、失敗理由、再試行されたアイテムの結果
- マシンの健全性:ランタイムの内訳、現在のステータスとスロット、稼働状況の推移、障害のランキング、ランタイムの分数
- 存在するアラート、その設定方法、アラートが発火したかどうか、トリガーされたアラートの配信方法
- テナントで Insights にアクセスできるユーザー、存在するロールとその権限、ロールが割り当てられているグループ
- Maestro プロセスの Monitoring タブに表示される内容:保存済みダッシュボードまたはテンプレート、保存済みのグローバルフィルター、ダッシュボードの作成、変更、削除、コピー
- Insights が組織のエクスポート先に引き続きアクセスできるかどうか、存在するエクスポート設定
- Looker 時代の Insights ダッシュボードの一覧、そのうち 1 つの埋め込み URL、埋め込みダッシュボードの読み込みに失敗する理由
重要なルール
--output jsonを使用します。jobsコマンドは{ Result, Code, Data }を返します。jobs investigateの各プレイブックにはInstructionsが追加されます。また、通常のjobs読み取りコマンド7つのうち4つ(top-failures、failures-by-reason、process-details、failure-details)、filter-*コマンド、queuesコマンドとmachinesコマンド、アラートコマンド、ダッシュボードコマンド、そして2つのlooker-dashboardsコマンドにもInstructionsが追加されます。さらに、filter-*、summary以外のすべてのqueuesコマンド、runtime-mix以外のすべてのmachinesコマンド、alerts list、alert-history list、dashboard-filters list、export-configurations list、looker-dashboards listにはPaginationも追加されます。一方、dashboardsのどの動詞にもPaginationはなく、export-configurations verifyにもありません。この動詞にはInstructionsだけが追加されます。対象となる行は組織が所有するすべての構成であり、ページ分割できないためです。説明では、これらのInstructionsを引用してください。失敗エンベロープにはResult、Message、Instructions、ErrorCode、Retryが含まれ、CodeとDataは含まれません。HTTP エラーにはhttpStatus、endpoint、場合によってはrequestIdとretryAfterを含むContextも含まれます。リクエスト送信前に発生した失敗にはContextがありません。CLI の JSON 出力では、Data内のキーは PascalCase です。そのため、completedJobsやfolderNameではなく、CompletedJobsとFolderNameを参照してください。jobsの読み取りコマンドは、バックエンドの幅広い DTO をそのまま出力するのではなく、名前付きの列にレスポンスを投影します。そのため、API にあると覚えているフィールドでも、よりわかりやすい名前になっていたり、存在しなかったりする場合があります。各読み取りコマンドが出力する内容は、jobs ガイドに記載されています。RBAC の読み取りコマンドは、ID フィールドを伏せた安全な投影を出力しますが、出力形式は関係ありません。完全な表示には、ファミリーごとに名前付きの include フラグが用意されているため、これらのコマンドでも--output jsonが適切です。- 1回の実行につきサブコマンドは1つだけを、そのまま記述します。 シェルで実行するのは
uip insightsコマンド1つだけで、それ以外は含めません。コマンドを連結、ループ、パラメーター化しないでください。&&や;による連結、改行で区切った複数コマンド、forループ、サブコマンド名やフラグ値を保持するシェル変数は使用しないでください。エポックタイムスタンプなどの値が必要な場合は、別のコマンドで先に求めてから、数値をそのまま渡してください。フラグ値に$(date ...)や$VARを記述してはいけません。 - ガイドに記載されたフラグのみを使用します。 ID、組織、テナントは、現在のセッションから取得されます。テナントフラグが見つかっても非推奨であり、
filter-*コマンドでは明示的に拒否されるため、使用しないでください。ガイドの共通オプション一覧にないフィルターは存在しません。 - 通常の読み取りコマンドでは時間範囲が必須で、単位はファミリーごとに異なります。 通常の
jobs読み取りコマンド7つでは、--time-range <minutes>(60 = 1h、1440 = 24h、10080 = 7d、43200 = 30d)を渡すか、--started-afterと--started-beforeの両方をエポックミリ秒で指定してください。queuesとmachinesのコマンドでは、jobsと同じ2つのフラグ名と単位を使用します。alert-historyコマンドにも時間範囲が必要ですが、絶対時間の境界はエポック秒単位の--sinceと--untilです。時間範囲を省略するとローカルで拒否されます。通常のjobs読み取りコマンドはResult: Failureを返して終了コード1となり、queues、machines、alert-historyは終了コード3となります。queuesとmachinesでは、サーバー側でも期間が30日に制限されます。この制限が適用される条件とCLIでの報告方法は、各ファミリーのガイドのルール2に記載されています。各jobs investigateプレイブックには代わりにデフォルトの期間があり、対応できない期間を指定するとResult: ValidationErrorを返して終了コード3となります。filter-*コマンド、アラート定義を読み取る3つのコマンド、ダッシュボードコマンド、export-configurationsコマンド、looker-dashboardsコマンドでは、時間フラグは指定しません。 - まず
summaryを実行し、その後に詳細を調べます。 タスクに必要なスコープの確認を済ませたら、ジョブの調査はuip insights jobs summaryで合計値を確認してから、対象を絞ったサブコマンドを実行します。キューの調査はuip insights queues summaryから始め、その後に対象を絞ったサブコマンドを実行します。サマリーが示す分母によって、失敗数の意味を把握できます。machinesファミリーにはサマリーがありません。テナント全体のランタイム内訳を確認する場合はuip insights machines runtime-mixでマシンの調査を始め、特定のマシンの現在の状態について尋ねられた場合はuip insights machines detailsを実行します。 - 空のデータは、範囲が限定された証拠として扱います。 結果が空でも、選択した時間範囲、最近のアクティビティ期間、呼び出し元の可視性、テナントのプロビジョニング状況が影響している可能性があります。アラートの読み取りでは、エンタイトルメントによるフィルタリングが影響する場合もあります。また、すべてのアラート定義読み取りコマンドは有効な定義のみを返します。空の結果は、リソースやイベントが一度も存在しなかったことの証明にはなりません。
- Insights APIを直接呼び出さず、CLIを使用します。 認証、テナントのルーティング、検証、安全なレスポンス投影、エラー処理はCLIが担います。
- 自動的に再試行しないでください。
Retryに基づいて対応します。RetryWillNotFixの場合は原因を修正し、RetryLaterの場合は報告して停止します。401 では新しいセッションが必要です。403 は権限の境界を示します。404 はテナントまたは可視性による制限の可能性があります。各ガイドには、それぞれのコマンドで発生するエラーの形式が記載されています。 uip loginを自分で実行しないでください。 対話型のブラウザーフローが開き、セッションが停止します。認証状態を報告し、ユーザーが実行する正確なコマンドを伝えてから停止してください。- 推測せず、識別子を確認します。 監視対象のスコープを解決するには
references/filter-discovery-guide.mdを使用し、アラートと配信の ID は一覧結果またはユーザーから取得してください。リソースが存在しないと結論づける前に、すべてのページの結果を確認してください。 - 原因調査は適切なツールに引き継ぎます。 Insights では、失敗したジョブ、プロセス、キューと、繰り返し発生する理由がわかります。個別のジョブやキュー項目で発生した例外の説明や、その修正方法はわかりません。理由を報告したうえで、原因の調査には
uipath-troubleshoot、修正にはuipath-rpaまたはuipath-agentsを案内してください。 - アラートへのアクセスは読み取り専用にします。 アラートガイドに記載された6つの読み取りサブコマンドだけが、許可された操作範囲のすべてです。アラート定義や配信に対する変更は、受信者、種類、構成に関するものも含め、すべてInsightsのUIで行います。その旨を伝え、自分が変更すると申し出ないでください。変更方法にかかわらず、このルールが適用されます。SDK、直接のHTTP呼び出し、または別のスキルを通じてアラートのルートにアクセスしてはいけません。
- アラートの発火と配信は分けて報告します。 履歴の行はアラートが発火したことを証明しますが、通知が送信または受信されたことは証明しません。また、どのアラート読み取りコマンドでも受信を確認することはできません。
- 作成するすべての内容からアラートの受信者データを除外します。 貼り付けるJSONも対象です。配信については種類と受信者数を報告し、「誰に通知されたか」という質問への回答は人数までにとどめてください。受信者の名前を挙げたり、生のアラートクエリJSONを引用したり、配信チャネルの設定を列挙したりしないでください。また、名前を特定するために別のコマンドやスキルを使用してはいけません。
- Insights RBACの操作は読み取り専用にします。 RBACガイドに記載された6つの読み取りサブコマンドだけが、許可された操作範囲のすべてです。ユーザーの作成、ロールの変更、アクセス権の割り当ては別の場所で行います。その旨を伝え、自分が実行すると申し出ないでください。変更方法にかかわらず、このルールが適用されます。SDK、直接のHTTP呼び出し、または別のスキルを通じてRBACのルートにアクセスしてはいけません。
- 作成するすべての内容からInsightsのIDデータを除外します。 貼り付けるJSONも対象です。ユーザーとグループは名前と数で要約してください。ユーザーとグループの読み取りで
--include-emailを指定するとメールアドレスとネストされたロール ID が含まれ、ロールの読み取りで--include-resourceを指定するとロールのリソース文字列が含まれます。ユーザーからこれらのフィールドのいずれかを求められた場合を除き、これらのフラグは指定せず、求められた場合に限り、そのフラグ名を引用してください。コマンド引数として識別子を渡すことは情報の開示ではありません。このルールは、あなたが書く内容に適用されます。 - ダッシュボードファイルは、リダイレクトした出力ではなく、アーティファクトチャネルから作成します。
dashboards get --output-file <path>でダッシュボードを読み取り、camelCase のファイルを編集してから、dashboards create --fileまたはdashboards update --fileに渡してください。同じ要件は--backup-fileと、コピーの--output-fileにも適用されます。リダイレクトしたCLIのJSONは PascalCase でラップされており、コマンドでは受け付けられません。 - ダッシュボードへの書き込みは一度だけ送信し、結果が不明なものは再送信しません。 まず対象のスロットを読み取ります。保存済みのダッシュボードがある場合、タスクは新規作成ではなく更新です。また、名前から解決したプロセスキーを書き込みに使用する場合は、事前にユーザーの確認が必要です。
unknown_errorが発生した場合は、スロットまたは ID を読み返し、書き込みガイドのエラー表とエンベロープ自体のInstructionsに従ってMessageと読み取り結果を確認します。RetryLaterは、その読み取り後にのみ再送信できます。拒否されたファイルは送信されていないため、修正して送信してください。更新では、新たに取得したプロセスキーの読み取り結果から--expected-versionを渡し、ルートにバージョンの前提条件がないため、この確認はベストエフォートであることを報告してください。--backup-fileとユーザーの明示的な依頼がない限り、削除を実行してはいけません。また、新規作成の拒否、更新の失敗、コピー先が使用中の場合に、やり直すために削除してはいけません。成功は、保存と読み戻しの完了として報告し、レンダリングは未確認としてください。
共通ワークフロー
-
タスクで UiPath Cloud を呼び出す場合は、アクティブなログインを確認します。
uip login status --output json -
このタスクについて、以下の Task Navigation テーブルで指定されているガイドを読みます。指定がない場合は、どのガイドも読みません。
-
ジョブを調査する場合は、自分でコマンドを連続実行するのではなく、
uip insights jobs investigateプレイブックを1つ実行します。実行に必要な情報はすべて以下のテーブルにあります。テーブルで疑問に答えられる場合、プレイブックのガイドを開かないでください。質問 プレイブック フラグ オートメーションの状態と成功率はどの程度ですか healthwindow(デフォルト 1440、最大 43200) どのプロセスが失敗しており、その理由は何ですか failingwindow(デフォルト 43200、最大 43200) 指定したプロセスが失敗する理由は何ですか process--process-name <name>(必須、値は1つ)、window(デフォルト 1440、最大 43200)ジョブが停止中、保留中、または実行中のままですか stuckwindow(デフォルト 1440、最大 43200) この期間は、その前の期間より良いですか、悪いですか comparewindow(デフォルト 10080、最大 21600) 名前で指定した1つのフォルダーに絞ったジョブの状態 folder--folder-name <name>(必須)、window(デフォルト 1440、最大 43200)プレイブックで指定できる期間の形式は1種類のみです。
--time-range <minutes>を使うか、--started-afterと--started-beforeの両方をエポックミリ秒で指定します。両方の形式を同時に指定した場合、上記の最大値を超える期間を指定した場合、または絶対期間の開始日時が30日を超えて古い場合は拒否されます。各拒否はローカルで発生し、Result: ValidationErrorと終了コード3が返され、リクエストは送信されません。通常のjobs読み取りではこれらのチェックは行われません。両方の形式を同時に受け付け、期間が広すぎる場合や開始日時が古すぎる場合も、通知せずにサーバーへ渡して補正させます。compareの最大期間が他のプレイブックの半分なのは、同じ長さの隣接する期間を2つ読み取り、どちらもサーバーの30日間の上限内に収める必要があるためです。各プレイブックが独自に期間の境界を解決するため、dateを使って境界を作成しないでください。すべてのプレイブックで--timezone-offset <minutes>も指定でき、バケットのタイムスタンプをクライアントのオフセットに合わせてずらせます。スコープフィルターはプレイブックごとに異なります。
health、failing、stuck、compareでは、繰り返し指定できる--folder-key、--process-name、--machine-nameを使います。processでは--folder-keyと--machine-nameに加えて、独自の--process-nameを使います。回答で1つのプロセスを指定するため、このオプションの値は1つです。folderでは--process-nameと--machine-nameを使い、--folder-nameが1つのキーに解決されるため、--folder-keyは使いません。各プレイブックは、他のすべてのコマンドと同じ{ Result, Code, Data }エンベロープを返します。また、数値に関する注意事項を示すInstructions文字列も返すため、説明ではその注意事項を引用してください。investigateでunknown commandが報告された場合、インストール済みの CLI はその機能に対応していません。ユーザーに更新(npm i -g @uipath/cli)を案内し、この実行ではreferences/investigation-playbook-guide.mdに記載された番号付きのコマンド連鎖に切り替えてください。 -
それ以外の場合はサブコマンドを実行し、結果を得るために
Dataを解析します。リスト系のサブコマンドでは、リストがすべて取得できているか確認するためにPaginationも読み取ります。サブコマンドの名前が指定されたリクエスト、またはすべてのサブコマンドを求めるリクエストは、7つの通常の
jobs読み取りを意味します。それらを実行してください。プレイブックは質問への回答に使うものであり、名前を指定された読み取りの代わりにはなりません。また、「すべてのサブコマンドを実行する」という依頼にも該当しません。呼び出し元が未加工のレスポンスを求めている場合も、通常の読み取りを使うと、投影も上限も適用されていない本体を取得できます。
デフォルトでは、アクティブな Production セッションを使用します。ユーザーが別の環境またはスコープを明示した場合に限り、権限、組織、またはテナントを変更します。コマンドはユーザーに提示し、自分では実行しないでください。
uip login --authority https://cloud.uipath.com --tenant MyTenant # named environment
uip login tenant set MyTenant # same environment, different tenant
タスクのナビゲーション
| ユーザーのタスク | 最初に読むもの |
|---|---|
| ジョブの状態、成功率、傾向、失敗、停止中のジョブを確認する、または期間を比較する | なし。Shared Workflow のステップ 3 から jobs investigate プレイブックを実行します。質問に適したプレイブックがない場合、または CLI に該当する動詞がない場合に限り、references/investigation-playbook-guide.md を読みます |
| Jobs のサブコマンド、フラグ、期間を選ぶ、または応答フィールドを解釈する | references/jobs-commands-guide.md |
| 表示可能なフォルダー、プロセス、キュー、マシンを確認する、またはフィルターに使用する正確なフォルダーキー、プロセス名、マシン名を特定する | references/filter-discovery-guide.md |
| キュー項目の合計、SLA のリスク、時間経過に伴う状態、失敗、再試行の結果について報告する | references/queue-monitoring-guide.md |
| マシンのランタイム構成、状態とスロット、稼働可能な時間帯、障害のランキング、ランタイムの分数について報告する | references/machine-monitoring-guide.md |
| アラートの定義、アラート機能の利用権限、トリガー履歴、配信メタデータを調べる | references/alerts-reads-guide.md |
| Insights のユーザー、ロール、グループを調べる | references/rbac-reads-guide.md |
| Maestro プロセスの監視ダッシュボード、その定義、保存済みのグローバルフィルターを確認する | references/dashboard-reads-guide.md |
| Maestro プロセスの監視ダッシュボードを作成、更新、削除、コピーする | references/dashboard-writes-guide.md |
| どの統合エクスポート構成が存在するか、または Insights から送信先に引き続きアクセスできるかを報告する | references/export-configurations-guide.md |
| Looker 時代の Insights ダッシュボードを一覧表示する、またはダッシュボードの埋め込み URL を生成する | references/looker-dashboards-guide.md |
タスクに必要なガイドだけを読みます。フォルダー、プロセス、マシンを最初に特定する必要があるジョブの調査では、フィルターガイドを読んでから Jobs ガイドを読みます。キューについての質問でキュー名が指定されている場合は、フィルターガイドで正確な名前を確認してから、キューガイドを読みます。マシンについての質問でマシン名が指定されている場合は、フィルターガイドで正確な名前を確認してから、マシンガイドを読みます。マシンガイドには、filter-machines list では報告されない 5 種類のマシンタイプラベルも記載されています。アラートについての質問では、定義、履歴、配信の手順全体を扱うアラートガイドだけが必要です。Insights のアクセスについての質問では、RBAC ガイドだけが必要です。ダッシュボードについての質問では、ダッシュボード読み取りガイドが必要です。書き込みを行う場合は、その後に書き込みガイドも必要です。プロセスキーはユーザーから取得するか、uip maestro bpmn processes list で取得します。ダッシュボードを見つける filter-* コマンドはありません。
スコープの境界
uip insights には、8 つのコマンドファミリーが含まれます。jobs、queues、machines、filter-* 検索コマンド、アラートの読み取りコマンド(alerts、alert-history、alert-deliveries)、RBAC の読み取りコマンド(users、roles、groups)、Maestro ダッシュボードコマンド(dashboards、dashboard-filters)、統合エクスポートの読み取りコマンド(export-configurations)、およびLooker時代のダッシュボードの読み取りコマンド(looker-dashboards)です。jobs ファミリーには、7 つの読み取りコマンドと、呼び出しごとに調査プレイブックを 1 つ実行する jobs investigate があります。これ以外が必要な場合は、サブコマンドを推測せず、利用できないことを伝えてください。
| リクエスト | 対応先 |
|---|---|
| 個々のジョブとその現在の状態を一覧表示または取得する。Insights が保持するのは期間内の履歴集計であり、稼働中のジョブレコードではありません | uipath-platform(uip or jobs list --state) |
| 個々の Orchestrator ジョブを開始、停止、再起動する、またはログを調べる | uipath-platform |
| 特定のジョブエラーの根本原因を診断する | uipath-troubleshoot |
| 失敗の原因となったワークフローまたはエージェントを修正する | uipath-rpa または uipath-agents |
個々のキューアイテムを一覧表示、追加、再試行、削除する。queues はキューアイテムを集計して報告するもので、個別のアイテムを変更することはありません | uipath-platform |
| アラートまたは配信に関する書き込み操作(重大なルール 12 を参照) | Insights UI。提供されている uip insights の機能には含まれません |
| マシンの作成、編集、削除、またはランタイムの管理 | uipath-platform。machines はマシンについて報告するもので、変更することはありません |
| マシンまたはロボットの容量に対する使用率(パーセンテージ)、あるいは期間内のランタイムから算出した平均同時実行数や「ロボット相当」数 | 提供されている uip insights の機能には含まれません。machines utilization が報告するのは容量の分母を持たないランタイム分数であり、これを期間で割ると存在しない値を作り出すことになります |
| Maestro プロセスのモニタリングダッシュボード、または保存済みのグローバルフィルターを読み取る | references/dashboard-reads-guide.md |
| Maestro プロセスのモニタリングダッシュボードを作成、更新、削除、またはコピーする(重大なルール 17 と 18 を参照) | references/dashboard-writes-guide.md |
| Insights にテキストプロンプトからダッシュボードを生成させる(製品独自の生成機能) | Insights UI。提供されている uip insights の機能には含まれません。ユーザーの説明に基づいて定義を作成する場合は、書き込みガイドを参照してください |
| Insights の RBAC に関する書き込み操作(ロールの割り当てなど。重大なルール 15 を参照) | Insights UI。提供されている uip insights の機能には含まれません |
| Insights の外部で組織レベルのユーザーアカウント、グループ、ロールを管理する | uipath-admin |
| 統合エクスポート設定の作成、編集、削除、または新しいエクスポート先の設定 | Insights 管理 UI。提供されている uip insights の機能には含まれません |
| エクスポートがエクスポート先に届かなくなった理由 | まず references/export-configurations-guide.md で、Insights が引き続きエクスポート先に接続できるかを確認し、次にエクスポート先側について uipath-troubleshoot を使用してください |
| Looker時代のInsightsダッシュボードを一覧表示する、またはダッシュボードの埋め込みURLを取得する | references/looker-dashboards-guide.md |
| Looker時代のダッシュボードを作成、更新、削除、エクスポート、または複製する | Insights UI。提供されている uip insights の機能には含まれません |
アンチパターン
jobsコマンド、dashboardsのいずれの動詞、またはlooker-dashboards get-embed-urlに--limitや--offsetを追加しないでください。これらはどれも受け付けません。ダッシュボードコマンドのうちページネーションに対応しているのは、dashboard-filters listとlooker-dashboards listのみです。どのコマンドがページネーションに対応しているかは、各ガイドに記載されています。- 例の識別子を再利用しないでください。フォルダーキー、プロセス名、マシン名、キュー名は
filter-*の結果またはユーザーから取得し、例外理由はfailures-by-reasonの行から取得します。Maestro のプロセスキーはユーザーまたはuip maestro bpmn processes listから取得し、ダッシュボード ID はdashboards get、dashboards create、またはdashboards copyの結果から取得します。 - 空または
falseのアラート結果を、証明として読み取らないでください。結果によって何が除外され、何が未解決のままかを報告してください。 - 安全なビューで非表示になるフィールドをユーザーが求めていない限り、RBAC の読み取りに
--include-emailや--include-resourceを渡さないでください。 - 接続文字列、アクセスキー、API キーを、いずれの
export-configurationsコマンドにも渡さないでください。verify <id>は Insights に保存されている認証情報を使用し、認証情報を受け取るコマンドはありません。 - 発行された Looker 埋め込み URL は、回答以外の場所に貼り付けないでください。これはユーザーごとに署名された認証情報であり、リンクではありません。
完了時の出力
回答、照会した期間、有効な組織とテナント、適用したフィルターを記載して締めくくってください。リスト結果については、すべてのページを取得したかどうかを示してください。権限による制限がある結果や空の結果については、その結果によって証明できることとできないことを明記してください。