- 基本情報
- ベスト プラクティス
- テナント
- Cloud ロボット
- フォルダー コンテキスト
- 自動化
- プロセス
- ジョブ
- Apps (アプリ)
- トリガー
- ログ
- 監視
- キュー
- アセット
- ストレージ バケット
- Test Suite - Orchestrator
- リソース カタログ サービス
- 認証
- Integrations
- クラシック ロボット
- トラブルシューティング
グリッドをバックグラウンドでエクスポートする
Orchestrator のオブジェクトはそれぞれの専用ページでグリッドに表示されています。グリッドには、そのオブジェクトのステータスの説明に役立つさまざまな列が含まれています。
これらのグリッドをエクスポートしてデータのバッチを取得し、後でダッシュボードやレポートの作成に使用できます。エクスポートの操作はバックグラウンドで行われます。ダウンロードの準備ができると通知が届くので、エクスポートの完了を待たずに Orchestrator の操作を続けることができます。
.csv
です。ダウンロード データには [マイ レポート] ページからアクセスできます。
グリッドをエクスポートできる Orchestrator オブジェクトは以下のとおりです。
- テナント レベル
- 監査ログ
- Test Automation の監査ログ
- フォルダー レベル
- キューのトランザクション
- ログ
- ジョブ
監査ログ、キューのトランザクション、ログ、ジョブのエクスポートは、テナントあたり 1 日 100 回までに制限されています。
この制限を超えると、テナントごとの 1 日あたりの制限に達したことを示す #4502 エラーが表示されます。
制限は 00:00 UTC にリセットされます。
[エクスポート] ボタンをクリックすると、[マイ レポート] ページにグリッドのコピーが作成されます。エクスポートの開始時と、エクスポートの完了時、またはエクスポートが失敗した場合は、ポップアップが表示されます。
エクスポートが完了すると、データがエクスポートされたことを知らせるアラートが送信されます。アラートの表示権限がある場合、レポートはブラウザーの既定のダウンロード場所に、バックグラウンドで自動的にダウンロードされます。ただし、[マイ レポート] ページにアクセスして好きな時にレポートをダウンロードすることもできます。
[マイ レポート] ページには、過去 168 時間 (7 日 x 24 時間) に作成したエクスポートのみが表示されます。168 時間を経過したエクスポートは完全に削除されます。たとえば、ある月の 1 日の 00:00 に作成されたエクスポートは、7 日の 23:59 まで利用できます。
エクスポートを確認するには、上部のナビゲーション バーにある [マイ レポート] アイコンをクリックします。
エクスポートで確認できるプロパティは以下のとおりです。
- エクスポートの種類 - Orchestrator のオブジェクトを参照します。
- [作成日時] - エクスポートを作成した相対時間のタイムスタンプです。
- 作成日時 (絶対時間) - エクスポートが作成された時刻の正確なタイムスタンプです。絶対時間のタイムスタンプはテナントのタイム ゾーンで表示されます。トリガーの次回の実行時刻はトリガーのタイム ゾーンで表示さるため、テナントのタイム ゾーンと異なる場合があります。
-
有効期限 - リストからエクスポートが削除される日付です。レポートは、示された日の 00:00 に削除されます。
これは、レポートがエクスポートされた後にのみ表示されます。
- サイズ - エクスポートのサイズです。これは、レポートがエクスポートされた後にのみ表示されます。
-
ステータス - エクスポート操作のステータスです。
- 新規 - エクスポートが進行中です。
- 完了 - エクスポートが完了しました。
-
失敗 - エクスポートに失敗しました。これは、SQL のタイムアウトまたは低ストレージによって発生する可能性があります。手動でエクスポートをリトライする必要があります。
エクスポートの解決に必要な計算時間は最大 15 分です。それを過ぎると、エクスポートは失敗します。エクスポートをリトライするには、あらかじめデータに追加のフィルターを適用してください。
重要:大量のデータのエクスポートが失敗しないようにするには、次の手順を実行します。
- 対応する Orchestrator オブジェクトの API エンドポイントを使用する必要があります。たとえば、監査ログをエクスポートするには
/odata/AuditLogs/UiPath.Server.Configuration.OData.Export
を使用します。
- 生成されるエクスポートの量は、頻度および取得するデータの量の両方の観点で、テナントのパフォーマンスに影響が出る場合があります。パフォーマンスに影響が出る場合、オートメーションが影響を受けないよう、このような要求に対してはスロットルやブロックが行われる可能性があります。
- エクスポートされるデータの量を減らすには、フィルターを適用します。
- 対応する Orchestrator オブジェクトの API エンドポイントを使用する必要があります。たとえば、監査ログをエクスポートするには
.csv
ファイルが含まれます。
エクスポートをデバイスにダウンロードするには、ストレージ ドメインを許可リストに追加する必要があります。詳細はこちらをご覧ください。
.zip
ファイルと .csv
ファイルの名前は、以下の命名規則に従います。
エクスポートされるオブジェクトの種類 |
ファイルの命名規則をダウンロードする |
---|---|
キューのトランザクション |
{queue-name}-items-{export-date}-{export-timestamp}-{export-id} キュー名に無効な文字 (
\ / : * ? " < > | ) が含まれている場合、_ に置換されます。
|
監査ログ |
audit-logs-{export-date}-{export-timestamp}-{export-id} |
ログ |
robot-logs-{export-date}-{export-timestamp}-{export-id} |
ジョブ | jobs-{job_folder_key}-{export-date}-{export-timestamp}-{export-id} |
場所:
- {queue_name} - エクスポートされるキュー アイテムを含むキューの名前です。
-
{job_folder_key} - ジョブ グリッドがエクスポートされるフォルダーの ID です。
- {export_date} - エクスポートが作成された日付です。形式は
yyyy-MM-dd
です。 - {export_timestamp} - エクスポートが作成された時刻です。形式は
HH-mm-ss-fff
です。 - {export-id} - エクスポートの ID です。
audit-logs-2023-01-27-12-29-40-843-24.zip
のようになります。
エクスポートされるレポートの時刻の列は、テナントのタイムゾーンで表されます。
-
エクスポートの API では
$select
、$top
、$skip
、$orderBy, and
はキーワードとしてサポートされていないため、使用を避けることを強くお勧めします。代わりに適切なフィルターを使用してください。$count
、 -
レポートのエントリは、
Id
(すなわち$orderBy=Id
) でのみ並べ替えられます。$orderBy
キーワードで使用した他のパラメーターは無視されます。 -
$filter=
構造を使用してフィルター処理すると、テーブルで利用可能としてマークされているフィールドのみが許可されます。 -
以下の表に示すように、サポートされていないフィールドを使用すると、400 エラーが返されます。
以下の表に、API を使用してキューのトランザクションをエクスポートすることで生成されるレポートで利用可能なフィールドと、そのフィールドをフィルター処理できるかどうかを示します。
API フィールド |
エクスポートされたレポートの対応する列 |
フィルター処理可能 |
---|---|---|
|
N/A |
|
|
Status |
|
|
リビジョン |
|
|
参照 |
|
|
Exception |
|
|
N/A |
|
|
処理期限 (絶対時間) |
|
|
優先度 |
|
|
Robot |
|
|
N/A |
|
|
延期 (絶対時間) |
|
|
N/A |
|
|
開始時刻 (絶対時間) |
|
|
N/A |
|
|
終了時刻 (絶対時間) |
|
|
トランザクション実行時間 |
|
|
前回の試行 ID |
|
|
AncestorUniqueKey |
|
|
リトライ回数 |
|
|
手動の親 ID |
|
|
ManualAncestorUniqueKey |
|
|
手動リトライ回数 |
|
|
UniqueKey |
|
|
固有データ |
|
|
キー |
|
|
レビュー担当者名 |
|
|
例外の理由 |
|
|
出力 |
|
|
N/A |
|
|
N/A |
|
|
分析データ |
|
|
N/A |
|
CreationTimeAbs |
作成時刻 (絶対時間) |
|
Progress | 進行状況 |
|
|
ID |
|
以下の表に、API を使用して監査ログをエクスポートすることで生成されるレポートで利用可能なフィールドと、そのフィールドをフィルター処理できるかどうかを示します。
API フィールド |
エクスポートされたレポートの対応する列 |
フィルター処理可能 |
---|---|---|
|
N/A |
|
|
N/A |
|
|
操作 |
|
|
コンポーネント |
|
|
N/A |
|
|
N/A |
|
|
操作 |
|
|
時刻 (絶対時間) |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
ユーザー (User) |
|
以下の表に、API を使用してロボット ログをエクスポートすることで生成されるレポートで利用可能なフィールドと、そのフィールドをフィルター処理できるかどうかを示します。
API フィールド |
エクスポートされたレポートの対応する列 |
フィルター処理可能 |
---|---|---|
|
N/A |
|
|
時刻 (絶対時間) |
|
|
レベル |
|
|
プロセス |
|
|
ホスト名 |
|
|
ホスト ID |
|
|
メッセージ |
|
|
N/A |
|
|
ロボット名 |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
API フィールド |
エクスポートされたレポートの対応する列 |
フィルター処理可能 |
---|---|---|
|
N/A |
|
|
N/A |
|
|
ステート |
|
|
優先度 |
|
|
ホスト名 |
|
|
ホスト ID |
|
|
マシン |
|
|
キー |
|
|
N/A |
|
|
プロセス |
|
|
Robot |
|
|
N/A |
|
|
環境 |
|
|
ジョブの種類 |
|
|
ランタイムの種類/ライセンス |
|
|
N/A |
|
|
開始時刻 (絶対時間) |
|
|
N/A |
|
|
終了時刻 (絶対時間) |
|
|
N/A |
|
|
ソース |
|
|
作成時刻 (絶対時間) |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|