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

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:8分
  • インジケーター スコアとスナップショットを定期的に収集するデータ収集ジョブをスケジュール パフォーマンスアナリティクス

    始める前に

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

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

    このタスクについて

    データ収集ジョブを構成するときに知っておくべき重要な項目は、次のとおりです。
    • 収集期間
    • 収集タイムゾーン
    • ドメインが使用される場合は、収集されるスコアのドメイン。
    • コレクション ジョブは、どのような制限もなく実行されます。実行するユーザーの権限は使用しません。

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

    手順

    1. 次のように移動する。 All (すべて) > パフォーマンスアナリティクス > データコレクター > ジョブ をクリックし、[ 新規] をクリックします。
      代わりに、ジョブの実行スケジュールを変更するなど、既存のデータ収集ジョブを編集することもできます。この場合は、 パフォーマンスアナリティクス > データコレクター > ジョブ をクリックし、ジョブ名をクリックします。
    2. [名前] フィールドには、わかりやすい名前を付けます。
      [PA インジケーター] 日次データ収集や [PA インジケーター] 履歴データ収集など、データ コレクタ ジョブの命名のための標準形式に従います。
    3. [演算子] フィールドで、データ収集を絶対時間でするのか、または相対時間でするのか選択します。
      演算子の値説明
      期間指定 絶対時間のデータを収集します。
      相対指定 ジョブが実行された時間を基準として特定期間のデータを収集します。
    4. [期間指定] を演算子として選択した場合、[開始日(固定)] 日付と [終了日(固定)] 日付を選択します。
    5. [相対] を演算子として選択した場合、データを収集する実行時間より前の間隔を指定します。
      1. [開始日(相対)][開始日指定(相対)] のフィールドで、データを収集する過去の期間の数と長さをそれぞれ設定します。
      2. [終了日(相対)][終了日指定(相対)] のフィールドで、データの収集を開始する過去の最後の期間の数と長さをそれぞれ設定します。
        ヒント:
        • ほとんどのインジケーター、したがってほとんどのデータ収集ジョブは毎日実行されます。日次スケジュール済みジョブは、通常、最後に完了した日について収集する必要があります。したがって、開始日 (相対) と終了 (相対) の両方が 1 日前である必要があります。収集期間が長い履歴データコレクションジョブは 1 回のみ実行します。
        • ビジネスカレンダーを使用するインジケーターでこのジョブを使用する場合は、 期間前の 間隔を考慮してください。この間隔は、ビジネスカレンダーに定義された期間に基づいています。
        たとえば、同じインジケーター ソースを使用して、日次の頻度で複数の新しいインジケーターのセットのスコアを収集するとします。まず、2 か月前から昨日までのデータを収集する履歴データ収集ジョブを作成します。このジョブで、[開始日(相対)]60 を、[開始日指定(相対)]日前を入力します。[終了日(相対)]2 を、[終了日指定(相対)]日前を入力します。[実行] フィールドを [オンデマンド] に設定します。[今すぐ実行] をクリックし、このジョブを 1 回実行して最初のスコアを収集します。

        開始日 (相対) と終了日 1 日前で 2 番目のジョブを作成し、[実行] フィールドを [日次] に設定します。このジョブを有効化し、昨日のスコアと、そのジョブが実行される前日について、将来のスコアをすべて収集します。

    6. 必要に応じて [ジョブパラメータ] を入力します。
      ジョブ パラメータ 説明
      実行方法 ドメインセパレーションインスタンスの場合は、このジョブを実行するユーザーを選択します。このジョブは、グローバルドメインを持つか、このユーザーのドメインにあるファクトテーブルおよび パフォーマンスアナリティクス レコードからスコアを収集します。

      データコレクションジョブはドメインのみに従い、このユーザーの権限はフォローしません。ACL とビジネスルールは、データ収集ジョブには適用されません。すべてのユーザーがジョブを実行できます。

      重要:
      このジョブのドメイン構成を選択すると、[ ユーザーとして実行 ] が上書きされます。このトピックのステップ 9 を参照してください。
      実行時のタイムゾーン クエリがジョブから実行されるときに使用するタイムゾーンを選択します。会社のレポートのタイムゾーンが存在する場合は、それを使用します。デフォルトでは、システムのタイムゾーンが使用されます。

      このタイムゾーンは、[[オープン][日付][今日]] などの条件で「今日」の曜日を決定します。

      [Active (アクティブ)] オンの場合、デフォルトではスケジュールされた日時にデータ収集が行われます。
      実行 データを収集するスケジュールを選択します。選択肢は次のとおりです。
      • 日次
      • 週次
      • 月次
      • 定期的
      • 1 回
      • オンデマンド
      ビジネスカレンダーを使用している場合は、ビジネスカレンダー期間の開始と終了について、次のオプションもあります ( ビジネスカレンダーエントリの定義を参照)。
      • ビジネスカレンダー:エントリー開始
      • ビジネスカレンダー:エントリー終了

      履歴データ収集ジョブを作成する場合は、オンデマンドで実行するようにジョブをスケジュールします。

      曜日
      • [実行][週次] の場合は、曜日を指定します。
      • [実行][月次] の場合は、日付を指定します。

      月末に収集するには、1 日目に設定し、[ 時間 ] を午前 0 時直後に設定します。この設定は、月の長さに関係なく、完了した月のデータを収集します。

      繰り返し間隔 [実行][定期的] の場合は、スケジュールされるデータ収集の間隔を日数と時間数で指定します。
      開始中 [実行][定期的] または [1 回] の場合、スケジュールされる最初のデータ収集の日時を指定します。
      時間 ジョブの実行時間 (24 時間制)。フィールドは 、[アクティブ ] が選択された後に表示されます。
      • 実行時のタイムゾーンではなく、ユーザーセッションのタイムゾーンに基づく時間です。
      • 通常、会社の深夜 0 時から午前 6 時までの 1 時間に設定して、最後の完了した期間を収集します。

      たとえば、ニューヨークにいて、ロサンゼルス時間の会社の午前 5 時にデータを収集する場合は、時間を 08:00:00 に設定します。

      収集 データ収集ジョブには、スコア収集とテキスト分析の収集のために個別のステップがあります。次のいずれかを選択します。
      • スコアのみ
      • テキストインデックスのみ
      • スコアとテキストインデックスの両方 (デフォルト)

      詳細については、「テキスト分析の設定」を参照してください。

      条件節 オンにすると、特定の条件が満たされた場合にのみデータ収集が行われます。
      条件 スケジュール済みジョブを実行するかどうかを決定する条件付きスクリプト。スクリプトの最後の式はブール値 (true/false) で評価されます。このテキストボックスは、[条件を使用 (Use conditions)] を選択した場合にのみ表示されます。
      警告:
      パフォーマンスアナリティクス データコレクションジョブの条件付きスクリプトは、サンドボックスで実行されます。したがって、関数定義は許可されません。一部の API 呼び出しとキーワードも許可されません。詳細については、「Script sandbox property (スクリプトサンドボックスプロパティ)」を参照してください。

      アップグレード後に、これらの許可されていない API コンポーネントを含む条件付きスクリプトがあるジョブは、「収集済み (エラーあり)」というメッセージが出て終了します。これらのジョブはスコアを収集しません。

      com.snc.pa.dc.script.use.sandbox システムプロパティは、データ収集スクリプトがサンドボックスを使用するかどうかを制御します。このプロパティを有効化できるのは、security_admin ロールを持つユーザーに限られます。このプロパティをオフにするときは注意が必要です。false に設定すると、権限のないユーザーがインスタンスに対して悪意のあるアクションを実行する可能性があります。

    7. フォームヘッダーを右クリックし、[Save (保存)] を選択します。
    8. [インジケーター] 関連リストで、[編集] をクリックし、このジョブがデータを収集するインジケーターを選択します。
      重要:
      • ジョブのインジケーターを少なくとも 1 つ含めます。そうしないと、ジョブは結果を返すことができません。
      • ジョブをメンテナンスしやすくするために、明確なユースケースがない限り、インジケーターを複数のアクティブな収集ジョブに関連付けないようにしてください。リアルタイム データを取得しようとしている場合は、リアルタイム インジケーターの使用を検討してください。
      • データ収集ジョブは、関連するインジケーターのインジケーター ソースごとに 1 つのデータベース クエリを生成します。したがって、インジケーター ソースを共有するすべてのインジケーターのデータは、同じ時点を表します。
    9. ドメイン構成を有効にしている場合は、[ ドメイン構成 ] 関連リストでこのジョブに関連付けるドメイン構成を選択できます。
      ドメイン構成は、ユーザーグループに対する可視化またはその他の条件に基づいてドメインをグループ化します。これらのグループには、親子関係を含めることができます。ジョブのドメイン構成を選択すると、ジョブはグローバルドメインを含む構成のドメイン内のレコードのスコアを収集します。ドメイン設定は [ ユーザーとして実行 ] を上書きします。詳細については、「パフォーマンスアナリティクスドメイン構成でのドメインのグループ化」を参照してください。
    10. [Submit (送信)] を選択します。

    次のタスク

    • デフォルトでは、各ジョブ インジケーターごとに、すべてのブレークダウンとインジケーター自体のデータが収集されます。インジケーターのこの設定を変更するには、「ジョブ インジケーターの構成」を参照してください。
    • ドメイン サポートを有効にしている場合は、[ドメイン設定] という関連リストがあります。このタブで、[編集] をクリックし、既存のドメイン設定とこのジョブを関連付けます。または、[新規] をクリックして新しいドメイン設定を作成します。詳細については、「ドメイン構成の作成」を参照してください。