このページでは、サーバの可視性に固有のコントローラ管理設定について説明します。[Account] または [Controller] タブから、これらのコントローラ設定および権限を適用できます。設定の変更は、次回エージェントが再起動されてコントローラに接続するときに有効になります。

これらの設定を変更するには、root ユーザーのパスワードが必要です。

アカウントレベルですべての設定プロパティを設定することはできません。各プロパティの [Description] 列を確認して、特定のサーバの可視性プロパティを有効にできるかどうかを判別してください。ロールと権限」および「コントローラのユーザーとグループの管理」を参照してください。

マシンエージェントのコントローラ管理設定を変更するには、「マシンエージェント用コントローラの設定」を参照してください。

サーバの可視性プロパティ説明デフォルト
sim.docker.enabledDocker の可視性を有効にします。「Docker Visibility によるコンテナのモニタ」を参照してください。true
sim.docker.machine.container.limitマシンごとにモニタするコンテナの数のグローバル制限。これは、2023-10-19_05-04-05_Access the Administration Console でコントローラの設定(すべてのアカウント)として指定することも、個々のアカウントのアカウント設定として指定することもできます。指定できるコンテナの最大制限は 120 個です。15
sim.docker.monitorAPMContainersOnly
(previously known as sim.docker.infraMode.enabled) 
true に設定すると、APM コンテナのみモニタできます。値が false に設定されている場合、マシンエージェントコンテナを除くマシン上のすべてのコンテナがモニタされます。このプロパティは、アカウントレベルで適用でき、APM を使用した場合と使用しない場合のコンテナのモニタリングを有効にします。このプロパティは、以前は sim.docker.infraMode.enabled という名前でした。true
sim.exceptions.stacktrace.enabled

この設定を有効にすると、クライアント要求でエラーが発生したときに、エラー応答でコントローラ スタック トレースが送信されます。

これを true に設定すると、セキュリティリスクになります。結果を理解している場合、およびサポートエンジニアから指示された場合にのみ、true に設定する必要があります。

false
sim.machines.agent.process.maxClasses

マシンごとに収集されるプロセスクラスの数のグローバル最大値。

  • maxClasses(コントローラのグローバル設定)が maxNumberMonitoredClassesserverMonitoringConfig.yml のローカル設定)よりも小さい場合、ローカル設定が上書きされ、グローバル MaxClasses がそのマシンの有効な最大値になります。
  • maxClasses(グローバル)が maxNumberMonitoredClasses(ローカル)よりも大きい場合、ローカル設定がそのマシンの有効な最大値になります。

サーバの可視性のためのマシンエージェントの設定」を参照してください。

この設定を増やすと、デプロイメントのリソース消費に影響する場合があります。この設定を増やす前に、アプリケーション環境およびコントローラが増加したリソース要件を処理できることを確認してください。

20
sim.machines.container.hostid.conflict.check.enabled

Docker の可視性を使用する場合で、unique host ID 設定がホストネットワークモードで container ID を使用するように構成されていない場合、マシンエージェントは container IDhost ID として使用してコンテナを自動的に登録します。

この設定は、コントローラのバージョン 20.8 で導入され、デフォルト値は false です。20.11 以降のコントローラでは、デフォルト値は true です。設定が true で、コンテナで setting --network=host が指定されていて、マシンエージェントのバージョンが 20.6 以前の場合、そのコンテナは登録されません。

true
sim.machines.count.maxPerAccount

アカウントごとに許可されるマシンの最大数。追加のマシンは表示されません。1 つのコントローラにレポートするマシンが 2000 を超えていて、この数を増やす必要がある場合は、sim.machines.registrations.maxPerSecondPerAccount 設定も増やす必要がある場合があります。

この設定を変更することで、デプロイメントのリソース消費に影響を及ぼす場合があります。この設定を変更する前に、アプリケーション環境およびコントローラが増加したリソース要件を処理できることを確認してください。

2000/account
sim.machines.deleteStaleMachines.maxLimit10 分ごと(パージャーの 1 サイクル)に削除するマシンの数を設定します。パフォーマンスを向上させるために、サイクルごとに最大 700 台のマシンをパージできます。100
sim.machines.dmm.defaultMode

コントローラの 動的モニタリングモードとサーバの可視性 のデフォルトを設定します。許可される設定は次のとおりです。

  • KPI :重要業績評価指標のみ収集します。
  • DIAGNOSTIC:KPI と診断メトリックを収集します。
  • ADVANCED_DIAGNOSTIC:使用可能なすべてのメトリックを収集します。

これらのいずれかを正確に文字列として入力する必要があります。別の値(「advanced-diagnostic」など)を入力すると、コントローラは設定を更新せず、一部のサーバがサーバリストに表示されない場合があります。

KPI
sim.machines.dmm.dmmAllowedこのオプションを有効にすると、コントローラは、各マシンエージェントの 動的モニタリングモードとサーバの可視性 設定に基づいて、そのエージェントからメトリックを収集します。このオプションを無効にすると、コントローラは、各エージェントから使用可能なすべてのメトリックを収集します。 false
sim.machines.dotNet.HostIdConflictCheckAllowed

このオプションを有効にした場合、マシンエージェントがコントローラに登録しようとしたときに、次の両方の条件が当てはまると、コントローラは例外をスローします。

  1. 同じマシン上の .NET エージェントが、マシンエージェントに対して指定された同じ <host-id> ですでに登録されている。
  2. .NET 互換モード がコントローラまたはマシンエージェントのいずれかで無効になっている。

生成された例外は、コントローラとマシンエージェントの両方で .NET 互換モードを有効にする必要があることを示すリマインダとして機能します。

このオプションは、AppDynamics サポートからの指示がない限り無効にしないでください。

true
sim.machines.hostidMappingAllowedマシンエージェントと .NET エージェントがインストールされているサーバで、マシンメトリックまたはサーバメトリックを収集して表示する場合、このモードを有効にする必要があります。「.NET 互換モード」を参照してください。true
sim.machines.offline.toStaleTimeoutMillis

オフラインマシンが失効と見なされ、削除のマークが付けられる前に待機する時間(ミリ秒単位)。この値が大きすぎると、新しいデータが到着しなくなります。値が小さすぎると、履歴が少なくなります。

21.2.0 以降のコントローラでは、古いマシンを消去するために 2 つのプロパティが一緒に使用されます。これらのプロパティは、ユーザインターフェイスで [Servers] リストを表示する方法を決定するために連携して使用されます。

  • sim.machines.offline.toStaleTimeoutMillis(172800000 ミリ秒)を使用して、どのマシンが古いと見なされるかを判断します。
  • sim.machines.registrations.update.frequency 設定(86400000 ms)は、モニタ対象ホストのプロパティに変更がない場合に、サーバの lastSeenTimeStamp が更新される頻度を決定します。この設定は変更できません。

必要に応じて sim.machines.offline.toStaleTimeoutMillis 設定を変更できます。これは、2023-10-19_05-04-05_Access the Administration Console でコントローラの設定(すべてのアカウント)として指定することも、個々のアカウントのアカウント設定として指定することもできます。コントローラでこの設定を変更した場合は、再起動が必要です。この設定がアカウントレベルで変更された場合、再起動する必要はありません。

まれに、古いロジックが原因で、マシンが顧客の設定よりも早く消去の対象と見なされることがあります。

172800000 ms (2 日)

sim.machines.registrations.hashCache.enabled後続の登録要求でデータを取得しないようにし、要求ペイロードで何も変更されていないかどうか比較します。true
sim.machines.registrations.maxPerSecondPerAccount

アカウントごとに 1 秒あたりに許可する登録の最大数を設定します。この設定は、同時登録が処理されるレートを制御し、マルチテナントコントローラの 1 つのアカウントが、エージェントの登録に必要なリソースを独占しないようにします。

デフォルト値は、マシンエージェントが 1 分間に均等に開始されることを前提としています。2000 台以上のマシンを実行している場合は、この設定を 600/秒に増やす必要がある場合があります。推奨される式は(マシン エージェント バージョン 4.2 以降の数/60)です。

すべてのエージェントを数秒以内に開始する導入スクリプトを使用する場合は、1 秒あたりの最大登録数をさらに調整する必要がある場合があります。

この設定を変更することで、デプロイメントのリソース消費に影響を及ぼす場合があります。この設定を変更する前に、アプリケーション環境およびコントローラが増加したリソース要件を処理できることを確認してください。

60
sim.machines.registrations.update.frequency失効したタイムアウト値に関係なく、特定の頻度でマシンのタイムスタンプを更新します。モニタ対象ホストのプロパティに変更がない場合に、サーバの lastSeenTimeStamp が更新される頻度を決定します。この設定は変更できません。

21.2.0 以降のコントローラでは、古いマシンを消去するために 2 つのプロパティが一緒に使用されます。これらのプロパティは、ユーザインターフェイスで [Servers] リストを表示する方法を決定するために連携して使用されます。sim.machines.offline.toStaleTimeoutMillis プロパティを参照してください。

まれに、古いロジックが原因で、マシンが顧客の設定よりも早く消去の対象と見なされることがあります。

86400000 ms (1 日)

sim.machines.reuse.enabled

一時的な環境を処理するために、SIM マシンエンティティを再利用します。現在、サポートは Docker コンテナマシンに限定されています。

false に設定すると、すべての新しいコンテナが新しいマシンと見なされます。

true
sim.machines.simAllowedこの設定を使用すると、コントローラからサーバの可視性を有効または無効にできます。true
sim.machines.stale.purgeIntervalMillis失効したマシンがコントローラデータベースから削除されるタイミングを決定する間隔(ミリ秒単位)。この値の期間が短すぎると、サーバが過負荷になる可能性があります。値が大きすぎると、失効したマシンはゆっくりと削除されます。

21600000 ms

(6 時間)

sim.machines.tags.maxPerAccountアカウントごとの一意のタグの最大数。1000
sim.machines.tags.maxPerMachineマシンごとのタグの最大数。50
sim.metrics.metricBrowser.machineMetricMappings.enabledメトリックブラウザによる、マシンごとにレポートされるメトリックの表示を有効または無効にします。この機能が有効になっている場合、サーバメトリックブラウザの階層ノードで使用できる、階層レベルで集約されるメトリックは表示されません。効率的なブラウジングが有効になっている場合、Hardware Resources および Custom Metrics フォルダは表示されません。true
sim.metrics.store.customMetrics.simNodeEnabledサーバの可視性によってモニタされるマシンに対するカスタムメトリック値の永続化を有効または無効にします。
設定ごとに次のようになります。
  • true:コレクタは、アプリケーションとマシンのカスタムメトリック値を保存して表示します。カスタムメトリックは、アプリケーションとサーバの可視性の両方のメトリックブラウザに表示されます。
  • false:コレクタは、アプリケーションに関するカスタムメトリック値のみ保存して表示します。カスタムメトリックは、アプリケーションに関するもののみメトリックブラウザに表示されます(サーバの可視性に関するものは表示されません)。

多数のカスタムメトリックを収集する場合は、この設定を無効にします。これにより、個々のマシンに対して保存されるメトリック値の数とレートの急増が防止されます。

true
sim.metrics.trackRegisteredEnabledノードメトリックの効率的なブラウジングを有効にします。このオプションは、複数のノードを含む階層のメトリックをブラウズする場合に使用します。 false
sim.perAccountProperty.enabledユーザがアカウントレベルでプロパティを設定できるようにします。true

sim.perAccountProperty.syncFrequencyInMillis

アカウントごとのプロパティデータがデータベースと同期する間隔(ミリ秒単位)。300000

sim.perAccountProperty.syncInBackground

バックグラウンドで、アカウントごとのプロパティデータをデータベースと同期できるようにします。パフォーマンスを向上させるには、この値を true に設定します。true
sim.processes.bulkDelete.enabledプロセスを 1 つずつ取得するのではなく、一括して削除します。パフォーマンスを向上させるには、この値を true に設定します。true
sim.processes.delete.maxCount10 分ごと(パージャーの 1 サイクル)に削除するプロセスの最大数を設定します。パフォーマンスを向上させるには、このプロセスの削除の maxCount 値をサイクルごとに 55000 に設定します。10000
sim.processes.count.maxPerAccountアカウントごとに保存されるプロセスの最大数。300000
sim.processes.count.maxPerMachine

各マシンエージェントがモニタできるプロセスの最大数。

この設定を増やすと、デプロイメントのリソース消費に影響する場合があります。この設定を増やす前に、アプリケーション環境およびコントローラが増加したリソース要件を処理できることを確認してください。

1000
sim.processes.creation.maxConcurrent

コントローラが同時に登録できるプロセスの最大数。デフォルトは 5000 個のプロセスです。最初の試行が失敗した場合、マシンエージェントはプロセスの登録を再試行します。プロセス要求がコントローラによって承認および処理されるまで、その要求内のプロセスは [Process Details] ページに表示されません。制限は次のように機能します。

ケース 1:マシンエージェントが、登録するプロセスが 6000 ある要求を送信し、制限が 5000 に設定されている場合、この要求は制限が増やされるまで拒否されます。

ケース 2:2 つのマシンエージェント(MA1 と MA2)がそれぞれ 3000 個のプロセスを登録しようとし、制限が 5000 に設定されているとします。MA1 要求と MA2 要求の両方がコントローラによって受信され、1 つの要求のみが処理されます(3000 + 3000 > 5000)。このように、コントローラは 1 つの要求だけを処理し、もう一方の要求を拒否する場合があります。

ケース 3:2 つのマシンエージェント(MA1 と M2)がそれぞれ 500 個のプロセスを登録しようとし、制限が 5000 に設定されているとします。両方の要求がコントローラに到着すると、500 + 500 < 5000 であるため、両方の要求が処理され、プロセスが登録されます。

5000
sim.processes.query.maxResultLimitUI(たとえば、[Server Dashboard >] [Processes] タブ)に表示できるプロセスの最大数。時間範囲が 2 週間で、エージェントがそのインターバルの間に 10000 を超えるプロセスをレポートしたとします。maxResultLimit = 5000 の場合、UI には 5000 個のプロセスが表示されます。5000
sim.processes.registrations.maxPerSecondPerAccountアカウントごとに 1 秒あたりに処理するプロセス要求の最大数を設定します。パフォーマンスを向上させるには、600/秒に設定します。マルチテナントコントローラでは、1 秒あたりのエージェントの合計数が 600/秒を超えないようにする必要があります。60/sec
sim.processes.stale.purgeIntervalMillisアカウントの失効したプロセスの連続削除間のミリ秒数。3600000 ms(1 時間)
sim.processes.terminated.toStaleTimeoutMillis終了したプロセスが失効と見なされ、新しいデータの領域を確保するために削除可能となるまでのミリ秒数。これは、「2023-10-19_05-04-05_Access the Administration Console」でコントローラの設定(すべてのアカウント)として指定することも、個々のアカウントのアカウント設定として指定することもできます。172800000 ms
(2 日)