--help

使用可能なヘルプオプションを表示します。

--help-all

すべてのヘルプオプションを表示します。

--help-admin

管理モジュールのオプションを表示します。

--help-proxy

プロキシモジュールのオプションを表示します。

--help-monitor

監視モジュールのオプションを表示します。

--help-agent

エージェントモジュールのオプションを表示します。

--admin-address=host:port

管理ポートのホスト名 (または IP アドレス) とポートを指定します。デフォルトは localhost:4041 です。

--admin-lua-script=script

プロキシの管理モジュールに使用するスクリプトを指定します。

--admin-password=pass

mysql-monitor-agent の管理モジュールに接続しようとしているユーザを認証するために使用するパスワードを定義します。管理モジュールは、接続のユーザ名とパスワードの要求に MySQL プロトコルを使用します。

--admin-username=user

mysql-monitor-agent の管理モジュールに接続しようとしているユーザを認証するために使用するユーザ名を定義します。デフォルト名は root 。管理モジュールは、接続のユーザ名とパスワードの要求に MySQL プロトコルを使用します。

--agent-collector-plugins=user

エージェントによって使用およびロードされ、収集項目を提供するために使用されるプラグインのコンマ区切りのリスト。

サーバーを監視する場合、agent プラグインを設定する必要があります。Query Analyzer をサポートする場合、proxy モジュールを有効にする必要もあります。 プラグインは、プラグイン名を示したカンマで区切ったリストとして指定されます。

Query Analyzer をインストールの際に有効にした場合、デフォルトの値はproxy,agentです。インストール中に Query Analysis を無効にした場合、デフォルト値は agent になります。

{--agent-connect-timeout=seconds

失敗がレポートされる前のエージェントのMySQLサーバーへのタイムアウト値です。

--agent-DNS-cachetimeout=seconds

与えられたDNS名のIPアドレスをキャッシュするためののタイムアウト値です。デフォルトでは、オペレーティンすシステムのアドレスのキャッシングが使用され、エージェント内のキャッシングはまったく使用されません。 -1 キャッシングを有効にした場合、タイムアウトしません。 他のすべての正の値はタイムアウト値を指定します。

--agent-net-timeout=seconds

エージェントが既に接続しているMySQLサーバーから、レスポンスを得るまでのタイムアウト。

--agent-report-network-fs

ネットワークファイルシステムのデータ収集を有効にします。情報の特定とレポートによるレイテンシが他の情報の収集とレポートの遅延の原因となるため、ネットワークファイルシステムのレポーティングは無効になっています。ネットワークファイルシステムにおいてカスタムデータ収集を実行するアドバイザとグラフを使用する必要がある場合、収集を手動で有効にする必要があります。

--agent-force-uncorking

MySQL Enterprise Service Manager に送信される応答のコーキングを強制的にオフにします。コーキングメカニズムは、サーバーでの情報の氾濫を防ぐため、サーバーに送信されるデータの報告間隔をランダム化しようとするものです。

このオプションと ---agent-report-offset を組み合わせると、データがサーバーに報告されるときのオフセットを指定できます。詳細は agent-report-offsetを参照してください。

この設定によってデータ収集の頻度が変更されることはありません。

--agent-generate-uuid

エージェントの UUID を再生成します。1 台のマシンからもう 1 台のマシンにエージェントの設定情報をコピーした場合に、これを使用して新しい UUID を生成できます。次のように使用します。

shell> /opt/mysql/enterprise/agent/bin/mysql-monitor-agent --agent-generate-uuid
ee9296d7-f7cd-4fee-8b26-ead884ebf398
2009-03-05 11:49:37: (critical) shutting down normally

詳細については、「複数の MySQL サーバーの監視」を参照してください。

--agent-heartbeat-interval=#

ハートビートの間隔を指定します。エージェントは MySQL Enterprise Service Manager にハートビートメッセージを送信して、まだ稼働中でありサーバーの監視を実行していることを示します。MySQL Enterprise Service Manager は、エージェントが使用可能かどうかを識別するためにこの情報を使用します。

--agent-host-id=HOSTID

エージェントのホスト ID を定義します。ホスト ID は、エージェントが稼働しているホストの一意の識別子にする必要があります。エージェント UUID とは異なります。2 つの同一のエージェント設定 (稼働中のサーバー設定と、プライマリサーバーの障害発生時に使用されるバックアップサーバー設定) を持つ HA 環境内では、使用するホスト ID を上書きできます。ホスト ID はサーバーがホストを特定するために使用されます。監視対象のサーバーが元のサーバーであってもフェイルオーバー (代わりの) サーバーのどちらであっても、フェイルオーバーのときはホスト ID が一定になるようにします。

--agent-host-id=HOSTID

MySQL Enterprise Agent が使用およびサポートする IP のバージョンを指定します。デフォルトでは、エージェントは IPv4 と IPv6 の両方をサポートします。または、4 か 6 を指定してバージョンを指定できます。

--host-id-commandline

ホスト ID を生成するコマンドラインを指定します。デフォルトでは、ホスト ID は、SSH 鍵や組み込みのホスト ID 情報の使用など、特定のプラットフォームのために設定されたさまざまな方法によって生成されます。これを代わりとなるコマンドラインに置き換えることができます。

--agent-hostname

自動的に決定されたホスト名を上書きします。これを使用して、エージェントに代わりのホスト名を指定できます。これは、複数のホスト名があり、特定のホスト名でマシンを識別する場合に役立ちます。

--agent-item-files

データ項目のロードに使用される項目ファイルのコンマ区切りのリスト。これらのデータ項目は、あとで収集され、MySQL Enterprise Service Manager に送信されます。詳細については、「 カスタムデータコレクションアイテムの作成」を参照してください。

デフォルト値はshare/mysql-proxy/items/quan.lua (Query Analyzer データを提供) およびshare/mysql-proxy/items/items-mysql-monitor.xml (コアエージェント監視データを提供）を含みます。

--agent-max-response-size

MySQL Enterprise Service Manager に送信される応答パケットの最大サイズを指定します。

--agent-ssh-keygen-attempts

Number of attempts that the agent should retry, for a failed ssh-keygen.

--agent-ssh-keygen-retry

Time interval (in seconds) between attempts for a failed ssh-keygen attempt.

--agent-master-uuid-discovery

デフォルトではMySQL Enterprise Agentはレプリケーションマスタの UUID を使用して、レプリケーショントポロジを識別します。このオプションを無効にすると、エージェントがmaster.infoへアクセスし、。レプリケーションマスタから得るUUIDを使用することを防ぎます。代わりにホスト名とポート情報を使用してトポロジを特定し、インスタンスとマスタ情報を一致させます。

--agent-mgmt-hostname

収集されたデータが送信される MySQL Enterprise Service Manager の URL を設定します。この URL には、エージェントのユーザ名とパスワードを含めなければいけません (例: http://agent:password@memserver:18080/heartbeat)。

--agent-mgmt-username

MySQL Enterprise Service Manager との通信時に使用するユーザ名。

--agent-mgmt-password

MySQL Enterprise Service Manager との通信時に使用するパスワード。

--agent-report-offset

データが MySQL Enterprise Service Manager に送信される時間 (分) からのオフセット (秒)。これを使用して複数のマシンにわたるエージェント報告を調和または一致させることで、パフォーマンスが向上する場合があります。

たとえば、--agent-report-offset=15 と設定すると、毎分 15 秒後にデータが報告されます。 例、12:00:15、12:01:15 など。

--agent-run-os-tests

内部のオペレーティングシステムテストを実行し、終了します。このオプションを使用すると、ホストについて収集可能な、さまざまなオペレーティングシステムの情報に関する大量の情報が生成されます。 これを使用すると、エージェントがサーバーに対して適切な量と品質の情報を集めているかどうかを判断できます。

出力例の抜粋を次に示します。

2010-01-22 16:15:45: (critical) MySQL Monitor Agent 2.2.1.1138 started.
sigar-test-all.c.128 ():
  pid = 1353
sigar-test-all.c.110 ():
  mem.ram = 6080,
  mem.total = 6374154240,
  mem.used = 3356090368,
  mem.free = 3018063872,
  mem.actual_free = 3018063872,
  mem.actual_used = 3356090368
sigar-test-all.c.143 ():
  swap.total = 28523896832,
  swap.used = 710623232,
  swap.free = 27813273600
sigar-test-all.c.169 ():
  cpu.user = 24544920,
  cpu.sys = 136764840,
  cpu.nice = 0,
  cpu.idle = 1234759920,
  cpu.wait = 0,
  cpu.total = 349015500
sigar-test-all.c.194 ():
[0]
  cpu.user = 8516770,
  cpu.sys = 56838970,
  cpu.nice = 0,
  cpu.idle = 283667220,
  cpu.wait = 0,
  cpu.total = 349022960
[1]
  cpu.user = 6130420,
  cpu.sys = 12671090,
  cpu.nice = 0,
...

--agent-sync-attempts

再同期のときに、サーバーとの同期を試行します。

--track-alloc

エージェントのさまざまなモジュールでメモリー割り当てを追跡して、メモリー使用量の監視を手助けします。

--agent-uuid

エージェントの UUID を指定します。UUID はインストール中に各エージェントのために自動的に生成され、自動的に設定に追加されます。agent-generate-uuid コマンドラインオプションを使用して、新しい UUID を生成できます。

複数のホストを設定して、ホスト間の設定をコピーする場合、agent-uuid が一意であることを確認してください。この設定プロパティを空白のままにすると、エージェントで新しい UUID を作成できます。

--basedir

ほかのすべてのファイル名設定オプションの先頭に追加されるベースディレクトリを指定します。 絶対パスでディレクトリ名を使用します。相対パスを使用すると、mysql-monitor-agent がスタートアップ時にエラーを発生します。

--defaults-file

設定情報を含むファイルとして使用するファイルを指定します。指定しない場合、設定オプションはコマンドラインからのみ取得されます。

--event-threads=#

受け取る要求を扱うために予約するイベントスレッドの数を指定します。

--keepalive

クラッシュなどの障害が発生したときに真の mysql-monitor-agent プロセスの再開を試行する、主要な mysql-monitor-agent を囲むプロセスを作成します。

エージェントが予期せず停止した場合、エンジェルがエージェントを復活させます。

予期できる停止:

エンジェル がSIGHIP、SIGTERM または SIGINT シグナルのいずれかを受信シア場合、そのシグナルははエージェントニ送られ、エージェントはシャットダウンを開始します。

--agent-backlog-timeout=VALUE

エージェントが MySQL Enterprise Service Manager と通信できない場合に、データがエージェントによって保持される時間 (秒単位)。 エージェントが再接続すると、データは MySQL Enterprise Service Manager に送信されます。 指定された値より古いデータは破棄されます。 デフォルトは 600 秒。

--aggr-address=host:port

MySQL Enterprise Agent Aggregator の待機ホスト名と待機ポートのどちらか、または両方を指定します。

--log-backtrace-on-crash

障害発生時、エラーログにバックトレースを記録して、デバッガの初期化を試行します。

--aggr-lua-script=SCRIPT

MySQL Enterprise Agent Aggregator の動作に使用されるスクリプトを指定します。

--aggr-max-request-body-size=bytes

Limits the maximum size of requests sent to the Aggregator, to avoid potential out-of-memory errors on the system running the Agent (and its Aggregator component).

--aggr-mem-baseurl=URL

クライアントプラグインから収集したクエリ集合を送信するときに使用される、MySQL Enterprise Service Manager のベース URL。

--aggr-ssl-address=host:port

SSL 接続の待機時に使用される、待機ホスト名と待機ポートのどちらか、または両方。

--aggr-ssl-ca-file=FILENAME

SSL 通信に使用される CA チェーンファイル。

--aggr-ssl-cert-file=FILENAME

MySQL Enterprise Agent Aggregator のサーバー証明書。これは、非公開鍵と署名付き証明書の組み合わせで構成される PEM ファイルの形式でなければいけません。

--aggr-ssl-ciphers=STRING

SSL を使用した安全な通信に使用される暗号のリスト。

--aggr-test-mode

MySQL Enterprise Agent Aggregator をテストモードで起動します。

--log-file=filename

ログ情報の記録に使用されるファイル名を指定します。完全なパス名を指定しない場合、ログファイルの位置は、エージェントのインストールディレクトリと相対的とみなされます。

--log-level=level

エラーメッセージの出力時に使用されるログレベル。 そのレベル以下のメッセージが出力されます。たとえば、message を指定すると、info、warning、および error メッセージも出力されます。

--log-use-syslog

エラーが syslog に送信されるようにします (Unix/Linux のみ)。

--lua-cpath=path

Lua スクリプトのコンパイル済みモジュールやライブラリのロード時に使用される LUA_CPATH を指定します。

--lua-path=path

Lua のモジュールのロード時に使用される LUA_CPATH を指定します。

--max-open-files=#

mysql-monitor-agent プロセスによってサポートされる、開くファイルとソケットの最大数。特定のスクリプトでは、この値を増やさなければならないことがあります。

--monitor-interval=#

この間隔でバックエンドにクエリを実行します。デフォルトは 1 です。

--monitor-lua-script=SCRIPT

監視モジュールに使用する Lua スクリプトのファイル名。

--monitor-password=PASS

監視するユーザアカウントのパスワード。

--monitor-username=USER

監視するユーザアカウントのユーザ名。

--mysqld-instance-dir=PATH

MySQL インスタンスの設定ファイルへのパス。

--agent-IP-version=VER

アドレス指定に使用される IP バージョンを明示的に設定します。デフォルトで、エージェントは両バージョンを使用します。この値は、4 (IPv4 の場合) または 6 (IPv6 の場合) を指定して設定します。

--aggr-flush-interval=seconds

MySQL Enterprise Service Managerにクエリがフラッシュされる間隔。 デフォルト値は60です。

--no-proxy

プロキシモジュールを無効にします。

--plugin-dir=path

mysql-monitor-agent のプラグインのロード時に使用するディレクトリ。

--plugins=plugin,...

ロードされるプラグインのコンマ区切りのリスト。

--proxy-address=host:port

プロキシサーバーの待機ホスト名 (または IP アドレス) およびポート。 デフォルトは :6446 です (すべての IP がポート 6446 を使用)。この設定は、Query Analysis を使用するときに、アプリケーションが通常の MySQL サーバーの代わりに使用するアドレスまたはポートとして使用されます。これは、デフォルトでは、インストール中に設定されます。

--proxy-read-only-backend-addresses=host:port

読み取り専用接続でのプロキシサーバーの待機ホスト名 (または IP アドレス) およびポート。この情報のデフォルトは設定されません。

--proxy-backend-addresses=host:port

接続する MySQL サーバーのホスト名 (または IP アドレス) およびポート。複数のオプションを使用すれば、複数のバックエンドサーバーを指定できます。クライアントは、ラウンドロビン方式で各バックエンドサーバーに接続されます。たとえば、2 つのサーバーとして A と B を指定した場合、1 つめのクライアント接続はサーバー A へ、2 つめのクライアント接続はサーバー B へ、そして 3 つめのクライアント接続はサーバー A へ向かいます。 8

--proxy-pool-no-change-user

backend-addresses リストで指定された接続のプールから接続を再利用する場合に、MySQL プロトコル CHANGE_USER の使用を無効にします。

--proxy-skip-profiling

クエリのプロファイル (時間統計の追跡) を無効にします。デフォルトでは、追跡が有効になっています。

--proxy-fix-bug-25371

5.1.12 より前のいずれかのバージョンの MySQL クライアントライブラリを使用している場合に、5.1.12 以降のバージョンの MySQL Server に接続したときに起こる問題を解決します。

--proxy-lua-script=file

ロードされる Lua スクリプトファイルを指定します。接続されるまでは、スクリプトファイルは物理的にロードおよび解析されません。また、指定された Lua スクリプトは接続されるごとに再ロードされます。mysql-monitor-agent の実行中に Lua スクリプトの内容が変更された場合、新しく接続されたときに更新された内容が自動的に使用されます。 Query Analyzerするには、このパラメータをshare/mysql-proxy/quan.luaに設定します。これはデフォルト値です。

--daemon

プロキシをデーモンモードで起動します。

--pid-file=file

プロセス ID の保存に使用されるファイル名を設定します。これは、シャットダウンされるプロセスを特定するために、エージェントをシャットダウンするスクリプトにより使用されます。デフォルト値は、エージェントインストーラにより作成される基本インストールディレクトリ内の mysql-monitor-agent.pid ファイルです。

--user=user

指定された user として mysql-monitor-agent を実行します。

--version

バージョン番号を表示します。

--verbose-shutdown

デフォルトでは、log-level を message またはそれ以上に設定してある場合のみ、エージェントシャットダウンメッセージが記録されます。このオプションを使用すると、ログレベルにかかわらず、シャットダウンメッセージが強制的に報告されるようにできます。