---
sourceDocument: Xanadu プラットフォームアナリティクス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/now-intelligence

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu プラットフォームアナリティクス

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# データ収集ジョブの作成またはスケジュール

# データ収集ジョブの作成またはスケジュール {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：8分

パフォーマンスアナリティクスインジケーターのスコアとスナップショットを定期的に収集するようにデータ収集ジョブをスケジュールします。

## 始める前に

データ収集ジョブを定義する前に、インジケーター ソース、ブレークダウン ソース、およびインジケーターが定義されていることを確認してください。そうしないと、ジョブは結果を返すことができません。

必要なロール：pa_data_collector または admin

## このタスクについて

データ収集ジョブを構成するときに知っておくべき重要な項目は、次のとおりです。

* 収集期間
* 収集タイムゾーン
* ドメインが使用される場合は、収集されるスコアのドメイン。
* コレクション ジョブは、どのような制限もなく実行されます。実行するユーザーの権限は使用しません。
{#t_CreatASchedDataCollJob__ul_qyh_crt_qbb}

データ収集ジョブは、スコアを収集するため、およびテキスト分析データを収集するために、異なるステップを実行します。デフォルトでは、ジョブは両方のタイプのデータを収集します。パフォーマンスを向上するため、スコアとテキスト分析データに別々のジョブをスケジュールすることもできます。

## 手順

1. 移動先 すべてPerformance Analytics (パフォーマンスアナリティクス)データコレクタジョブ をクリックし、\[ New\] をクリックします。  
   代わりに、ジョブの実行スケジュールを変更するなど、既存のデータ収集ジョブを編集することもできます。この場合は、 Performance Analytics (パフォーマンスアナリティクス)データコレクタジョブ をクリックし、ジョブ名をクリックします。
2. \[名前\] フィールドには、わかりやすい名前を付けます。  
   \[PA インジケーター\] 日次データ収集や \[PA インジケーター\] 履歴データ収集など、データ コレクタ ジョブの命名のための標準形式に従います。
3. \[演算子\] フィールドで、データ収集を絶対時間でするのか、または相対時間でするのか選択します。

   | 演算子の値 | 説明 |
   | 期間指定 | 絶対時間のデータを収集します。 |
   | 相対指定 | ジョブが実行された時間を基準として特定期間のデータを収集します。 |
   |-|-|

   {#t_CreatASchedDataCollJob__choicetable_y4r_n1h_4bb}
4. \[期間指定\] を演算子として選択した場合、\[開始日（固定）\] 日付と \[終了日（固定）\] 日付を選択します。
5. \[相対\] を演算子として選択した場合、データを収集する実行時間より前の間隔を指定します。
   1. \[開始日（相対）\] と \[開始日指定（相対）\] のフィールドで、データを収集する過去の期間の数と長さをそれぞれ設定します。
   2. \[終了日（相対）\] と \[終了日指定（相対）\] のフィールドで、データの収集を開始する過去の最後の期間の数と長さをそれぞれ設定します。  
      ヒント:  
      * ほとんどのインジケーター、つまりほとんどのデータ収集ジョブは毎日実行されます。通常、日次スケジュール済みジョブは、最後に完了した日について収集する必要があります。したがって、1 日前の相対的な開始と相対的な終了の両方が必要です。収集期間が長い履歴データ収集ジョブは、一度だけ実行します。
      * ビジネスカレンダーを使用するインジケーターでこのジョブを使用する場合は、 前の期間 の間隔を考慮してください。この間隔は、ビジネスカレンダーに定義されている期間に基づいています。
      {#t_CreatASchedDataCollJob__ul_r5w_mcx_2nb}  
      たとえば、同じインジケーターソースを使用して、日次頻度で複数の新しいインジケーターのセットのスコアを収集するとします。まず、2 か月前から昨日までのデータを収集する履歴データ収集ジョブを作成します。このジョブで、\[開始日（相対）\] に 60 を、\[開始日指定（相対）\] に日前を入力します。\[終了日（相対）\] に 2 を、\[終了日指定（相対）\] に日前を入力します。\[実行\] フィールドを \[オンデマンド\] に設定します。\[今すぐ実行\] をクリックし、このジョブを 1 回実行して最初のスコアを収集します。

      開始日 (相対) と終了日 1 日前で 2 番目のジョブを作成し、\[実行\] フィールドを \[日次\] に設定します。このジョブを有効化し、昨日のスコアと、そのジョブが実行される前日について、将来のスコアをすべて収集します。
   {#t_CreatASchedDataCollJob__substeps_vr2_gch_4bb}
6. 必要に応じて \[ジョブパラメータ\] を入力します。  
   {#t_CreatASchedDataCollJob__tbl_PerformanceAnalyticsDataCollectionJobProperties__entry__2}

   | ジョブ パラメータ | 説明 |
   |-|-|
   | 実行方法 | ドメインセパレーションインスタンスの場合は、このジョブを実行するユーザーを選択します。このジョブは、グローバルドメインを持つか、このユーザーのドメイン内にあるファクトテーブルと パフォーマンスアナリティクス レコードからスコアを収集します。 データ収集ジョブはドメインのみに従い、このユーザーの権限は実行されません。ACL およびビジネスルールは、データ収集ジョブには適用されません。すべてのユーザーがジョブを実行できます。 重要: このジョブのドメイン構成を選択すると、 実行ユーザーが上書き されます。このトピックの手順 [9](https://servicenow-prod.fluidtopics.net/qLHKgYKXro0IPaRHsrZnqQ#t_CreatASchedDataCollJob__step_domain-config) を参照してください。 |
   | Run as tz (実行時のタイムゾーン) | クエリがジョブから実行されるときに使用するタイムゾーンを選択します。会社のレポートタイムゾーンがある場合は、それを使用します。デフォルトでは、システムのタイムゾーンが使用されます。 このタイムゾーンは、\[\[Opened\]\[on\]\[Today\]\] のような条件の "今日" の日を決定します。 |
   | アクティブ | オンの場合、デフォルトではスケジュールされた日時にデータ収集が行われます。 |
   | 実行 | データを収集するスケジュールを選択します。選択肢は次のとおりです。 * 日次 * 週次 * 月次 * 定期的 * 1 回 * オンデマンド {#t_CreatASchedDataCollJob__ul_err_n2v_hp} ビジネスカレンダーを使用している場合は、ビジネスカレンダー期間の開始と終了に次のオプションもあります ( [ビジネスカレンダーエントリの定義](https://www.servicenow.com/docs/access?context=define-business-calendar-entries&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)を参照)。 * ビジネスカレンダー: エントリ開始 * ビジネスカレンダー: エントリ終了 {#t_CreatASchedDataCollJob__ul_f55_v4d_4mb} 履歴データ収集ジョブを作成する場合は、オンデマンドで実行するようにジョブをスケジュールします。 |
   | 曜日 | * \[実行\] が \[週次\] の場合は、曜日を指定します。 * \[実行\] が \[月次\] の場合は、日付を指定します。 {#t_CreatASchedDataCollJob__ul_lkx_k2v_hp} 月末に収集するには、1 日目に設定し、\[ 時刻 \] を午前 0 時過ぎに設定します。この設定では、月の長さに関係なく、完了した月のデータが収集されます。 |
   | 繰り返し間隔 | \[実行\] が \[定期的\] の場合は、スケジュールされるデータ収集の間隔を日数と時間数で指定します。 |
   | 開始中 | \[実行\] が \[定期的\] または \[1 回\] の場合、スケジュールされる最初のデータ収集の日時を指定します。 |
   | 時刻 | ジョブの実行時刻 (24 時間形式)。フィールドは \[アクティブ \] を選択した後に表示されます。 * 実行 時のタイム ゾーンではなく、ユーザーセッションのタイムゾーンに基づく時間。 * 通常、会社で午前 0 時から午前 6 時までの 1 時間に設定して、最後の完全な期間を収集します。 {#t_CreatASchedDataCollJob__ul_l3k_gts_yjb} たとえば、ニューヨークにいて、ロサンゼルス時間の会社のデータを午前 5 時に収集する場合は、時刻を 08:00:00 に設定します。 |
   | Collect (収集) | データ収集ジョブには、スコア収集とテキスト分析の収集のために個別のステップがあります。次のいずれかを選択します。 * スコアのみ * テキストインデックスのみ * スコアとテキストインデックスの両方 (デフォルト) {#t_CreatASchedDataCollJob__ul_hqv_2sl_sbb} 詳細については、「[テキスト分析の設定](https://servicenow-prod.fluidtopics.net/gryrDTHg6H1hMNOOrY30Vw "分析するテキスト フィールドと分析するインジケーターを選択します。")」を参照してください。 |
   | 条件節 | オンにすると、特定の条件が満たされた場合にのみデータ収集が行われます。 |
   | 条件 | スケジュール済みジョブを実行するかどうかを決定する条件付きスクリプト。スクリプトの最後の式はブール値 (true/false) で評価されます。このテキストボックスは、\[条件を使用 (Use conditions)\] を選択した場合にのみ表示されます。 警告: パフォーマンスアナリティクス データコレクションジョブの条件付きスクリプトは、サンドボックスで実行されます。したがって、関数定義は許可されません。一部の API 呼び出しとキーワードも許可されません。詳細については、「[Script sandbox property (スクリプトサンドボックスプロパティ)](https://www.servicenow.com/docs/access?context=r_ScriptSandboxing&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US)」を参照してください。 アップグレード後に、これらの許可されていない API コンポーネントを含む条件付きスクリプトがあるジョブは、「収集済み (エラーあり)」というメッセージが出て終了します。これらのジョブはスコアを収集しません。 `com.snc.pa.dc.script.use.sandbox` システムプロパティは、データ収集スクリプトがサンドボックスを使用するかどうかを制御します。このプロパティを有効化できるのは、security_admin ロールを持つユーザーに限られます。このプロパティをオフにするときは注意が必要です。false に設定すると、権限のないユーザーがインスタンスに対して悪意のあるアクションを実行する可能性があります。 |
   [ ]

   {#t_CreatASchedDataCollJob__tbl_PerformanceAnalyticsDataCollectionJobProperties}
7. フォームヘッダーを右クリックし、\[保存\] を選択します。
8. \[インジケーター\] 関連リストで、\[編集\] をクリックし、このジョブがデータを収集するインジケーターを選択します。  
   重要:  
   * ジョブのインジケーターを少なくとも 1 つ含めます。そうしないと、ジョブは結果を返すことができません。
   * ジョブを保守可能に保つために、明確なユースケースがない限り、インジケーターを複数のアクティブな収集ジョブに関連付けないようにしてください。リアルタイムデータを取得しようとしている場合は、リアルタイムインジケーターの使用を検討してください。
   * データ収集ジョブは、関連するインジケーターのインジケーターソースごとに 1 つのデータベースクエリを生成します。したがって、インジケーターソースを共有するすべてのインジケーターのデータは、同じ時点を表します。
   {#t_CreatASchedDataCollJob__ul_orp_4lc_r3b}
9. ドメイン構成を有効にしている場合は、\[ ドメイン構成 \] 関連リストでこのジョブに関連付けるドメイン構成を選択できます。  
   ドメイン構成は、ユーザーグループに対する可視化またはその他の条件に基づいてドメインをグループ化します。これらのグループ化には、親子関係を含めることができます。ジョブのドメイン構成を選択すると、ジョブはグローバルドメインを含む、構成のドメイン内のレコードのスコアを収集します。ドメイン構成は、 ユーザーとして実行 を上書きします。詳細については、「[パフォーマンスアナリティクスドメイン構成でのドメインのグループ化](https://servicenow-prod.fluidtopics.net/M4vedzokjFWLLwT976gqWA "特定のユーザーのドメインの パフォーマンスアナリティクス を構成する代わりに、再利用可能なドメイン構成を作成します。ユーザーのグループに表示されるドメインを選択するか、ドメインを直接フィルタリングします。ドメイン構成を使用すると、階層関係を定義し、複数のドメイン間でスコアを集計できます。")」を参照してください。 {#t_CreatASchedDataCollJob__step_domain-config}
{#t_CreatASchedDataCollJob__step_domain-config}
10. \[送信\] をクリックします。

## 次のタスク

* デフォルトでは、各ジョブ インジケーターごとに、すべてのブレークダウンとインジケーター自体のデータが収集されます。インジケーターのこの設定を変更するには、「[ジョブ インジケーターの構成](https://servicenow-prod.fluidtopics.net/LdEt0BYpQRNqYAdMIsY62w "必要かつ合理的なデータのみを収集するようにジョブ インジケーターを構成することにより、データ収集の効率を向上させます。")」を参照してください。
* ドメイン サポートを有効にしている場合は、\[ドメイン設定\] という関連リストがあります。このタブで、\[編集\] をクリックし、既存のドメイン設定とこのジョブを関連付けます。または、\[新規\] をクリックして新しいドメイン設定を作成します。詳細については、「[ドメイン構成の作成](https://servicenow-prod.fluidtopics.net/2f66HsIYiUJUyPjD6Unt0Q "ドメイン構成を作成して、スコアを収集するドメインと、ドメイン階層内にスコアを格納する方法を定義します。")」を参照してください。
{#t_CreatASchedDataCollJob__ul_jbf_mph_4bb}

