APM ChangeDetector データの表示

内容
apmdevops104jp
内容
CA APM ChangeDetector は、ユーザが容易にアプリケーション環境の変更を監視できるように CA Introscope を拡張して、CA Introscope に直接統合されます。
CA APM ChangeDetector をインストールしたまま、CA Introscope のこれらの変更を参照します。
  • CA Introscope コンソールで、CA APM ChangeDetector ダッシュボードは変更データの概要を表示します。
  • Workstation では、[変更]タブに変更データが階層化されたツリー ビューまたはテーブル ビューで表示されます。
  • Workstation では、変更ビューアでオプションを設定して、表示する変更を指定できます。
  • CA Introscope メトリック グラフおよびダッシュボードで、注釈は変更イベントを識別します。
  • CA Introscope レポートで、変更の履歴を参照できます。
すべての CA Introscope エージェントが Enterprise Manager に接続する前に MOM に接続した場合は、変更の数と CA Introscope エージェントの数が誤って Workstation に表示されます。データを更新するには、数分間、別のノードをクリックするか、別の Investigator を開きます。
変更データの表示 
CA APM ChangeDetector をインストールして設定する場合、監視する CA Introscope エージェントを特定し、CA APM ChangeDetector が収集する変更データのタイプを指定します。また、Workstation で変更データを表示してレポートを作成できます。
Workstation では、以下のように変更データを表示できます。
  • CA APM ChangeDetector ダッシュボード
  • Investigator のツリー ビュー
  • Investigator のテーブル ビュー
Investigator の変更テーブルには、[変更ビューア ウィンドウの起動]ボタンがあります。Change Viewer には、表示する変更データをさらに細かく制御するためのオプションがあります。
CA APM ChangeDetector ダッシュボードでの変更データの表示
CA Introscope コンソールには、変更データの概要を表示する CA APM ChangeDetector ダッシュボードが含まれます。
ChangeDetector ダッシュボードには、変更データが以下のように表示されます。
  • アラート インジケータは、過去 20 分間の変更を表示します。CA APM ChangeDetector は過去 20 分間に変更があったかどうかを確認します。これは過去 20 分間の累積値ではありません。たとえば、過去 20 分間に変更が 10 存在する場合でも、これらの変更が別の期間に送信された場合は、黄色のインジケータになります。インジケータが赤色になるのは、1 つの期間で 5 つ以上の変更がある場合のみです。
  • CA Introscope エージェントが最後に再起動されてから、1 つの間隔当たりに検出された変更がグラフに表示されます。
  • CA Introscope エージェントが最後に再起動されてから、完了したスキャン数がグラフに表示されます。
CA APM ChangeDetector の開始
CA APM ChangeDetector を開く方法
  • CA Introscope Investigator を開き、[変更]タブをクリックします。CA APM ChangeDetector が[ツリー ビュー]モードで開きます。
ツリー ビューでの変更データの表示
Investigator の CA APM ChangeDetector のツリー ビューには、ルート ノードの[
変更
]に変更データが階層化され、さらに日付と時間でグループ化されて表示されます。ツリー ビューは、デフォルトの Investigator ビューです。
変更データの整理
CA Introscope Investigator のツリーでエージェントの ChangeDetector ノードをクリックするか、または CA Introscope エージェントの ChangeDetector データソースのいずれかをクリックすると、特定のCA Introscope エージェントの変更データも表示できます。
  • 注: ChangeDetector データソースがシャット オフされると、[一般]タブのメトリック データは表示されなくなりますが、[変更]タブの変更データはそのまま表示されます。
  • Introscope の[変更]タブには、先週の変更データと、セッション中の変更のライブ データが表示されます。別の対象期間を選択すると、その対象期間の変更データが表示されます。
  • ChangeDetector 構成パラメータを使用して、デフォルトの期間を変更して変更データを表示できます。詳細については、「ChangeDetector のインストールと設定」を参照してください。
  • ツリー ビューの変更データは、時間ごと、またはリソースごとにグループ化できます。いくつかの変更があるノードをクリックすると、下部のペインに、そのノードの変更イベントがすべてテーブル形式で一覧表示されます。
  • 下部のペインの変更イベントを右クリックすると、さらに別の表示オプションが選択できます。
    • [強調表示]を選択すると、テーブルが強調表示されて特定の種類の変更がさらに見やすくなります(「テーブルの強調表示の使用」を参照)。
    • [この変更を親ビューで選択]をクリックすると、その変更のツリー ビューが開くと共に、[変更概要]タブにその特定の変更データが表示されます。
    • [このリソースの変更履歴を新しいウィンドウで表示します]をクリックすると、別のウィンドウにテーブル ビューが開いて、選択したリソースの変更履歴が表示されます。
[変更概要]タブでの情報の表示
ツリーで変更を 1 つ選択すると、必ず[変更概要]タブが開きます。[変更概要]タブには、常に[変更サマリ]が表示されます。さらに、[変更メタデータ]および[変更詳細]パネルが表示される場合もあります。
  • 変更サマリ
    変更を 1 つ選択すると[変更概要]タブに表示されます。変更サマリには、変更に関する基本情報が表示されます。表示される情報は、エージェント ID、変更時刻(ファイルのみ。以下の注記を参照)、検出時刻、変更の種類、リソースとデータソースの名前、およびデータソースの種類です。
  • 変更メタデータ
    変更データにメタデータが含まれる場合に[変更概要]タブに表示されます。たとえば、ファイルの変更の場合、メタデータには、Last Time Modified と File Size が含まれます。
  • 変更詳細
    変更の詳細を[以下のバージョン以前]/[以下のバージョン移行]テーブルに表示できる場合にのみ [変更概要]タブに表示されます。たとえば、環境プロパティ、データベース属性、および Java クラスなどの種類のデータの場合です。
注:
ファイルの場合、オプションの Workstation のプロパティを設定すると、CA APM ChangeDetector は変更の検出時刻とファイルの最終変更時刻を区別します。CA APM ChangeDetector 対応のエージェントを初めて起動した場合、ファイルの最終変更時刻がライブ タイム 期間(デフォルトで 7 日)よりも前だと、ライブ モードでファイルの追加イベントが表示されないことがあります。
ただし、表示されていない、現在の時間範囲で、[時間範囲]ドロップダウン リストから別の時間範囲を選択してデータにアクセスすることができます。「検出時刻」と「変更時刻」の間の時間差がスキャンの時間より長い場合、一部のインスタンスでは CA APM ChangeDetector はファイルの変更を検出するフル スキャンよりも長い時間を必要とすることがあります。これには、さまざまな理由があります。たとえば、既存のファイルを上書きしてファイルの名前が変更されたとします。CA APM ChangeDetector は、上書きされたファイルの変更イベントとしてこの状況を判断しますが、このファイルの最終変更タイムスタンプは、名前を変更する前のタイムスタンプのままです(この動作は、オペレーティング システムによって異なります)。このため、このような状況が発生します。また、一部のオペレーティング システムでは、システム ユーティリティを使用して、ファイルの最終変更タイムスタンプを変更できます。これによっても、同じ状況が発生します。変更時刻を表示するように ChangeDetector を設定するには、「オプションの構成プロパティ」を参照してください。
[テキスト差分表示]タブでの情報の表示
ChangeDetector の[テキスト差分表示]タブを使用して、テキスト ファイルの内容の差異を特定できます。
[テキスト差分表示]タブは、以下の変更を選択すると、ChangeDetector のツリー ビューまたはテーブル ビューに表示されます。
  • テキスト ファイル(構成ファイルなど)、および
  • 構成ファイル(ChangeDetector-config.xml)に定義されている
    maxFileSizeToUpload
    プロパティの値よりもサイズが小さいファイル
サイズが maxFileSizeToUpload よりも大きいテキスト ファイルは、Workstation の[テキスト差分表示]に表示されません。
テーブル ビューでの変更データの表示
Investigator でリソースを選択すると、そのリソースの変更データをツリー ビューまたはテーブル ビューで表示できます。ツリー ビューで変更イベント(削除や修正など)を選択すると、選択したイベントの詳細を示す行がテーブル ビューで強調表示されます。
テーブル ビューに表示されたデータは、変更の種類、検出時刻、リソース名、データソース、およびエージェント ID など、さまざまな軸で並べ替えられます。
[テーブル ビュー]での所有者データの表示
CA APM ChangeDetector は、ファイル システム監視データソースに対して変更を行ったユーザを識別します。
デフォルトの ChangeDetector 設定に加えて、ChangeDetector で所有者名を表示するには、PATH 環境変数を設定します。
以下の手順に従います。
  1. Windows および LD_LIBRARY_PATH for UNIX の PATH 環境変数に、必要な dll/so ファイルを含むフォルダのパスを設定します。
    たとえば、デフォルト設定で cdnativefile_<bitNo>.dll または libcdnativefile_<bitNo>.so は、エージェントのインストールの共通のフォルダにあります。
    Windows の場合
    set %PATH% = %PATH%;<agent_home>/common
    Linux の場合
    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<agent_home>/common
  2. テーブル ビューで、ファイル システム データソースを表示します。
[所有者]列で、ユーザの識別情報が表示されます。
その他のデータソースを表示する場合、[テーブル ビュー]の[所有者]列にはデータが表示されません。
テーブルの強調表示の使用
特定の種類の変更データをわかりやすく表示するために、テーブル ビュー内のイベントを強調表示できます。強調表示では、変更の種類、検出時刻、リソース、データソース、またはエージェントごとに色を変更できます。
強調表示を適用する方法
  1. 強調表示する特性を持つイベント(たとえば、特定のリソースのイベント、または修正イベントなど)を選択します。
  2. イベントを右クリックして、[強調表示]を選択し、[変更タイプ別]、[検出時刻別]、[リソース別]、[データソース別]、または[エージェント別]の中から強調表示する特性を選択します。
    [変更時刻別]を選択した場合は、時間範囲も指定する必要があります。
  3. 強調表示の色を選択します。
    これにより、選択した特性を持つイベントがすべて強調表示されます。
強調表示の動作
強調表示は、定義した順序が優先されて適用され、重複しません。たとえば、変更タイプを対象にして赤い強調表示を定義した場合、その変更タイプのイベントはすべて赤く強調表示されます。次に、リソースを対象にして黄色い強調表示を定義すると、赤く強調表示されたイベントの色は変わりません。黄色の強調表示は、残りのイベントが、選択したリソースに一致した場合に適用されます。
  • 強調表示の優先順位はすべて変更できます。
  • 各強調表示は個別に削除することも、すべて一度に削除することもできます。
    以下の例の[強調表示]メニューを参照してください。3 つの強調表示が定義されています( リソース、検出時刻、およびデータソース)。
グラフおよびレポートでの変更データの表示
CA APM ChangeDetector は、変更データに関する情報を CA Introscope のグラフに統合します。また、過去 24 時間にシステムで発生したすべての変更を表示するレポート テンプレートを提供します。
統合された CA APM ChangeDetector グラフ
CA APM ChangeDetector は、変更データに関する情報を CA Introscope のグラフに統合します。変更データは、グラフの X 軸の下とヒントにグラフの注釈として表示されます。
CA APM ChangeDetector のグラフ注釈の表示
CA APM ChangeDetector のグラフ注釈には、凡例に対応する記号と色が使用されるため、変更の起源を簡単に特定できます。以下に、ChangeDetector のグラフ注釈の機能の一部を示します。
  • 注釈の上にマウス ポインタを置くと、ヒントが開いて詳細情報が表示されます。
    複数のグラフ注釈の位置が近すぎて識別できなくなる可能性があるため、CA APM ChangeDetector では最大で 5 つの注釈を積み上げてヒントに表示し、同時に読めるようにします。注釈が 6 つ以上ある場合は、ウィンドウの上部に注釈の総数を示すメッセージが表示されて、最初の 5 つの注釈のみが表示されます。
  • グラフ注釈をダブルクリックすると、Change Viewer が開かれて、注釈の両側にある 2 本のグリッド線の間で発生した変更が一覧表示され、注釈自体に対応するイベントがハイライト表示されます。
  • グラフに表示される注釈は、グラフに現れているメトリックによって異なります。たとえば、グラフ内に CA Introscope エージェント A、B、および C からのメトリックが表示されているときに、エージェント A と B のみが CA APM ChangeDetector 対応である場合は、エージェント A と B からの、指定期間内の変更の注釈のみが表示されます。
  • 指定期間内に変更がない場合は、変更データが表示されず、グラフ最下部の変更の注釈も表示されません。
表示されるグラフ注釈の指定
グラフに表示される注釈を指定できます。たとえば、特定のデータソースまたはリソースからの注釈のみを表示したい場合や、ある CA Introscope エージェントから収集された変更を、別の CA Introscope エージェントから収集されたメトリックと相関させたい場合に、この機能は便利です。
表示される変更は、以下のいずれかの方法で指定できます。
  • Investigatorで、[プロパティ] - [グラフ注釈オプション]を選択します。
  • グラフを右クリックして、[グラフ注釈オプション]を選択します。
注釈オプションの変更は、現在のグラフにのみ適用されます。グラフからほかの場所に移動すると、変更は維持されません。
グラフの注釈を指定する方法
  1. [グラフ注釈オプション]ダイアログ ボックスを開きます。
  2. [デフォルト オプションを使用]または[カスタム オプションを使用]を選択します。
    デフォルト設定
    グラフにメトリックが表示されている CA APM ChangeDetector 対応エージェントのグラフ注釈のみを表示します。
    たとえば、グラフ内に CA Introscope エージェント A、B、および C からのメトリックが表示されているときに、エージェント A と B のみが CA APM ChangeDetector 対応である場合は、エージェント A と B からの、指定期間内の変更の注釈のみが表示されます。エージェント D からの変更は、エージェント D が CA APM ChangeDetector 対応であるかどうかに関係なく、グラフには表示されません。これは、エージェント D からのメトリックがグラフに含まれていないからです。
    カスタム設定
    グラフ注釈のラベルを付ける CA APM ChangeDetector コンポーネントを選択します。
組み込み CA APM ChangeDetector レポートの実行
CA APM ChangeDetector には、過去 24 時間にシステムで発生したすべての変更を表示するレポート テンプレートが用意されています。このレポートはCA Introscope エージェント別にグループ化され、エージェントごとのサマリとレポート サマリがあります。
レポートの対象時間は、レポートを生成する Workstation のタイム ゾーンに応じて計算されます。
過去 24 時間での変更
レポートを実行する方法
  1. [Workstation]-[レポートを生成]を 選択して、[レポート テンプレートを選択]ダイアログ ボックスを開きます。
    リストに、[
    過去 24 時間での変更
    ]レポート テンプレートが含まれています。
  2. [過去 24 時間での変更]を選択し、[選択]をクリックして、[レポートを生成]ダイアログ ボックスを開きます。
  3. レポートの開始および終了日を指定します。
  4. CA APM ChangeDetector 対応のエージェントのリストからエージェントを選択するか、別のエージェント一致パターンを指定して、テンプレートのエージェント一致パターンを上書きします。
  5. [プレビューを生成]をクリックします。
    プレビューにレポートのタイトル ページが表示されます。
  6. プレビューの各ボタンを使用して、レポートの出力を操作し、レポートを保存します。
CA Introscope レポートへの CA APM ChangeDetector エレメントの追加
組み込みの[
過去 24 時間での変更
]レポート テンプレートのほかに、CA APM ChangeDetector には CA Introscope のレポート機能も組み込まれているため、CA APM ChangeDetector エレメントを追加することによってカスタム レポートを作成できます。
レポートの期間中に発生した変更を示す方法として、変更データ用のレポート オプションのみを追加することも、そのオプションと一緒にメトリック グラフを追加することもできます。
カスタム CA APM ChangeDetector レポートを作成する方法
  1. Workstation の Investigator で、[ファイル]-[新規管理モジュール エディタ]を選択します。
  2. [エレメント]-[レポート テンプレートを新規作成]を選択します。
  3. 新しいレポート テンプレートの名前を入力し、[強制的に一意にする]をクリックして、レポートの名前が一意になるようにします。
    [強制的に一意にする]を選択すると、ユーザが入力した名前が一意でない場合は、CA Introscope により番号が追加されて一意の名前に変更されます。追加される番号は、作成後のレポート テンプレートを 管理モジュール エディタに表示したときに表示されます。[強制的に一意にする]をオンにしなかった場合、同じレポート テンプレート名が存在するときは、CA Introscope でエラー メッセージが表示され、レポートは作成されません。
  4. レポートに含める管理モジュールを選択して、[OK]をクリックします。
    [レポート テンプレートを新規作成]ダイアログ ボックスが表示されます。
  5. [アクティブ]チェック ボックスをクリックして、レポート テンプレートをアクティブにし、CA Introscope コンソール、Investigator、および管理モジュール エディタのレポート テンプレートのリストに表示されるようにします。
  6. [テンプレート エディタを開く]をクリックします。
    レポート テンプレートが開き、レポートの目次で選択できるオプションが表示されます。
  7. [表紙]タブをクリックしてレポートの目的を入力します。
    レポート タイトル
    生成されるレポートのタイトルを入力します。タイトルは、目次と共にタイトル ページに表示されます。
    ロゴ
    レポートと関連付けるロゴを選択します。
    レポートの概要
    レポートの概要を説明するテキストを入力します。
  8. [デフォルト データ プロパティ]タブをクリックして、プロパティを指定します。
    デフォルトでは、データ プロパティは変更できません。ただし、[変更時間を使用]をオフにして、ファイルの実際の変更時刻ではなく、変更検出数を表示するようにできます。
    デフォルトの対象期間を変更するには、[テンプレートのデフォルト時間範囲]以下の次のフィールドを変更します。
    開始時刻と終了時刻
    対象期間を指定する場合は、特定の開始日および終了日、または「
    24 時間
    」などの期間を指定できます。
    レポートの対象期間は、以下のいずれかの方法で指定できます。
    1. 特定の開始および終了日時を入力するか、カレンダ アイコンをクリックして開始および終了日を選択します。
    2. [開始時刻]を空白にし、[継続時間]および[単位]パラメータを使用してレポートの実行期間を指定します。
    3. [終了時刻]を空白にし、[継続時間]および[単位]パラメータを使用してレポートの実行期間を指定します。
    4. [終了時刻]に「現在」と入力し、[継続時間]および[単位]パラメータを使用して、過去の履歴をどれだけさかのぼってレポートするかを指定します。
    継続時間
    レポートを実行する期間を指定する数字を入力します。この数は、[単位]の値との組み合わせで機能します。たとえば、[単位]が[時間]の場合には[継続時間]フィールドに「
    24
    」と入力できます。開始時刻と終了時刻と連動して使用期間およびユニット パラメータ方法の詳細については、開始時刻および終了時刻に含まれます。
    単位
    ドロップダウン リストから時間の単位を選択します。設定値は、[
    ]、[
    時間
    ]、[
    ]、または[
    ]です。
  9. [表示プロパティ]タブをクリックし、レポート生成後のレポートのグラフおよびテーブルの表示を決定するプロパティを設定します。
    並べ替え基準
    この行をクリックしてリストを開き、[タイムスタンプ]、[データソース]、[リソース]、または[変更タイプ]から選択します。レポート内の変更はすべて、最初はエージェント ID ごとにグループ化されます。[並べ替え基準]フィールドでは、各エージェント内での 2 番目のグループ化を指定します。
    並べ替え順序
    この行をクリックしてリストを開き、[昇順]または[降順]を選択します。
    最大行数
    レポートに表示する最大行数を入力します。