InterSystems 診断レポートの使用法
インターシステムズは、InterSystems IRIS® データ・プラットフォーム・インスタンスに対して診断レポートを実行するメカニズムを提供しています。診断レポートは、実行されているインスタンスに関する情報のスナップショットで、インターシステムズのサポート窓口 (WRC)Opens in a new tab に送られ、システムの問題を診断する際の助けとなります。収集される情報の種類の詳細は、"診断レポートの内容" のセクションを参照してください。
このトピックでは、管理ポータルからのタスクとして、診断レポートを構成し、実行する方法について説明します。このタスクに関する詳細は、"インターシステムズ・クラス・リファレンス" の "%SYS.Task.DiagnosticReportOpens in a new tab" エントリを参照してください。
診断レポートのタスクの実行
レポート生成の最も直接的な方法は、管理ポータルの [診断レポート] ページ ([システム処理] > [診断レポート]) に移動して、診断レポート・タスクのための適切な情報を入力することです。このページに戻って、いつでもこの情報を編集できます。フィールドを編集しない場合は、[実行] をクリックして、現在の設定を使用してレポートを生成します。
情報を何も入力せずに [実行] をクリックすると、タスクによって詳細レポートが生成され、InterSystems IRIS インスタンスの管理者のディレクトリ (install-dir\mgr) に HTML ファイルとして配置されます。ファイル名は、顧客名 YYYYMMDDHHMM.html の形式です。
例えば、2019 年 9 月 24 日 8:46 p.m. に、C:\MyInstallDir にインストールされたインスタンスで MyCompany に発行されたライセンス・キーを使用して診断レポート・タスクを実行すると、以下のレポート・ファイルが生成されます。
C:\MyInstallDir\mgr\MyCompany201909242046.html
いつタスクを実行するか、どこにファイルを保存するか、およびファイルを WRC に送信するかどうかに影響するいくつかのフィールドをページ上で設定できます。"診断レポートの設定の構成" のセクションでこれらの設定について説明します。[閉じる] をクリックすると、変更が破棄され、レポートのタスクは実行されません。
診断レポート・タスクの履歴の表示
[診断レポート] ページの最上部にある [タスク履歴] をクリックすると、診断レポート・タスクの履歴が表示されます (タスクとタスク履歴の詳細は、"システム管理ガイド" の “InterSystems IRIS の管理” の章にある "タスク・マネージャの使用" を参照してください)。
診断レポートの内容
診断レポートのタスクを実行すると、基本情報と詳細情報の両方を記録した HTML 形式のログ・ファイルが作成されます。このファイルは、問題解決のために WRC が使用できます。以下では、このレポートの各セクションについて説明します。
Note:
Microsoft Windows 32 ビット・システムの場合、レポートでは、SysInternals Software が開発した以下のサードパーティ・ユーティリティが使用されます。
基本情報
基本情報には、以下のカテゴリがあります。
一般
以下の情報が表示されます。
-
完全なホスト名 (ドメインを含む)
-
IP アドレス
-
ユーザ名
-
レポート作成日時
-
InterSystems IRIS のバージョンの文字列 ($ZVersion)
-
InterSystems IRIS オブジェクトのバージョンの文字列
-
InterSystems ODBC/JDBC サーバのバージョン情報
-
各国言語サポート (NLS) 情報
-
フリー・ブロック・カウント情報
-
オペレーティング・システムのバージョン (UNIX® システムの uname -a)
-
拡張システム情報 (PsInfo.Exe ユーティリティが、InterSystems IRIS Bin ディレクトリにある場合、Windows システムでのみ)
キー・ファイル
ライセンス・キー・ファイルの場所、ライセンス・キーの内容、ライセンスの可用性 ($System.License.CKEY() の出力) などのアクティブなライセンス情報を表示します。
ライセンス・カウント
ライセンス使用情報 ($System.License.ShowCounts() の出力) を表示します。
%SS
システムの状態の情報 (^%SS の出力 — 30 秒の間隔をおいて取られた 2 つのスナップショット) を表示します。
オペレーティング・システム・プロセス・リスト
オペレーティング・システム・プロセス情報を表示します (PsList.Exe ユーティリティが InterSystems IRIS Bin ディレクトリにある場合、Windows システムでのみ)。
CPF ファイル
アクティブな InterSystems IRIS 構成ファイル (iris.cpf) の内容を表示します。
SysLog
InterSystems IRIS システム・エラー・ログの内容を表示します。詳細は、“管理ポータルを使用した InterSystems IRIS の監視” の章にある "InterSystems IRIS システム・エラー・ログ" を参照してください。
セキュリティ
以下のセキュリティ情報のリストを表示します。
-
セキュリティ・パラメータ
-
サービス
-
リソース
-
ロール
-
アプリケーション
-
システム・ユーザ
-
現在のログインの失敗
-
ドメイン
-
SSL 構成
監査
イベントのリストや監査ログ・データベースの内容などの監査情報を表示します。
メッセージ
messages.log の内容を表示します (サイズが 5 MB 以下の場合)。
Note:
基本情報のみを記録したレポートを生成する手順は次のとおりです。
-
[タスクスケジュール表示] ページ ([システム処理] > [タスクマネージャ] > [タスクスケジュール表示]) に移動します。
-
診断レポートの行で、[詳細] をクリックします。
-
[タスク詳細] ページ ([システム処理] > [タスクマネージャ] > [タスクスケジュール表示] > [タスク詳細]) で、[編集] をクリックします。
-
[タスクスケジューラウィザード] ページで、[拡張レポート] チェック・ボックスのチェックを外し、[完了] をクリックします。
-
[タスク詳細] ページ ([システム処理] > [タスクマネージャ] > [タスクスケジュール表示] > [タスク詳細]) の診断レポートの行で [実行] をクリックします。
-
[タスク実行] ページで、[すぐに実行する] をクリックします。
-
[閉じる] をクリックします。
詳細情報
詳細情報には、以下のカテゴリがあります。
irisstat Snapshot #1
以下のオプションを使用して実行された InterSystems 統計ユーティリティ (irisstat) の出力を表示します。
irisstat -e2 -m-1 -n3 -j5 -g1 -m3 -L1 -u-1 -v1 -p-1 -c-1 -q1 -w2 -S-1 -E-1 -N65535 -s<mgr_dir>
irisstat ユーティリティの詳細は、このドキュメントの付録 "irisstat ユーティリティを使用した InterSystems IRIS の監視" を参照してください。
irisstat Snapshot #2
1 分後に最初のスナップショットと同じオプションを使用して実行された irisstat ユーティリティの出力を表示します。
irisstat 出力ファイルが大きすぎる場合は、個別のファイルに保存され、レポートと共に送信されることはありません。個別のファイルが作成されると、以下のようなメッセージが診断レポートの irisstat セクションに通知されます。
File /iris/iristestsys/mgr/irisstat201103151102.html is too big to be appended to
the Log File. A copy has been left in the Directory.
それらのファイルは html 拡張子を持ちますが、プレーン・テキストなのでブラウザではなくテキスト・エディタで表示する必要があります。
ネットワークのステータス
ネットワーク情報を表示します。以下のユーティリティの出力です。
ダンプ・ライセンス
ローカル・ライセンス・テーブルのエントリおよびキー情報を表示します ($System.License.DumpLocalInUse() および $System.License.DumpKeys() の出力)。
マネージャのディレクトリのダンプ・ファイル
コアまたは *.dmp ファイル (存在する場合) のリストを表示します。
GloStat
グローバル統計情報 (^GLOSTAT の出力 — 10 秒ごとに取られる 10 枚のスナップショット) を表示します。