コレクタへのエージェントの割り当ての構成

MOM エージェント負荷分散の設定 › コレクタへのエージェントの割り当ての構成

コレクタへのエージェントの割り当ての構成

MOM loadbalancing.xml を使用して、MOM のロードバランサが接続元エージェントをどのようにコレクタに割り当てるかを制御するエージェントエレメントを構成できます。 include エレメントおよび exclude エレメントを構成して、特定の Enterprise Manager へのエージェント接続を許可または禁止できます。

注：過負荷状態にあるコレクタの負荷分散を実行する場合、バージョン 9.1 より前の CA APM では、MOM は、コレクタに直接接続するように設定されたエージェントを対象にしていませんでした。 CA APM バージョン 9.1 から、MOM は 9.1 以前および 9.1 以降のエージェントを対象にして切断できるようになりました。バージョン 9.1 以前およびそれ以降のエージェントの特定のコレクタへの接続を保持して、負荷分散を行わないようにするには、loadbalacing.xml に agent-Collector エレメントを追加します。

以下の手順に従います。

MOM 上の <EM_Home>/config ディレクトリに移動します。
loadbalancing.xml を開きます。
環境の要件に応じて、プロパティを定義します。
これらのプロパティを定義するとき、以下のガイドラインおよびエージェントの負荷分散の設定例を使用します。
- <agent-collector name> 属性はオプションです。
- MOM ロードバランサは <agent-collector> エレメントを順番に評価します。
  接続元エージェントが <agent-specifier> 正規表現に一致すると、<include> リストに含まれるコレクタの 1 つに割り当てられます。 loadbalancing.xml 内で最初に一致した <agent-specifier> が優先されます。 <include> リストがない場合、エージェントは <exclude> リストに含まれないコレクタに割り当てられます。これらの制限を満たす利用可能なコレクタがない場合、エージェントのコレクタ接続要求は拒否されます。
- <agent-collector> エレメントごとに、エージェントのセットに一致する <agent-specifier> エレメントを 1 つまたは複数定義します。
- <agent-specifier> のテキストの内容が *¥|.*¥|EPAgent1</agent-specifier> などの Perl5 正規表現であることを確認します。
  注：エージェント指定子の正規表現には、エージェントパス名の 3 つのエレメント <host machine name>|<custom process name>|<agent name> が含まれる必要があります。たとえば、EPAgent で始まる名前を持つエージェントすべてを含めるように、次のコンテンツを使用します。
```
<agent-specifier>.*¥|.*¥|EPAgent.*</agent-specifier>
```
- <agent-collector> エレメントでは、include リストが空の場合があります。 include リストには、エージェントが接続を許可されたコレクタを含めることもできます。
  - include リストが空の場合、エージェントはコレクタへ接続することを許可されません。
```
<include>
</include>
```
  - <include> エレメントおよび </include> エレメントに、エージェントが接続できるコレクタを追加できます。
    この例では、エージェントは localhost@5002 という名前のコレクタ上でのみ許可されます。
```
<include>
    <collector host="localhost" port="5002"/>
</include>
```
- <agent-collector> エレメントでは、exclude リストが空の場合があります。 exclude リストには、エージェントが接続を許可されていないコレクタを含めることもできます。
  - exclude リストが空の場合、エージェントはすべてのコレクタへの接続を許可されます。
```
<exclude>
</exclude>
```
  - <exclude> エレメントおよび </exclude> エレメントに、エージェントが接続を許可されていないコレクタを追加できます。
    この例では、エージェントは localhost@5002 という名前のコレクタ上でのみ許可されていません。
```
<exclude>
   <collector host="localhost" port="5002"/>
</exclude>
```
- latched プロパティを true に設定して、特定のコレクタが利用可能なときはいつも、そのコレクタへの接続を優先することを示します。このコレクタはラッチ済みコレクタと呼ばれます。
  この例では、エージェントはポート 6001 上の newCollector-ip という名前のコレクタにラッチされます。 newCollector-ip が利用不可のときは、MOM はエージェントを Collector1-ip へ割り当てることができます。
```
<include>
```
```
<Collector host="newCollector-ip" port="6001" latched=”true” />
<Collector host="Collector1-ip" port="6001" />
```
```
</include>
</agent-Collector>
```
  include リストへ 1 つのコレクタのみを追加する場合、ラッチ済みプロパティの設定は必要ありません。
  
  複数のコレクタが「latched=true」に設定されている場合、接続設定はすべてのラッチ済みコレクタに適用されます。
  
  ラッチ済みプロパティが true に設定され、コレクタが過負荷状態になっているとき、MOM はコレクタからエージェントを切断しません。ラッチ済みコレクタがダウンすると、切断されたエージェントは別に許可された利用可能なラッチ済みコレクタに接続します。
  
  利用可能なラッチ済みコレクタがない場合、エージェントは許可されたコレクタに接続します。利用可能な許可されたコレクタがない場合、エージェントの動作はエージェントのバージョンで決まります。
  たとえば、環境に 10 個のコレクタがある場合、エージェントを 1 つ以上のコレクタにラッチするよう設定できます。ラッチ済みコレクタがすべて利用不可になる場合、MOM はもう一方の利用可能なラッチされていないコレクタへエージェントを転送できます。
  
  ラッチ済みプロパティがコレクタに設定されないとき、エージェントはそのコレクタに接続しますが、これはラッチ済みコレクタがすべて利用不可の場合のみに起こります。
  
  ラッチ済みプロパティのデフォルト値は false です。
- クロスクラスタデータビューアを 1 つ以上デプロイ済みであり、負荷分散を使用している場合は、CDV が接続するコレクタへのみ目的のエージェントを接続します。そうでない場合、MOM は、ほかのコレクタへの CDV 接続を使用して、コレクタからエージェントを負荷分散できます。この状況では、以下のイベントが発生します。
  - CDV は、移動されたエージェントに関するメトリックデータを収集できません。
  - CDV Workstation ユーザは、移動されたエージェントに関するデータを表示できません。
- 同じクラスタ内でホストされているコレクタにエージェントを負荷分散するには、デフォルトの通信チャネルと関連付けられているポート番号を指定します。デフォルトポートは 5001 です。
  エージェントから Enterprise Manager への以下の通信プロトコルに対して、正しいポート番号を指定します。
  - 直接ソケット接続
  - HTTP トンネル接続またはプロキシサーバ経由の HTTP トンネル
  - HTTPS 接続
  - SSL 接続
- 異なるクラスタでホストされているコレクタにエージェントを負荷分散するには、特定のセキュアな通信チャネルと関連付けられているポート番号を指定します。 1 つのクラスタ内の MOM は、別のクラスタ内のコレクタのプロパティを参照できません。
  エージェントから Enterprise Manager への以下の通信プロトコルに対して、特定のセキュアな通信チャネルの正しいポート番号を指定します。
  - 直接ソケット接続。デフォルトの通信チャネルのポート（デフォルトではポート 5001）を指定します。
  - HTTP トンネル接続またはプロキシサーバ経由の HTTP トンネル。 HTTP ポート（デフォルトでは 8081）を指定します。
  - HTTPS 接続。 HTTPS ポート（デフォルトでは 8444）を指定します。
  - SSL 接続。 SSL ポート（デフォルトでは 5443）を指定します。
loadbalancing.xml を保存して閉じます。
新しい値は、Enterprise Manager がホットデプロイ中にプロパティファイルをチェックするときに自動的に有効になります。ホットデプロイは、約 60 秒ごとに実行されます。 MOM は、次の負荷分散の間隔で、クラスタの負荷を分散させます。