ヘルス レポート、ジョブ モニタ、Governor 設定、およびデータ ウェアハウス監査ダッシュボード

ccppmop1571
HID_admin_health_report
管理者のセキュリティと診断のニーズを満たすために、システム ヘルス レポート、ログ分析ポートレット、現在実行中のジョブ モニタ、およびデータ ウェアハウス監査ダッシュボードを利用できます。
  • ヘルス レポートには、アプリケーション、データベース、およびデータ ウェアハウスのシステム ステータスが表示されます。
  • ヘルス レポートでは、非準拠のガバナー設定(最大データ制限)を検出することもできます。
  • 関連する検出分析レポートは、システムのカスタマイズを検出します。
  • [ログの分析] ページには、システムの統計情報、日単位 ページまたは XOG ビュー、およびログデータが含まれています。
  • [ジョブ モニタ]ページには、現在実行中のジョブが表示されます。
  • 15.6 以降では、新しいデータ ウェアハウス監査ダッシュボードに、データ ウェアハウスのロード ジョブの最新の進捗状況を表示されます。
2
必要なアクセス権
  • ヘルス レポートを実行するには、「
    管理 - アプリケーションのセットアップ
    」のグローバル アクセス権があることを確認します。
  • ログ分析ポートレットを表示するには、「
    管理 - アクセス
    」権限があり、ログ分析アクセス グループに割り当てられていることを確認します。
  • Tomcat アクセス ログを実行するには、「
    ジョブ - アクセス
    」権があることを確認します。 また、以下のインスタンス レベルのジョブ定義アクセス権があることを確認します: 「
    Tomcat アクセス ログ インポート/分析
    」の「
    ジョブ - 実行
Clarity PPM システム ヘルス レポートの表示またはダウンロード
Clarity PPM
アプリケーション サーバ、データベース、およびデータ ウェアハウスを含むシステム ヘルスは重要です。 管理者、アプリケーション サポート エンジニア、またはヘルプ デスク 技術者は、稼動状態を維持し、ダウンタイムを最小化します。 その他のサポート担当者に連絡したり、オンライン コミュニティと連携したりする前に、
Clarity PPM
システム ヘルスの迅速な評価を行います。
以下の手順に従います。
  1. 管理者アクセス権限でクラシック PPM にログインします。
  2. [管理]
    メニューをクリックします。
    [セキュリティと診断]
    [ヘルス レポート]
    を選択します。
  3. 以下のいずれかのタブを選択します。
    • 概要
      : このタブには、アプリケーション、データベース、およびデータ ウェアハウスのヘルス ステータスと完了率が表示されます。 [完了率 (%)]という値は、新規インストールまたはアップグレード中に値を必要とする設定の合計数を計算します。 ヘルス レポートの要約は、必要な設定のどの部分に値があるかを示します。 たとえば、「
      88% 完了
      」というのは、全設定の残り 12% に有効な値がないことを示しています。 レポートに設定完了というメッセージと緑のステータス アイコンが表示された場合、そのカテゴリのヘルスは良好であることを示しています。 セットアップが完了していない場合は、赤いアイコンが表示されます。 [詳細]をクリックし、他の 3 つのタブのいずれかを表示します。
    • アプリケーション
      : このタブには、アプリケーション サーバの詳細が表示されます。 設定には、ファイルの場所、URL、Java のバージョン、JVM、LDAP、SSO、SSL、およびポートが含まれます。 また、インスタンス特有の CSA の設定、背景(bg)、および beacon サービスも含まれます。
      • 新ユーザ エクスペリエンス
        の設定を確認するには、[アプリケーション インスタンス(app)]-[新規ユーザ エクスペリエンス]を展開します。 新しいバージョンが使用可能だが展開されていない場合、
        ppm-ux
        属性は赤色のアイコンで表示されます。
        新ユーザ エクスペリエンス
        機能は別々の Java WAR ファイルで提供および更新されます。 WAR ファイルには META-INF フォルダがある必要があります。
      • ガバナーの上限の設定を確認するには、[ガバナーの上限]を展開します。
      • その場で RateMatrix プロパティのステータスを切り替えるには、有効または無効をクリックします。 有効な場合、アプリケーションは、PRJ_RT_RATES_EXTRACTION レート マトリクスのオプションを適用します。 この設定はデフォルトで無効になります。
    • データベース
      : このタブでは、データベース接続、表領域、データベース オプション、およびサーバ パラメータに関する情報が提供されます。
    • データ ウェアハウス
      : このタブでは、データ ウェアハウス接続、表領域、データ ウェアハウス オプション、およびサーバ パラメータに関する情報が提供されます。 設定には、JDBC URL、データベース タイムゾーンの不一致、データベース サイズ、およびデータ ウェアハウスのロード ジョブに対する ETL ジョブ タイムアウトが含まれます。 このタブには、データ ウェアハウスのタイム スライスおよびその他のアプリケーション設定も含まれています。
      [修正]
      リンクをクリックすると、非準拠設定を修正できるアプリケーション ページに移動します。 たとえば、赤いアイコンおよび
      [修正]
      リンクは、エンティティまたはタイム スライスの設定に役立つように表示されます。
  4. [データベース]および[データ ウェアハウス]タブの各設定の推奨値を表示する方法
    1. [推奨]フィールドでは、コンプライアンスの達成およびシステム ヘルスの改善に必要な値を提供しています。 正確な値が推奨されていない場合、フィールドは空白のままになります。
    2. [ステータス]アイコンにマウスを合わせると、表示されているアイテムの修正に対する推奨が表示されます。
    3. Oracle データベース管理者の場合、V_$PARAMETER への権限を持っている場合があります。 権限を持っている場合は、[データベース パラメータ]を展開し、データベースおよびデータ ウェアハウス パラメータのヘルスを表示します。 権限を持たない場合、ステータス アイコンにマウスを合わせ、アクセスを許可するコマンドを表示します。
  5. 完全なヘルス レポートを Excel にエクスポートするには、[要約]タブで[ヘルス レポートのダウンロード]ボタンをクリックします。 HealthReport.xlsx.zipファイルを開いて、ExcelでHealthReport.xlsxファイルを表示します。
CSA で以前使用できたヘルス チェックは、このリリースでは使用できなくなりました。 新しいヘルス レポート タブ付きページを使用して、ヘルス レポートを Excel にダウンロードするか、または代わりにコマンド ライン ヘルス レポートを実行します。
コマンド ライン ヘルス レポート
コマンド ラインからヘルス レポートを実行するには、以下のコマンドを入力します。
admin healthreport
ヘルス レポートの除外
SaaS および FedRAMP 環境では、ヘルス レポート データベースおよびデータ ウェアハウス タブに以下のアイテムが表示されません。
  • JDBC URL
  • データベース パラメータ
  • SQLNET パラメータ
ガバナー設定(最大データ制限)
ガバナー設定は、特定のデータに対して最大制限値を適用することによりパフォーマンスを最適化します。 たとえば、アップロードされたドキュメント用に許可される最大サイズは 20 メガバイト、Excel にエクスポートできる行の最大数は 25,000 です。 これらの制限値により、一部のユーザが他の大半のユーザのパフォーマンスを低下させることがなくなります。
現在のリリースの Clarity PPM では、管理者は、既定の制限を、指定された重要な制限まで上書きできます。
以下の表は、推奨され適用されているガバナー設定を示しています。
名前
ガバナー フィールド
説明
DEF_LIMIT
CRITICAL_LIMIT
単位
ドキュメント サイズ
DMS_DOCUMENT_MAX_SIZE
最初のアップロード中のドキュメントの最大ファイル サイズ。
(以前から存在するドキュメントは、この設定を超過していても、ガバナーによって検証されません。)
20
50
MB
Excel にエクスポート
E2E_MAX_ROWS
クラシック PPM から Excel にエクスポート可能な行の最大数。
25,000
75,000
オブジェクト/NSQL 制限
MAX_FETCH_LIMIT
NSQL によってリスト ビューまたはグリッド ポートレットに取得可能な行の最大数。
(リスト ビューまたはグリッド ポートレットで集計を設定している場合にのみ、適用できます。)
50,000
100,000
SQL GEL 行
MAX_SQL_GEL_ROWS
GEL スクリプトを実行して取得可能な SQL クエリ行の最大数。*
100,000
120,000
CSV GEL 行
MAX_CSV_GEL_ROWS
最大 GEL CSV 行が許可されます。
25,000
50,000
タイムシート タスク
MAX_TIMESHEET_TASKS
1 つのタイムシート内のタスクの最大数。
250
300
タスク
最大 XML ノード
MAX_XML_NODES
XOG から読み取りまたは書き込みできるノードの最大数。
150,000
400,000
ノード
最大投資属性
PFM_LIMITS_MAX_INV_ATTRS
ポートフォリオの属性の最大数。
700
700
属性
ロールの PFM 制限
PFM_LIMITS_MAX_ROLES
ポートフォリオのロールの最大数。
75
100
ロール
Excel にエクスポート(App)
E2E_MAX_ROWS_APP
Excel にエクスポートできる最大行数(アプリケーション レベル設定)。
25,000
75,000
Excel へのエクスポート タイマ
E2E_TIMER
エクスポートを終了するまでの Excel へのエクスポート最大時間。
600
720
タスクの To Do アイテムの最大数
MAX_TODOS_PER_TASK
タスクの To Do アイテムの最大数。
25
40
To Do アイテム
最大ドキュメント数
DMS_MAX_DOCUMENTS
単一のアップロード セッションで許可されるドキュメントの最大数。
5
10
ファイル
最大添付ファイル数
ODF_MAX_ATTACHMENTS
ODF オブジェクトに対して許可される会話添付ファイルの最大数。
5
10
ファイル
CSV インポート制限
CSV_IMPORT_LIMIT
CSV インポート処理で許可されるレコードの最大数。
250
500
CSV エクスポート制限
E2CSV_MAX_ROWS
CSV エクスポートで許可されるレコードの最大数。
25,000
75,000
CSV へのエクスポート タイマ
E2CSV_TIMER
CSV にエクスポートするためのタイマ
1,800
2,000
最大要求パラメータ数
MAX_REQUEST_PARAMETER_COUNT
許可される要求パラメータの最大数。
1,800
1,800
パラメータ
*15.5.1 では、Excel に対する同じ制限は MAX_CSV_GEL_ROWS=25000 で CSV に適用されます。 この制限を MAX_SQL_GEL_ROWS=100000 と混同しないでください。 15.5.1 以降にアップグレードするまでは、非常に大きな CSV ファイル内のレコードの読み取り、実行、または追加を行う GEL スクリプトを作成しないでください。 メモリ不足エラーおよびアプリケーションの停止が発生することがあります。
パフォーマンスを最適化またはメンテナンスするために、承認済みの既定値が適用されます。 オンプレミス管理者には、これらの設定を変更しないことをお勧めします。
以下の制限は、ガバナー設定では設定されませんが、新ユーザ エクスペリエンスでハードコードされています。
設定
最大
単位数
ボードのレイアウトの列の最大数。
100
CSV にエクスポートできる最大行数。
250,000
設定可能な詳細パネルのフィールドの最大数。
200
フィールド
新機能: PPM データベースに格納されている Clarity PPM 15.6.1 のガバナー制限
15.6.1 以降をアップグレードまたはインストールすると、ガバナーの制限がデータベースに格納されるようになりました。
  • 新規インストールでは、上記の推奨値に設定されます。
  • アップグレードでは、以前の設定が保持されます。
ガバナー制限を管理するための新しい API
  1. API コールが機能するために必要なサーバ設定
    <accessToServerStatus allow="ALL" />
  2. 以下の API ランディング ページに移動します。
    http(s)://<server>:<port>/niku/serverstatus/governorlimits
  3. 応答を HTML 形式で表示するには、以下の URL を使用します。
    http(s)://<server>:<port>/niku/serverstatus/governorlimits?run=html
  4. 違反者の結果を取得するには、以下の URL を使用します。
    http(s)://<server>:<port>/niku/serverstatus/governorlimits?type=violators
新しい admin コマンド
オンプレミス管理者は、一連の
admin governors
コマンドを使用して、ガバナー制限を重要な制限のみ(推奨されていませんが、システムによって許可される)まで拡張できます。
  • これらのコマンドは、ガバナー制限を確立された重要な制限まで一時的にバイパスするために許可およびサポートされる、排他的な方法です。
  • 重要な制限は、すべての SaaS 顧客に対して設定された最大数に基づいて決定されました。
  • 重要な制限を回避する唯一の方法は、直接データベースを更新する(サポートされていない、または推奨されない)ことです。
コマンドは、set、unset (reset または restore defaults とも呼ばれる)、および list オプションをサポートしています。
admin governors -set <governorKey> <governorValue>
admin governors -list <governorKey|all|violated>
admin governors -unset <governorKey|all> set to default and enables governor
C:\Windows\System32>admin governors -list MAX_SQL_GEL_ROWS Code: MAX_SQL_GEL_ROWS Current Limit: 110000 Critical Limit: 120000 Default Limit: 100000 Active: true # # # # # # # # # # # # # # # # # #
カスタマイズ検出分析レポートのダウンロード
このレポートは、オンプレミス環境を SaaS 環境に移行する準備の際の CA Technologies Global Delivery チーム、CA サポート、および高度な管理者用に設計されています。 オンプレミス環境で許可されている一部のカスタマイズは、SaaS 環境では許可されていない可能性があります。 非準拠オブジェクトおよびその他の要因によって、レポート カバー ページの複雑度の予想レベルが決定されます。
以下の手順に従います。
  1. 管理者アクセス権限で
    Clarity PPM
    にログインします。
  2. [管理]
    メニューをクリックします。
    [セキュリティと診断]
    [ヘルス レポート]
    を選択します。
  3. [要約]タブで、
    [検出分析レポートのダウンロード]
    ボタンをクリックします。 出力には、非準拠オブジェクト、データ ソース、およびグリッド ポートレットを含むデータのタブが約 20 含まれています。 環境をアップグレードまたは変更する前に、これらのカスタマイズについて議論してください。
  4. (オプション)大規模な展開の場合、検出分析レポートを利便性のためのジョブとしても利用することができます。 このレポートを準備するには、[PPM カスタマイズ検出分析]ジョブの[アクティブ]チェック ボックスをオンにします。 ジョブは Excel スプレッドシートを生成します。これは、実行時にジョブパラメータで指定された受信者にメールで送信することもできます。
詳細
  • ドキュメントの英語版で「ジョブ参照」の「
    PPM カスタマイズ検出分析ジョブ
    」を参照してください。
システム統計およびログ データの表示
システム パフォーマンスを調べるには、[ログ分析]ポートレットを使用します。 これらのポートレットは、アプリケーション サーバのログ ファイルを解析し、視覚的な分析のためにこれらのファイルをデータベースに保存するプロセスを自動化します。 これらのポートレットを使用して、パフォーマンス ボトルネック、アクセス頻度の高い機能、レスポンス時間、ピーク時間などを特定します。
以下の手順に従います。
  1. 管理者アクセス権限で
    Clarity PPM
    にログインします。
  2. このドキュメントの冒頭にある「
    必要なアクセス権
    」セクションを参照してください。 これらのポートレットでデータを更新するには、まずサーバからデータをエクスポートし、アプリケーション データベースにインポートするジョブを実行します。
  3. [管理]
    メニューをクリックします。 [
    セキュリティおよび診断
    ]で、[
    ログ分析
    ]を選択します。
  4. 以下のいずれかのタブを選択します。
    1. システム状態(時間/日別)
      : 平均サーバ レスポンス時間、合計セッション数、および特定の日に実行された最も低速のアクションのリストを表示するには、このタブを使用します。
    2. システム状態(月別)
      : すべてのサーバに対する、またはサーバ別にグループ化された、月別ページ ビューおよび XOG リクエストを表示するには、このタブを使用します。 また、月別のセッション数を表示することもできます。
    3. 日次ページ/XOG ビュー数
      : 最も低速の 20 のページを分析するには、このタブを使用します。 たとえば、最も低速のページに対してトラブルシューティングを行い、パフォーマンスを高めるために最適化することができます。 このタブには、サービス別またはサーバ別のページ ビュー、日別のページ ビュー、日別の平均レスポンス時間、サービス別またはサーバ別の XOG リクエスト、それらの平均レスポンス時間、および日別の XOG コールの合計数が含まれます。
  5. フィルタ条件を入力します。
    1. [日付]
      を選択します。
    2. [すべて]
      [ローカル]
      など、
      [環境]
      を選択します。
    3. [すべて]
      や特定のアプリケーション サーバなど、
      [ホスト名]
      を選択します。
    4. [フィルタ]
      をクリックします。
  6. データをエクスポートするには、
    [ログ データ エクスポート]
    タブをクリックします。 エクスポートするデータの
    [環境]
    および日付範囲を指定します。 エクスポートされるデータの各行には、日付、すべてのユーザによる合計ページ ビュー、ページの平均レスポンス時間(秒単位)、XML Open Gateway (XOG)リクエストの合計数、XOG の平均レスポンス時間、およびその日の一意のセッション数が表示されます。
  7. これらのタブのポートレットのいずれかを設定するため、利用可能な場合は、
    [設定]
    をクリックします。 データを Excel または PowerPoint にエクスポートするには、[Excel にエクスポート]または[PowerPoint にエクスポート]をクリックします。 すべてのポートレットが、これらのオプションをサポートするわけではありません。
[平均応答時間(サーバ別)]の以下の例では、特定の日の午前 9 時 00 分に低速のレスポンス時間が観察されました。 詳細な分析により、ユーザのグループが同様のクエリ、ジョブ、およびプロセスを実行していたことがわかりました。 時間のかかるプロセスを再スケジュールすると、レスポンス時間が改善されました。
ログ分析ポートレットの例。
以下の例では、[低速アクション数(日別)]ポートレットで確認できるデータを示します。
URL
時間(秒)
開始
終了
ホスト名
メソッド
バイト数
セッション Cookie
ユーザ名
security.loginAction
18.5
20180223 14:20:1020180223 14:20:10
20180223 14:21:3420180223 14:21:34
myserver.name1myserver.name1
ポスト
42,30042,300
S131430_DD778-4012S131430_DD778-4012
user12
unreadPushNotificationsCountunreadPushNotificationsCount
12.3
20180223 15:44:1720180223 15:44:17
20180223 15:45:0820180223 15:45:08
myserver.name2myserver.name2
取得
6,100
S131437_EE778-4014S131437_EE778-4014
admin14
セッション ID の関連ユーザ名は、システム内のユーザ アクティビティをトレースするのに役立ちます。 たとえば、user_01 が Studio でカスタム オブジェクトを削除した後、user_02 が、[URL]列に示されている別のページで遅延およびパフォーマンス低下の通知を開始しました。
ユーザがアプリケーションにログインすると、トリガにより、そのユーザ名および関連するセッション ID クッキー値が記録されます。
ジョブ モニタ
管理者は、ジョブ モニタを表示して、各サーバで現在実行されているバックグラウンド ジョブを特定します。
以下の手順に従います。
  1. 管理者アクセス権限で
    Clarity PPM
    にログインします。
  2. [管理]-[セキュリティと診断]
    -
    [ジョブ モニタ]
    を選択します。 以下の情報が表示されます。
    • ジョブ名
      : 現在実行されているジョブのインスタンス。
    • 実行 ID
      : 現在実行中のジョブのインスタンス ID。
    • ジョブ ID
      : 実行中のジョブの先祖または親の ID。
    • ジョブ定義名
      : 先祖または親のジョブ名。
    • ジョブ定義 ID
      : 先祖または親のジョブ定義。
    • 説明
      : ジョブのオプションの説明。
    • スケジューラ サーバ
      : ジョブ プロセスをキューに入れ、現在ジョブを実行しているサーバ。 例: [email protected]_server1.xx.yyy
データ ウェアハウス監査ダッシュボードの表示
新機能: ビデオ: Clarity PPM 15.6 にデータ ウェアハウスのロード ジョブ監査ダッシュボードを搭載

以下の手順に従います。
  1. 管理者アクセス権限でクラシック PPM にログインします。
  2. [管理]-[セキュリティと診断]
    -
    [データ ウェアハウス]
    をクリックします。
  3. (オプション)監査データを検索するには、
    [+ Expand Filter (+ フィルタの展開)]
    をクリックし、フィルタ条件を入力してから、
    [フィルタ]
    をクリックします。
  4. [データ ウェアハウス監査]
    ポートレットには、以下のフィールドが表示されます。
    • データ ウェアハウス テーブル名
    • 更新日
    • ロード開始日時のタイムスタンプ
    • ロード終了日時のタイム スタンプ
    • 期間(秒)
    • 行数
  5. 監査データを確認します。 たとえば、行数や期間でソートして、テーブルの最大負荷を確認します。
  6. 何らかのエラーが発生した場合、
    [データ ウェアハウス エラー]
    ポートレットには、以下のフィールドが表示されます。
    • データ ウェアハウス テーブル名
    • エラー メッセージ
    • エラー番号
    • SQL コマンド
  7. (オプション)監査またはエラー ポートレットを設定するには、
    [オプション]
    をクリックします。 データをエクスポートすることもできます。 たとえば、問題のある SQL コマンドを CSV ファイルにエクスポートし、トラブルシューティング チームに送信します。
以下のイメージは、Clarity PPM 15.6 に搭載されているデータ ウェアハウス監査ダッシュボードの例を示しています。
この図は、Clarity PPM データ ウェアハウス監査ダッシュボードを示しています。