A OCLUMONコマンドのリファレンス

コマンドライン・ツールを使用して、クラスタ状態モニターを問い合せ、特定の期間のノード固有のメトリックを表示します。

OCLUMONを使用して、デバッグ・レベルの変更、クラスタ状態モニターのバージョンの問合せ、メトリック・データベース・サイズの変更など、様々な管理タスクを実行できます。

A.1 oclumon analyze

oclumon analyzeコマンドを使用して、CHMメトリックを分析します。

構文

oclumon analyze [-h] [-i CHM_METRICS_DIR] -o OUT_DIR [-l LOG_DIR] [--log_level {DEBUG,INFO,WARNING,ERROR}] [-s START_TIME] [-e END_TIME] [-f FORMAT] [--version]

パラメータ

表A-1 oclumon analyzeコマンドのパラメータ

パラメータ 説明

-i CHM_METRICS_DIR

--chm_metrics_dir CHM_METRICS_DIR

CHMメトリックを含むディレクトリを指定します。

-o OUT_DIR

--out_dir OUT_DIR

結果の出力ディレクトリを指定します。

-l LOG_DIR

--log_dir LOG_DIR

ログ・ディレクトリを指定します。

--log_level {DEBUG,INFO,WARNING,ERROR}

ログ・レベルを指定します。

-s START_TIME

--start_time START_TIME

分析の開始時間をYYYY-MM-DDTHH:MM:SS形式で指定します。

-e END_TIME

--end_time END_TIME

分析の終了時間をYYYY-MM-DDTHH:MM:SS形式で指定します。

-f FORMAT

--format FORMAT

カンマ区切りのレポート形式(texthtml)を指定します。指定しない場合、デフォルトはtext形式になります。textまたはhtml、あるいはその両方が可能です

--version

プログラムのバージョン番号を表示して終了します。

例A-1 oclumon analyzeの例

CHMリポジトリ全体のテキスト分析レポートを生成するには:
oclumon analyze -o /<outpur-dir>
2024-03-14T05:00:00から2024-03-14T05:15:00までの期間のテキスト分析レポートを生成するには:
oclumon analyze -o /<output-dir> -s 2024-03-14T05:00:00 -e 2024-03-14T05:15:00
CHMリポジトリ全体のHTML分析レポートを生成するには:
oclumon analyze -o /<output-dir> -f html
アーカイブされたCHMデータセットから分析レポートを生成するには:
oclumon analyze -i /<chm-data-dir> -o /<output-dir>

例A-2 サンプルCHM分析レポート

CHM分析レポートには、次のセクションが含まれます。

  • ヘッダー・セクション: ノード、分析期間、システム構成およびシステム・リソース統計に関する情報が含まれます。

    図A-1 システム構成およびシステム・リソースの統計


    このイメージは、システム構成およびシステム・リソースの統計を示しています

  • 測定結果および結果のサマリー・タイムライン・セクション: 測定された問題のリストと、問題のサマリー・タイムラインが含まれます。

    図A-2 問題のある結果とサマリー・タイムライン


    このイメージは、問題のある結果とサマリー・タイムラインを示しています

  • 結果の詳細セクション: 上記で確認した各問題の詳細なコンテキスト情報が含まれます。

    図A-3 問題のある結果 - 詳細


    このイメージは、問題のある結果の詳細を示しています

A.2 oclumon dumpnodeview

oclumon dumpnodeviewコマンドを使用して、ノード・ビューの形式でシステム監視サービスからログ情報を表示します。

構文

oclumon dumpnodeview [[([(-system | -protocols | -v)] |
	 [(-cpu | -process | -procagg | -device | -nic | -filesystem | -thread | -nfs)
	 [-detail] [-all] [-pinned_only] [-sort <metric_name>] [-filter <string>] [-head <rows_count>] [-i <seconds>]])
	 [([-s <start_time>  -e <end_time>] | -last <duration>)]] |
	 [-inputDataDir <absolute_path> -logDir <absolute_path>]
	 [-h]]

パラメータ

表A-2 oclumon dumpnodeviewコマンドのパラメータ

パラメータ 説明

-system

システム・メトリックをダンプします。たとえば:
oclumon dumpnodeview -system
.

-cpu

CPUメトリックをダンプします。たとえば:
oclumon dumpnodeview -cpu
.

-process

プロセス・メトリックをダンプします。たとえば:
oclumon dumpnodeview -process
.

-procagg

プロセス集計メトリックをダンプします。たとえば:
oclumon dumpnodeview -procagg
.

-device

ディスク・メトリックをダンプします。たとえば:
oclumon dumpnodeview -device
.

-nic

ネットワーク・インタフェースのメトリックをダンプします。たとえば:
oclumon dumpnodeview -nic
.

-filesystem

ファイルシステム・メトリックをダンプします。たとえば:
oclumon dumpnodeview -filesystem
.

-thread

固定プロセスのスレッド・メトリックをダンプします。たとえば:
oclumon dumpnodeview -thread

-nfs

NFSメトリックをダンプします。たとえば:
oclumon dumpnodeview -nfs
.

-protocols

システム起動からの累積値であるネットワーク・プロトコル・メトリックをダンプします。たとえば:
oclumon dumpnodeview -protocols
.

-v

ノード・ビューの詳細出力を表示します。たとえば:
oclumon dumpnodeview -v
.

-h、--help

コマンドライン・ヘルプを表示して終了します。

表A-3 oclumon dumpnodeviewコマンドのフラグ

フラグ 説明

-detail

このオプションを使用して、詳細なメトリックをダンプします。-processおよび-nicオプションに適用できます。

たとえば:
oclumon dumpnodeview -process -detail
.

-all

このオプションを使用して、すべてのエントリのノード・ビューをダンプします。-processオプションに適用可能です。

たとえば:
oclumon dumpnodeview -process -all
.

-pinned_only

このオプションを使用して、すべての固定プロセスのノード・ビューをダンプします。-processオプションに適用可能です。

たとえば:
oclumon dumpnodeview -process -pinned_only

-head rows_count

このオプションを使用して、結果内の指定した数のメトリック行のノード・ビューをダンプします。-processオプションに適用可能です。デフォルトは5に設定されています。

たとえば:
oclumon dumpnodeview -process -head 7
.

-sort metric_name

このオプションを使用して、-process-device-nic-cpu-procagg-filesystem-nfsオプションでサポートされている、指定したメトリック名に基づいてソートします。

たとえば:
oclumon dumpnodeview -device -sort "ioR"
.

-i seconds

指定された間隔(秒)で区切られたデータを表示します。5の倍数である必要があります。連続モード問合せに適用可能です。

たとえば:
oclumon dumpnodeview -device -i 5

-filter string

このオプションを使用して、各メトリックの名前列でフィルタ文字列を検索します。

たとえば、-process -filter "ora"と指定すると、名前に"ora"の部分文字列が含まれるプロセス・メトリックが表示されます。

-process-device-nic-cpu-procagg-filesystem-nfsオプションでサポートされています。

たとえば:
oclumon dumpnodeview -process -filter "ora"
.

-show_all_sample_with_filter

フィルタが一致しないすべてのサンプルも出力に表示されます。-filterオプションとのみ一緒に使用できます。

たとえば:
oclumon dumpnodeview -filter filter_criteria -show_all_sample_with_filter

表A-4 oclumon dumpnodeviewコマンドのログ・ファイル・ディレクトリ

ディレクトリ 説明

-inputDataDir absolute_dir_path

JSONログ・ファイルが含まれるディレクトリの絶対パスを指定します。

たとえば:
oclumon dumpnodeview -cpu -inputDataDir absolute_path

-logDir absolute_log_dir_path

スクリプト実行ログが格納されるディレクトリの絶対パスを指定します。

たとえば:
oclumon dumpnodeview -cpu -inputDataDir absolute_path -logDir absolute_log_dir_path

表A-5 oclumon dumpnodeviewコマンドの履歴問合せオプション

フラグ 説明

-s start_time

-e end_time

-sオプションを使用して一連の問合せを開始するタイム・スタンプを指定し、-eオプションを使用して一連の問合せを終了するタイム・スタンプを指定します。

二重引用符("")で囲んだYYYY-MM-DD HH24:MM:SS形式で時間を指定します。

範囲を取得するには、これら2つのオプションを一緒に指定します。

たとえば:
oclumon dumpnodeview -cpu -s "2019-07-10 03:40:25" -e "2019-07-10 03:45:25"

-last duration

最後のメトリックを取得する時間(二重引用符("")で囲んだHH24:MM:SS形式)を指定するには、このオプションを使用します。

"00:45:00"を指定すると、過去45分間のメトリックがダンプされます。

たとえば:
oclumon dumpnodeview -nic -last "00:45:00"
.

A.3 oclumon chmdiag

oclumon chmdiagを使用して、サポートされているすべてのイベントおよびアクションの詳細な説明を取得し、様々なコンポーネントによって送信されたCHMDiagイベントまたはアクションを問い合せてHTMLまたはテキスト・レポートを生成し、CHMDiagによって生成されたすべてのイベントまたはアクションのデータを、指定した出力ディレクトリの場所に収集します。

A.4 oclumon localrepo getconfig

oclumon localrepo getconfigを使用して、すべてのノードのリポジトリの構成を取得します。

構文

oclumon localrepo getconfig [-reposize] [-repopath] [-retentiontime] [-local | -n <node1> ...]

パラメータ

パラメータ 説明

-reposize

リポジトリ・サイズ(MB)を取得します。

-repopath

リポジトリ・パスを取得します。

-retentiontime

現在構成されているリポジトリ・サイズの履歴データに基づいて、時間単位でのローカル・リポジトリの保存の見積りを取得します。

-local

ローカル・ノードのみの構成を取得します。

-n

必要なノードのリストの構成を取得します。

例A-3 すべてのノードのリポジトリの完全な構成を表示するには

oclumon localrepo getconfig
Node: <node-name1>
Repository size: 500 MB
Repository path: $ORACLE_HOME/crsdata/<node-name1>/crf/db/json
Repository retention time: 246 Hours

Node: <node-name2>
Repository size: 500 MB
Repository path: $ORACLE_HOME/crsdata/<node-name2>/crf/db/json
Repository retention time: 240 Hours

例A-4 すべてのノードのリポジトリ・パスとサイズのみを表示するには

oclumon localrepo getconfig -reposize -repopath
Node: <node-name1>
Repository size: 500 MB
Repository path: $ORACLE_HOME/crsdata/<node-name1>/crf/db/json

Node: <node-name2>
Repository size: 500 MB
Repository path: $ORACLE_HOME/crsdata/<node-name2>/crf/db/json

例A-5 ローカル・ノードのリポジトリの完全な構成を表示するには

oclumon localrepo getconfig -local
Node: <node-name>
Repository size: 500 MB
Repository path: $ORACLE_HOME/crsdata/<node-name>/crf/db/json
Repository retention time: 246 Hours

例A-6 特定のノード<node-name1>および<node-name2>のリポジトリの完全な構成を表示するには

oclumon localrepo getconfig -n <node-name1> <node-name2>
Node: <node-name1>
Repository size: 500 MB
Repository path: $ORACLE_HOME/crsdata/<node-name1>/crf/db/json
Repository retention time: 246 Hours

Node: <node-name2>
Repository size: 500 MB
Repository path: $ORACLE_HOME/crsdata/<node-name2>/crf/db/json
Repository retention time: 240 Hours

A.5 oclumon version

oclumon versionコマンドを使用して、使用中のクラスタ状態モニターのバージョンを取得します。

構文

oclumon version

例A-7 oclumon version

このコマンドを実行すると、次のような出力が生成されます。
Cluster Health Monitor (OS), Release 20.0.0.0.0
Version : 20.3.0.0.0

A.6 oclumon debug

oclumon debugコマンドを使用して、クラスタ状態モニター・サービスのログ・レベルを設定します。

構文

oclumon debug [log daemon module:log_level] [version]

パラメータ

表A-6 oclumon debugコマンドのパラメータ

パラメータ 説明

log daemon module:log_level

デーモンのログ・レベルおよびデーモン・モジュールを変更する場合に、このオプションを使用します。

サポートされているデーモンは次のとおりです。

  • osysmond
  • client
  • all

サポートされているデーモン・モジュールは次のとおりです。

  • osysmond: CRFMONDCRFMおよびallcomp
  • client: OCLUMONCRFMおよびallcomp
  • all: allcomp

サポートされているlog_levelの値は012および3です。

ここで、レベル0は最小ロギングで最低のデフォルト・レベル、レベル3は最大ロギングで最高レベルです。

version

デーモンのバージョンを表示する場合に、このオプションを使用します。

例A-8 oclumon debug

次の例では、システム監視サービス(osysmond)のログ・レベルを設定します。
$ oclumon debug log osysmond CRFMOND:3
次の例では、デーモンのバージョンを表示します。
$ oclumon debug version

Cluster Health Monitor (OS), Release 20.0.0.0.0
Version           : 20.3.0.0.0
NODEVIEW Version  : 19.03
Label Date        : 200116