Download PDF
Download page サーバの可視性のコントローラ設定.
サーバの可視性のコントローラ設定
このページでは、サーバの可視性に固有のコントローラ管理設定について説明します。[Account] または [Controller] タブから、これらのコントローラ設定および権限を適用できます。設定の変更は、次回エージェントが再起動されてコントローラに接続するときに有効になります。
アカウントレベルですべての設定プロパティを設定することはできません。各プロパティの [Description] 列を確認して、特定のサーバの可視性プロパティを有効にできるかどうかを判別してください。「ロールと権限」および「コントローラのユーザーとグループの管理」を参照してください。
マシンエージェントのコントローラ管理設定を変更するには、「マシンエージェント用コントローラの設定」を参照してください。
サーバの可視性プロパティ | 説明 | デフォルト |
---|---|---|
sim.docker.enabled | Docker の可視性を有効にします。「Docker Visibility によるコンテナのモニタ」を参照してください。 | true |
sim.docker.machine.container.limit | マシンごとにモニタするコンテナの数のグローバル制限。これは、2023-10-19_05-04-05_Access the Administration Console でコントローラの設定(すべてのアカウント)として指定することも、個々のアカウントのアカウント設定として指定することもできます。指定できるコンテナの最大制限は 120 個です。 | 15 |
sim.docker.monitorAPMContainersOnly | true に設定すると、APM コンテナのみモニタできます。値が false に設定されている場合、マシンエージェントコンテナを除くマシン上のすべてのコンテナがモニタされます。このプロパティは、アカウントレベルで適用でき、APM を使用した場合と使用しない場合のコンテナのモニタリングを有効にします。このプロパティは、以前は sim.docker.infraMode.enabled という名前でした。 | true |
sim.exceptions.stacktrace.enabled | この設定を有効にすると、クライアント要求でエラーが発生したときに、エラー応答でコントローラ スタック トレースが送信されます。 これを | false |
sim.machines.agent.process.maxClasses | マシンごとに収集されるプロセスクラスの数のグローバル最大値。
「サーバの可視性のためのマシンエージェントの設定」を参照してください。 この設定を増やすと、デプロイメントのリソース消費に影響する場合があります。この設定を増やす前に、アプリケーション環境およびコントローラが増加したリソース要件を処理できることを確認してください。 | 20 |
sim.machines.container.hostid.conflict.check.enabled | Docker の可視性を使用する場合で、 この設定は、コントローラのバージョン 20.8 で導入され、デフォルト値は | true |
sim.machines.count.maxPerAccount | アカウントごとに許可されるマシンの最大数。追加のマシンは表示されません。1 つのコントローラにレポートするマシンが 2000 を超えていて、この数を増やす必要がある場合は、 この設定を変更することで、デプロイメントのリソース消費に影響を及ぼす場合があります。この設定を変更する前に、アプリケーション環境およびコントローラが増加したリソース要件を処理できることを確認してください。 | 2000/account |
sim.machines.deleteStaleMachines.maxLimit | 10 分ごと(パージャーの 1 サイクル)に削除するマシンの数を設定します。パフォーマンスを向上させるために、サイクルごとに最大 700 台のマシンをパージできます。 | 100 |
sim.machines.dmm.defaultMode | コントローラの 動的モニタリングモードとサーバの可視性 のデフォルトを設定します。許可される設定は次のとおりです。
これらのいずれかを正確に文字列として入力する必要があります。別の値(「advanced-diagnostic」など)を入力すると、コントローラは設定を更新せず、一部のサーバがサーバリストに表示されない場合があります。 | KPI |
sim.machines.dmm.dmmAllowed | このオプションを有効にすると、コントローラは、各マシンエージェントの 動的モニタリングモードとサーバの可視性 設定に基づいて、そのエージェントからメトリックを収集します。このオプションを無効にすると、コントローラは、各エージェントから使用可能なすべてのメトリックを収集します。 | false |
sim.machines.dotNet.HostIdConflictCheckAllowed | このオプションを有効にした場合、マシンエージェントがコントローラに登録しようとしたときに、次の両方の条件が当てはまると、コントローラは例外をスローします。
生成された例外は、コントローラとマシンエージェントの両方で .NET 互換モードを有効にする必要があることを示すリマインダとして機能します。 このオプションは、AppDynamics サポートからの指示がない限り無効にしないでください。 | true |
sim.machines.hostidMappingAllowed | マシンエージェントと .NET エージェントがインストールされているサーバで、マシンメトリックまたはサーバメトリックを収集して表示する場合、このモードを有効にする必要があります。「.NET 互換モード」を参照してください。 | true |
sim.machines.offline.toStaleTimeoutMillis | オフラインマシンが失効と見なされ、削除のマークが付けられる前に待機する時間(ミリ秒単位)。この値が大きすぎると、新しいデータが到着しなくなります。値が小さすぎると、履歴が少なくなります。 21.2.0 以降のコントローラでは、古いマシンを消去するために 2 つのプロパティが一緒に使用されます。これらのプロパティは、ユーザインターフェイスで [Servers] リストを表示する方法を決定するために連携して使用されます。
必要に応じて まれに、古いロジックが原因で、マシンが顧客の設定よりも早く消去の対象と見なされることがあります。 |
|
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.reuse.enabled | 一時的な環境を処理するために、SIM マシンエンティティを再利用します。現在、サポートは Docker コンテナマシンに限定されています。
| true |
sim.machines.simAllowed | この設定を使用すると、コントローラからサーバの可視性を有効または無効にできます。 | true |
sim.machines.stale.purgeIntervalMillis | 失効したマシンがコントローラデータベースから削除されるタイミングを決定する間隔(ミリ秒単位)。この値の期間が短すぎると、サーバが過負荷になる可能性があります。値が大きすぎると、失効したマシンはゆっくりと削除されます。 |
(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 |
sim.metrics.trackRegisteredEnabled | ノードメトリックの効率的なブラウジングを有効にします。このオプションは、複数のノードを含む階層のメトリックをブラウズする場合に使用します。 | false |
sim.perAccountProperty.enabled | ユーザがアカウントレベルでプロパティを設定できるようにします。 | true |
| アカウントごとのプロパティデータがデータベースと同期する間隔(ミリ秒単位)。 | 300000 |
| バックグラウンドで、アカウントごとのプロパティデータをデータベースと同期できるようにします。パフォーマンスを向上させるには、この値を true に設定します。 | true |
sim.processes.bulkDelete.enabled | プロセスを 1 つずつ取得するのではなく、一括して削除します。パフォーマンスを向上させるには、この値を true に設定します。 | true |
sim.processes.delete.maxCount | 10 分ごと(パージャーの 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.maxResultLimit | UI(たとえば、[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 日) |