EUMサーバーの構成

このページでは、EUM サーバーの管理構成および高度な構成のオプションについて説明します。

データ保存期限の構成

EUMで使用される分析機能の一環として、サーバーはクラッシュレポートやリソーススナップショットなど一部のデータをローカルのBlobstoreに保存します。デフォルト設定は 30 日ですが、次の手順に従って保存期間を長くまたは短く変更できます。

テキストエディタで $APPDYNAMICS_HOME/EUM/eum-processor/bin/eum.properties を開きます。
テキストエディタで $APPDYNAMICS_HOME/EUM/eum-processor/bin/eum.sample.properties を開きます。
サンプルファイルから onprem.crashReportExpirationDays プロパティと onprem.resourceSnapshotExpirationDays プロパティを eum.properties にコピー、任意の値に設定します。単位は日数です。
サーバーを再起動します。

ビーコンから読み取るページURLの最大長の設定

デフォルトでは、EUMコレクタがビーコンを受信し、EUMプロセッサはビーコン内のページURLの512文字のみを読み取ります。ページURLが512文字を超えている場合、EUMプロセッサはそのページURLを切り捨てます。EUM プロセッサがそれより長いページ URL を読み取るように beaconReader.maxUrlLength で構成できます。設定可能な最大長は2048であり、この値はビーコンを作成するJavaScriptエージェントでの制約です。

EUMプロセッサが読み取るページURLの最大長を変更するには

テキストエディタで $APPDYNAMICS_HOME/EUM/eum-processor/bin/eum.properties を開きます。
目的の長さ（2048 以内）をプロパティ beaconReader.maxUrlLength に追加します。
```
beaconReader.maxUrlLength=<max_length>
```
サーバーを再起動します。

EUMサーバーのGeoサーバーの更新

オンプレミスの EUM サーバーには、IP アドレスの地理的位置を管理するために Neustar の IP GeoPoint データベースが付属しています。Neustar の IP GeoPoint の日次更新をダウンロードサイトから取得できます。

データベースを最新バージョンにしておくには、以下のようにして、データベースのコピーを手動で更新する必要があります。

Linux

ダウンロードサイトで、Neustar データファイル（neustar.dat）を検索してダウンロードします。
$APPDYNAMICS_HOME/EUM/eum-processor/bin の neustar.dat を置き換えます。
$APPDYNAMICS_HOME/EUM/eum-processor.log で、新しいデータファイルがロードされていることを確認します。
$APPDYNAMICS_HOME/EUM/eum-processor/bin/eum-processor-launcher.vmoptions ファイルで JVM の -Xmx オプションを更新します。
- サーバーのJVM最大メモリ（-Xmx）を800 MB以上増やします。

Windows

ダウンロードサイトで、Neustar データファイル（neustar.dat）を検索してダウンロードします。
$APPDYNAMICS_HOME\EUM\eum-processor\bin の neustar.dat を置き換えます。
$APPDYNAMICS_HOME\EUM\eum-processor.log で、新しいデータファイルがロードされていることを確認します。
$APPDYNAMICS_HOME\EUM\eum-processor\bin\eum-processor-launcher.vmoptions ファイルの JVM の -Xmx オプションを更新します。
- サーバーのJVM最大メモリ（-Xmx）を800 MB以上増やします。

EUMエージェント用ポートの構成

オンプレミスのEUMサーバーは、デフォルトではEUMエージェントからデータを収集するためのポートと同じポートを使用して、APIサーバーを介してコントローラにデータを送信します。以下の手順に従って、EUM サーバーが別のポートを使用して EUM エージェントからデータを収集するように構成できます。

テキストエディタで $APPDYNAMICS_HOME/EUM/eum-processor/bin/eum.properties を開きます。
以下の行を $APPDYNAMICS_HOME/EUM/eum-processor/bin/eum.properties に追加し、EUM サーバーがリスンするポートで <PORT> を置き換えます。
```
processorServer.collectorHttpPort=<PORT>
processorServer.collectorHttpsPort=<PORT>
```
EUMサーバーを再起動します。
[Controller Admin UI] から、以下のプロパティのポートを変更します。eum.public.cloud.host、eum.beacon.host、eum.beacon.https.host、eum.cloud.host、eum.mobile.screenshot.host のポートを、processorServer.collectorHttpPort と processorServer.collectorHttpsPort に割り当てられているポートと同じにします。そうすることによって、ビーコンがコレクタと通信できるようになります。

たとえば、processorServer.collectorHttpPort=7050 および processServer.collectorHttpsPort=7051 を設定する場合、次のプロパティのポートを設定することになります。
プロトコルプロパティポート
HTTP eum.beacon.host と eum.mobile.screenshot.host 7050
HTTPS eum.beacon.https.host と eum.public.cloud.host 7051

プロトコル	プロパティ	ポート
HTTP	`eum.beacon.host` と `eum.mobile.screenshot.host`	7050
HTTPS	`eum.beacon.https.host` と `eum.public.cloud.host`	7051

EUM スナップショットの数の制限

アプリケーションでページあたりの Ajax リクエストの数が大きい場合、EUM サーバーは多数のスナップショットを保持し、その中にはベース、仮想、および Ajax のページだけでなく iFrame も含まれている可能性があります。グローバルの最大値を設定するか、保持時間を短縮するか、ネットワークの応答時間に基づいてスナップショットをフィルタリングすることで、EUM サーバーが保持するスナップショットの数を制限できます。

スナップショットのグローバル制限の設定

1 分あたりに保持されるスナップショットの数のグローバル上限を構成 browserBeaconSampling.maxSamples で設定します。デフォルト値は 1000 です。上限に達すると、すべてのスナップショットが無差別にドロップされます。この上限は eum.properties ファイルを使用してグローバルに構成できます。

テキストエディタで $APPDYNAMICS_HOME/EUM/eum-processor/bin/eum.properties を開きます。
以下の行を eum.properties に追加し、<global_limit> を保持されるスナップショットのグローバル最大数に置き換えます。
```
browserBeaconSampling.maxSamples = <global_limit>
```
EUMサーバーを再起動します。

イベントスナップショットの存続期間の短縮

EUMスナップショットの数を制限するもうひとつの方法は、イベントスナップショットが保持される日数を短くすることです。イベントスナップショットは、クラッシュレポート、コードの問題、および IoT のエラーにのみ適用され、ローカルの blob ストアである $APPDYNAMICS_HOME/EUM/eum-processor/store に保存されます。

デフォルトでは、EUM サーバーはイベントスナップショットを 90 日間保持します。イベントサービスでイベントが保持される期間が短い（例：14 日間）場合は、EUM サーバーの保持期間をイベントサービスの保持期間と同じ期間に変更しても構いません。ただし、EUM サーバーでイベントスナップショットが保持される期間がイベントサービスより短い場合は、コントローラ UI でその期間より前のイベントを表示するときにエラーが発生することがあります。

注: イベントスナップショットの寿命を短くしても、コントローラまたはイベントサービスの保持期間は変更されません。

イベントスナップショットの存続期間の設定

テキストエディタで $APPDYNAMICS_HOME/EUM/eum-processor/bin/eum.properties を開きます。
以下の行を eum.properties に追加し、イベントスナップショットを保持する日数で <no_of_days> を置き換えます。デフォルト値は90です。
```
eventSnapshotStore.lifespanInDays = <no_of_days>
```
EUMサーバーを再起動します。

ネットワーク応答時間に基づいたスナップショットのフィルタリング

ネットワーク応答時間に基づいてスナップショットをフィルタリングするためのしきい値を設定します。ネットワーク応答時間が構成しきい値以下であれば、そのスナップショットは保持されます。しきい値は、構成 browserBeaconSampling.hierarchyAwareSamplerPageUXThreshold で設定します。

サポートされているしきい値と保持されるスナップショットは以下のとおりです。デフォルト値は Slow です。

Normal - このしきい値を使用すると、すべてのスナップショットが保持されます。
低速 - このしきい値を使用すると、ネットワーク応答時間が遅い、非常に遅い、停止しているスナップショットが保持されます。

ネットワーク応答時間のしきい値の設定

テキストエディタで $APPDYNAMICS_HOME/EUM/eum-processor/bin/eum.properties を開きます。
以下の行を eum.properties に追加し、スナップショットの保持期間としてサポートされているしきい値（Normal または Slow）のいずれかで <threshold> を置き換えます。
```
browserBeaconSampling.hierarchyAwareSamplerPageUXThreshold = "<threshold>"
```
EUMサーバーを再起動します。

アクセスログの有効化

EUM サーバーの下層のアプリケーションサーバーに対するサーバーアクセスログはデフォルトでは無効になっています。有効にするには、$APPDYNAMICS_HOME/EUM/eum-processor/conf/local-eum-processor.yml をテキストエディタで開き、server エントリの下にある次のセクションを見つけます。

 requestLog:
        appenders: []

以下の情報を追加します。

requestLog:
        timeZone: UTC
        appenders:
          - type: file
            archive: true
            currentLogFilename: ../logs/access.log
            archivedLogFilenamePattern: ../log/accedd-%d.log.gz

ファイルを保存し、EUM サーバーを再起動します。

EUMサーバー構成ファイル

EUM サーバーは、$APPDYNAMICS_HOME/EUM/eum-processor/bin/eum.propertiesファイルでプロパティを設定することで構成できます。参照サンプルファイル $APPDYNAMICS_HOME/EUM/eum-processor/bin/eum.sample.properties を $APPDYNAMICS_HOME/EUM/eum-processor/bin/eum.properties にコピーし、必要に応じて設定を変更してから、新しい設定が適用されるように EUM サーバーを再起動することをお勧めします。

次の表は、サポートされている EUM プロパティと、その説明、デフォルト値、および必須かどうかの一覧を示しています。データベースプロパティの値はスキーマオブジェクト名で示されている MySQL 構文ルールに適合している必要があります。


EUMプロパティ	デフォルト	必須かどうか	説明
`onprem.dbHost`	`dbHost`	あり	データベースホストの名前。
`onprem.dbPort`	`3388`	あり	データベースホストへのポート。
`onprem.dbSchema`	`eum_db`	あり	EUMデータベースの名前。
`onprem.dbUser`	`eum_user`	あり	EUMデータベース用のユーザー名。
`onprem.dbPassword`	N/A	あり	EUMデータベースのユーザーパスワード。このパスワードでは「^」、「/」、「$」以外のASCII文字を使用できます。
`onprem.eventSnapshotDiskAllowance`	-1	いいえ	イベントスナップショットの保存に割り当てられる最大ディスク容量。デフォルト値の -1 は、イベントスナップショットを保存するために無制限のディスク容量を割り当てます。イベントスナップショットを保存するための最大バイト数を表す正の整数を指定できます。
`onprem.fileStoreRoot`	`../store`	いいえ	スナップショットなどのEUMデータを保存するディレクトリのパス。
`onprem.crashReportExpirationDays`	年中無休	いいえ	クラッシュレポートが保持される日数。
`onprem.resourceSnapshotExpirationDays`	15	いいえ	リソーススナップショットが保持される日数。
`onprem.resourceSnapshotDiskAllowance`	21474836480（20 GB）	いいえ	リソーススナップショットの保存に割り当てられる最大ディスク容量。デフォルトの最大ディスク容量は20 GB（21474836480バイト）です。リソーススナップショットを保存するための最大バイト数を表す正の整数を指定できます。
`processorServer.httpPort`	`7001`	いいえ	EUMプロセッサへのHTTPポート。EUM プロセッサは、コレクタ、アグリゲータ、クラッシュプロセッサ、モニタリングサービスが含まれている 1 つのプロセスで実行されます。
`processorServer.httpsPort`	`7002`	いいえ	EUMプロセッサへのHTTPSポート。
`processorServer.httpsProduction`	`true`	いいえ	EUMプロセッサに対しHTTPSを有効（true）または無効にするフラグ。
`processorServer.keyStorePassword`	N/A	いいえ	EUMプロセッサのキーストアのパスワード。
`processorServer.keyStoreFileName`	`bin/ssugg.keystore`	いいえ	EUMプロセッサのキーストア用パスワードを保存するファイルのパス。
`processorServer.collectorHttpPort`	`7001`	いいえ	EUMコレクタのHTTPポート。デフォルトでは、EUMコレクタはEUMプロセッサと同じポートを共有しますが、異なるポートに構成できます。EUMコレクタはJavaScriptエージェントから送信されたメトリックを受信します。
`processorServer.collectorHttpsPort`	`7002`	いいえ	EUMコレクタのHTTPSポート。
`analytics.enabled`	true	あり	分析サーバーを有効または無効にするフラグ。
`analytics.serverScheme`	http	いいえ	分析サーバーに接続するためのネットワークプロトコル。`analytics.enabled=true` の場合にのみ必要です。
`analytics.serverHost`	`events.service.hostname`	いいえ	分析サーバーのホスト名。`analytics.enabled=true` の場合にのみ必要です。
`analytics.port`	`9080`	いいえ	分析サーバーへのポート。`analytics.enabled=true` の場合にのみ必要です。
`analytics.accountAccessKey`	`access-key`	いいえ	分析サーバーに接続するためのアクセスキー。`analytics.enabled=true` の場合にのみ必要です。
`analytics.eventTypeLifeSpan.0.eventType`	`BrowserRecord`	いいえ	保存されるイベントのタイプ。以下の値がサポートされています。 `BrowserRecord` `MobileSnapshot` `SessionRecord` `MobileSessionRecord` このプロパティを設定する場合は、`analytics.eventTypeLifeSpan.0.lifeSpan` も設定する必要があります。
`analytics.eventTypeLifeSpan.0.lifeSpan`	8	いいえ	`analytics.eventTypeLifeSpan.0.eventType` で指定されているイベントレコードが保持される日数。このプロパティを設定する場合は、`analytics.eventTypeLifeSpan.0.eventType` も設定する必要があります。
`analytics.eventTypeLifeSpan.1.eventType`	`MobileSnapshot`	いいえ	保存されるイベントのタイプ。以下の値がサポートされています。 `BrowserRecord` `MobileSnapshot` `SessionRecord` `MobileSessionRecord` このプロパティを設定する場合は、`analytics.eventTypeLifeSpan.1.lifeSpan` も設定する必要があります。
`analytics.eventTypeLifeSpan.1.lifeSpan`	8	いいえ	`analytics.eventTypeLifeSpan.1.eventType` で指定されているイベントレコードが保持される日数。このプロパティを設定する場合は、 `analytics.eventTypeLifeSpan.1.eventType`も設定する必要があります。
`analytics.eventTypeLifeSpan.2.eventType`	`SessionRecord`	いいえ	保存されるイベントのタイプ。以下の値がサポートされています。 `BrowserRecord` `MobileSnapshot` `SessionRecord` `MobileSessionRecord` このプロパティを設定する場合は、`analytics.eventTypeLifeSpan.2.lifeSpan` も設定する必要があります。
`analytics.eventTypeLifeSpan.2.lifeSpan`	8	いいえ	`analytics.eventTypeLifeSpan.2.eventType` で指定されているイベントレコードが保持される日数。このプロパティを設定する場合は、`analytics.eventTypeLifeSpan.2.eventType` も設定する必要があります。
`analytics.eventTypeLifeSpan.3.eventType`	`MobileSessionRecord`	いいえ	保存されるイベントのタイプ。以下の値がサポートされています。 `BrowserRecord` `MobileSnapshot` `SessionRecord` `MobileSessionRecord` このプロパティを設定する場合は、 `analytics.eventTypeLifeSpan.3.lifeSpan`も設定する必要があります。
`analytics.eventTypeLifeSpan.3.lifeSpan`	8		`analytics.eventTypeLifeSpan.3.eventType` で指定されているイベントレコードが保持される日数。このプロパティを設定する場合は、 `analytics.eventTypeLifeSpan.3.eventType`も設定する必要があります。
`onprem.mobileAppBuildTimeSeriesRequestCountRollupDays`	7	いいえ	EUM コレクタは、構成されている日数の間ビーコントラフィックで dSYM ファイルを検索します。その構成されている期間内にdSYMファイルが見つからなかった場合はコントローラUIに警告メッセージが表示されます。
`onprem.maxNumberOfMobileBuildsWithoutDsym`	10	いいえ	コントローラUIで表示可能な不足dSYMファイルの最大数。
`collection.sessionEnabled`	true	いいえ	ブラウザ/モバイルセッションのコレクションを有効または無効にするフラグ。EUM サーバーをバージョン 4.2 以前から 4.3 以降にアップグレードしている場合、デフォルトは false です。
`collection.accessControlAllowOrigins.{n}`	*。	いいえ	デフォルトでは、EUM コレクタは `Access-Control-Allow-Origin: *` を使用して応答します。次のように、URL に割り当てられた整数プロパティを使用して、CORS を特定のドメインに制限できます。 `collection.accessControlAllowOrigins.0=http://example1.com` `collection.accessControlAllowOrigins.1=http://example2.com` `collection.accessControlAllowOrigins.2=http://example3.com`
`eventSnapshotStore.lifespanInDays`	90	いいえ	EUM サーバーのローカル blob ストア（$APPDYNAMICS_HOME/EUM/eum-processor/store）に保存されているイベントスナップショットが保持される日数。イベントスナップショットは、クラッシュレポート、コードの問題、および IoT のエラーにのみ適用されます。
`sessionization.webSessionRetentionMins`	5	いいえ	ブラウザセッションの終了後にそのセッションが保持される分数。この設定によって、開始時刻と終了時刻が異なるブラウザセッションを保持できるようになります。保持時間を長くするほど、メモリに保持される終了済みセッションの数が多くなって、メモリ使用量が多くなります。
`sessionization.mobileSessionRetentionMins`	5	いいえ	モバイルセッションの終了後にそのセッションが保持される分数。この設定によって、開始時刻と終了時刻が異なるモバイルセッションを保持できるようになります。保持時間を長くするほど、メモリに保持される終了済みセッションの数が多くなって、メモリ使用量が多くなります。
`throttling.resourceSnapshot.maxTotalPerMinPerAccount`	1000	いいえ	1つのアカウントで保持される1分ごとの総リソーススナップショットの最大数。
`throttling.resourceSnapshot.maxNormalPerMinPerAccount`	800	いいえ	1 つのアカウントで保持される 1 分ごとの、ユーザーエクスペリエンスが「Normal」であるページのリソーススナップショットの最大数。通常は、このプロパティの値を `throttling.resourceSnapshot.maxTotalPerMinPerAccount` の値より小さくして、ユーザーエクスペリエンスが「Slow」、「Very Slow」、または「Stall」であるページのリソーススナップショットも保持できるようにします。
`throttling.session.maxTrackedSessionsPerAccount`	50000	いいえ	1つのアカウントでメモリに保存されている、アクティブなセッションと期限前に終了したセッションの最大数。最大数に達すると、新たなセッションを作成するイベントはドロップされます。この設定は、セッションに使用されるメモリをアカウントレベルで制御するのに役立ちます。

注: EUM サーバーバージョン 4.5.1 以降では、プロパティ crashProcessing.sessionEnabled はサポートされなくなりました。代わりに、セッションとクラッシュの関連付けはデフォルトで有効になっています。以前のバージョン（4.5.1 より前）の EUM サーバーを使用していて、4.5.1 以降にアップグレードする場合は、EUM サーバーがエラーをスローしないように、eum.properties ファイルからプロパティ crashProcessing.sessionEnabled を削除する必要があります。