PEMエージェントの管理¶
以下のセクションでは、PEMエージェントの動作と管理に関する情報を提供します。
エージェント権限¶
デフォルトでは、PEMエージェントは、オペレーティングシステムホストのroot権限とデータベースサーバーのスーパーユーザー権限でインストールされます。これらの特権により、PEMエージェントは、システムの使用状況について監視対象ホストおよびデータベースサーバーで無制限のプローブを呼び出し、情報を取得してPEMサーバーに返すことができます。
PEMエージェントの権限が低下すると、PEM機能が低下することに注意してください。完全な機能を実現するには、PEMエージェントをrootとして実行する必要があります。 PEMエージェントがデータベースサーバーのサービスアカウントで実行されている場合、PEMプローブはレポートの生成に使用される統計情報に完全にアクセスできず、機能はそのアカウントの機能に制限されます。 PEMエージェントが別のより低い特権のアカウントで実行されている場合、機能はさらに制限されます。
PEMエージェントのオペレーティングシステム権限を制限すると、PEMプローブの一部が情報を返さず、次の機能が影響を受ける可能性があります。
| プローブまたはアクション | オペレーティング・システム | 影響を受けるPEM機能 |
| データとログファイルの分析 | Linux / Windows | Postgres Expertは完全な情報にアクセスできません。 |
| セッション情報 | Linux | プロセスごとの統計は不完全です。 |
| PG HBA | Linux / Windows | Postgres Expertは完全な情報にアクセスできません。 |
| サービス再起動機能 | Linux / Windows | 監査ログマネージャー、サーバーログマネージャー、ストリーミングレプリケーション、ログ分析エキスパート、およびPEMは、要求された変更を適用できない場合があります。 |
| パッケージ展開 | Linux / Windows | PEMは、ダウンロードしたインストールモジュールを実行できません。 |
| バッチタスク | 窓 | PEMは、Windowsでスケジュールされたバッチジョブを実行できません。 |
| サーバーからデータを収集する（ルートアクセスが必要） | Linux / Windows | スワップ使用率、CPU使用率、IO読み取り、IO書き込みなどの列は、セッションアクティビティダッシュボードに0として表示されます。 |
..注::上記のリストは包括的なものではありませんが、制限される機能の種類の概要を提供する必要があります。
PEMエージェントのデータベース特権を制限すると、次のPEM機能が影響を受ける可能性があります。
| プローブ | オペレーティング・システム | 影響を受けるPEM機能 |
| 監査ログの収集 | Linux / Windows | PEMはPEMデータベースから空のデータを受け取ります。 |
| サーバーログ収集 | Linux / Windows | PEMはサーバーログ情報を収集できません。 |
| データベース統計 | Linux / Windows | データベース/サーバー分析ダッシュボードには、不完全な情報が含まれます。 |
| セッション待機/システム待機 | Linux / Windows | セッション/システム待機ダッシュボードには、不完全な情報が含まれます。 |
| ロック情報 | Linux / Windows | データベース/サーバー分析ダッシュボードには、不完全な情報が含まれます。 |
| ストリーミングレプリケーション | Linux / Windows | ストリーミングレプリケーションダッシュボードには情報は表示されません。 |
| Slonyレプリケーション | Linux / Windows | データベース分析ダッシュボードのSlony関連のチャートには情報が表示されません。 |
| 表領域サイズ | Linux / Windows | サーバー分析ダッシュボードには完全な情報は表示されません。 |
| xDBレプリケーション | Linux / Windows | PEMはxDBアラートとトラップを送信できません。 |
プローブが不十分な特権でオペレーティングシステムを照会している場合、プローブはpermission deniedエラーを返す場合があります。
プローブが不十分な権限でデータベースを照会している場合、プローブはpermission deniedエラーを返すか、返されたデータを空の値としてPEMチャートまたはグラフに表示する場合があります。
プローブが失敗すると、プローブの名前、プローブが失敗した理由、問題の解決に役立つヒントを含むエントリがログファイルに書き込まれます。
サーバーで発生したプローブ関連のエラーをプローブログダッシュボードで表示したり、PEMワーカーログファイルのエラーメッセージを確認したりできます。 Linuxでは、ログファイルのデフォルトの場所は次のとおりです。
/var/log/pem/worker.log
Windowsでは、 Event Viewerでログ情報を利用できます。
エージェント設定¶
多数のユーザー設定可能なパラメーターとレジストリエントリがPEMエージェントの動作を制御します。 Streaming Replicationウィザードなどの一部のPEM機能を有効にするには、PEMエージェントのパラメーター設定を変更する必要がある場合があります。 PEMエージェント構成ファイルの値を変更した後、変更を適用するにはPEMエージェントを再起動する必要があります。
PEM_MAXCONNパラメーターを除き 、PEM機能を有効にするために変更が必要な場合を除き 、EnterpriseDBサポートの専門家に相談することなく、以下にリストされている構成パラメーターまたはレジストリエントリを変更しないことを強くお勧めします。
Linuxシステムでは、PEM構成オプションは/opt/edb/pem/agent/etcにあるagent.cfgファイルに保存されます。 agent.cfgファイルには、次のエントリが含まれています。
| パラメータ名 | 説明 | デフォルト値 |
|---|---|---|
| pem_host | PEMサーバーのIPアドレスまたはホスト名。 | 127.0.0.1。 |
| pem_port | PEMサーバーと通信するためにエージェントが接続するデータベースサーバーポート。 | ポート5432。 |
| pem_agent | PEMエージェントに割り当てられた一意の識別子。 | 最初のエージェントは「1」、2番目のエージェントは「2」などです。 |
| agent_ssl_key | PEMエージェントのキーファイルへの完全なパス。 | /root/.pem/agent.key |
| agent_ssl_crt | PEMエージェントの証明書ファイルへの完全なパス。 | /root/.pem/agent.crt |
| agent_flag_dir | HAサポートに使用されます。別のサーバーの監視を引き継ぐための要求をチェックするディレクトリパスを指定します。要求は、指定されたフラグディレクトリ内のファイルの形式で行われます。 | デフォルトでは設定されていません。 |
| log_level | ログレベルは、PEMログファイルに書き込まれるイベントのタイプを指定します。 | 警告 |
| log_location | PEMワーカーログファイルの場所を指定します。 | 127.0.0.1。 |
| agent_log_location | PEMエージェントのログファイルの場所を指定します。 | /var/log/pem/agent.log |
| 長い待ち時間 | 最初の接続試行が失敗した場合、PEMエージェントがPEMサーバーへの接続を試行する前に待機する最大時間（秒単位）。 | 30秒 |
| short_wait | キュー内の次のプローブが実行されるのを確認する前にPEMエージェントが待機する最小時間（秒）。 | 10秒 |
| alert_threads | エージェントによって生成されるアラートスレッドの数。 | エージェントに対して1に設定 PEMサーバーのホスト上にある;他のすべてのエージェントの場合は0。 |
| enable_smtp | trueに設定すると、SMTP電子メール機能が有効になります。 | PEMサーバーホストの場合はtrue。他のすべての場合はfalse。 |
| enable_snmp | trueに設定すると、SNMPトラップ機能が有効になります。 | PEMサーバーホストの場合はtrue。他のすべての場合はfalse。 |
| enable_nagios | trueに設定すると、Nagiosアラートが有効になります。 | PEMサーバーホストの場合はtrue。他のすべての場合はfalse。 |
| connect_timeout | エージェントが接続を待機する最大時間（秒）（10進整数文字列）。 | デフォルトでは設定されていません。 0に設定すると、エージェントは無期限に待機する必要があります。 |
| allow_server_restart | TRUEに設定すると、エージェントは、監視するデータベースサーバーを再起動できます。このパラメーターの値に応じて、一部のPEM機能を有効/無効にすることができます。 | 本当 |
| allow_package_management | TRUEに設定すると、更新モニターとパッケージ管理機能が有効になります。 | 偽 |
| max_connections | 接続スロットルで使用されるプローブ接続の最大数。 | 0（無制限の数） |
| connection_lifetime | ConnectionLifetime（またはconnection_lifetime）を使用して、開いているがアイドル状態の接続が保持される最小秒数を指定します。 MaxConnectionsで指定された値に達し、待機中の要求を満たすために（異なるデータベースへの）新しい接続が必要な場合、このパラメーターは無視されます。 | デフォルトでは、0に設定されます（エージェントの処理ループ後に接続がアイドル状態になると、接続はドロップされます）。 |
| allow_batch_probes | TRUEに設定すると、ユーザーはカスタムプローブ機能を使用してバッチプローブを作成できます。 | 偽 |
| heartbeat_connection | TRUEに設定すると、ハートビートの送信に専用の接続が使用されます。 | 偽 |
| allow_streaming_replication | TRUEに設定すると、ユーザーはストリーミングレプリケーションを構成およびセットアップできます。 | 偽 |
| batch_script_dir | スクリプトファイル（アラート用）が保存されるパスを指定します。 | / tmp |
| connection_custom_setup | 監視対象サーバーとの新しい接続が確立されたときに呼び出されるSQLコードを提供するために使用します。 | デフォルトでは設定されていません。 |
| ca_file | CA証明書が存在するパスを指定します。 | /opt/PEM/agent/share/certs/ca-bundle.crt。 |
64ビットWindowsシステムでは、PEMレジストリエントリは次の場所にあります。
HKEY_LOCAL_MACHINE\\Software\\Wow6432Node\\EnterpriseDB\\PEM\\agent
レジストリには次のエントリが含まれます。
| パラメータ名 | 説明 | デフォルト値 |
| PEM_HOST | PEMサーバーのIPアドレスまたはホスト名。 | 127.0.0.1。 |
| PEM_PORT | PEMサーバーと通信するためにエージェントが接続するデータベースサーバーポート。 | ポート5432。 |
| AgentID | PEMエージェントに割り当てられた一意の識別子。 | 最初のエージェントは「1」、2番目のエージェントは「2」などです。 |
| AgentKeyPath | PEMエージェントのキーファイルへの完全なパス。 | ％APPDATA％\ Roaming \ pem \ agent.key。 |
| AgentCrtPath | PEMエージェントの証明書ファイルへの完全なパス。 | ％APPDATA％\ Roaming \ pem \ agent.crt |
| AgentFlagDir | HAサポートに使用されます。別のサーバーの監視を引き継ぐための要求をチェックするディレクトリパスを指定します。要求は、指定されたフラグディレクトリ内のファイルの形式で行われます。 | デフォルトでは設定されていません。 |
| LogLevel | ログレベルは、PEMログファイルに書き込まれるイベントのタイプを指定します。 | 警告 |
| 長い待ち時間 | 最初の接続試行が失敗した場合、PEMエージェントがPEMサーバーへの接続を試行する前に待機する最大時間（秒単位）。 | 30秒 |
| shortWait | キュー内の次のプローブが実行されるのを確認する前にPEMエージェントが待機する最小時間（秒）。 | 10秒 |
| AlertThreads | エージェントによって生成されるアラートスレッドの数。 | PEMサーバーのホストに常駐するエージェントに対して1に設定します。他のすべてのエージェントの場合は0。 |
| EnableSMTP | trueに設定すると、SMTP電子メール機能が有効になります。 | PEMサーバーホストの場合はtrue。他のすべての場合はfalse。 |
| EnableSNMP | trueに設定すると、SNMPトラップ機能が有効になります。 | PEMサーバーホストの場合はtrue。他のすべての場合はfalse。 |
| ConnectTimeout | エージェントが接続を待機する最大時間（秒）（10進整数文字列）。 | デフォルトでは設定されていません。 0に設定すると、エージェントは無期限に待機します。 |
| AllowServerRestart | TRUEに設定すると、エージェントは、監視するデータベースサーバーを再起動できます。このパラメーターの値に応じて、一部のPEM機能を有効/無効にすることができます。 | 本当 |
| AllowPackageManagement | TRUEに設定すると、更新モニターとパッケージ管理機能が有効になります。 | 偽 |
| MaxConnections | 接続スロットルで使用されるプローブ接続の最大数。 | 0（無制限の数） |
| ConnectionLifetime | ConnectionLifetime（またはconnection_lifetime）を使用して、開いているがアイドル状態の接続が保持される最小秒数を指定します。 MaxConnectionsで指定された値に達し、待機中の要求を満たすために（異なるデータベースへの）新しい接続が必要な場合、このパラメーターは無視されます。 | デフォルトでは、0に設定されます（エージェントの処理ループ後に接続がアイドル状態になると、接続はドロップされます）。 |
| AllowBatchProbes | TRUEに設定すると、ユーザーはカスタムプローブ機能を使用してバッチプローブを作成できます。 | 偽 |
| HeartbeatConnection | TRUEに設定すると、ハートビートの送信に専用の接続が使用されます。 | 偽 |
| AllowStreamingReplication | TRUEに設定すると、ユーザーはストリーミングレプリケーションを構成およびセットアップできます。 | 偽 |
| BatchScriptDir | スクリプトファイル（アラート用）が保存されるパスを指定します。 | / tmp |
| ConnectionCustomSetup | 監視対象サーバーとの新しい接続が確立されたときに呼び出されるSQLコードを提供するために使用します。 | デフォルトでは設定されていません。 |
| ca_file | CA証明書が存在するパスを指定します。 | /opt/PEM/agent/share/certs/ca-bundle.crt。 |
エージェントのプロパティ¶
[ PEM Agent Properties ]ダイアログには、ダイアログを開いたPEMエージェントに関する情報が表示されます。ダイアログを開くには、PEMクライアントツリーコントロールでエージェント名を右クリックし、コンテキストメニューから[ Properties ]を選択します。
PEMエージェントのプロパティダイアログ
PEMエージェントプロパティダイアログのフィールドを使用して、PEMエージェントに関する情報を確認または変更します。
- [
Descriptionフィールドには、PEMエージェントの変更可能な説明が表示されます。この説明は、PEMクライアントのツリーコントロールに表示されます。 - グループを使用して、PEMクライアントツリーコントロールでサーバーとエージェントを整理できます。 [
Groupドロップダウンリストボックスを使用して、エージェントが表示されるグループを選択します。 - [
Teamフィールドを使用して、エージェントによって監視されているサーバーにアクセスできるグループロールの名前を指定します。このエージェントによって監視されるサーバーは、接続されたチームメンバーのPEMクライアントツリーコントロールに表示されます。これは便利な機能であることに注意してください。 Teamフィールドは真の分離を提供しないため、セキュリティの目的で使用しないでください。 - [
Heartbeat intervalフィールドには、PEMエージェントからPEMサーバーへのレポート間の経過時間の長さが表示されます。間隔を変更するには、[Minutesまたは[Secondsフィールドの横にあるセレクターを使用します。
