マップエレメントエイジングの設定

アプリケーション問題切り分けマップの構成 › アプリケーション問題切り分けマップ › マップエレメントエイジングの設定

マップエレメントエイジングの設定

接続用データがエイジアウトするか、APM データベースから廃棄されると、エージェントはフロントエンドとビジネスサービスおよびその依存関係を再検出します。 Workstation はアプリケーション問題切り分けマップにこのデータを表示します。

エージェントによってアプリケーション問題切り分けマップデータを収集できるように指定した後で、エージェントによるデータ収集の頻度を構成できます。たとえば、以下の頻度でアプリケーション問題切り分けマップデータを収集するようにエージェントを構成できます。

環境に頻繁に変更が加えられる場合、24 時間ごとに 1 回。
環境への変更の頻度が少ない場合、1 週間に 1 回。

また、Enterprise Manager がマップにデータを配信する期間を構成できます。たとえば、エージェントによって検出されたデータを 1 週間または 1 か月間表示できます。この期間は 2 つのマップ時間範囲プロパティ「エイジング時間」と「ウィンドウ時間」に基づきます。

エイジングは、アプリケーション問題切り分けマップエレメントの特性です。 CA Introscope がフロントエンドまたはビジネストランザクションのデータを受信しなくなったとき、そのマップエレメントの状態をエイジングと呼びます。エイジング時間は、Workstation がアプリケーション問題切り分けマップ内のエレメントの表示を継続する時間です。この時間が期限切れになったとき、エレメントはエージェントキャッシュから削除され、アプリケーション問題切り分けマップに aged と表示されますエイジング時間は introscope.apm.data.agingTime プロパティで設定します。デフォルト値は 1 日です。

時間ウィンドウは、エイジングエレメントがマップから表示されなくなるまで Workstation がエレメントを表示する時間です。このオプションは introscope.apm.data.timeWindow プロパティで設定します。デフォルト値は 3 日です。

たとえば、以下のようなデフォルト設定を仮定します。

アプリケーション A はアプリケーション問題切り分けマップのフロントエンドで、アプリケーション B と依存関係にあります。エージェントによってアプリケーション B のデータが継続的にレポートされ、アプリケーション B はマップ内に正常に表示されます。データがアプリケーション B からレポートされなくなると、エイジング時間とウィンドウ時間の計測が開始されます。 1 日後、アプリケーション B のマップノードが aged と表示されます。 3 日後、アプリケーション B のマップノードはマップに表示されなくなります。

考慮事項：

timeWindow には、agingTime の期間が含まれます。
timeWindow と agingTime を同じ期間に設定すると、マップエレメントを aged と表示できません。 timeWindow の期間が終了すると、これらは表示されなくなります。
timeWindow を agingTime よりも大きな値に設定した場合は、aged のマップエレメントは agingTime の期間の経過後に表示されなくなります。
agingTime と timeWindow については、組織がアプリケーションに対して追加や変更を行う頻度に基づいて値を選択します。この値によって、エージェントと Enterprise Manager のオーバーヘッドが増減する可能性があります。設定する値が低いほど、マップに表示されるアプリケーションの依存関係はリアルタイムなものになります。高い値を設定すると、マップに現在のアプリケーションの依存関係が表示されます。

重要： クラスタ環境では、agingTime または timeWindow のデフォルトプロパティ値への変更は、MOM およびすべてのコレクタに適用される必要があります。

以下の手順に従います。

<EM_Home>/config ディレクトリにある IntroscopeEnterpriseManager.properties ファイルを開きます。
introscope.apm.data.agingTime の値を変更する場合
1. エージェントを停止します。
2. Enterprise Manager をシャットダウンします。
  重要： introscope.apm.data.agingTime プロパティの値を変更する場合は、「アプリケーション問題切り分けマップのエイジング時間設定を小さくする場合の影響」を参照してください。
introscope.apm.data.agingTime プロパティを設定します。デフォルト値は 1 日です。値は 1 分より小さくすることはできません。
introscope.apm.data.timeWindow プロパティを設定します。デフォルト値は 3 日です。値は 1 分より小さくすることはできません。
IntroscopeEnterpriseManager.properties ファイルを保存して閉じます。
introscope.apm.data.agingTime プロパティを変更した場合は、エージェントを再起動します。
Enterprise Manager を再起動します。
<EM_Home>/logs ディレクトリ内のマップデータエイジングプロパティに関するする Enterprise Manager ログファイルメッセージを確認します。例：
```
11/23/09 12:02:13 PM PST [INFO] [Manager] [ The APM Data  property : introscope.apm.data.agingTime set to value : [ PropertyWithTimeUnit : 1 Min]]
```

アプリケーション問題切り分けマップのエイジング時間設定を小さくする場合の影響

IntroscopeEnterpriseManager.properties ファイル内のプロパティ introscope.apm.data.agingTime の値を小さくする場合、CA Technologies では、履歴データへの予期しない影響を回避するために、アプリケーション問題切り分けマップデータをクリーンアップすることをお勧めします。エイジング時間を小さくすると、マップ表示に示されるデータサンプルも少なくなります。その結果、エージェントによる Enterprise Manager へのデータレポートが原因で、APM データベース内のデータに基づく誤った表示が行われる可能性があります。データベースからデータをクリーンアップすることで、この問題を回避できます。

データをクリーンアップするには、PostgreSQL クライアントを使用する必要があります。このクライアントは PostgreSQL サイト（http://www.pgadmin.org）からダウンロードできます。

PostgreSQL クライアントを使用してデータベースをクリーンアップする方法

以下の SQL ステートメントを実行します。
```
truncate apm_edge;
```
プロパティ introscope.apm.data.agingTime の値を増やす場合は、このような予期しない影響はありません。データベースのクリーンアップが必要になるのは、プロパティの値を減らす場合のみです。

エイジング関連のプロパティが履歴ビューに与える影響

アプリケーション問題切り分けマップで履歴データを表示する際、以下の概念に注意してください。

履歴期間の開始点と終点の設定にかかわらず、アプリケーション問題切り分けマップに表示されるデータは常に、最低でも introscope.apm.data.timeWindow プロパティに設定された期間を含みます。例：
- 履歴期間の開始日と終了日の間を 10 日に設定し、introscope.apm.data.timeWindow を 3 日に設定した場合、マップには 10 日間全体のデータが表示されます。
- 履歴期間の開始日と終了日の間を 2 日に設定し、introscope.apm.data.timeWindow を 3 日に設定した場合、マップには 3 日分のデータが表示されます。これは、2 日間の終了日と同じ日を最後とする 3 日分です。手動で設定された履歴期間のほうが小さい場合でも、introscope.apm.data.timeWindow プロパティに設定されている期間が、マップに表示される最小期間になります。
マップエレメントのエイジングは、エイジング時間が履歴ウィンドウ後に発生したかのように、introscope.apm.data.agingTime プロパティに設定された期間を経過します。例：
- introscope.apm.data.agingTime が 1 日に設定され、履歴期間が 10 日に設定されている場合、エージェントによって期間の最終日（1 日）の間このエレメントがレポートされないと、マップエレメントが aged と表示されます。