インジケーターソース

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:11分
  • インジケーター ソース は、1 つのテーブルまたはデータベースビューからのフィルタリングされたレコードで構成されるデータセットです。

    インジケーターソース構成では、インシデント [incident] などのテーブル、そのテーブルからレコードをフィルタリングするための条件、および条件に基づく頻度を指定します。インジケーターソースは、ローテーションされたテーブルを指定できません。複数のインジケーターで同じインジケーター ソースを使用できます。データコレクションジョブは、インジケーターソースごとに 1 回データベースをクエリします。したがって、同じインジケーター ソースを使用するすべてのインジケーターは、同じ時点からデータを取得します。

    通常、インジケーターは特定の日付の状況を追跡します。インジケーター ソースの条件には、[オープン済み][日付][今日] のような日付関連のフィルタが含まれている必要があります。収集周期の低いインジケーターでは、[クローズ済み][日付][今月] のようなより広い日付範囲を指定できます。

    注意深くインジケーター ソースを作成します。インジケーター ソースには複数のインジケーターがリンクされる可能性があるため、インジケーター ソースを作成した後に変更することは容易ではありません。さらに、インジケーターソースを変更すると、既に収集したスコアと不整合が生じる可能性があります。

    注:
    インジケーターを作成する前に、インジケーター ソースを作成する必要があります。

    インジケーター ソースの定義

    1 つ以上のインジケーターで評価できるフィルター済みレコードのデータセットを提供するには、インジケーターソースを作成します。

    始める前に

    次の理由から、インジケーターソースのリストを確認します。
    • 要件を満たすインジケーターソースが既に存在している可能性があります。インスタンスを維持するため、インジケーター ソースを重複して作成しないでください。
    • 作成するインジケーターソースには、必ず一意の名前を付けてください。異なるインジケーターソースに同じ名前を付けると、混乱を招く可能性があります。

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

    手順

    1. 次のいずれかのナビゲーションパスを使用します。
      • プラットフォームアナリティクス に移行されていないアップグレード済みインスタンスを使用している場合、次の場所に移動します: All (すべて) > パフォーマンスアナリティクス > ソース > インジケーターソース [ 新規] を選択します。
      • 新しいインスタンスを使用している場合、または プラットフォームアナリティクス に移行した場合は、次に移動します: All (すべて) > プラットフォームアナリティクス管理 > データソース > インジケーターソース [ 新規] を選択します。
    2. インジケーター ソースの使用目的を簡単に確認できる一意 の名前を入力します ( 「Incidents.Open」など)。
    3. 他のユーザーがこのインジケーター ソースの使用と目的を理解し、重複の作成を回避できるように、詳細な 説明 を追加します。
    4. [ カレンダー ] フィールドで、標準カレンダーまたはインスタンスで定義されているビジネスカレンダーのいずれかを選択します。
      警告:
      ビジネスカレンダーを使用し、後でそのビジネスカレンダーのエントリを変更すると、 パフォーマンスアナリティクス データが無効になります。エントリーを変更する前に収集したスコアは、エントリーを変更した後に収集したスコアと互換性がありません。この警告は、会計カレンダーのスケジュールにも適用されます。

      ビジネスカレンダーを使用する場合は、[ビジネスカレンダー:エントリ開始時間 (Business Calendar: Entry start)] または [ビジネスカレンダー:エントリ終了時間 (Business Calendar: Entry end times)] で実行されるデータ収集ジョブを作成できます。

    5. [ 有効な頻度 ] または [カレンダー頻度 ] フィールドに入力します。
      • 標準カレンダーを選択した場合は、[ 有効期限] 頻度フィールドがあります。このフィールドでは、標準のインジケーター頻度を選択できます。デフォルトの選択は [日次] です。
      • ビジネスカレンダーを選択すると、[ カレンダー頻度 ] フィールドが表示されます。このフィールドは必須です。選択したビジネスカレンダーによって、使用可能な頻度の範囲が決まります。
      このインジケーターソースに基づくインジケーターは、このフィールドの値をインジケーター の頻度として使用します。デフォルトでは、インジケーターのスコア収集期間はこの周期に従います。インジケーターレコードでこの動作を上書きできます。

      設定する周期がわからない場合は、ビジネス サイクルの周期を基準にします。

    6. 直接、またはレポートソースを再利用して、ファクトテーブルを選択します。
      フィールド説明
      ファクトテーブル ファクト テーブルおよびそのテーブルのレコードをフィルタリングする条件を指定します。データベースビューをファクトテーブルとして指定できます。リモートテーブルはサポートされていません。
      レポートソース 再利用する既存のレポート ソースを指定します。レポート ソースでは、ファクト テーブルとフィルタリング条件を指定します。

      レポート ソースが変更された場合、インジケーター ソースを表示したときに警告が表示されて、変更が通知されます。インジケーター ソースを更新するには、[レポートソース] フィールドの横にあるリフレッシュ ボタンをクリックします。

      警告:
      • パフォーマンスアナリティクス はリモートテーブルをサポートしていません。
      • データの収集を開始した後は、ソースのファクトテーブルを変更しないでください。ファクトテーブルを変更すると、次のスコア収集時に関連するインジケーターのすべての履歴スコアが失われます。
    7. ファクトテーブルを直接選択する場合は、データをサブセットに含める前に満たす必要がある 条件 を追加します。
      たとえば、条件 [有効][次の値に等しい (=)][true][作成日][次の値もしくはそれ以前(<=)][日付] などと設定します。
      ヒント:
      • テキスト フィールドのインジケーター ソース条件では、大文字と小文字は区別されません。
      • インジケーター ソースとインジケーターに設定された条件がすべて適用されます。
      • インジケーターにリアルタイム スコアを表示するには、インジケーターまたはインジケーター ソースのいずれかに条件を設定します。
      • インジケーター ソースを再利用できるように、上位レベルの条件のみを使用してインジケーター ソース条件を定義してください。データをより深く理解するには、個々のインジケーターの詳細フィルタを使用します。
      • インジケーターソースには、[作成日][日付][今日] など、少なくとも 1 つの日付条件が必要です。
      • 通常、日付条件はインジケーター頻度と同じ期間を参照する必要があります。たとえば、日数に関する条件は日次インジケーターにのみ設定する必要があります。月数に関する条件は、月次指標にのみ記載する必要があります。
      • テーブルのsys_idまたは表示値へのドット連結は避けてください。不要な結合が作成されないように、代わりに参照フィールドを単独で使用します。
      • インジケーター ソースの条件を適切に設計すると、そのソースの少なくとも 1 つのインジケーターに追加条件がなくなります。

      条件のビルドに関する一般的な情報については、「 条件ビルダー」を参照してください。

    8. オプション: 関連リスト条件を定義して、フィルターに別のテーブルとの関係を含めます。
      詳細については、「 関連リスト条件の追加」を参照してください。
    9. このインジケーター ソースが返すレコードの数を確認するには、[ プレビュー] をクリックします。
      警告:

      プレビュー機能に表示される内容にかかわらず、収集されるレコードの上限を超える可能性があります。プレビュー機能では、データコレクターが実際にフェッチするレコード数よりも少ないレコード数が表示されます。データコレクションジョブはレコードをフェッチするときに ACL とビジネスルールを無視しますが、プレビュー機能はそれらに従います。詳細については、「 KB0756238」を参照してください。

    10. [レコードビュー] タブ のリストビューで、デフォルトビューを選択します。
      デフォルトのビューは、ワークベンチウィジェットと、 アナリティクスハブ および KPI 詳細でこのインジケーターソース用に収集されたレコードリストに適用されます。使用可能なビューは、ファクトテーブルによって異なります。
    11. オプション: [レコード収集] タブで、このインジケーター ソースについてのみ、単一のインジケーター ソースに対してジョブが収集できるレコードの最大数を上書きします。
      [レコード収集の上書き] を選択し、[収集されるレコードの最大数] に値を入力します。プロパティ com.snc.pa.dc.max_row_count_indicator_sourceに設定されているデフォルト値を上書きしています。詳細については、「パフォーマンスアナリティクスのプロパティ」を参照してください。
    12. コンテキストメニューを展開して [ 保存] をクリックします。
    13. オプション: ビジネス カレンダーを使用するようにこのインジケーター ソースを構成した場合は、スコアとスナップショットを保持し、季節パターンを検索するための期間数を設定します。
      これらの設定は、同じカレンダー頻度を使用するすべてのインジケーター ソースとインジケーターに適用されます。インジケーターのオーナーは、そのインジケーターのこれらの設定を上書きできます。インジケーター ソースでこれらの値を設定しないと、このカレンダー頻度を使用して初めてインジケーターを作成するときに、これらの値を設定するように求められます。
      1. 関連リンクで、[ 保存期間の設定] をクリックします。
        PA ビジネスカレンダー保持期間レコードが開きます。
      2. [季節性を確立するエントリの数] フィールドに、季節パターンを見つけるために必要な、ビジネスカレンダーまたはスケジュールエントリで定義されている期間の数を入力します。
        ビジネスカレンダーエントリの詳細については、「 ビジネスカレンダーの作成」を参照してください。
      3. ビジネスカレンダーまたはスケジュールエントリで定義されているように、スコアとスナップショットを保持する期間を設定します。
        デフォルト値は 1 ですが、変更を検討する必要があります。

    シンプルなインジケーターソース

    次の設定は、毎日新しいインシデントを収集するインジケーター ソースを作成します。
    • [名前]Incidents.New
    • [周期]日次
    • [ファクトテーブル]インシデント [incident]
    • [条件][オープン済み][日付][今日]
    図 : 1. インジケーター ソースの作成
    インジケーター ソースの作成

    次のタスク

    インジケーター ソースを作成した後、レコードの関連リストでテキスト インデックス構成を定義できます。これらの構成を使用して、ワードクラウドで パフォーマンスアナリティクス テキストウィジェットを作成します。詳細については、「テキスト分析の設定」を参照してください。

    レポート ソースを再利用していて、レポート ソースが変更されると、インジケーター ソース レコードに警告が表示されます。レポート ソースと一致するようにインジケーター ソースを更新するには、[ レポート ソースの更新] をクリックします。[レポートソース] フィールドの横にある更新ボタンをクリックすることもできます。

    読み取り専用の [レポートソース更新日時] フィールドにレポート ソースが最後に更新された時刻が表示されます。この日付と時刻は常に GMT タイムゾーンで表示されます。

    インジケーター ソースでのデータベース ビューの使用

    インジケーター ソースのファクト テーブルとしてデータベース ビューを選択できます。データベース ビューを使用すると、デフォルトでは接続されていないServiceNowインスタンスのテーブルのデータを統合することができます。

    始める前に

    必要なロール:pa_admin

    このタスクについて

    データベースビューでテーブルを結合すると、ビューを呼び出してテーブルに簡単にアクセスできます。次に、ビューに含まれる任意のテーブルからフィールドを選択できます。たとえば、違反した SLA の数をレポートする場合、SLA とインシデント テーブル両方のフィールドが必要です。

    手順

    インジケーター ソースのファクト テーブルとしてデータベース ビューを選択した場合は、インジケーター ソース フォームの [レコードビュー] セクションで追加の構成を行います。
    図 : 2. インジケーターソースフォームの [レコードビュー] セクション
    インジケーターソースフォームの [レコードビュー] セクション
    フィールド 説明
    ビューテーブル レコードのスナップショットは、データベースビューの 1 つのテーブルからのみ収集されます。レコードを収集するテーブルを選択します。
    重要:
    この値を変更すると、以前のスナップショットがすべて削除されます。この変更は、次回データ収集ジョブが実行されるときに有効になります。この変更は、履歴スコアには影響しません。
    リストビュー 収集されたレコード セットの表示に使用するリスト ビューを選択します。デフォルトのビュー が提案されますが、 ワークスペースなどの定義されたビューを選択できます。
    注:
    一意のシステム ID を生成しないビューテーブルで第 2 レベルのブレークダウンを収集すると、スコアとレコード数が一致しない場合があります。これらの値が一致しない場合、スコアは正しいです。一意でないsys_idsのアーティファクトであるため、レコード数が間違っています。

    データベースビューからのインジケーターソース

    SLA に違反したインシデントの数を追跡するインジケーターを作成するとします。タスク SLA [task_sla] テーブルとインシデント [incident] テーブルを結合する incident_sla と呼ばれるデータベースビューが ベースシステム に既に含まれています。したがって、このデータベース ビューを使用して新しいインジケーター ソースを作成します。

    データベースビューを見ると、タスク SLA テーブルのタスクがインジケーターテーブルの一意のsys_id値と一致するレコードが取得されることがわかります。
    Where 節がハイライト表示された [データベースビューテーブル] リスト
    スナップショットは 1 つのテーブルからしか取得できません。通常は、一意の値を持つフィールドを持つテーブルのスナップショットを取得することをお勧めします。したがって、インジケーターソースのビューテーブルとしてインシデント [incident] を選択します。
    [レコードビュー] タブ