pmmgr - クラウドでオンライン

プログラム：

NAME

pmgr - pcpデーモンマネージャー

SYNOPSIS

pmgr [-v] [-c 構成ディレクトリ] [-p ポーリング間隔] [-l ログファイル]

DESCRIPTION

pmgr 検出されたローカルおよびリモート ホストのセットに対する PCP デーモンのコレクションを管理します
XNUMX 個以上の条件に従ってパフォーマンス メトリック収集デーモン (PMCD) を実行する
構成ディレクトリ。 一致するセットを保持します 午後ロガー および ピーミー デーモン
実行中、およびそのアーカイブ/ログがマージ/ローテーションされました。 古いものに取って代わる pmlogger_* 　
pmie_* チェック/日次管理シェルスクリプト。

pmmgr は大部分が自己構成であり、ほとんどの実行時エラーにもかかわらず持続します。 pmgr が実行されます
中断されるまでフォアグラウンドで表示されます。 シグナルが送られると、実行中のデーモンが停止します
終了する前に。

に固有のコマンド ライン オプションの説明 pmgr 以下：

-c ディレクトリにジョブを開始します。 指定された構成ディレクトリを pmmgr に追加します。 pmgrは監督できる
複数の異なる構成を同時に実行できます。 構成にエラーが発生する可能性があります
標準エラーに注意されますが、pmgr は組み込みの関数で欠落情報を埋めます。
デフォルト。 デフォルトのディレクトリは次のとおりです $PCP_SYSCONF_DIR/pmmgr

-p ポーリング間隔 ホスト検出ポーリング間隔を指定された数に設定します。
秒。 デフォルトは 60 です。特定のターゲット ホストのデーモンが再起動されます。
この間隔よりも頻繁に実行することはできません。

-l ログファイル 標準出力とエラーを、作成される指定されたログ ファイルにリダイレクトします。
改めて

-v 標準出力にさらに詳細なトレースを追加します。

CONFIGURATION

A pmgr 構成は、どのホストを監視する必要があるか、どのデーモンを監視する必要があるかを特定します。
それらのデーモンを実行する際にどのようなオプションを使用する必要があるか。 pmgr は
テキスト ファイル内の行ではなく、構成ディレクトリ内の少数のファイル。 の
個々のファイルには、100% 純粋な構成テキストが XNUMX 行以上含まれています。
コメント。 (必要に応じて、構成は他のファイルでコメント化できます。
自由形式の README)。

TARGET SELECTION
この設定ファイルのセットは、pmgr が pmcd インスタンスを検索する場所を識別します。
それらを一意に識別する方法と、それぞれのログ ファイルなどの状態をどこに保持する必要があるか。
理想的には、永続的かつ一意のホスト ID 文字列が潜在的なターゲット pmcd ごとに計算されます。
指定されたメトリック値から。 このホスト ID は、次のサブディレクトリ名としても使用されます。
デーモンデータを検索しています。

ホスト ID メトリック
このファイルには、次の形式のメトリック仕様が XNUMX 行以上含まれています。
によって受け入れられた pmParseMetricSpec。 インスタンス指定子のないメトリクスはすべてを意味します
そのメトリクスのインスタンス。 これらは、 ユニーク のホスト ID 文字列
pmgr が検出する各 pmcd サーバー。 検出時に、すべてのメトリクス/インスタンス
名前が照会され、文字列値がフェッチされ、単一に正規化/連結されます。
ハイフンで区切られた印刷可能な文字列。 デフォルトは単一のメトリックです pmcd.ホスト名、その
検出されたすべてのホストが一意であれば十分です。 hostname(2)。 そうしないと、
他の PCP メトリック仕様を追加して、サイトで区別する必要があります。 の
追加するほどホスト ID 文字列は長くなりますが、偶発的なエラーが発生する可能性が高くなります。
重複が防止されます。

ただし、ホスト ID も同様であることが望ましい場合があります。 永続性、そのため、
ターゲット ホストがオフラインになり、後で復帰すると、新しいホスト ID が以前のホスト ID と一致します。
XNUMX つは、古い歴史と新しい歴史を結びつけることができるからです。 これは使用に反対します
ブートごとに値が異なるメトリクス。

考慮すべき指標の候補は次のとおりです。 network.interface.hw_addr,
network.interface.inet_addr["eth0"], network.interface.ipv6_addr,
kernel.uname.nodename

ログディレクトリ
このファイルには、ホストごとの ID が属するディレクトリのパスが含まれています。
サブディレクトリは pmmgr によって作成されます。 フルパスでない場合は、
構成ディレクトリ自体に対して暗黙的に相対的に指定されます。 デフォルトは
$PCP_LOG_DIR/pmmgr/.

ターゲットホスト
このファイルには、pmcd ホストの仕様を含む XNUMX 行以上の行が含まれています。
に記載されている PCピントロ(1) マニュアルページ。 各ポーリング間隔で、pmgr は次のことを試みます。
概要を作成する pmNewContext ホストに接続して活性を確認します。 それはではありません
同じホストに対して複数の仕様がリストされている場合に問題が発生します。
host-id処理により重複を排除し、任意の仕様を選択
その中で。 デフォルトでは、pmcd をターゲットにします。 地元：.

ターゲットの発見
このファイルには、
pmDiscoverServices PMAPI 呼び出し。それぞれが変動するセットにマッピングされる可能性があります。
ローカルまたはリモートの pmcd サーバー。 ポーリング間隔ごとに、pmmgr は再実行を試みます。
指定された仕様をすべて備えた検出。 繰り返しますが、それ以上であれば問題ありません
複数の仕様が同じ実際の pmcd に一致します。確認された XNUMX つのアクセス パスは次のとおりです。
任意に選択されます。 デフォルトは次のとおりです いいえ 発見。 含めることを検討してください
アバヒ、タイムアウト=5 ローカルネットワーク上の pmcd 自己アナウンスに依存する (検索
毎回最大 XNUMX 秒間）。

サブターゲットコンテナ
このファイルが存在する場合、pmmgr は実行中に見つかった各ホストをスキャンします。
コンテナ。 実行中のコンテナごとに、独立したサブターゲットが作成されます。
pmlogger インスタンスを実行しています。 これらのサブターゲットのホスト ID 文字列は、ホストの
host-id 文字列、その後に二重ハイフン、その後に完全な一意のコンテナ
インスタンス名の文字列。 (一時的に、これらに対して pmie インスタンスは試行されません。
PCP バグ PR1105 によるサブターゲット。)

ログサブディレクトリ-gc
このファイルには、次のように時間間隔の仕様が含まれる場合があります。 PCピントロ マニュアルページ。
log ディレクトリのすべてのサブディレクトリには、pmgr- のデータが含まれていると想定されます。
監視対象サーバー。 触れられていないもの（ 統計/時間 意味）で
少なくともその長さであり、現在監視されているターゲットに関連付けられていないものは、
完全に削除されました。 この値は、pmmgr が実行する最長間隔よりも長くする必要があります。
通常はアーカイブを再作成します (pmgr の再起動などにより、 pmlogmerge
間隔）。 デフォルト値は次のとおりです 90days.

PMロガー CONFIGURATION
この構成オプションのグループは、 午後ロガー 各ホストのデーモン。 これはもしかしたら
これには、構成の生成とアーカイブの管理が含まれます。

午後ロガー
このファイルが存在する場合に限り、pmmgr は 午後ロガー それぞれのデーモン
ターゲットとなるホスト。 このファイルには、スペースで区切られた追加のオプションが XNUMX 行含まれています
pmie デーモン用。 (pmmgr はすでに -h、-f、-r、-l、そしておそらく -c を追加しています。)
デフォルトは維持することです いいえ 午後ロガー (そして、このセクションの他の構成はありません。
加工済み）。

pmlogconf
このファイルが存在する場合にのみ、pmmgr が実行されます。 pmlogconf を生成する
各ターゲット pmcd の設定ファイル。 ファイルには XNUMX 行のスペースが含まれています。
pmlogconf プログラムの追加オプションを分離しました。 pmlogconf が生成される
出力ファイルは、log-directory/hostid サブディレクトリに保存されます。 (pmgr
すでに -c、-r、および -h が追加されています。) デフォルトは次のとおりです。 いいえ pmlogconfしたがって、代わりに、
上記の pmlogger ファイルにはおそらく -c オプションが含まれている必要があります。これは、固定長を指定するためです。
pmloggerの設定。

アーカイブ LOG 公演の
デフォルトの pmlogger 構成では、XNUMX 日あたり数十メガバイトのデータを収集できます (おそらく
複数のアーカイブに分割)、ターゲット ホストごとに。 ディスク容量が無限未満の場合は、
またはアーカイブの分割が扱いにくい場合は、これを管理する必要があります。 デフォルトの管理されていないケースでは、
システム管理者は個人を管理する責任があります。 アーカイブ-* ファイルから
ホストごとのロギングサブディレクトリ。 pmmgr には他にもいくつかのオプションがあります。
パフォーマンスと使いやすさのさまざまなトレードオフを表します。

アーカイブ LOG 公演の - pmlogmerge
このスタイルのアーカイブ ログ管理では、以前のアーカイブから単一のマージされたアーカイブが定期的に作成されます。
ターゲット ホストごとにアーカイブし、実際には古いデータを切り取って新しいデータを追加します。 あ
単一のマージされたアーカイブは比較的大きくなる可能性があります (デフォルトは 100 つあたり約 400 ～ XNUMX MB)
ホスト)、ストレージに対応する I/O 負荷がかかりますが、詳細な用途に最も便利です。
ロングタイムフレーム分析。 pmlogger が再起動されると、常に新しいアーカイブが作成されるため、
定常状態では、最近の履歴の統合されたアーカイブが XNUMX つと、現在の履歴が XNUMX つ存在します。
pmlogger によってアーカイブに書き込まれています。

pmlogmerge
このファイルが存在すると、pmmgr が実行されます。 pmlogextract 定期的に結合する
各ターゲット pmcd の既存のログ アーカイブを XNUMX つの大きなログ アーカイブにまとめます。 そうして
既存のログ アーカイブは削除されます (以前にマージされたものを含む)。 これ
構成ファイルには、次のように時間間隔の指定が含まれる場合があります。 PCピントロ
man ページ。pmlogger が一時的に停止されるまでの期間を表します。
停止し、アーカイブがマージされました。 これは、
統合されたアーカイブ 遅れる 現在の時間。 デフォルトは 24hours.

pmlogmerge-粒状
このファイルが存在する場合、pmmgr は既存のログ アーカイブのサブセットのみをマージします。
それらすべてではなく、新しいものに置き換えて、粒度の整ったものに近づけます。
マージされたアーカイブのセット。 選択されたサブセットは前回に対応します
によって指定された間隔 pmlogmerge 制御ファイル。 デフォルトは いいえ 粒度.

pmlogmerge-rewrite
このファイルが存在すると、pmmgr が実行されます。 pmlogrewrite -i (さらにリストされているその他のオプション
このファイル内) をマージする前に各入力アーカイブに追加します。 これには当然必要になります
ディスク I/O が増加します。 デフォルトは いいえ 書き換え.

pmlogmerge-retain
pmmgr は一定期間後に元の解像度のアーカイブを縮小/削除します
このファイルによって指定され、ファイル mtime によって測定されます。 期間も
-S への負のパラメータとして pmlogextract に渡されます。 デフォルトは 14days。 へ
アーカイブを無期限に保存するには、これを「99999weeks」のような大きな量に設定します。

pmlogreduce
このファイルが存在する場合は、有効期限が切れるアーカイブを削除する前に、
pmlogmerge-retain ピリオドは次のように処理されます。 pmlogreduce 削減されたものを作成する
アーカイブ (名前付き) 削減-*）。 ファイルにスペースで区切られたオプションが含まれている場合、それらは次のようになります。
pmlogreduce に渡されます。 (デフォルトでは、pmlogreduce ダウンサンプルは 600 秒に設定されます
間隔。）

pmlogreduce-retain
このファイルが存在する場合、アーカイブは縮小されます ( 削減-* パターン）
ファイルから測定されたように、このファイルで指定された期間が経過すると削除されます
時間。 この時間は pmlogreduce の実行時間である可能性が高いため、合計保持期間は
時間はほぼ pmlogmerge-retain 時間になります さらに pmlogreduce-retain
時間。 デフォルトは 90days。 縮小されたアーカイブを無期限に保存するには、これを次のように設定します。
「99999weeks」のような大量の値。

ピーミー CONFIGURATION
この構成オプションのグループは、 ピーミー 各ホストのデーモン。 これはもしかしたら
カスタム構成の生成が含まれます。

pmie このファイルが存在する場合に限り、pmmgr は ピーミー それぞれのデーモン
ターゲットのpmcd。 このファイルには、スペースで区切られた追加のオプションが XNUMX 行含まれています
pmie デーモン用。 (pmmgr はすでに -h、-f、-l、そしておそらく -c を追加しています。) デフォルト
維持することです いいえ ピーミー (そして、このセクションの他の構成は処理されません)。

pmieconf
このファイルが存在する場合にのみ、pmmgr が実行されます。 pmieconf を生成する
各ターゲット pmcd の設定ファイル。 ファイルには XNUMX 行のスペースが含まれています。
pmieconf プログラムの追加オプションを分離しました。 pmieconf が生成した出力
ファイルは log-directory/hostid サブディレクトリの下に保存されます。 (pmmgr はすでに
-F、-c、および -f を追加します。) デフォルトは次のとおりです。 いいえ pmieconfしたがって、代わりに、上記の pmie ファイル
固定 pmie 構成を指定するには、おそらく -c オプションを含める必要があります。

onworks.netサービスを使用してオンラインでpmmgrを使用する