^pButtons を使用したパフォーマンスの監視
この章では、^pButtons ユーティリティについて説明します。このユーティリティは、Caché インスタンスおよびインスタンスが稼働するプラットフォームに関する詳細なパフォーマンス・データを収集するためのツールです。このユーティリティで生成されたレポートをインターシステムズのサポート窓口Opens in a new tabに送信して、システムの問題の診断に役立てることができます。^pButtons は診断レポート (このドキュメントの “Caché 診断レポート” を参照) に似ていますが、パフォーマンス・データに重点を置いています。^pButtons は、リリース 5.0 以降のすべてのバージョンの Caché で使用できます。
このユーティリティは、リリース間で更新されている可能性があります。ftp://ftp.intersys.com/pub/performance/Opens in a new tab からの pButtons_package.zip のダウンロードの詳細は、インターシステムズのサポート窓口Opens in a new tabまでお問い合わせください。
プロファイルは、ターミナルで実行 (この章の "^pButtons ユーティリティの実行" を参照) することも、管理ポータルのタスク・マネージャを使用してスケジュールで実行を管理 (この章の "タスク・マネージャを使用した ^pButtons ユーティリティのスケジュール" を参照) することもできます。また、このユーティリティに用意されている API を使用して、プロファイルの追加、変更、および削除ができます。
^pButtons レポートから選択したセクションを抽出して、そのセクションに含まれるデータに基づいたグラフを作成できる Python ベースのユーティリティに関する詳細は、InterSystems Developer Community に掲載されたインターシステムズのシニア・テクノロジ・アーキテクトによる記事 "Yape - Yet another pButtons extractorOpens in a new tab (and automatically create charts)" を参照してください (GitHub でダウンロードできます)。
この章では、以下の項目について説明します。
システム・パフォーマンスの評価のための ^pButtons レポートの生成および使用に関する詳細で実用的な考察については、InterSystems Developer Community に掲載されたインターシステムズのシニア・テクノロジ・アーキテクトによる記事 "InterSystems Data Platforms and performance – Part 1Opens in a new tab" および "InterSystems Data Platforms and performance – Part 2Opens in a new tab" を参照してください。
^pButtons ユーティリティの実行
^pButtons ユーティリティでは、実行する 1 つ以上のプロファイルを選択できます。(使用できるプロファイルは、ご使用の Caché リリースおよび実行したカスタマイズによって異なります。)このユーティリティは、選択されたプロファイルに基づいて一連のログ・ファイルを生成し、出力ディレクトリに格納します。既定の出力ディレクトリは、Caché インスタンスのマネージャ・ディレクトリ (install-dir\mgr) です。この章の "出力ディレクトリの変更" のセクションの説明に従って出力ディレクトリを指定することもできます。
デフォルトでは、^pButtons には以下のプロファイルが用意されています。
-
12hours — 10 秒おきにサンプリングを行う 12 時間の実行
-
24hours — 10 秒おきにサンプリングを行う 24 時間の実行
-
30mins — 1 秒おきにサンプリングを行う 30 分間の実行
-
4hours — 5 秒おきにサンプリングを行う 4 時間の実行
-
8hours — 10 秒おきにサンプリングを行う 8 時間の実行
-
test — 30 秒おきにサンプリングを行う 5 分間のテスト実行
^pButtons ユーティリティを実行するには、以下の手順に従います。
-
ターミナルで、以下のコマンドを入力します (大文字と小文字が区別されます)。このコマンドは、%SYS ネームスペースで実行する必要があります。
%SYS>do ^pButtons -
表示されたメイン・メニューで、実行するプロファイルの番号を入力するか、Enter キーを押して、メイン・メニューを終了します。
Current log directory: c:\intersystems\cache20111\mgr\ Windows Perfmon data will be left in raw format. Available profiles: 1 12hours - 12-hour run sampling every 10 seconds 2 24hours - 24-hour run sampling every 10 seconds 3 30mins - 30-minute run sampling every 1 second 4 4hours - 4-hour run sampling every 5 seconds 5 8hours - 8-hour run sampling every 10 seconds 6 test - 5-minute TEST run sampling every 30 seconds select profile number to run: -
実行するプロファイルを入力すると、収集中のデータに関する情報が表示されます。
select profile number to run: 1 Collection of this sample data will be available in 1920 seconds. The runid for this data is 20111007_1041_30mins.
生成されたログ・ファイルは出力ディレクトリに格納されます。これらのファイルは runid によって一意の名前が付けられて識別されます。名前の形式は YYYYMMDD_HHMM_profile_name.log です。YYYYMMDD_HHMM はユーティリティがデータの収集を開始した年月日および時刻、profile_name は選択したプロファイルの名前です。
ユーティリティによるデータ収集の完了後 (つまり、プロファイルで指定された期間の最後に)、読みやすいパフォーマンス・レポートを生成できます。詳細は、この章の "^pButtons パフォーマンス・レポートの生成" を参照してください。
^pButtons の中止
実行中のプロファイルを停止する場合には、$$Stop^pButtons(runid) コマンドによってデータの収集を中止し、必要に応じてそのプロファイルのすべての .log ファイルを削除できます。例えば、runid20111220_1327_12hours で識別されるレポートのデータ収集を中止して、これまでに書き込まれたすべての .log ファイルを削除するには、%SYS ネームスペースのターミナルで以下のコマンドを入力します。
do Stop^pButtons("20111220_1327_12hours")
ログ・ファイルを削除せずにジョブを停止するには、以下のコマンドを入力します。
do Stop^pButtons("20111220_1327_12hours",0)
このコマンドの詳細は、"プログラムによる ^pButtons の実行" サブセクションの $$Stop^pButtons("runid") を参照してください。
ジョブを停止し、ファイルを削除する権限が必要です。
プログラムによる ^pButtons の実行
以下のテーブルで説明するように、start 関数、collect 関数、preview 関数、および stop 関数のエントリ・ポイントをプログラム的に使用して、^pButtons ユーティリティを実行することができます。
同時に複数のプロファイルを実行することができます。
| コマンド | 説明 |
|---|---|
| $$run^pButtons("profile") |
指定した profile を起動します。成功した場合は runid を、失敗した場合は 0 を返します。 |
| $$literun^pButtons("profile") |
オペレーティング・システム・データを含まないことを除いて、$$run^pButtons("profile") と同じです。
Note:
このコマンドは、オペレーティング・システム・データが重複している可能性がある、複数の Caché インスタンスを実行するサーバを想定しています。 |
| $$Collect^pButtons("runid") |
指定した runid について、読みやすい HTML パフォーマンス・レポート・ファイルを生成します。成功した場合は 1 とレポートのファイル名を返し、失敗した場合は 0 に続けてキャレット (^) と失敗の理由を返します。 |
| $$Preview^pButtons("runid") |
指定した runid について、読みやすい HTML 中間 (未完了) パフォーマンス・レポート・ファイルを生成します。成功した場合は、1 を返します。失敗した場合は、0 に続けてキャレット (^) と失敗の理由を返します。 |
| $$Stop^pButtons("runid",[0]) |
^pButtons による指定した runid のデータ収集を停止 (中止) し、既定ではこのユーティリティによって生成された関連する .log ファイルを削除します。.log ファイルを削除せずにデータ収集を停止するには、runid の後に 0 パラメータを加えます。成功した場合は 1:2:3:4_1:2:3:4 を、失敗した場合は 0 に続けてキャレット (^) と失敗の理由を返します。
Note:
“成功”の返りステータスは、アンダースコアで区切られた OS 専用と Caché 専用の 2 つの部分で構成されています。それぞれの部分で、コロンで区切られた値によって以下が指定されます。
|
| $$waittime^pButtons("runid") | 指定した runid について、最終 HTML ファイルが完成するまでの時間を報告します。 runid が完了している場合は ready now を返し、完了していない場合は XX hours YY minutes ZZ seconds の形式の文字列を返します。 |
次の例では、^pButtons ユーティリティによって作成される runid が、プログラムによって取得され、完全なレポートまたは中間レポートが生成されたかどうかがテストされ、判定されます。プロファイルが完了していないため完全なレポートが作成されておらず (“0^not ready” が返される)、中間レポートが作成された (“1” が返される) ことがプログラムによって判定されます。この情報を基に、HTML ファイルが生成されていることがわかります。
%SYS>set runid=$$run^pButtons("30mins")
%SYS>set sc=$$Collect^pButtons(runid)
pButtons run 20111004_1238_30mins is not yet ready for collection.
%SYS>write sc
0^not ready
%SYS>set sc=$$Preview^pButtons(runid)
%SYS>write sc
1
%SYS>
^pButtons パフォーマンス・レポートの生成
^pButtons ユーティリティは、^pButtons ユーティリティにより生成されるログ・ファイルから、完全で読みやすい HTML パフォーマンス・レポートを自動的に生成します。また、Preview^pButtons エントリ・ポイントを使用して、^pButtons ユーティリティの実行時に選択したプロファイルによって収集されているデータを使用して、中間 (不完全な) レポートを生成することもできます。
生成されたレポート・ファイルは出力ディレクトリに格納されます。このディレクトリは、既定では、Caché インスタンスのマネージャ・ディレクトリ (install-dir\mgr) です。ファイルは名前で一意に識別されます。名前の形式は hostname_instance_runid.html です。hostname は Caché のインスタンスが実行されているシステムのホスト名、instance はパフォーマンス・データ収集の対象となったインスタンスの名前、runid は ^pButtons ユーティリティの実行時に生成された一意の識別子です。レポートが中間レポートの場合、ファイル名に _Pn が付加されます。P は暫定レポートであることを示し、n は暫定レポートの番号を示します。
タスク・マネージャを使用した ^pButtons ユーティリティのスケジュール
このセクションでは、システム管理ポータルでタスク・マネージャ (ホーム, タスクマネージャ を参照) を使用して、^pButtons の実行をスケジュールする例を示します。
この例では、必要なフィールドのみを説明しています。その他のフィールドは必要に応じて編集してください。
この例では、24 時間、パフォーマンス・データを収集する 24hours というプロファイルを毎週木曜日午前 9 時に実行するように ^pButtons ユーティリティをスケジュールするタスクを作成します。このタスクをスケジュールするには、"Caché システム管理ガイド" の “Caché の管理” の章にある "タスク・マネージャのスケジュール" で説明されている手順を使用します。
この例では、まず、^pButtons を実行するタスクを作成します。
-
管理ポータルの ホーム, タスクマネージャ ページから、[新規タスクスケジュール] オプションを選択して、[タスクスケジューラウィザード] を起動します。次に、指定されたフィールドに以下の情報を入力します。
-
[タスク名] — 「24HourRun」と入力します。
-
[説明] — 「Start 24-hour ^pButtons Run」と入力します。
-
[このタスクを実行するネームスペース] — ドロップダウン・リストから [%SYS] を選択します。
-
[タスクタイプ] — ドロップダウン・リストから [レガシータスク実行] を選択します。
[実行コード] テキスト・ボックスに以下のコードを入力します。
set ^zmgstat(+$h,1)=$$run^pButtons("24hours") -
[出力ファイル] — 空白のままにします。このタスクには出力がありません (^pButtons 出力ディレクトリのカスタマイズについての詳細は、"出力ディレクトリの変更" を参照)。
-
-
[次へ] をクリックします。次に、指定されたフィールドに以下の情報を入力します。
-
[頻度] — ドロップダウン・リストから [週次] を選択します。
[木曜日] チェック・ボックスにチェックを付けます。
-
[開始日] — テキスト・ボックスに開始日を入力します。
[この時刻に一度実行] をクリックし、テキスト・ボックスに「09:00:00」と入力します。
-
-
[完了] をクリックします。
この例では、2 分間、パフォーマンス・データを収集する 2mins というプロファイルを毎日午後 12 時に実行するように ^pButtons ユーティリティをスケジュールするタスクを作成します。このタスクをスケジュールするには、"Caché システム管理ガイド" の “Caché の管理” の章にある "タスク・マネージャのスケジュール" で説明されている手順を使用します。
この例では、まず、^pButtons を実行するタスクを作成します。
-
管理ポータルの ホーム, タスクマネージャ ページから、[新規タスクスケジュール] オプションを選択して、[タスクスケジューラウィザード] を起動します。次に、指定されたフィールドに以下の情報を入力します。
-
[タスク名] — 「2MinRun」と入力します。
-
[説明] — 「Start 2-minute ^pButtons Run」と入力します。
-
[このタスクを実行するネームスペース] — ドロップダウン・リストから [%SYS] を選択します。
-
[タスクタイプ] — ドロップダウン・リストから [レガシータスク実行] を選択します。
[実行コード] テキスト・ボックスに以下のコードを入力します。
set ^zmgstat(+$h,3)=$$run^pButtons("2mins") -
[出力ファイル] — 空白のままにします。このタスクには出力がありません (^pButtons 出力ディレクトリのカスタマイズについての詳細は、"出力ディレクトリの変更" を参照)。
-
-
[次へ] をクリックします。次に、指定されたフィールドに以下の情報を入力します。
-
[頻度] — ドロップダウン・リストから [日次] を選択します。
-
[開始日] — テキスト・ボックスに開始日を入力します。
[この時刻に一度実行] をクリックし、テキスト・ボックスに「12:00:00」と入力します。
-
-
[完了] をクリックします。
^pButtons ユーティリティのカスタマイズ
このセクションでは、API で実行できるタスクについて説明します。
出力ディレクトリの変更
ログ・ファイルおよび結果として得られる HTML レポート・ファイルの既定の出力ディレクトリは、^pButtons ユーティリティの実行対象である Caché インスタンスのマネージャ・ディレクトリ (install-dir\mgr) です。以下のテーブルで説明するコマンドを使用して、既定のディレクトリを変更することができます。
これらのコマンドは、HTML レポート・ファイルが生成済みであるかどうかにかかわらず、現在実行中のプロファイルには影響を与えません。つまり、現在実行中のプロファイルに関連付けられているファイルは、新しい出力ディレクトリに移動されません。
| コマンド | 説明 |
|---|---|
| do setlogdir^pButtons("directory") |
出力ディレクトリのパス名を directory に設定します。directory が存在しない場合は作成されます。
Note:
絶対パス名 (例 ： C:\pButtonReports) を指定しなかった場合、そのディレクトリは、マネージャ・ディレクトリの相対パスであると見なされます。 |
| do clrlogdir^pButtons() |
出力ディレクトリのパス名を既定のマネージャ・ディレクトリにリセットします。 |
バージョン情報の取得
現在の ^pButtons ユーティリティのバージョンを調べるには、以下のコマンドを使用します。
-
write $$version^pButtons()
-
set ver=$$version^pButtons()
プロファイルの操作
プロファイル定義を操作するには、以下のセクションで説明する API を使用します。
新規プロファイルの作成
以下の API コマンドを使用して、新しいプロファイルを作成できます。
set rc=$$addprofile^pButtons("profilename","description",interval,count)
profilename (必須) は一意の値でなければなりません。また、スペースや空白文字は使用できません。description (必須) は ^pButtons ユーティリティの実行時にメニューに表示されるため、わかりやすいものでなければなりません。interval (必須) は、各サンプルの実行周期 (1 ～ 300 秒) を秒単位で表したものです。count (必須) は、プロファイルの実行回数です。
1 秒の間隔は、プロファイルの期間が 1 時間以下の場合にのみ選択可能です。
例えば、サンプリングが 12 回行われるまで、10 秒ごとに (合計 120 秒、または 2 分間) サンプリングを実行するプロファイル 2minrun を作成するには、次のように入力します。
set rc=$$addprofile^pButtons("2minrun","A 2-minute run sampling every 10 seconds",10,12)
次回、^pButtons ユーティリティを実行したときには、プロファイルのリストに、以下のプロファイル名と説明が表示されます。
2minrun A 2-minute run sampling every 10 seconds
また、以下の API コマンドを使用して、わかりやすい名前と説明が指定された新規プロファイルをすばやく生成することができます。
set rc=$$genprofile^pButtons("duration"[,interval])
duration (interval * count) (必須) の形式は "hh:mm"、"hh:"、または "mm" でなければなりません。interval (オプション) は各サンプルの実行周期です。
duration の最大値は 24 時間 (86,400 秒) です。これよりも長い継続時間を指定すると、^pButtons により 24 時間に引き下げられます。duration の値は、時間を表すコロン (:) を含む場合に限り、二重引用符で囲む必要があります。
interval (指定されている場合) の最小値は 2 秒ですが、継続時間 (つまり、interval * count) が 1 時間よりも短い場合、interval の最小値は 1 秒になります。interval に無効な値が指定されている場合は、^pButtons により最低限必要な値まで引き上げられます。interval が指定されていない場合の既定値は 10 秒です。
例えば、5 分おきに 12 時間、サンプリングを行う 12hours というプロファイル (生成されたプロファイル名と説明を持つもの) を生成するには、以下のように入力します。
set rc=$$genprofile^pButtons("12:",300)
また、10 分おきに 90 分間サンプリングを実行する 90mins というプロファイルを生成するには、以下のように入力します。
set rc=$$genprofile^pButtons(90)
次回、^pButtons ユーティリティを実行したときには、プロファイルのリストに、以下のプロファイル名と説明が表示されます。
12hours A 12 hour run sampling every 300 seconds
90mins A 90 minute run sampling every 10 seconds
プロファイルの編集
次の API コマンドを使用して、既存のプロファイルを編集できます (ただし、事前定義された “test” プロファイルは例外です)。
set rc=$$editprofile^pButtons("profilename","description",[interval],[count])
profilename (必須) は一意の値でなければなりません。また、スペースや空白文字は使用できません。description (必須) は ^pButtons ユーティリティの実行時にメニューに表示されるため、わかりやすいものでなければなりません。interval (オプション) は、各サンプルの実行時間 (2 ～ 300 秒) です。count (オプション) は、プロファイルの実行回数です。
引数は位置によって決められます。例えば、count 引数を編集し、interval 引数で指定された値はそのままにしておくには、set rc=$$editprofile^pButtons("2minrun","A 5-minute run sampling every 30 seconds",,50) のようにコンマ区切り文字を使用する必要があります。
継続時間が 24 時間 (86,400 秒) を超える場合は、自動的に 24 時間に引き下げられます。
例えば、サンプリングが 10 回行われるまで、30 秒ごとに (合計 300 秒、または 5 分間) サンプリングを実行するように、プロファイル 2minrun を変更するには、次のように入力します。
set rc=$$editprofile^pButtons("2minrun","A 5-minute run sampling every 30 seconds",30,10)
次回、^pButtons ユーティリティを実行したときには、プロファイルのリストに、以下のプロファイル名と説明が表示されます。
2minrun A 5-minute run sampling every 30 seconds
プロファイルのコピー
既存のプロファイルを、異なる名前のファイルにコピーするには、以下の API コマンドを使用します。
set rc=$$copyprofile^pButtons("sourceprofilename","targetprofilename")
sourceprofilename (必須) は既存のプロファイル名です。targetprofilename (必須) は一意の値でなければなりません。また、スペースや空白文字は使用できません。
例えば、2minrun プロファイルのコピーを作成するには、以下のように入力します。
set rc=$$copyprofile^pButtons("2minrun","5minrun")
次回、^pButtons ユーティリティを実行したときには、プロファイルのリストに、以下のプロファイル名と説明が表示されます。
2minrun A 2-minute run sampling every 30 seconds
5minrun A 2-minute run sampling every 30 seconds
これで、ガイドのこのセクションにある "プロファイルの編集" で説明されているとおり、新規プロファイルを編集できます。
プロファイルの削除
次の API コマンドを使用して、既存のプロファイルを削除できます (ただし、事前定義された “test” プロファイルは例外です)。
set rc=$$delprofile^pButtons("profilename")
ここで、profilename (必須) には、削除するプロファイルの名前を二重引用符で囲んで指定する必要があります。
例えば、2minrun プロファイルを削除するには、以下のように入力します。
set rc=$$delprofile^pButtons("2minrun")
次回、^pButtons ユーティリティを実行したときには、プロファイルのリストに 2minrun プロファイルは含まれていません。
^pButtons ユーティリティで作成されるパフォーマンス・レポート
^pButtons ユーティリティは、この章の説明のとおり、プラットフォーム固有のレポートを生成します。このレポートは、以下のリストに示すとおり、複数のセクションに分かれています。
Configuration CACHE20161 on machine testsystem Customer: InterSystems Development License : 123456 Caché Version String: Cache for Windows (x86-32) 2016.1 (Build 656) Thu Mar 17 2016 17:51:22 EDT -------------------------------------------------------------- Profile Profile run "test" started at 10:07 on Jun 01 2016. Run over 10 intervals of 30 seconds. -------------------------------------------------------------- license Product=Enterprise License Type=Concurrent User Server=Multi Platform=Heterogeneous Licensed Users=1000 Licensed CPUs=16 . . . -------------------------------------------------------------- End of Caché Performance Data Report
このセクションのテーブルで、プラットフォーム固有の各レポートのセクションについて説明します。セクションは、具体的なセクションを簡単に検索できるように、各テーブルでアルファベット順にリストされています。1 回だけ収集されるデータには、アスタリスク (*) のフラグが立てられています。残りのデータは、プロファイルの実行中に収集されます。
プラットフォーム固有のデータの詳細は、以下のテーブルを参照してください。
以下の表すべてにおいて、 * の付いたデータは、実行ごとに 1 回収集されます。
| セクション | 説明 |
|---|---|
| %SS |
ALL^%SS コマンドを使用して実行中に取得される 4 つのサンプル。 |
| Configuration * |
Caché インスタンス名およびサーバのホスト名、Caché バージョンの完全な文字列、ライセンスが供与された顧客名、およびライセンス注文番号。 |
| cpf file * |
現在アクティブな構成ファイルのコピー。 |
| cstat -c |
コマンド .\bin\cstat -s -p-1 -c-1 -e1 -m8 -n2 -N127 を使用して、実行中に等間隔で取得される 4 つのサンプル。次に各引数について簡単に説明します。
cstat ユーティリティの詳細は、このドキュメントの付録 “cstat ユーティリティを使用した Caché の監視” を参照してください。 |
| cstat -D |
コマンド ccontrol stat cache --f1 -D10,100 を使用して、実行中に等間隔で取得される 8 つのサンプル。次に各引数について簡単に説明します。
cstat ユーティリティの詳細は、このドキュメントの付録 “cstat ユーティリティを使用した Caché の監視” を参照してください。^BLKCOL ユーティリティを使用したブロック衝突の監視の詳細は、このドキュメントの “^BLKCOL を使用したブロック衝突の監視” の章を参照してください。 |
| license * |
Decode^%LICENSE および counts^%LICENSE を使用した Caché ライセンス使用情報。 |
| mgstat |
^mgstat ユーティリティを使用して実行中に取得される Caché 固有のデータ。"Caché 監視ガイド" の "^mgstat を使用したパフォーマンスの監視" のセクションを参照してください。 |
| perfmon |
Microsoft Windows perfmon ユーティリティからの出力。 Microsoft Windows perfmon データは、既定では未処理の形式で表示されます。表示形式は切り替えて、繰り返し表示されるサーバ名を削除したり、日時の列を複数の列に分離するなど、見やすくなるように処理を加えることができます。 以下の関数では、perfmon データを操作するかどうか決定するフラグのクエリと更新が可能です。set rc=$$setperfmonpostproc^pButtons(<onoroff>) onoroff には、1 (オン) または 0 (オフ)、あるいは "on" または "off" (大文字小文字は区別されない) の単語を指定できます。 返りコードの 1 は、フラグの正常な更新を示し、0 は更新の失敗、-1 は非 Windows プラットフォームを示します。 現在の形式 (未処理または処理済み) を判断するには、以下のようにします。set status=$$getperfmonpostproc^pButtons() 返りコードの 1 は、処理済みの形式を示し、0 は未処理の形式を示します。 さらに、フラグの現在の状態は、^pButtons のインタラクティブ実行で、プロファイル・メニューを表示する前に表示されます。 既定で、perfmon は、既定の pbctrs.txt ファイルに指定されたカウンタの定義を監視します。前に定義された perfmon カウンタを監視するには、以下を使用して定義を ^pButtons にインポートします。 write $$importctrs^pButtons(WindowsCtrName [,pButtonsCtrName [,pButtonsFileName]]) 返りコードの 0 は成功を示し、負の数字とそれに続く理由の文字列は失敗を示します。pButtons カウンタ名の重複は許可されていません。必要に応じて、^pButtons は内部カウンタ名とファイル名の両方を生成します。 既定の pButtons カウンタの定義を既存の定義に変更するには、以下を使用します。write $$setctrdefault(pButtonsCtrName) 返りコードの 1 は成功を示し、0 とそれに続く理由の文字列は失敗を示します。無効なカウンタが指定された場合、組み込みの既定が設定されます。 既定の pButtons カウンタ定義をリセットするには、以下を使用します。do clrctrdefault^pButtons() 特定の pButtons カウンタ定義を既存のプロファイルに関連付けるには、以下を使用します。write $$addctrtoprofile(ProfileName,pButtonsCtrName) 返りコードの 1 は成功を示し、0 とそれに続く理由の文字列は失敗を示します。プロファイルかカウンタ定義のいずれかが存在しない場合、コマンドは実行されません。 |
| Profile * |
このログを作成した ^pButtons プロファイルに関する情報。 |
| tasklist * |
tasklisk -V コマンドから出力される、プロファイル実行開始時にシステムで実行されるすべてのプロセスのリスト。 |
| Windows info * |
Windows バージョン (ホットフィックス情報は除く) やハードウェアの情報を含む、systeminfo コマンドから出力される情報で、プロセッサの個数、インストールされているメモリ、使用されているメモリなどがあります。 |
| セクション | 説明 |
|---|---|
| %SS |
ALL^%SS コマンドを使用して実行中に取得される 4 つのサンプル。 |
| Configuration * |
Caché インスタンス名およびサーバのホスト名、Caché バージョンの完全な文字列、ライセンスが供与された顧客名、およびライセンス注文番号。 |
| cpf file * |
現在アクティブな構成ファイルのコピー。 |
| cstat -c |
コマンド ccontrol stat cache -p-1 -c-1 -e1 -m8 -n2 -N127 を使用して、実行中に等間隔で取得される 4 つのサンプル。次に各引数について簡単に説明します。
cstat ユーティリティの詳細は、このドキュメントの付録 “cstat ユーティリティを使用した Caché の監視” を参照してください。 |
| cstat -D |
コマンド ccontrol stat cache --f1 -D10,100 を使用して、実行中に等間隔で取得される 8 つのサンプル。次に各引数について簡単に説明します。
cstat ユーティリティの詳細は、このドキュメントの付録 “cstat ユーティリティを使用した Caché の監視” を参照してください。^BLKCOL ユーティリティを使用したブロック衝突の監視の詳細は、このドキュメントの “^BLKCOL を使用したブロック衝突の監視” の章を参照してください。 |
| ipcs * |
共有メモリ、セマフォ、およびメッセージ・キューを含むプロセス間の通信構成情報。ipcs -a コマンドから出力されます。 |
| license * |
Decode^%LICENSE および counts^%LICENSE を使用した Caché ライセンス使用情報。 |
| MacOS Info * |
OS バージョンおよびハードウェアに関する情報。sw_vers、uname -a、mount、netstat の各コマンドから出力されます。 |
| mgstat |
^mgstat ユーティリティを使用して実行中に取得される Caché 固有のデータ。"Caché 監視ガイド" の "^mgstat を使用したパフォーマンスの監視" のセクションを参照してください。 |
| Profile * |
このログを作成した ^pButtons プロファイルに関する情報。 |
| ps ： | コマンド ps -eflv を使用して、実行中に等間隔で取得される 4 つのサンプル。 |
| sar -d | ディスク (ブロック) デバイスのスループットおよび遅延の統計。 |
| sar -g | ページ・アウト率。 |
| sar -n DEV | ネットワーク・デバイスのスループット。 |
| sar -n EDEV | ネットワーク・デバイスのエラー率。 |
| sar -p | ページ・イン率およびページ・フォルト率。 |
| sar -u | CPU 使用量の統計。 |
| sysctl -a * | カーネルおよびシステム・パラメータの設定。 |
| vm_stat * | メモリ・ページ情報。 |
| セクション | 説明 |
|---|---|
| %SS |
ALL^%SS コマンドを使用して実行中に取得される 4 つのサンプル。 |
| Configuration * |
Caché インスタンス名およびサーバのホスト名、Caché バージョンの完全な文字列、ライセンスが供与された顧客名、およびライセンス注文番号。 |
| cpf file * |
現在アクティブな構成ファイルのコピー。 |
| cstat -c |
コマンド ccontrol stat cache -p-1 -c-1 -e1 -m8 -n2 -N127 を使用して、実行中に等間隔で取得される 4 つのサンプル。次に各引数について簡単に説明します。
cstat ユーティリティの詳細は、このドキュメントの付録 “cstat ユーティリティを使用した Caché の監視” を参照してください。 |
| cstat -D |
コマンド ccontrol stat cache --f1 -D10,100 を使用して、実行中に等間隔で取得される 8 つのサンプル。次に各引数について簡単に説明します。
cstat ユーティリティの詳細は、このドキュメントの付録 “cstat ユーティリティを使用した Caché の監視” を参照してください。^BLKCOL ユーティリティを使用したブロック衝突の監視の詳細は、このドキュメントの “^BLKCOL を使用したブロック衝突の監視” の章を参照してください。 |
| df -k * |
マウント・ポイント、論理ボリューム、および空き領域を含む、マウントされたファイル・システムに関する情報。df -k コマンドから出力されます。 |
| HP-UX info * |
OS バージョンおよびハードウェアに関する情報。uname -a、file /vmunix、vmstat -f、/usr/sbin/sysdef、/usr/sbin/kctune -g の各コマンドから出力されます。 |
| ipcs * |
共有メモリ、セマフォ、およびメッセージ・キューを含むプロセス間の通信構成情報。ipcs -a コマンドから出力されます。 |
| license * |
Decode^%LICENSE および counts^%LICENSE を使用した Caché ライセンス使用情報。 |
| mgstat |
^mgstat ユーティリティを使用して実行中に取得される Caché 固有のデータ。"Caché 監視ガイド" の "^mgstat を使用したパフォーマンスの監視" のセクションを参照してください。 |
| mount * |
すべてのファイル・システムおよびそのマウント・オプションに関する情報。 |
| ps ： | コマンド ps -efl を使用して、実行中に等間隔で取得される 4 つのサンプル。 |
| Profile * |
このログを作成した ^pButtons プロファイルに関する情報。 |
| sar -b |
バッファ・キャッシュの統計。 |
| sar -d |
ディスク (ブロック) デバイスのスループットおよび遅延の統計。 |
| sar -Mu |
CPU の統計 (-u) および CPU ごとの統計 (-M)。 |
| sar -w |
バッファ・キャッシュの統計。 |
| ServiceGuard * | /etc/cmcluster.conf の内容 (このファイルが存在する場合)。 |
| vmstat |
CPU およびメモリ使用量の統計。 |
| セクション | 説明 |
|---|---|
| %SS |
ALL^%SS コマンドを使用して実行中に取得される 4 つのサンプル。 |
| AIX info * |
oslevel、uname -a、prtconf、lspv の各コマンドから出力されます。 |
| Configuration * |
Caché インスタンス名およびサーバのホスト名、Caché バージョンの完全な文字列、ライセンスが供与された顧客名、およびライセンス注文番号。 |
| cpf file * |
現在アクティブな構成ファイルのコピー。 |
| cpu type * |
取り付けられているプロセッサの情報および SMT が有効かどうか。lsattr -El proc0 から出力されます。 |
| cstat -c |
コマンド ccontrol stat cache -p-1 -c-1 -e1 -m8 -n2 -N127 を使用して、実行中に等間隔で取得される 4 つのサンプル。次に各引数について簡単に説明します。
cstat ユーティリティの詳細は、このドキュメントの付録 “cstat ユーティリティを使用した Caché の監視” を参照してください。 |
| cstat -D |
コマンド ccontrol stat cache --f1 -D10,100 を使用して、実行中に等間隔で取得される 8 つのサンプル。次に各引数について簡単に説明します。
cstat ユーティリティの詳細は、このドキュメントの付録 “cstat ユーティリティを使用した Caché の監視” を参照してください。^BLKCOL ユーティリティを使用したブロック衝突の監視の詳細は、このドキュメントの “^BLKCOL を使用したブロック衝突の監視” の章を参照してください。 |
| df -k * |
マウント・ポイント、論理ボリューム、および空き領域を含む、マウントされたファイル・システムに関する情報。df -k コマンドから出力されます。 |
| filesystems * |
現在の /etc/filesystems ファイル。 |
| ioo -a * | I/O 調整可能パラメータの現在値。ioo -a コマンドから出力されます。
^pButtons プロファイルを起動するユーザに root アクセス権がある場合にのみ含まれます。 |
| iostat -DIT |
IBM AIX® 5.3 以降向けの、サンプル時間を含めた拡張ディスク/デバイスの統計の長いリスト。iostat -DIT コマンドから出力されます。 IBM AIX® 5.3 より前のリリースでは情報が異なります。 |
| ipcs * |
共有メモリ、セマフォ、およびメッセージ・キューを含むプロセス間の通信構成情報。ipcs -a コマンドから出力されます。 |
| license * |
Decode^%LICENSE および counts^%LICENSE を使用した Caché ライセンス使用情報。 |
| mount * |
すべてのファイル・システムおよびそのマウント・オプションに関する情報。 |
| mgstat |
^mgstat ユーティリティを使用して実行中に取得される Caché 固有のデータ。"Caché 監視ガイド" の "^mgstat を使用したパフォーマンスの監視" のセクションを参照してください。 |
| Profile * |
このログを作成した ^pButtons プロファイルに関する情報。 |
| ps ： | コマンド ps aux を使用して、実行中に等間隔で取得される 4 つのサンプル。 |
| sar -d |
^pButtons プロファイルを起動するユーザに root アクセス権があり、/usr/sbin/sar が存在する場合にのみ含まれます。 |
| sar -r |
^pButtons プロファイルを起動するユーザに root アクセス権があり、/usr/sbin/sar が存在する場合にのみ含まれます。 |
| sar -u |
マイクロパーティショニング情報 (使用している場合) を含む CPU の統計。 ^pButtons プロファイルを起動するユーザに root アクセス権があり、/usr/sbin/sar が存在する場合にのみ含まれます。 |
| vmo –a |
仮想メモリ調整可能パラメータの現在値。vmo -a コマンドから出力されます。 ^pButtons プロファイルを起動するユーザに root アクセス権がある場合にのみ含まれます。 |
| vmstat -s * |
ページ・インとページ・アウトの合計を含む仮想メモリ統計の絶対数。 |
| vmstat -t |
タイムスタンプを含む、仮想メモリおよび CPU (ページング、キューイングおよび CPU) の統計。 |
| vmstat -v * |
空きページ、pbuf 使用量および fsbuf 使用量を含む仮想メモリ統計をサンプリングします。 |
| セクション | 説明 |
|---|---|
| %SS |
ALL^%SS コマンドを使用して実行中に取得される 4 つのサンプル。 |
| Configuration * |
Caché インスタンス名およびサーバのホスト名、Caché バージョンの完全な文字列、ライセンスが供与された顧客名、およびライセンス注文番号。 |
| cpf file * |
現在アクティブな構成ファイルのコピー。 |
| cstat -c |
コマンド ccontrol stat cache -p-1 -c-1 -e1 -m8 -n2 -N127 を使用して、実行中に等間隔で取得される 4 つのサンプル。次に各引数について簡単に説明します。
cstat ユーティリティの詳細は、このドキュメントの付録 “cstat ユーティリティを使用した Caché の監視” を参照してください。 |
| cstat -D |
コマンド ccontrol stat cache --f1 -D10,100 を使用して、実行中に等間隔で取得される 8 つのサンプル。次に各引数について簡単に説明します。
cstat ユーティリティの詳細は、このドキュメントの付録 “cstat ユーティリティを使用した Caché の監視” を参照してください。^BLKCOL ユーティリティを使用したブロック衝突の監視の詳細は、このドキュメントの “^BLKCOL を使用したブロック衝突の監視” の章を参照してください。 |
| df -k * |
マウント・ポイント、論理ボリューム、および空き領域を含む、マウントされたファイル・システムに関する情報。df -k コマンドから出力されます。 |
| license * |
Decode^%LICENSE および counts^%LICENSE を使用した Caché ライセンス使用情報。 |
| mgstat |
^mgstat ユーティリティを使用して実行中に取得される Caché 固有のデータ。"Caché 監視ガイド" の "^mgstat を使用したパフォーマンスの監視" のセクションを参照してください。 |
| Profile * |
このログを作成した ^pButtons プロファイルに関する情報。 |
| ps ： | コマンド ps -efl を使用して、実行中に等間隔で取得される 4 つのサンプル。 |
| sar -b |
バッファ・キャッシュ使用量および効率の統計。 |
| sar -d |
ディスク (ブロック) デバイスのスループットおよび遅延の統計。 |
| sar -r |
空きメモリ・レポート。 |
| sar -u |
CPU 使用量の統計には iowait パーセンテージが含まれます。 |
| vmstat |
CPU、キューおよびメモリ使用量の統計。 |
| セクション | 説明 |
|---|---|
| %SS |
ALL^%SS コマンドを使用して実行中に取得される 4 つのサンプル。 |
| Configuration * |
Caché インスタンス名およびサーバのホスト名、Caché バージョンの完全な文字列、ライセンスが供与された顧客名、およびライセンス注文番号。 |
| cpf file * |
現在アクティブな構成ファイルのコピー。 |
| cstat -c |
コマンド ccontrol stat cache -p-1 -c-1 -e1 -m8 -n2 -N127 を使用して、実行中に等間隔で取得される 4 つのサンプル。次に各引数について簡単に説明します。
cstat ユーティリティの詳細は、このドキュメントの付録 “cstat ユーティリティを使用した Caché の監視” を参照してください。 |
| cstat -D |
コマンド ccontrol stat cache --f1 -D10,100 を使用して、実行中に等間隔で取得される 8 つのサンプル。次に各引数について簡単に説明します。
cstat ユーティリティの詳細は、このドキュメントの付録 “cstat ユーティリティを使用した Caché の監視” を参照してください。^BLKCOL ユーティリティを使用したブロック衝突の監視の詳細は、このドキュメントの “^BLKCOL を使用したブロック衝突の監視” の章を参照してください。 |
| df -k * |
マウント・ポイント、論理ボリューム、および空き領域を含む、マウントされたファイル・システムに関する情報。df -k コマンドから出力されます。 |
| free -m |
MB 単位でのメモリ使用量の統計 (-m)。 |
| iostat |
CPU およびディスクのスループット。 |
| license * |
Decode^%LICENSE および counts^%LICENSE を使用した Caché ライセンス使用情報。 |
| mgstat |
^mgstat ユーティリティを使用して実行中に取得される Caché 固有のデータ。"Caché 監視ガイド" の "^mgstat を使用したパフォーマンスの監視" のセクションを参照してください。 |
| Profile * |
このログを作成した ^pButtons プロファイルに関する情報。 |
| ps ： | コマンド ps -efly を使用して、実行中に等間隔で取得される 4 つのサンプル。 |
| sar -d |
ディスク (ブロック) デバイスのスループットおよび遅延の統計。 |
| sar -u |
CPU 使用量の統計には iowait パーセンテージが含まれます。 |
| vmstat -n |
CPU、キューイング、ページングの統計。1 つのヘッダのみが印刷されます (-n)。 |
