---
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) 所要時間：15分

外部データソースに対するパフォーマンス分析により、ServiceNow インスタンスにないデータに対して詳細な分析を実行できます。

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

* スコアを収集するために使用される JDBC データソースと SQL ステートメントを指定する外部インジケーター
* ブレークダウン要素を指定するために使用される JDBC データソースと SQL ステートメントを指定する外部ブレークダウン
* 外部インジケーターとブレークダウンの関係を定義する外部インジケーター ブレークダウンと、そのインジケーターの各ブレークダウン要素のスコアを収集するために使用される SQL ステートメント
{#pa-external-data__ul_dzz_dyt_2bb}

## 外部データでサポートされているデータベース形式 {#ariaid-title2}

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

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

{#supported-database-formats__table_ov4_ctn_lgb}
**関連情報**   

* [JDBC タイプのデータソース](https://www.servicenow.com/docs/access?context=r_JDBCTypeDataSource&version=xanadu&pubname=xanadu-integrate-applications&ft:locale=en-US)

## 外部データのインジケーターの作成 {#ariaid-title3}

外部インジケーターを作成して、評価するデータと、インジケーター スコアを決定するために使用される SQL ステートメントを定義します。{#create-ind-ext-data__ph_create-external-indicator}

### 始める前に

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

### 手順

1. 移動先 すべてPerformance Analytics (パフォーマンスアナリティクス)外部インジケーター をクリックし、\[ New\] をクリックします。
2. インジケーターにわかりやすい \[名前\] を付けます。
3. \[周期\] フィールドに、\[日次\]、\[週次\]、または \[月次\] などの、インジケーターのデータ ポイントの周期を指定します。 {#create-ind-ext-data__step_ext-indicator-freq}
{#create-ind-ext-data__step_ext-indicator-freq}
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... ここで、DATE(date_field) >= DATE(${start_at}) AND DATE(date_field) < DATEADD(month, 1, ${start_at})<c0/>。`
   {#create-ind-ext-data__step_ext-indicator-sql}
{#create-ind-ext-data__step_ext-indicator-sql}
6. このインジケーターのスコアが時間の経過とともに増減することを希望する場合は、\[方向\] フィールドで \[最大化\] または \[最小化\] を選択します。  
   分析ツールとグラフィック ディスプレイがこのインジケーターの \[方向\] に使用されています。  
   ヒント:  
   可能な限り方向を設定します。すべてのキー インジケーターは、最大化または最小化に設定する必要があります。

   | 値 | ユースケース |
   | 最大化 | このインジケーター スコアの増加が求められている場合に選択します。例えば、収益を表示するインジケーターには \[最大化\] を選択することを考慮します。分析ツールとグラフィック要素は、この指標スコアの増加は良いことであり、減少は悪いことを反映しています。 |
   | 最小化 | このインジケーター スコアの減少が求められている場合に選択します。例えば、収益を表示するインジケーターには \[最小化\] を選択することを考慮します。分析ツールとグラフィック要素は、このインジケータースコアの減少は良いことであり、増加は悪いことを反映しています。 |
   | なし | このスコアの変更の方向が、ビジネスにとって重要でない場合に選択します。 |
   |-|-|

   {#create-ind-ext-data__choicetable_myb_r3v_vcb}
7. **オプション:** 次のインジケータープロパティのいずれかを指定します。  
   {#create-ind-ext-data__table_uh3_vsv_q2b__entry__2}{#create-ind-ext-data__row_unit}{#create-ind-ext-data__row_precision}

   | フィールド | 説明 |
   |-|-|
   | 単位 | 数値、日数、割合などスコアの測定単位。 \[価格\]、\[通貨\]、または \[FX 通貨\] フィールドでシステム参照通貨でスコアを収集するには、\[ 参照通貨を使用\] を選択します。詳細については、「[参照通貨でのインジケータースコア](https://servicenow-prod.fluidtopics.net/gLGMO1zZ72lbQkrv83b67Q "価格、通貨、または FX 通貨タイプの通貨フィールドの傾向を追跡できます。これらのフィールドのいずれかに基づくインジケーターのスコアは、参照通貨値で収集されます。")」を参照してください。 単位として % または期間を選択する場合は、インジケーターへの適用から一部のタイプの時系列を除外することを検討してください。詳細については、「[インジケーターからの時系列の除外](https://servicenow-prod.fluidtopics.net/IPbX12yT_OLEsUIKLEK_3g "時系列集計の中には、インジケーターに適用するのに不適切なものがあります。自動、数式、および手動インジケーターでは時系列を除外できます。除外された時系列は、 アナリティクスハブ、 KPI 詳細、またはウィジェットから選択できません。他の時系列は選択可能なままになります。")」を参照してください。 単位として \[時間\] を選択した場合、時間は \[日\]、\[時間\]、および \[分\] で指定されます。システムプロパティ glide.ui.duration.seconds.enabled が存在し、true である場合は、秒も表示されます。この場合、インスタンスのすべての時間フィールドにも秒が表示され、 Microsoft Excel へのエクスポートに含まれます。 |
   | Precision (精度) | 小数点の後ろの桁数。詳細については、「[インジケーターの丸めと精度](https://servicenow-prod.fluidtopics.net/YcVi0c4hcaEe3lg8mTdALA "インジケーターは、インジケーター [精度] に応じて、「銀行家の丸め」または数学的な丸めを使用して、結果の小数部を丸めます。")」を参照してください。 このフィールドは、単位が \[参照通貨を使用\] の場合は使用できません。この場合、精度は参照通貨から継承されます。 |
   | 数値形式 | 数千から五分数までの多数の略語に使用されます。詳細については、「[インジケーターの丸めと精度](https://servicenow-prod.fluidtopics.net/YcVi0c4hcaEe3lg8mTdALA "インジケーターは、インジケーター [精度] に応じて、「銀行家の丸め」または数学的な丸めを使用して、結果の小数部を丸めます。")」を参照してください。 |
   | キー | インジケーターをキー インジケーターとして識別します。のインジケーターのリストをフィルタリングするためにのみ使用されます Performance Analytics (パフォーマンスアナリティクス)アナリティクスハブ.プラットフォームアナリティクスエクスペリエンスでは使用されません。 |
   [ ]

   {#create-ind-ext-data__table_uh3_vsv_q2b}
8. \[ アクセス制御 \] タブで、このインジケーターをライブラリに保存するかどうか、およびユーザー、グループ、またはロール別にインジケーターの表示を制限するかどうかを設定します。  
   ライブラリへの共有を有効にすると、インジケーターが次の場所で使用できるようになります。
   * プラットフォームアナリティクスエクスペリエンスライブラリの KPI のリスト
   * KPI 詳細
   * アナリティクスハブに完全に移行されていないアップグレード済みインスタンスに限ります プラットフォームアナリティクス
   {#create-ind-ext-data__ul_hd3_lrn_1bc} {#create-ind-ext-data__cmd_access-control-fields}
9. **オプション:** \[その他\] タブで、その他のさまざまなプロパティを設定します。  
   {#create-ind-ext-data__table_hft_ltv_q2b__entry__2}{#create-ind-ext-data__row_default-time-series}{#create-ind-ext-data__row_live-group-profile}{#create-ind-ext-data__row_order}{#create-ind-ext-data__row_render-cont-lines}

   | フィールド | 説明 |
   |-|-|
   | デフォルトの時系列 | インジケーターの生のスコアを表示する代わりにインジケーターに適用する、7 日間の移動平均などの事前定義された分析関数。{#create-ind-ext-data__ph_time-series-desc} 詳細については、「[時系列集計の適用](https://servicenow-prod.fluidtopics.net/7U7IjrfVlhnf3sO07SZIjg#applying-time-series-aggregations "インジケーターの変化を個別の時間間隔に集計できます。これらの集計により、傾向が見やすくなったり、ターゲットに対する進捗状況を追跡したりするのに役立ちます。")」を参照してください。 注: ビジネスカレンダーまたは会計カレンダーを使用するインジケーターには、デフォルトの時系列を設定することはできません。これらのカレンダーは時系列集計をサポートしていません。 |
   | ライブグループプロファイル | ライブフィードグループのライブグループプロフィール \[live_group_profile\] レコード。グループプロファイルを指定して、そのグループがこのインジケーターに関する通知を受け取るようにします。 Now Platform上のこのソーシャルアプリケーションの詳細については、「[ライブフィード](https://www.servicenow.com/docs/access?context=c_GetStartedWithLiveFeed&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)」を参照してください。 |
   | 注文 | インジケーターが アナリティクスハブに表示される順序を示す番号。最小値のインジケーターがリストの一番上に表示されます。\[順序\] フィールドに値が指定されていない場合、インジケーターは \[名前\] フィールドを使用して a から z まで表示されます。\[順番\] フィールドを使用するには、すべてのインジケーターの順番の番号を入力する必要があります。少数のインジケーターにのみ数値を入力すると、インジケーターが表示される順序が a から z に戻ります。 プラットフォームアナリティクスエクスペリエンスでは使用されません。 |
   | デフォルトのグラフ種別 | このインジケーターのデフォルトのチャート タイプ (行、列、スプライン、または領域) を設定します。このインジケーターの アナリティクスハブ または KPI 詳細 を初めて開くときは、デフォルトのグラフタイプが使用されます。アナリティクスハブまたはKPI 詳細でグラフの種類が変更された場合、その設定が記憶されます。 |
   | 実線のレンダリング | 選択すると、特定の日付にデータがない場合でも、このインジケーターの アナリティクスハブ と KPI 詳細 に切れ目のないデータ線が表示されます。この動作は、開始日が異なるデータセットを表示する場合や、在庫情報など定期的に更新されないデータを表示する場合に便利です。 インジケーター、 アナリティクスハブ 、または KPI 詳細に時系列が設定されている場合、実線は表示されません。 |
   | リアルタイムスコアを表示 | 選択すると、 アナリティクスハブ と KPI 詳細 に、このインジケーターのスコアと関連レコードの現在のステータスがリアルタイムで表示されます。第三者のソースからのデータを使用した統合などインジケーター データがリアルタイムで利用できない場合は、このチェックボックスをオフにします。詳細については、「[リアルタイムスコア](https://servicenow-prod.fluidtopics.net/NoFHxTRWdmo1x3KLxKhJ_w "一部の パフォーマンスアナリティクス スコアは、最新のデータ収集ジョブからではなくリアルタイムで表示できます。リアルタイム スコアが有効になっている場合は、 アナリティクスハブ 、一部のウィジェット、レポートでリアルタイム スコアを表示できます。")」を参照してください。 注意:リアルタイムスコアを表示するには、インジケーターまたは関連するインジケーターソースに条件を設定する必要があります。 |
   [表 : 2. \[その他\] タブのフィールド]

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

   {#create-ind-ext-data__ul_x5k_rzc_lwb}

10. **オプション:** \[予測\] タブで、予測方法、予測するデータ収集期間、予測の基礎となる履歴データの量、予測値の上限と下限を設定します。  
    詳細については、「[パフォーマンスアナリティクススコア予測](https://servicenow-prod.fluidtopics.net/rhJpZDhwGwHeh1Dq5RMd0A#c_ForecastingData "パフォーマンスアナリティクス を使用すると、過去の動作に基づいて将来のスコアを予測できます。時系列ウィジェット、時系列データの可視化、 KPI 詳細、および アナリティクスハブでスコアを予測できます。予測スコアは点線で表示されます。")」を参照してください。 {#create-ind-ext-data__cmd_forecasting-fields}
11. インジケーターを保存します。
12. \[Test Collection\] を押します。  
    このアクションは、インジケーターのメインクエリをテストします。

### 次のタスク

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

## 外部データを使用したブレークダウンの作成 {#ariaid-title4}

外部ブレークダウンを作成して、外部インジケーター スコアのブレークダウンに使用できる要素を定義します。{#create-bd-ext-data__ph_ext-bkdwn-short-desc}

### 始める前に

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

### このタスクについて

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

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

### 手順

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

### 次のタスク

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

## 外部ブレークダウンを使用するための外部インジケーターの構成 {#ariaid-title5}

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

### 始める前に

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

### 手順

1. 移動先 すべてPerformance Analytics (パフォーマンスアナリティクス)外部インジケーター.
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}) GROUP BY GUID`  
   重要:  
   集計の別名は \[値\]、ブレークダウンの一意のキーの別名は \[ID\] である必要があります。
6. 変更内容を保存します。
7. \[Test Collection\] を押します。  
   このアクションは、ブレークダウン要素のスコア値を計算する SQL ステートメントをテストします。

### 次のタスク

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

## 外部インジケーターとブレークダウンのテスト {#ariaid-title6}

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

### 始める前に

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

### このタスクについて

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

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

### 手順

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

### 次のタスク

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

## 日付による外部データのフィルタリング {#ariaid-title7}

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

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

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

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

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

外部データを測定するときは、特定のパフォーマンス分析機能が利用できません。
* スナップショットは収集できません。
* リアルタイム スコアは表示できません。
* 第 2 レベルのブレークダウンは適用できません。
* 外部データを持つ第 2 レベルのブレークダウンに依存するウィジェットのチャート化を使用することはできません。これには、ピボットやヒートマップによるチャート化が含まれます。
* スナップショットが利用できないため、収集されたレコードの変更を表示できません。
{#pa-ext-data-limitations__ul_gh2_gbb_t1b}