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

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

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

    パフォーマンスアナリティクスの外部データ収集では、次の 3 つのタイプの設定レコードを使用します。
    • スコアの収集に使用する JDBC データソースと SQL ステートメントを指定する外部インジケーター。
    • ブレークダウン要素の指定に使用する JDBC データソースと SQL ステートメントを指定する外部ブレークダウン。
    • 外部インジケーターとブレークダウンの関係を定義する外部インジケーターブレークダウンと、そのインジケーターの各ブレークダウン要素のスコアを収集するために使用される SQL ステートメント。
    重要:
    これらのトピックは、 Workflow Data Fabric テーブルを介してアクセスされる外部データには適用されません。通常、 Workflow Data Fabric テーブルのインジケーターまたはブレークダウンソースを作成できます。

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

    パフォーマンスアナリティクス は、 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 詳細
      • アナリティクスハブ、ただし完全に移行されていないアップグレード済みインスタンスでのみ可能です プラットフォームアナリティクス
    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 で、表示名エイリアスは name である必要があります。
    5. ブレークダウンを保存します。
    6. [ コレクションのテスト] を押します。
      このアクションでは、ブレークダウン要素を選択するクエリをテストします。

    次のタスク

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

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

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

    始める前に

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

    手順

    1. 移動先 すべて > パフォーマンスアナリティクス > 外部インジケーター.
    2. [インジケーター] を選択します。
    3. [ ブレークダウン] 関連リストで、[ 新規] をクリックします。
    4. このインジケーターに適用する外部 ブレークダウン を選択します。
    5. SQL ステートメントフィールドに、各ブレークダウン要素のスコア値を計算する SQL ステートメントを入力します。
      SQL ステートメントでは、インジケーター SQL ステートメントと同じ集計関数 (COUNT など) を使用する必要があります。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 レベルのブレークダウンに依存するウィジェットの可視化を使用することはできません。これには、ピボットとヒートマップの可視化が含まれます。
    • スナップショットを利用できないため、収集されたレコードの変更を表示することはできません