On this page:

Relevant pages:

SNP CrystalBridge® Monitoring コネクタには、分析 API を介して SAP システムデータをカスタム分析データに複製するために使用されるアダプタが含まれています。使用するアダプタは、t-code /DVD/APPD_CUST > [Analytics events API settings ] > [Version] ドロップダウンリストを使用して選択できます。「AppDynamics イベントサービスと分析への接続」を参照してください。

20.11.0 リリースより前では、Legacy アダプタのみが使用可能でした。リリース 20.11.0 では、Harmonizedアダプタは使用可能ですが、現時点ではまだオプションです。

分析 API アダプタは、t-code /DVD/APPD_CC > KPI detail tableに基づいて実行されます。スキーマは、[Anl (Replicate to Analytics)] チェックボックスがオンになっていて、SNP CrystalBridge® Monitoring ジョブが詳細テーブルにリンクされた KPI 値を収集する場合にのみ作成され、行のデータが入力されます（列 [Custom event type] は詳細テーブル名に対応します）。 

詳細テーブルと KPI 間のリンクは、[Assigned to KPI] にあります。[MIX] 値をクリックすると、関連する KPI の完全なリストが表示されます。

KPI がモニターされているかどうかは、[Running profile] のメトリックマッピングのテーブルで確認できます。この値が空の場合、[Anl] チェックボックスがオンになっていても、KPI の収集、SNP CrystalBridge® Monitoring 詳細テーブルへのデータの入力、分析 API アダプタの実行は行われません。

KPI がメトリックマッピングのテーブルにない場合、t-code /DVD/MON を使用して、特定の KPI または詳細テーブルがアクティブなモニタリングジョブによって処理されているかどうかを確認できます。コレクタジョブを右クリックし、[Show monitored KPI(s)] を選択します。

使用可能な分析 API アダプタについては、以降のセクションで説明します。

レガシーアダプタ

このアダプタは、Schema nameの値に従って名前が付けられたカスタムスキーマを作成します。これは、分析に関連するものとしてマークされた KPI detail tables とイベントサービスとの間に 1：1 のマッピングがあることを意味します。

分析 API 制限

分析 API（分析イベント API）は 20 custom analytics schemasに制限されます。この制限は、次の間で共有されます。

  • 初期状態の分析に関連するとしてマークされたデフォルトの詳細テーブル。
  • 顧客による分析に関連するものとしてマークされたカスタムの詳細テーブル。
  • ビジネスジャーニーによって作成されたスキーマ。
  • 分析イベント API を使用する他のツールおよびベンダーによって作成されたカスタムスキーマ。

つまり、最大 20 のテーブルのみを使用して SAP データを whole accountの分析に複製できることを意味します。「カスタムイベントの取り込みの制限」も参照してください。


このアダプタは、各スキーマに次の技術フィールドを追加します。

  • Application：t-code /DVD/APPD_CUST でカスタマイズされた値。
  • Tier：t-code /DVD/APPD_CUST でカスタマイズされた値。
  • Node：アプリケーションサーバーの名前と連結されているアプリケーション。
    • 詳細テーブルにサーバー（ノードレベル）データが入力されている場合、この値はデータの送信元のアプリケーションサーバーに対応します。
    • 詳細テーブルにシステム（階層レベル）データが入力されている場合、この値はモニタリングジョブがデータを収集したアプリケーションサーバーに対応します。
  • SID：SAP システム ID。
  • TIMESTAMP：モニタリングジョブ実行のタイムスタンプ。

特別なフィールド：

  • EVENT_TIMESTAMP：詳細テーブルにこのフィールドが含まれている場合、通常はイベントサービスによって入力されるデフォルト [Timestamp（eventTimastamp）] フィールド値を上書きするために使用されます。
  • USER_EXPERIENCE：詳細テーブルにこのフィールドが含まれている場合、[User Experience ] フィールドはカスタム分析スキーマに追加されます。

整合アダプタ

このアダプタは、ABAP エージェントが使用するカスタム分析スキーマの総数を減らすために導入されました。スキーマグループ化モデルを KPI detail tablesのリストに追加しました。このアダプタを使用すると、カスタム分析スキーマ名がSchema group nameの値に対応します。デフォルトのスキーマグループの完全なリストについては、「レガシー分析スキーマと整合分析スキーマ間のマッピング」を参照してください。

Schema group nameが空の場合、またはSchema group が NONE の場合、行が分析に関連するものとしてマークされていても、データはイベントサービスに送信されません（[Anl] チェックボックスはオンになっています）。 

KPI detail tablesのリストに追加されたカスタム行は、分析に関連するものとして設定でき、スキーマグループ CUSTOM1、CUSTOM4 のいずれかを使用できます。これは、デフォルト行（元のSchema groupの値は NONE）が上書きされている場合でも可能です。

分析 API 制限

カスタムスキーマフィールドのカウント制限を回避するために、これらのカスタムグループ間でカスタムテーブルと上書きされたテーブルを分散することをお勧めします。「カスタムイベントの取り込みの制限」を参照してください。

このアダプタは、各スキーマに次の技術フィールドを追加します。

  • application：t-code /DVD/APPD_CUST でカスタマイズされた値。
  • tier：t-code /DVD/APPD_CUST でカスタマイズされた値。
  • node：アプリケーションサーバーの名前と連結されているアプリケーション。
    • 詳細テーブルにサーバー（ノードレベル）データが入力されている場合、この値はデータの送信元のアプリケーションサーバーに対応します。
    • 詳細テーブルにシステム（階層レベル）データが入力されている場合、この値はモニタリングジョブがデータを収集したアプリケーションサーバーに対応します。
  • sapTabname：詳細テーブル名。値は Custom event typeの下のKPI detail tables の行の値に対応します。
  • sapSchema ：以前にレガシーアダプタで使用されていたスキーマ名。値は Schema nameの下のKPI detail tables の行の値に対応します。
  • SID：SAP システム ID

特別なフィールド：

  • EVENT_TIMESTAMP：詳細テーブルにこのフィールドが含まれている場合、通常はイベントサービスによって入力されるデフォルト [Timestamp（eventTimastamp）] フィールド値を上書きするために使用されます。
  • USER_EXPERIENCE：詳細テーブルにこのフィールドが含まれている場合、[User Experience ] フィールドはカスタム分析スキーマに追加されます。

整合アダプタへの移行

レガシーアダプタから整合アダプタに移行する場合は、分析 API の制限を考慮する必要があります。最も重要な制限は、20 custom analytics schemas per accountです（システムごとの SAP ではありません）。制限にすでに達している場合、または十分なカスタム分析スキーマが使用できない場合は、準備なしでレガシーコレクタを整合コレクタに切り替えると、分析データのレプリケーションが失われます。

分析 API アダプタが整合アダプタに切り替わると、次のようになります。

  1. レガシーカスタムスキーマは、切り替える前に記録されたデータを保持します（データ保持の長さは、購入したトランザクション分析ライセンスの数によって異なります）が、新しいデータは受信しません。
  2. 整合アダプタは新しいカスタム分析スキーマの登録を試みます。「レガシー分析スキーマと整合分析スキーマ間のマッピング」を参照してください。
    1. 整合カスタムスキーマが正常に作成されると、レガシーカスタムスキーマの代わりにデータの受信を開始します。
    2. 整合カスタムスキーマの作成が失敗すると、レガシーカスタムスキーマに以前記録されたデータは記録されなくなります。

モニタリングデータの損失を防ぐには、カスタム分析スキーマの使用を減らすために次の手順を検討します。整合アダプタには、少なくとも 6 つの空き状態のカスタム分析スキーマリソースが必要です（BiQ コレクタを使用する場合は +1、カスタムテーブルを分析に複製する場合は +1）。

  1. 非生産的な SAP システムで t-code /DVD/APPD_CUST を使用して分析イベント API を一時的に無効にします。 
  2. 生産的な SAP システムで使用されていないカスタムスキーマを確認し、それらを削除します。
  3. 十分なカスタム分析スキーマリソースを使用できない場合は、生産的な SAP システムで未使用または重要度の低いレガシースキーマのレプリケーションを一時的に無効にすることを検討してください。
  4. また、非アクティブ化された生産的なレガシースキーマも削除します（データ保持ポリシーによってスキーマからすべてのデータが削除された後または直後）。
  5. 非生産的な SAP システムを整合アダプタに切り替え、t-code /DVD/APPD_CUST  を使用して分析イベント API をアクティブ化し、すべての整合カスタム分析スキーマが正しく登録されるようにします。
  6. すべての整合スキーマが登録されたら、すべての実稼働システムを整合アダプタに切り替え、すべてのスキーマにデータが入力されることを検証します。
  7. 生産的な SAP システムを移行したら、非生産的な SAP システムを移行して分析イベント API をオンに戻すこともできます。

分析ダッシュボードとメトリックの移行

レガシーアダプタから整合アダプタに移行すると、レガシースキーマはデータの受信を停止し、一部は移行中に削除されて限られたリソースを解放します。

ダッシュボードまたは分析クエリメトリックで使用されているカスタムスキーマを確認してください。レガシーカスタム分析スキーマを使用するダッシュボードは、手動で調整する必要があります。レガシーカスタム分析スキーマから作成されたメトリックは、再作成する必要があります。これは、レガシーメトリックが切り替え後に最終的に 0 のままになるため、このようなメトリックがアラートに使用される場合に特に重要です。

整合スキーマに複製されたデータには、既存のダッシュボードを簡単に移行できるように、[sapSchema] フィールドにレガシースキーマ名が含まれます。ダッシュボードおよびメトリックでレガシースキーマから整合スキーマに切り替えるには、次の手順を実行します。

  1. レガシー分析スキーマと整合分析スキーマ間のマッピングを確認して、新旧のスキーマ名を特定します。
  2. ダッシュボードウィジェットまたはメトリックの背後にあるクエリを編集し、次の変更を実行します。
    1. クエリ文字列の FROM 部分の古い（レガシー）スキーマ名を新しい（整合）スキーマ名に置き換えます。
    2. WHERE 条件 AND sapSchema = <古いスキーマ名> を追加します。

例：

Legacy query

SELECT * FROM idocs_details WHERE SID = "ED2"
SQL

Migrated query

SELECT * FROM sap_idoc_data WHERE SID = "ED2" AND sapSchema = "idocs_details"
SQL

カスタム分析スキーマの削除

21.11.0 リリース以降では、ABAP エージェントによって生成されたカスタム分析スキーマを削除できます。 

前提条件

  1. 分析イベント API 設定を維持する必要があります。
  2. OAuth 設定を維持する必要があります。

未使用のカスタム分析スキーマを削除するには、t-code /DVD/APPD_STATUS に移動し、[Event service] ノードを展開します。[Custom Analytics Schemas] ノードを展開すると、ABAP エージェントによって生成されたカスタム分析スキーマの完全なリストがロードされます。未使用のスキーマ名の横にある削除ボタンを使用できます。 

削除ボタンをクリックし、ポップアッププロンプトでイベントサービスからスキーマを削除することを確認します。


[Used] ステータステキストをクリックすると、スキーマにデータを入力する SAP システムのリストを表示できます。

使用済みスキーマの削除

デバッグモードをアクティブにすることで、まだデータが含まれているスキーマを削除できます。この変更は元に戻せません。ポップアッププロンプトが確認されると、スキーマとそれに含まれるすべてのデータがイベントサービスから削除されます。

トラブルシューティング

  • Schema is empty or does not exist

    • SNP CrystalBridge® Monitoring コレクタが正常に実行されているかどうかを確認します。

    • 整合またはレガシーバージョンを使用している場合は、/DVD/APPD_CUST の分析アダプタ設定を確認します。

    • バージョンに応じて、正しい分析スキーマでデータを検索していることを確認してください。20.11 リリース以降、コントローラ上のスキーマの数を減らすために、複数のスキーマがスキーマグループにマージされました。このマッピングはこちらにあります。

    • 正しいスキーマを検索してもデータが表示されない場合は、スキーマがレガシーバージョンから整合バージョンに移行し、分析スキーマ数の制限により新しいスキーマグループが登録できなかった可能性があります。

      • ABAP エージェントバージョン 21.11 以降を使用している場合は、このガイドに従って、未使用のスキーマをトランザクション /DVD/APPD_STATUS から直接削除できます。

      • 21.11 より前のバージョンを使用している場合は、スキーマの削除についてサポートに連絡してください。