PCPIntro - クラウド上のオンライン

プログラム：

NAME

PCPはじめに - パフォーマンス コパイロット (PCP) の紹介

はじめに

Performance Co-Pilot (PCP) は、システムの監視と管理のために設計されたツールキットです。
レベルのパフォーマンス。 これらのサービスは分散されており、ほとんどのサービスに対応できるように拡張可能です。
複雑なシステム構成とパフォーマンスの問題。

PCP は、Linux、MacOSX、
ソラリスと Windows。 高レベルの PCP には、次の XNUMX つのクラスが含まれていると考えることができます。
ソフトウェアユーティリティ:

CFP コレクター
これらは、さまざまなデータからパフォーマンス データを収集および抽出する PCP の部分です。
ソース (オペレーティング システム カーネルなど)。

CFP モニター
これらは、ホスト (またはアーカイブ) から収集されたデータを表示する PCP の部分です。
それは CFP コレクタ インストールされています。 多くの監視ツールが部品として利用可能
コア PCP リリースの他の (通常はグラフィカルな) 監視ツールは
PCP GUI パッケージで別途入手可能です。

このマニュアルエントリでは、ほとんどの PCP に共通する高レベルの機能とオプションについて説明します。
すべてのプラットフォームで利用できるユーティリティ。

概要

PCP アーキテクチャは、任意の PCP ツールを実行できるという意味で分散されています。
遠隔で。 監視対象のホスト上で、パフォーマンス メトリックの各ドメイン、
カーネル、サービス層、データベース管理システム、Web サーバー、
アプリケーションなどにはパフォーマンス メトリック ドメイン エージェント (PMDA) が必要です。
そのドメインからパフォーマンス測定値を収集する責任があります。 すべてのPMDAは、
パフォーマンス メトリック コレクター デーモン (pmcd(1)) 同じホスト上にあります。

クライアント アプリケーション (監視ツール) の接続先 pmcd(1)、ルーターとして機能します。
リクエストを適切な PMDA に転送し、応答を PMDA に返すことにより、リクエストを処理します。
クライアントたち。 クライアントは、PCP アーカイブ (次を使用して作成) からパフォーマンス データにアクセスすることもできます。
午後ロガー(1)) 遡及分析用。

セキュリティ 哲学
PCP は、ホスト内およびホスト全体に豊富なパフォーマンス情報を再配布します。
ネットワーク。 次のセキュリティ哲学は、いくつかの設定の基礎となっています。 デフォルト
送受信される情報の量を制御します。

デフォルトでは、PMCD によって公開されるホストに関する情報はほぼ同じです
そのホスト上の完全に特権のないユーザーが利用できる機密性のレベル。 それで、
利用可能なパフォーマンスデータ read 機械上で完全に自由に作ることができる
PMCD によってネットワークに接続できます。

ただし、PMCD を実行しているホストとそのネットワークは 親善試合のみを想定
アプリケーション。 したがって、 書きます ローカル ホストからのものも含め、タイプの操作はサポートされません。
デフォルトで許可されています。

これらのデフォルトは、次のようないくつかの方法で上書き (拡張または縮小) できます。
ネットワーク ACL の指定 pmcd.conf、デフォルト以外の PMDA をアクティブ化する、または PMCD を使用する
ユーザー資格情報を渡す接続。 たとえば、一部の PMDA は、
特定の認証されたユーザーまたはグループに関するより詳細な情報。

アプリケーション
次のパフォーマンス監視アプリケーションは主にコンソール ベースであり、通常は
コマンド ラインから直接実行でき、以下のツールとして利用できるツールのほんの一部にすぎません。
基本 PCP パッケージの一部。

各ツールまたはコマンドは、それぞれのリファレンス ページに完全に文書化されています。

午後統計 システム パフォーマンスの概要を ASCII で出力します。

ピーミー 述語アクション ルールを評価してアラームを実行し、
システム管理タスクを自動化します。

午後情報 特定のパフォーマンス メトリックとそれを説明するメタデータを調べます。

午後ロガー
ほとんどの PCP による再生に適したパフォーマンス メトリックの PCP アーカイブを生成します
ツール。

pmval パフォーマンス指標の一部またはすべてのインスタンスに関する簡単な定期レポート。
オプションの VCR 時間制御。

PCP GUI パッケージがインストールされている場合は、次の追加ツールを使用できます。

午後のチャート
XNUMX つまたは複数のパフォーマンス メトリックから任意に選択したパフォーマンス メトリックの経時的な傾向を表示します。
より多くのホスト。

午後 複数のツール間の時間を調整するための時間制御ユーティリティ (
pmchart と pmval)。

午後ダンプテキスト
パフォーマンス メトリックの任意の組み合わせについて ASCII レポートを作成します。

COMMON COMMAND LINE 議論

ほとんどの PCP で一貫して使用される一連の共通コマンド ライン引数があります。
ツール。

-a アーカイブ
パフォーマンスメトリクス情報は、パフォーマンスから遡って取得されます。
副操縦士 (PCP) アーカイブ、以前に生成された 午後ロガーとします。見る pcp-
アーカイブ(5)for形式でアーカイブしたプロジェクトを保存します．のドキュメントで詳しく説明されています）。 この -a と -h オプションは相互に排他的です。

アーカイブ によって作成されたすべての物理ファイルに共通のベース名です。
のインスタンス 午後ロガー(1)、または物理ファイルのいずれか XNUMX つ (例: 私のアーカイブ （ベース
名前）または 私のアーカイブ.meta (メタデータ ファイル) または 私のアーカイブ。索引 (時間インデックス)
or 私のアーカイブ.0 (最初のデータ量 アーカイブ）または 私のアーカイブ.0.bz2 or
私のアーカイブ.0.bz (最初のデータ ボリュームは次の方法で圧縮されます) bzip2(1)) または 私のアーカイブ.0.gz
or 私のアーカイブ.0.Z or 私のアーカイブ.0.z (最初のデータ ボリュームは次の方法で圧縮されます) gzip（1））、
私のアーカイブ.1 or 私のアーカイブ.3.bz2 or 私のアーカイブ.42.gz 等々

-a アーカイブ[,アーカイブ,...]
の別の形式 -a 複数のアーカイブを処理できるアプリケーション向け。

-h hostname
によって別のホストに指示されない限り -h オプション、または -a
オプションの場合、パフォーマンス メトリックのソースはパフォーマンス メトリック コレクターになります。
ローカルホスト上のデーモン (PMCD)。 を参照してください。 PMCD 主催者 仕様
を形成するときに利用できる多くのオプションの詳細については、後ほど説明します。 hostname
仕様とデフォルトのローカルホストの詳細な説明
繋がり。 の -a と -h オプションは相互に排他的です。

-s サンプル
議論 サンプル 取得してレポートするサンプルの数を定義します。
If サンプル 0または -s が指定されていない場合、アプリケーションはサンプリングしてレポートします
継続的に (リアルタイム モードで)、または PCP アーカイブが終了するまで (アーカイブ内で)
モード）。

-z レポートのタイムゾーンをソースであるホストのローカル タイムゾーンに変更します。
のいずれかによって識別されるパフォーマンス メトリックの -h or -a オプション。

-Z タイムゾーン
デフォルトでは、アプリケーションはローカル タイムゾーンに従って時刻を報告します。
アプリケーションが実行されるシステム。 の -Z オプションでタイムゾーンを変更します
〜へ タイムゾーン 環境変数の形式で TZ で説明されているように
環境とします。

INTERVAL 仕様 そして 調整

ほとんどの PCP ツールは、定期的なサンプリングまたはレポートを使用して動作します。 -t と -A オプションは
サンプル間隔の継続時間とサンプルのアライメントを制御するために使用されます。
回。

-t インターバル
更新またはレポートの間隔を設定します。

この インターバル 引数は、次の XNUMX つ以上の要素のシーケンスとして指定されます。
フォーム
数[ユニット]
コラボレー 数 整数または浮動小数点定数です (次を使用して解析されます)。 ストロッド（3））および
オプションの ユニット の一つであります： 秒, 2番目の, ドライ, ドライ, s, 分, 分, 分,
分, m, 時, 時間, h, 日, 中 と d。 もし 単位 空です、 2番目の 想定されます。

さらに、上記のいずれかの大文字 (または大文字と小文字の混合) バージョンも
許容できます。

スペースのどこにでも インターバル 無視されるので、 4 日 6 時 30 分,
4日6時間30分, 4日6時間30分 と 4d6.5h すべて同等です。

複数の仕様は追加的です。例: 「1hour 15分 30秒'' と解釈されます
3600+900+30秒として。

-A 整列する
デフォルトでは、サンプルは必ずしも自然な時間単位に一致しているわけではありません。 の -A
オプションを使用すると、初期サンプルを強制的に境界に位置合わせすることができます。
自然な時間の単位。 例えば -A 1sec, -A 30min と -A 1hour 位置合わせを指定する
それぞれXNUMX秒、XNUMX分、XNUMX時間です。

この 整列する 引数は、 インターバル 上で説明した引数
　 -t オプションを選択します。

必要に応じて時間を進めることで位置合わせが行われることに注意してください。 -A として機能します
時間ウィンドウの開始 (次のセクションを参照) と
原点時間 ( -O オプションが指定されています）。

タイム 窓 仕様

多くの PCP ツールは、対象となる時間枠で動作するように設計されています。たとえば、
リアルタイム監視の終了時刻、または PCP 内の開始時刻と終了時刻を定義します。
アーカイブログ。

の不在で -O と -A 初期サンプル時間の原点と時間を指定するオプション
アラインメント (上記を参照) を行うと、PCP アプリケーションは開始時に最初のサンプルを取得します。
時間枠。

次のオプションを使用して、対象の時間枠を指定できます。

-S 始まる時間
デフォルトでは、時間枠はリアルタイム モードですぐに開始されるか、それと同時に開始されます。
アーカイブ モードでの PCP アーカイブ ログの開始時の時刻。 の -S オプションはかもしれません
時間枠の開始時刻を後で指定するために使用されます。

この 始まる時間 パラメータは XNUMX つの形式 (インターバル と同じです。
-t 上で説明したオプション、 日付時刻 以下で説明します):

インターバル
現在の時間からのオフセットを指定するには (リアルタイム モードの場合)、または
PCP アーカイブの開始 (アーカイブ モード)、単純に間隔を指定します。
引数として時間を指定します。 例えば -S 30min 時間の開始を設定します
ウィンドウはリアルタイム モードでは今からちょうど 30 分、またはちょうど 30 分になります。
PCP アーカイブの開始から数分。

-インターバル
PCP アーカイブ ログの末尾からのオフセットを指定するには、接頭辞として インターバル
引数にはマイナス記号を付けます。 この場合、時間枠の開始は
アーカイブの終了時刻よりも指定された間隔だけ先行します。 例えば
-S -1時間 時間枠の開始をちょうど XNUMX 時間に設定します
PCP アーカイブ ログの最後のサンプルの時刻より前。

@日付時刻
カレンダーの日付と時刻 (レポートのタイムゾーンの現地時間) を指定するには
時間枠の開始には、先頭に at を付けた datetime 構文を使用します。
サイン。 詳細については、以下の日時の説明を参照してください。

-T 終了時間
デフォルトでは、時間枠の終わりは無制限 (リアルタイム モードの場合) または整列しています。
PCP アーカイブ ログの末尾の時刻 (アーカイブ モード)。 の -T オプションはかもしれません
時間枠の終了時刻を早めに指定するために使用されます。

この 終了時間 パラメータは XNUMX つの形式 (インターバル と同じです。
-t 上で説明したオプション、 日付時刻 以下で説明します):

インターバル
時間ウィンドウの開始からのオフセットを指定するには、単に次のコマンドを使用します。
引数として時間間隔を指定します。 例えば -T 2h30m の終わりを設定します
時間枠は開始時刻から 2 時間 30 分後となります
窓。

-インターバル
PCP アーカイブ ログの末尾の時刻から遡ったオフセットを指定するには、次のようにします。
接頭辞を付けます インターバル 引数にはマイナス記号を付けます。 例えば -T -90m 意志
時間枠の終了を最後の時間の 90 分前に設定します。
PCP アーカイブ ログ内のサンプル。

@日付時刻
カレンダーの日付と時刻 (レポートのタイムゾーンの現地時間) を指定するには
時間枠の終わりには、at を前に付けた datetime 構文を使用します。
サイン。 詳細については、以下の日時の説明を参照してください。

-O 起源
デフォルトでは、サンプルは時間ウィンドウの先頭からフェッチされます (説明を参照)
of -S オプション) から時間枠の終わりまで (の説明を参照) -T オプション）。 The -O
オプションを使用すると、時間ウィンドウ内の原点を指定して次のように使用できます。
初期サンプル時間。 これは、PCP ツールを対話的に使用する場合に便利です。
午後(1) VCR 再生機能。

この 起源 によって受け入れられた議論 -O と同じ構文とセマンティクスに準拠します。
始まる時間 の引数 -T オプションを選択します。

例えば、 -O -0 初期位置が末尾であることを指定します。
時間枠。 これは、コンテンツ内で「逆方向」に再生したい場合に最も便利です。
時間枠。

この 日付時刻 の引数 -O, -S と -T オプションは次のもので構成されます。
date 時間 ゾーン 中 相対
日付は、YY-MM-DD、MM/DD/YY、DD Month YYYY、または Month DD YYYY のいずれかです。 時間は
HH:MM:SS、HH:MM のいずれか。 HH:MM は、12 時間 (午前または午後の接尾辞を使用) または 24 時間を使用できます。
時間の約束事。 曜日には、オプションで曜日を詳しく記述することができます。
第 XNUMX 火曜日のように、前に序数が付きます。 ゾーンは次のようなタイムゾーン値です。
によって指定された tzselect(1) 指示。 相対時間は、次のような時間単位になります。
1 年や 2 か月などの基数の前に、時刻の XNUMX つが付きます。
これまたは最後の言葉、または直前までに成功した言葉。 相対時間も次のいずれかになります。
時間の言葉：昨日、今日、明日、今。 日時文字列の例は次のとおりです。
1996-03-04 13:07:47 東アフリカ 月, 1996-03-05 14:07:47 東アフリカ -1時間, 月 3月 4 13:07:47 1996, 3月
4 1996, 3月 4, 3月, 13:07:50 or 13:08.

下位フィールドが欠落している場合、時間、分、および時間にはデフォルト値の 0 が想定されます。
秒、1 は月の日、Jan は月を表します。 したがって、以下は同等です。
-S '@ 3月 1996 ' と -S '@ 3月 1 00:00:00 1996 '.

上位フィールドが欠落している場合は、年、月から順に埋められます。
現在時刻 (リアルタイム モード) または PCP の開始時刻からの日
アーカイブ ログ (アーカイブ モード)、フィールドに一致するまで時間を進めます。
指定された。 たとえば、タイム ウィンドウがデフォルトで「Mon Mar 4 13:07:47」に開始されるとします。
1996年」、当時 -S @ 13：10 これは 13 年 10 月 00 日月曜日の 4:1996:XNUMX に相当します。 -S @ 10：00
これは、10 年 00 月 00 日火曜日の 5:1996:XNUMX に相当します (これは翌日であることに注意してください)。

より高い精度を実現するには 日付時刻(3)、秒コンポーネントは
浮動小数点数。

パフォーマンスとは メトリクス - 名前 そして 識別子

ほとんどのプラットフォームで PCP によってサポートされるパフォーマンス メトリック名の数は、多数の範囲に及びます。
数百から数千まで。 PCP ライブラリとアプリケーションは内部
単一の整数を既知のそれぞれに明確に関連付ける識別スキーム
パフォーマンス指標。 この整数は、パフォーマンス メトリック識別子 (PMID) として知られています。
要件ではありませんが、PMID はすべてのシステムにわたってグローバルな一貫性を持つ傾向があるため、
通常、特定のパフォーマンス メトリックは同じ PMID を持ちます。

すべてのユーザーとほとんどのアプリケーションにとって、PMID を直接使用することは不適切です (例:
これにより、アクセス可能なメトリクスの範囲が制限され、コードの保守が困難になり、強制的に
ユーザーインターフェイスは特にバロック風にするなど）。 したがって、パフォーマンスメトリクス名は
スペース (PMNS) は、外部名と階層分類を提供するために使用されます。
パフォーマンス指標。 PMNS はツリーとして表され、各ノードにはラベル、
PMID (リーフ ノードの場合) または PMNS 内の一連の子孫ノード (リーフ ノードの場合) へのポインタ
非リーフノード)。

ノード ラベルはアルファベットで始まり、その後に XNUMX 個以上の文字が続く必要があります
アルファベット、数字、文字「_」（アンダースコア）から抽出されます。 アルファベットの場合
ノードラベル内の文字は大文字と小文字が区別されます。

慣例により、パフォーマンス メトリックの名前は、
ルート ノードからリーフ ノードまで PMNS を経由するパス上のノード ラベル。「.」が付きます。
区切り文字。 PMNS のルート ノードにはラベルが付けられていないため、すべての名前はラベルで始まります。
PMNS のルート ノードの下の子孫ノードの XNUMX つに関連付けられます。例:
kernel.percpu.syscall。 通常 (これは要件ではありませんが)、次の場所にあります。
PMNS 内の PMID ごとにほとんどの名前が XNUMX つあります。 例えば カーネル.all.cpu.idle と ディスク.dev.read
は XNUMX つの異なるパフォーマンス メトリックの一意の名前であり、それぞれに一意の PMID が付いています。

関連する PMID のグループは、PMNS ツリー内の非リーフ ノードに名前を付けることによって名前を付けることができます。
ディスク.

で使用されるデフォルトのローカル PMNS pmcd に位置しています $PCP_VAR_DIR/pmns/root しかしながら
環境変数 PMNS_DEFAULT 別の PMNS のフルパス名に設定される場合があります
これはデフォルトのローカル PMNS として使用されます。

ほとんどのアプリケーションはローカル PMNS を直接使用せず、PMNS の一部をインポートします。
必要に応じて、パフォーマンス メトリックがフェッチされるのと同じ場所から、つまり pmcd(1)
ライブモニタリングの場合はPCPアーカイブから、遡及モニタリングの場合はPCPアーカイブから。

PMNS を調べるには、以下を使用します。 午後情報(1)、または PCP GUI パッケージがインストールされている場合は、新しいチャート
およびメトリック検索ウィンドウ内の 午後のチャートとします。

パフォーマンスとは メトリック 規格

構成ファイルおよび (程度は低いですが) コマンド ライン オプションでは、メトリック
仕様は次の構文規則に従っています。

パフォーマンス メトリクスのソースがリアルタイムである場合、 pmcd(1) この場合、受け入れられる構文は次のとおりです。
host:メトリック[インスタンス1,インスタンス2,...]

パフォーマンス メトリックのソースが PCP アーカイブ ログである場合、受け入れられる構文は次のとおりです。
アーカイブ/メトリック[インスタンス1,インスタンス2,...]

この host:, アーカイブ/ と [インスタンス1,インスタンス2,...] コンポーネントはすべてオプションです。

この , インスタンス名のリスト内の区切り文字は空白に置き換えることができます。

の特殊文字 名前を二重で囲むことで名前をエスケープすることができます
引用符で囲むか、文字の前にバックスラッシュを付けます。

引用符内を除いて空白は無視されます。 名前。

空っぽ は黙って無視され、特に「」[]「」は「いいえ」と同じです。
、一方で「」[XNUMX、、XNUMX]'' は XNUMX つのインスタンスのみを指定するものとして解析されます。XNUMXつ'' と
``2''。

特殊な場合として、次の場合は、 host 単一文字「@」の場合、これは
PM_CONTEXT_LOCAL ソース、参照 pmNewContextとします。

安全 PMCD CONNECTIONS

PCP バージョン 3.6.11 以降、モニターは、ネットワークへの安全な接続を明示的に要求できます。
コレクターホストが実行中 pmcd（1）または pmproxy(1) PM_CTXFLAG_SECURE コンテキスト フラグを使用します。 もし
PCP コレクター ホストはこの機能をサポートしています。詳細については、pmcd.feature.secure メトリックを参照してください。
これの確認 - TLS/SSL (トランスポート層セキュリティまたはセキュアソケット層)
公開キー暗号化および関連技術を使用して接続を確立できます。
これらの機能は、悪意のある第三者による盗聴やデータ改ざんを防ぐことを目的としています。
サーバー側の認証 (信頼できる本人確認) を提供するだけでなく、
クライアントによるサーバー）を使用して、中間者攻撃を防ぐことができます。

安全な pmcd 接続には証明書ベースの認証を使用する必要があります。 セキュリティ
が提供する機能 pmcd と pmproxy ネットワーク セキュリティ サービスを使用して実装されます
(NSS) API とユーティリティ。 NSS certutilを ツールを使用して証明書を作成できます
PCP モニターとコレクター ホスト間の信頼を確立するのに適しています。

完全な説明はこのドキュメントの範囲を超えています。を参照してください。 CFP ENVIRONMENT,
ファイル と 関連項目 ALSO 詳細については、セクションを参照してください。 これには、次のチュートリアルへのリンクが含まれます。
利用可能なセキュリティ機能のセットアップに必要な手順。

PMCD 主催者 仕様

明示的なホスト名の指定がない場合、ほとんどのツールはデフォルトで
ライブアップデートモードのローカルホスト。 3.8.4 以降の PCP リリースでは、これにより、
効率的なローカル プロトコルが選択されています (通常は Unix ドメイン ソケット)。 このオプションの場合
が使用されます (これは、 UNIX： ホスト仕様の説明
以下)、すべての接続が自動的に認証されることに注意することが重要です。
つまり、クライアント ツールを呼び出すユーザーの資格情報は自動的に設定されます。
に利用可能になりました pmcd(1) およびそのすべての PMDA は、ユーザーに代わって、結果が
個々のユーザーの権限レベルに合わせてカスタマイズできます。

を実行しているリモート ホストの名前 pmcd(1) もちろん、リクエストにデーモンを提供することもできます
リモートホストが使用されます。 最も基本的な形式は、 pmcd ホスト指定は単純なホストです
必要に応じてドメイン名を含む名前。 ただし、これは次のように拡張できます。
接続の属性をさらに絞り込むためのさまざまな方法 pmcd.

この pmcd ポート番号とオプション pmproxy(1) ホスト名とそのポート番号は、
PCP バージョン 3.0 以降、ホスト仕様の一部として指定されています。 これらは置き換えられます (そして
古いスタイルの PMCD_PORT、PMPROXY_HOST、および PMPROXY_PORT 環境変数をオーバーライドします。

以下は、への接続を指定する有効なホスト名の仕様です。 pmcd ホスト上で
nas1.servers.com ポートのリストあり/なし、 pmproxy(1)接続
ファイアウォールを経由し、示されているように IPv6 および IPv4 アドレスを使用します。

$ pcp -h nas1.servers.com:44321、[メール保護]：44322
$ pcp -h nas1.servers.com:[メール保護]：44322
$ pcp -h nas1.servers.com:[メール保護]
$ pcp -h [メール保護]
$ pcp -h nas1.servers.com:44321
$ pcp -h [fe80::2ad2:44ff:fe88:e4f1%p2p1]
$ pcp -h 192.168.0.103

また、「接続属性」も指定できます。 これらにはユーザー名、
パスワード (対話的に指定でき、認証メカニズムに応じて異なる場合があります)
採用）、特定の実行中のコンテナをターゲットにするかどうか、安全なコンテナを使用するかどうか
(暗号化された) プロトコルまたはネイティブ (裸の) プロトコルなど。 前の例はすべてデフォルトで
ネイティブ プロトコルであり、認証は使用しません。 これは次のように変更できます。
例。

$ pcp -h pcps://app2.servers.com?container=cae8e6edc0d5
$ pcp -h pcps://nas1.servers.com:44321?username=tanya&method=gssapi
$ pcp -h pcps://[メール保護]?メソッド=プレーン
$ pcp -h pcp://nas3.servers.com
$ pcp -h 192.168.0.103?container=cae8e6edc0d5,method=digest-md5
$ pcp -h unix:
$ pcp -h ローカル:

認証方法の選択、およびユーザー名などのその他の結果パラメータ
オプションでパスワードなどは、それぞれ (リモート) で使用される SASL2 構成によって異なります。 pmcd.
認証の構成のさまざまな側面を指定するチュートリアルが利用可能です
使用されるモジュールの詳細については、このドキュメントの範囲外です。

あらゆる状況において、ホスト名は IPv4 または IPv6 アドレッシングと同じ意味で使用できます。
上に示すように (直接)。 IPv6 アドレスの場合、完全なアドレスは次のようになります。
角括弧で囲み、スコープ (インターフェイス) も指定する必要があります。

最終 地元： 上記の例は、現在、ほとんどのツールのデフォルトになっています。 この接続は、
Unix をサポートするすべてのプラットフォーム上で自動的に認証されるローカル ホスト接続
ドメインソケット。 パスワードは不要で、認証は自動で行われます。 これもまた
利用可能な最も効率的な (最も低いオーバーヘッド) 通信チャネル。

違い UNIX： と 地元： 前者は厳密な Unix ドメインソケットであるということです
仕様 (その方法で接続できない場合は接続が失敗します) に対して、後者には
より寛容なフォールバックを使用する ローカルホスト (つまり、通常の Inet ソケット接続が使用されます)
Unix ドメイン ソケット接続が利用できない場合)。

ENVIRONMENT

「」で説明されている PCP ランタイム環境と構成変数に加えて、
CFP ENVIRONMENT 以下のセクションでは、次の環境変数がすべてに適用されます。
インストール。

PCP_CONSOLE
設定すると、デフォルトのコンソールが次のように変更されます。 / dev / tty (Unix の場合) または CON： （に
Windows) を指定されたコンソールにします。 の特別な値 なし に使用することができます
使用できるコンソールがないことを示します。 これはコンソールの場所で使用されます。
ベースのツールはユーザーと対話する必要があり、特に次のような場合に使用されます。
認証が行われています。

PCP_DEBUG
この変数を設定すると、使用する値を初期化する代替方法が提供されます。
診断およびデバッグ出力を制御します (これを抑制するには、デフォルト値は 0 です)
出力）。 の値 $PCP_DEBUG XNUMX 進整数である必要があります。を参照してください。 pmdbg（1）
サポートされる値の説明。

PCP_DERIVED_CONFIG
この変数を設定すると、ファイルやディレクトリのコロンで区切られたリストが定義されます。
(構文は $ PATH の変数 sh(1))。 コンポーネントは次のとおりです。
次のようにファイルのリストに展開されます。 $PCP_DERIVED_CONFIG is
ファイルの場合、そのファイルはリストに追加されます。コンポーネントがディレクトリの場合は、リストに追加されます。
次に、再帰降下を使用して、そのディレクトリの下にあるすべてのファイルを列挙します。
これらはリストに追加されます。

結果のリスト内の各ファイルには、派生したファイルの定義が含まれていると想定されます。
で説明されている構文によるメトリクス pmLoadDerivedConfig(3)、これらはロードされます
順番に。

派生メトリクスは、利用可能なメトリクスを新しい (派生) メトリクスで拡張するために使用できます。
単純な算術式を使用したメトリクス。

If PCP_DERIVED_CONFIG が設定されると、派生メトリック定義が処理されます
パフォーマンス メトリックの新しいソースが確立されるたびに自動的に実行されます (つまり、
時間 pmNewContext(3) が呼び出される場合)、または PMNS に対してリクエストが行われた場合。

内の任意のコンポーネント $PCP_DERIVED_CONFIG ファイルのリストまたは拡張されたリスト
ファイルではないか、ディレクトリではないか、またはアクセスできません（権限または不正なため）
シンボリック リンク) は黙​​って無視されます。

PCP_SECURE_SOCKETS
この変数を設定すると、すべてのモニター ツール接続が次の方法で強制的に確立されます。
証明書ベースのセキュアソケット機能。 接続できない場合
安全に確立されても失敗します。

PCP_SECURE_DB_METHOD
安全なソケット接続では、証明書と鍵データベースは次の方法で保存されます。
　 sql： デフォルトではメソッド。 使用 PCP_SECURE_DB_METHOD デフォルトをオーバーライドするには、ほとんどの場合
通常、値を空の文字列に設定します (古いデータベース メソッドの場合)。

PCP_STDERR
多くの PCP ツールは環境変数をサポートしています PCP_STDERRに使用できます
エラーメッセージの送信先を制御します。 設定されていない場合、デフォルトの動作は次のようになります。
「使用法」メッセージとオプション解析エラーは標準エラーで報告されます。
初回起動後のメッセージはツールのデフォルトの宛先に送信されます。
つまり、ASCII ツールの場合は標準エラー、GUI ツールの場合はダイアログです。

If PCP_STDERR リテラル値に設定されます DISPLAY すべてのメッセージは次のようになります
ダイアログに表示されます。 これは、デスクトップから起動されるツールに使用されます。
環境。

If PCP_STDERR 他の値に設定されている場合、その値はファイル名とみなされます。
すべてのメッセージがそこに書き込まれます。

PMCD_CONNECT_TIMEOUT
リモートに接続しようとすると pmcd(1) 起動中のマシン上で、
接続試行は、リモート マシンが接続されるまで長時間ブロックされる可能性があります。
初期化を終了します。 ほとんどの PCP アプリケーションと一部の PCP ライブラリ
接続が確立されていない場合、ルーチンは中止され、エラーが返されます。
指定された間隔が経過した後。 デフォルトの間隔は 5 秒です。
これは設定によって変更される可能性があります PMCD_CONNECT_TIMEOUT 環境の中で実際に
希望するタイムアウトの秒数。 これは、次のような場合に最も役立ちます。
リモート ホストは低速ネットワークの終端にあるため、より長い待ち時間が必要です
接続を正しく確立してください。

PMCD_RECONNECT_TIMEOUT
モニターまたはクライアント アプリケーションがネットワークへの接続を失った場合 pmcd（1）、
接続は、PCP ライブラリ内のサービス ルーチンを呼び出すことによって再確立できます。
ただし、再接続の試行は、回避するためにバックオフ戦略によって制御されます。
ネットワークに再接続要求が溢れます。 デフォルトでは、バックオフは遅延します。
からの連続した再接続要求の場合、5、10、20、40、80 秒です。
クライアント (XNUMX 回目以降の試行では、最後の遅延が繰り返されます)。
環境変数の設定 PMCD_RECONNECT_TIMEOUT カンマ区切りリストに
正の整数を指定すると、バックオフ遅延が再定義されます。たとえば、
PMCD_RECONNECT_TIMEOUT 「1,2」にすると 1 秒間バックオフしてから、別の値を試みます。
その後は 2 秒ごとに接続リクエストが行われます。

PMCD_REQUEST_TIMEOUT
に接続されているモニターまたはクライアント アプリケーションの場合 pmcd(1)の可能性があります
アプリケーションがパフォーマンス メトリクス、メタデータ、またはヘルプのリクエストで「ハング」している
文章。 システムが実行されている場合、これらの遅延は深刻になる可能性があります。 pmcd クラッシュ、または
ネットワーク接続が失われます。 環境変数を設定することで
PMCD_REQUEST_TIMEOUT 秒数までのリクエスト pmcd 後にタイムアウトします
この秒数。 デフォルトの動作では、10 秒間待機します。
すべての人からの応答のために pmcd すべてのアプリケーション用。

PMCD_WAIT_TIMEOUT
日時 pmcd(1)はから始まります $PCP_RC_DIR/pcp 次に、のプライマリインスタンス
午後ロガー(1) 設定フラグが有効な場合に開始されます。 午後ロガー is chkconfig(8)
有効化され、 pmcd 実行中であり、接続を受け入れています。

チェックオン pmcdの準備が整うまで待ちます PMCD_WAIT_TIMEOUT 秒。 もしも pmcd
起動時間が長い (非常に大規模なシステムなど)、 PMCD_WAIT_TIMEOUT
デフォルトの 60 秒よりも長い最大待機時間を設定できます。

PMNS_DEFAULT
設定されている場合、デフォルトのローカル PMNS として使用される完全パス名として解釈されます。
for pmLoadNameSpace(3)。 それ以外の場合、デフォルトのローカル PMNS は次の場所にあります。
$PCP_VAR_DIR/pcp/pmns/root 基本 PCP インストール用。

PCP_COUNTER_WRAP
PCP エージェントからエクスポートされたパフォーマンス メトリックの多くは、次のセマンティクスを持っています。
カウンタ つまり、単調増加すると予想されます。 いくつかの下で
状況によっては、これらのメトリクスの XNUMX つの値が、以前に取得した値よりも小さくなる場合があります。
価値。 これは、有限精度のカウンタがオーバーフローした場合、または
PCP エージェントがリセットまたは再起動されたとき、または PCP エージェントが値をエクスポートしているとき
何らかの非同期の影響を受けるいくつかの基礎となる計測から
不連続。

環境変数 PCP_COUNTER_WRAP そのようなすべてを示すように設定できます。
「カウンター」が減少する場合は、カウンターのオーバーフローとして扱う必要があります。
したがって、値は次の間隔で XNUMX 回折り返されたとみなされます。
連続サンプル。 この「ラッピング」動作は、以前の PCP のデフォルトでした。
ただし、バージョン 1.3 以降の PCP リリースではデフォルトで無効になっています。

PMDA_PATH
この PMDA_PATH 環境変数は、によって使用される検索パスを変更するために使用できます。
pmcd（1）と pmNewContext(3) (のための PM_CONTEXT_LOCAL コンテキスト) を検索するとき
デーモンまたは DSO PMDA。 構文は次のとおりです パス in sh(1)、つまりコロン
ディレクトリの区切りリスト。デフォルトの検索パスは次のとおりです。
「/var/pcp/lib:/usr/pcp/lib」 (または Linux では「/var/lib/pcp/lib」 (環境に応じて)
$PCP_VAR_DIR 環境変数の値)。

PMCD_PORT
によって使用される TPC/IP ポート pmcd(1) 受信接続用のソケットを作成します。
およびリクエストは、歴史的には 4321 であり、最近では正式に登録されました
ポート44321; 現在のリリースでは、 両言語で ポート番号はデフォルトで使用されます。
過渡的な取り決め。 これは設定によって上書きされる可能性があります PMCD_PORT へ
別のポート番号、またはポート番号のカンマ区切りのリスト。 デフォルトでない場合
ポートは次の場合に使用されます pmcd が開始され、次に接続するすべての監視アプリケーション
それ pmcd も持っている必要があります PMCD_PORT を試みる前に環境に設定してください
接続。

次の環境変数は、次のようなインストールに関連します。 午後ロガー（1）
PCP アーカイブ ロガーが使用されます。

PMLOGGER_PORT
環境変数 PMLOGGER_PORT ベース TCP/IP ポートを変更するために使用される場合があります
が使用する番号 午後ロガー(1) 接続先のソケットを作成します。 pmlc(1) インスタンスが試行します
そして接続します。 デフォルトのベース ポート番号は 4330 です。使用すると、 PMLOGGER_PORT
前に環境に設定する必要があります 午後ロガー 実行されます。

PMLOGGER_REQUEST_TIMEOUT
日時 pmlc(1) に接続します 午後ロガー(1)、可能性はわずかにありますが、 pmlc
ネットワーク障害の結果、情報要求が「ハングアップ」すること
or 午後ロガー。 環境変数を設定することで PMLOGGER_REQUEST_TIMEOUT へ
秒数、リクエスト 午後ロガー この秒数が経過するとタイムアウトになります。
デフォルトの動作では、各ユーザーからの応答を永遠に待ちます。
にリクエスト 午後ロガー。 使用すると、 PMLOGGER_REQUEST_TIMEOUT に設定する必要があります
以前の環境 pmlc 実行されます。

PCP 製品がインストールされている場合、次の環境変数は次のとおりです。
パフォーマンス メトリック ドメイン エージェント (PMDA) に関連します。

PMDA_LOCAL_PROC
この変数の使用は非推奨となり、現在は無視されています。 「手続き」PMDA の場合
で使用するために DSO として構成されています pmcd(1) ローカルホスト上のすべての
「proc」メトリクスは、 PM_CONTEXT_LOCAL
コンテキスト。

以前の動作では、この変数が設定されている場合、コンテキスト
と設立されました type of PM_CONTEXT_LOCAL 「proc」PMDA にアクセスできるようになります。
個々のプロセスに関するパフォーマンス メトリックを取得します。

PMDA_LOCAL_SAMPLE
この変数の使用は非推奨となり、現在は無視されています。 「サンプル」なら
PMDA は、DSO として構成されており、 pmcd(1) ローカルホスト上のすべての
「サンプル」メトリクスは、 PM_CONTEXT_LOCAL
コンテキスト。

以前の動作では、この変数が設定されている場合、コンテキスト
と設立されました type of PM_CONTEXT_LOCAL 「サンプル」にアクセスできるようになります
PMDA (このオプションの PMDA がローカルにインストールされている場合)。

PMIECONF_PATH
設定されている場合、 pmieconf(1) を形成します pmieconf(5) 仕様（パラメータ化されたセット
ピーミー(1) ルール) 有効なものをすべて使用 pmieconf このファイルの各サブディレクトリの下にあります
コロンで区切られたサブディレクトリのリスト。 設定されていない場合、デフォルトは次のとおりです。
$PCP_VAR_DIR/config/pmieconf.

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