外部データとのパフォーマンス分析の使用

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間:15分
  • 外部データソースに対するパフォーマンス分析により、ServiceNow インスタンスにないデータに対して詳細な分析を実行できます。

    外部データのスコアを収集する場合、パフォーマンス分析は、インスタンスに外部データのスコアとブレークダウン要素を保存します。分析される生データは外部データソースに残り、インスタンスにはコピーされません。この機能を使用すると、基礎となるデータを複製せずにメトリックを分析および共有できます。

    パフォーマンス分析の外部データ収集では、次の 3 つのタイプの構成レコードが使用されます。
    • スコアを収集するために使用される JDBC データソースと SQL ステートメントを指定する外部インジケーター
    • ブレークダウン要素を指定するために使用される JDBC データソースと SQL ステートメントを指定する外部ブレークダウン
    • 外部インジケーターとブレークダウンの関係を定義する外部インジケーター ブレークダウンと、そのインジケーターの各ブレークダウン要素のスコアを収集するために使用される SQL ステートメント

    外部データでサポートされているデータベース形式

    パフォーマンスアナリティクス は、 ServiceNow がデフォルトでサポートするデータベース形式のみをサポートしています。顧客がサポートされていないデータベース形式の JDBC ドライバーを追加した場合、 パフォーマンスアナリティクス はそのデータベース形式を外部データソースとしてサポートしません。

    表 : 1. サポートされているデータベース形式
    SQL Server タイプ ポート
    MySQL 3306
    Microsoft SQL Server 1433
    Oracle 1521

    外部データのインジケーターの作成

    外部インジケーターを作成して、評価するデータと、インジケーター スコアを決定するために使用される SQL ステートメントを定義します。

    始める前に

    必要なロール:pa_admin、pa_power_user、または admin

    手順

    1. 移動先 すべて > パフォーマンスアナリティクス > 外部インジケーター をクリックし、[ 新規] をクリックします。
    2. インジケーターにわかりやすい [名前] を付けます。
    3. [周期] フィールドに、[日次][週次]、または [月次] などの、インジケーターのデータ ポイントの周期を指定します。
    4. [ソース] タブで、スコアを収集する [データソース] を選択します。
      パフォーマンス分析では、JDBC タイプのデータ ソースのみがサポートされています。データソースの設定については、データソースのドキュメントを参照してください。
      注:
      データソースで定義された [SQL ステートメント] と [インポート・セット] の両テーブルはパフォーマンス分析では使用されません。
    5. スコア値を計算するために使用する [SQL ステートメント] を指定します。
      SQL ステートメントは、エイリアス valueを含む集計値を返す必要があり、日付フィールドに基づいてデータをフィルタリングする必要があります。
      重要:
      集計の別名は、[値] である必要があります。
      単純なインジケーターの場合、SQL ステートメントは SELECT count(*) AS value FROM... のようになります。ここで、DATE(date_field) >= DATE(${start_at})

      より複雑なインジケーターでは、DATE が DATEADD が返す日付よりも前であるという条件も必要になる場合があります。ここで、複合データを含む月次インジケーターには、SQL ステートメント SELECT count(*) AS value FROM... WHERE DATE(date_field) >= DATE(${start_at}) AND DATE(date_field) < DATEADD(month, 1, ${start_at})

    6. このインジケーターのスコアが時間の経過とともに増減することを希望する場合は、[方向] フィールドで [最大化] または [最小化] を選択します。
      分析ツールとグラフィック ディスプレイがこのインジケーターの [方向] に使用されています。
      ヒント:
      可能な限り方向を設定してください。すべての主要なインジケーターを [最大化] または [最小化] に設定する必要があります。
      ユースケース
      最大化 このインジケーター スコアの増加が求められている場合に選択します。例えば、収益を表示するインジケーターには [最大化] を選択することを考慮します。分析ツールとグラフィック要素は、このインジケータースコアの増加が良いことであり、減少することが悪いことであることを反映しています。
      最小化 このインジケーター スコアの減少が求められている場合に選択します。例えば、収益を表示するインジケーターには [最小化] を選択することを考慮します。分析ツールとグラフィック要素は、このインジケータースコアの減少は良いことであり、増加することは悪いことであることを反映しています。
      なし このスコアの変更の方向が、ビジネスにとって重要でない場合に選択します。
    7. オプション: 次のインジケータープロパティのいずれかを指定します。
      フィールド 説明
      単位 数値、日数、割合などスコアの測定単位。

      価格、通貨、または FX 通貨フィールドでシステム参照通貨でスコアを収集するには、[ 参照通貨を使用] を選択します。詳細については、「参照通貨でのインジケータースコア」を参照してください。

      単位として % または期間を選択する場合は、一部のタイプの時系列をインジケーターに適用しないようにすることを検討してください。詳細については、「インジケーターからの時系列の除外」を参照してください。

      単位として [時間] を選択した場合、時間は [日]、[時]、および [分] で表示されます。システムプロパティ glide.ui.duration.seconds.enabled が存在し、true の場合は、秒も表示されます。この場合、インスタンスのすべての時間フィールドにも秒が表示され、 Microsoft Excel へのエクスポートに含まれます。

      精度 小数点の後ろの桁数。詳細については、「インジケーターの丸めと精度」を参照してください。

      このフィールドは、単位が [ 参照通貨を使用] の場合は使用できません。この場合、精度は参照通貨から継承されます。

      数値形式 数千からクインティリオンの多数の略語。詳細については、「インジケーターの丸めと精度」を参照してください。
      キー インジケーターをキー インジケーターとして識別します。でインジケーターのリストをフィルタリングするためにのみ使用されます パフォーマンスアナリティクス > アナリティクスハブ.プラットフォームアナリティクスエクスペリエンスでは使用されません。
    8. [ アクセス制御 ] タブで、このインジケーターをライブラリに保存するかどうか、およびインジケーターの表示をユーザー、グループ、またはロール別に制限するかどうかを設定します。
      [ ライブラリに共有] を有効にすると、インジケーターは次の場所で使用できるようになります。
      • プラットフォームアナリティクスエクスペリエンスライブラリの KPI のリスト
      • KPI 詳細
      • アナリティクスハブ、ただし完全に移行されていないアップグレード済みインスタンスでのみ有効です プラットフォームアナリティクス
    9. オプション: [その他] タブで、その他のさまざまなプロパティを設定します。
      表 : 2. [その他] タブのフィールド
      フィールド 説明
      デフォルトの時系列

      インジケーターの生のスコアを表示する代わりにインジケーターに適用する、7 日間の実行平均などの事前定義された分析関数。

      詳細については、「時系列集計の適用」を参照してください。
      注:
      ビジネスカレンダーまたは会計カレンダーを使用するインジケーターのデフォルトの時系列を設定することはできません。これらのカレンダーは時系列集計をサポートしていません。
      ライブグループプロファイル

      ライブフィードグループのライブグループプロファイル [live_group_profile] レコード。グループプロファイルを指定すると、そのグループがこのインジケーターに関する通知を受け取ることができます。

      ServiceNow AI Platform上のこのソーシャルアプリケーションの詳細については、「ライブフィード」を参照してください。

      順序

      インジケーターが アナリティクスハブに表示される順序を示す番号。値が最も小さいインジケーターがリストの一番上に表示されます。[ 順序] フィールドに値が指定されていない場合、インジケーターは [名前 ] フィールドを使用して a から z まで表示されます。[順番] フィールドを使用するには、すべてのインジケーターの順番の番号を入力する必要があります。いくつかのインジケーターのみに数値を入力すると、インジケーターが表示される順序が a から z に戻ります。

      プラットフォームアナリティクスエクスペリエンスでは使用されません。

      デフォルトのグラフ種別

      このインジケーターのデフォルトのチャート タイプ (行、列、スプライン、または領域) を設定します。このインジケーターの アナリティクスハブ または KPI 詳細 を初めて開くと、デフォルトのグラフタイプが使用されます。アナリティクスハブまたはKPI 詳細でグラフタイプが変更された場合、その設定が記憶されます。

      実線のレンダリング

      選択すると、特定の日付のデータがない場合でも、 アナリティクスハブKPI 詳細 にこのインジケーターのデータ行が途切れることなく表示されます。この動作は、開始日が異なるデータセットを表示する場合や、在庫情報など定期的に更新されないデータの場合に便利です。

      インジケーター、 アナリティクスハブKPI 詳細に時系列が設定されている場合、連続線はレンダリングされません。

      リアルタイムスコアを表示

      選択すると、 アナリティクスハブKPI 詳細 に、このインジケーターのスコアと関連レコードの現在のステータスをリアルタイムで表示できます。第三者のソースからのデータを使用した統合などインジケーター データがリアルタイムで利用できない場合は、このチェックボックスをオフにします。詳細については、「リアルタイムスコア」を参照してください。

      注意:リアルタイムスコアを表示するには、インジケーターまたは関連するインジケーターソースに条件を設定する必要があります。

      たとえば、[その他] タブでは、次のようにインジケーターを設定できます。
      • デフォルトでは、ウィジェットには 30 日間移動合計のスコアが表示されます。このデフォルトは、 アナリティクスハブKPI 詳細、ダッシュボードウィジェット、またはワークスペースデータの可視化で上書きできます。
      • IT ライブグループにインジケーターの変更が通知されます。
      • インジケーターは、インジケーターの アナリティクスハブ リストの 3 番目に表示されています。他のすべてのインジケーターにも、その位置が指定されています。この設定は、 KPI 詳細のインジケーターの順序には影響しません。
      • デフォルトのグラフタイプは、 アナリティクスハブKPI 詳細の [スプライン] です。
      • データが欠落している場合でも、インジケーターのデータ行は途切れることなく表示されます。
      • アナリティクスハブKPI 詳細は、このインジケーターのスコアをリアルタイムで表示できます。

      以前にリストされた設定を含むインジケーターの [その他] タブ

    10. オプション: [予測] タブで、予測方法、予測するデータ収集期間、予測の基礎となる履歴データの量、予測値の上限と下限を設定します。
      詳細については、「パフォーマンスアナリティクススコア予測」を参照してください。
    11. [Save (保存)] を選択してインジケーターを保存します。
    12. [ コレクションのテスト] を押します。
      このアクションは、インジケーターのメインクエリをテストします。

    次のタスク

    インジケーターのブレークダウン スコアを収集する場合は、外部ブレークダウンを定義し、インジケーターに関連付けます。

    外部データを使用したブレークダウンの作成

    外部ブレークダウンを作成して、外部インジケーター スコアのブレークダウンに使用できる要素を定義します。

    始める前に

    必要なロール:pa_admin、pa_power_user、または admin

    このタスクについて

    デフォルトでは、外部ブレークダウンには最大で 5000 個の要素を含めることができます。この制限は、プロパティ com.snc.pa.dc.max_external_elements によって制御されます。

    外部ブレークダウン要素は、pa_ext_elements テーブルに格納されます。

    手順

    1. 移動先 すべて > パフォーマンスアナリティクス > 外部ブレークダウン.
    2. [New] をクリックします。
    3. ブレークダウン要素として使用するレコードを含むデータソースを選択します。
      パフォーマンス分析では、JDBC タイプのデータ ソースのみがサポートされています。データソースの設定については、データソースのドキュメントを参照してください。
      注:
      データソースで定義された [SQL ステートメント] と [インポート・セット] の両テーブルはパフォーマンス分析では使用されません。
    4. [SQL ステートメント] を指定して、ブレークダウン要素を選択します。
      SQL ステートメントは、エイリアス id を含む各ブレークダウン要素の一意のキーと、エイリアス name を含む要素表示名 ( 例: SELECT guid AS id、user_name AS name FROM... など) を返す必要があります。
      重要:
      一意のキーの別名は [ID]、表示名の別名は [名前] である必要があります。
    5. ブレークダウンを保存します。
    6. [ コレクションのテスト] を押します。
      このアクションでは、ブレークダウン要素を選択するクエリをテストします。

    次のタスク

    ブレークダウン要素の収集方法を定義したら、外部ブレークダウンを 1 つ以上の外部インジケーターに関連付けます。

    外部ブレークダウンを使用するための外部インジケーターの構成

    外部インジケーターと外部ブレークダウンを関連付けて、インジケーターのブレークダウンスコアの収集方法を定義します。

    始める前に

    必要なロール:pa_admin、pa_power_user、または admin

    手順

    1. 移動先 すべて > パフォーマンスアナリティクス > 外部インジケーター.
    2. [インジケーター] を選択します。
    3. [ブレークダウン] 関連リストで、[新規] をクリックします。
    4. 外部の [ブレークダウン] を選択してこのインジケーターに適用します。
    5. [SQL ステートメント] フィールドに、各ブレークダウン要素のスコア値を計算する SQL ステートメントを入力します。
      SQL ステートメントには、COUNT などの、インジケーター SQL ステートメントと同じ集計関数を使用する必要があります。SQL ステートメントは、エイリアス value を含む集計値と、エイリアス ID を持つブレークダウン要素の一意のキーを返す必要があります。また、SQL ステートメントは、ブレークダウン要素の値を含む列でデータをグループ化する必要があります。
      たとえば、 SELECT count(*) AS value, guid as id FROM... WHERE DATE(date_field) >= DATE({$start_AT}) GUID でグループ化
      重要:
      集計の別名は [値]、ブレークダウンの一意のキーの別名は [ID] である必要があります。
    6. 変更内容を保存します。
    7. [ コレクションのテスト] を押します。
      このアクションは、ブレークダウン要素のスコア値を計算する SQL ステートメントをテストします。

    次のタスク

    前の手順を繰り返して、インジケーターにブレークダウンを追加します。それぞれを追加した後、SQL ステートメントをテストします。

    外部インジケーターとブレークダウンのテスト

    外部インジケーターとブレークダウンをテストし、外部データソースに接続して期待するデータを収集できることを確認します。

    始める前に

    必要なロール:pa_admin、pa_power_user、または admin

    このタスクについて

    インジケーターをテストして、そのインジケーターのクエリと、すべてのブレークダウン要素のクエリをテストします。ブレークダウンをテストして、利用可能なブレークダウン要素を決定するために使用されるクエリをテストします。

    インジケーターまたはブレークダウンをテストするときは、スコアまたはブレークダウン要素は保存されません。

    手順

    1. 移動先 すべて > パフォーマンスアナリティクス > 外部インジケーター または パフォーマンスアナリティクス > 外部ブレークダウン.
    2. テストするインジケーターまたはブレークダウンを選択します。
    3. [テスト] ボタンをクリックします。
      クエリが正常に実行されると、収集されるスコアまたはブレークダウン要素の数が表示されます。テスト中にエラーが発生すると、エラー メッセージが表示されます。

    次のタスク

    すべてのクエリが正常に実行され、期待するデータが返されることを確認したら、データ収集ジョブに外部インジケーターを追加して、スコアの収集を開始します。

    日付による外部データのフィルタリング

    外部データとともにパフォーマンス分析を使用する場合は、スコアを収集する SQL ステートメントを日付によりフィルタリングする必要があります。

    インジケーターおよびインジケーターブレークダウン SQL ステートメントでは、日付でクエリをフィルタリングします ( 例:WHERE DATE(my_date_field) >= DATE(${start_at}) )。ブレークダウン SQL ステートメントは、スコアではなく要素のみを収集するため、ブレークダウン SQL ステートメントを日付によりフィルタリングする必要はありません。

    変数 ${start_at} には、収集される期間の日付が YYYYMMDD の形式で含まれます。日次インジケーターの場合、この値は常に収集される日付です。週次や月次などの、収集頻度の長いインジケーターの場合、この日付は収集期間の最初の日となります。データ収集ジョブが実行される日付は、この変数に影響しません。

    インジケーターまたはブレークダウンをテストすると、${start_at} 変数は常に現在の日付に設定されます。

    外部データとパフォーマンス分析を使用する場合の制限事項

    外部データを測定するときは、特定のパフォーマンス分析機能が利用できません。

    • スナップショットは収集できません。
    • リアルタイム スコアは表示できません。
    • 第 2 レベルのブレークダウンは適用できません。
    • 外部データを持つ第 2 レベルのブレークダウンに依存するウィジェットのチャート化を使用することはできません。これには、ピボットやヒートマップによるチャート化が含まれます。
    • スナップショットが利用できないため、収集されたレコードの変更を表示できません。