構造化ログ

以下の出力では、NVP 形式オプション (名前と値のペア) が使用されています。このサンプルは、表示の都合上、編集されています。実際の出力では、各エントリは 1 行のみで、エントリ間に空白行はありません。

when="2019-08-01 18:43:02.216" pid=8240 level=SEVERE event=Utility.Event 
text="Previous system shutdown was abnormal, system forced down or crashed"

when="2019-08-01 18:43:05.290" pid=8240 level=SEVERE event=Utility.Event 
text="LMF Error: No valid license key. Local key file not found and LicenseID not defined."

when="2019-08-01 18:43:05.493" pid=8240 level=WARNING event=Generic.Event 
text="Warning: Alternate and primary journal directories are the same"

when="2019-08-01 18:46:10.493" pid=11948 level=WARNING event=System.Monitor 
text="CPUusage Warning: CPUusage = 79 ( Warnvalue is 75)."

この形式では、ファイル内の各行に、スペースで区切られた一連の名前と値のペアが含まれます。名前と値の各ペアの形式は、name=value で、value にスペース文字が含まれる場合は、value が括弧で囲まれます。ログ・ファイルの行には、以下の名前と値のペアの一部またはすべてが含まれます。

以下の出力では、JSON 形式オプションが使用されています。このサンプルは、表示の都合上、編集されています。実際の出力では、各エントリは 1 行のみで、エントリ間に空白行はありません。

{ "when": "2019-08-07 14:11:04.904", "pid": "8540", "level": "SEVERE", "event": "Utility.Event", 
"text": "Previous system shutdown was abnormal, system forced down or crashed"}

{ "when": "2019-08-07 14:11:08.155", "pid": "8540", "level": "SEVERE", "event": "Utility.Event", 
"text": "LMF Error: No valid license key. Local key file not found and LicenseID not defined."}

{ "when": "2019-08-07 14:11:08.311", "pid": "8540", "level": "WARNING", "event": "Generic.Event", 
"text": "Warning: Alternate and primary journal directories are the same"}

{ "when": "2019-08-07 14:16:13.843", "pid": "10816", "level": "WARNING", "event": "System.Monitor", 
"text": "CPUusage Warning: CPUusage = 84 ( Warnvalue is 75)."}

この形式では、ファイル内の各行が、一連のプロパティを持つ JSON オブジェクトです。プロパティの名前 (およびプロパティに含まれる値) は、前のセクションの名前と値のペアで示したものと同じです。

管理ポータルでは、[システム] > [構成] > [システム構成] > [Log Daemon Configuration] ページで構造化ログを管理できます。このページでは、ログ・デーモンの現在のステータスを確認できます。このステータスは、500 ミリ秒ごとに更新されます。インスタンスのログ・デーモン設定を編集することもできます。使用できる設定について、以下で詳しく説明します。

Child Process Launch Command

パイプ・コマンド。システムから構造化ログを送信する宛先を指定します。以下の形式の応答を入力します。

irislogd -f c:/myfilename.log

ただし、c:/myfilename.log を、宛先ログ・ファイルの完全修飾パス名に置き換えます。このコマンドで、irislogd は、ログ・データを受け取って、指定したファイル (-f オプションによる) にそのデータを書き込むインターシステムズの実行可能ファイルの名前です。

パイプ・コマンドの場合、最も簡単な方法は、ここで説明している実行可能ファイル (irislogd.exe) を使用することですが、別のターゲットを代わりに使用することもできます。irislogd.exe のその他のオプションについては、最後のセクションを参照してください。

+<pattern>: Include events matching <pattern>
-<pattern>: Exclude events matching <pattern>
<pattern>: Default include (equivalent to +<pattern>)

^LOGDMN ルーチンを使用すると、構造化ログを管理できます。

^LOGDMN を使用して構造化ログを有効にする手順は次のとおりです。

1. ターミナルを開いて以下のコマンドを入力します。

   set $namespace="%sys"
   do ^LOGDMN
   

   

   これによりルーチンが開始し、以下のプロンプトが表示されます。

    
   1) Enable logging
   2) Disable logging
   3) Display configuration
   4) Edit configuration
   5) Set default configuration
   6) Display logging status
   7) Start logging
   8) Stop logging
   9) Restart logging
    
   LOGDMN option?
   

   

2. 4 を押して、構成の詳細を指定します。ルーチンから以下の項目について入力を求められます。

   1. 最小ログ・レベル。以下のいずれかを指定します。

      • DEBUG2 — 詳細なデバッグ・メッセージ (16 進ダンプなど)。

      • DEBUG — それほど詳細ではないデバッグ・メッセージ。

      • INFO — すべての監査イベントを含む情報メッセージ。

      • WARN (既定値) — 警告。注意が必要な可能性はあるが、処理の中断は生じていない問題を示します。

      • SEVERE — 重大なエラー。処理の中断を招いた問題が発生したことを示します。

      • FATAL — 致命的なエラー。この問題によってシステムが動作しなくなったことを示します。

   2. パイプ・コマンド。システムから構造化ログを送信する宛先を指定します。以下の形式の応答を入力します。

      irislogd -f c:/myfilename.log
      

      

      ただし、c:/myfilename.log を、宛先ログ・ファイルの完全修飾パス名に置き換えます。このコマンドで、irislogd は、ログ・データを受け取って、指定したファイル (-f オプションによる) にそのデータを書き込むインターシステムズの実行可能ファイルの名前です。

      パイプ・コマンドの場合、最も簡単な方法は、ここで説明している実行可能ファイル (irislogd.exe) を使用することですが、別のターゲットを代わりに使用することもできます。irislogd.exe のその他のオプションについては、最後のセクションを参照してください。

   3. パイプに送信するデータの形式。NVP (既定値) または JSON のいずれかを指定します。オプション NVP を指定すると、スペースで区切られた名前と値のペアで構成されるデータが送信されます。オプション JSON を指定すると、JSON 形式の出力でデータが送信されます。"出力例" を参照してください。

   4. パイプ・コマンドへの連続した呼び出しの間隔 (秒数)。既定値は 10 秒です。

   5. イベント・フィルタ。イベント・タイプに基づいて構造化ログ内のイベントを制限します。フィルタ・パターンは、以下の形式で指定できます。

      +<pattern>: Include events matching <pattern>
      -<pattern>: Exclude events matching <pattern>
      <pattern>: Default include (equivalent to +<pattern>)
      

      フィルタ・パターンを指定する際は、以下の構文規則を考慮します。

      • ピリオド (.) ： 階層名のセパレータとして使用します (A.B.C など)。

      • アスタリスク (*) ： ワイルドカードとしてパターンの末尾でのみ使用します (例えば、A.B.* は A.B の下にあるすべてのイベントに一致します)。

      • コンマ (,) ： 複数のフィルタ・パターンを区切ります (-A,A.B など)

      以下に例を示します。

      -Audit.*,Audit.LoginFailure
      

      

      LoginFailure 以外のすべての Audit イベントを除外します。

3. ルーチンからメイン・プロンプト (LOGDMN option?) が再度表示されたら、1 を押してログを有効にします。

4. 7 を押してログを開始します。

構造化ログを管理するには、管理ポータルや ^LOGDMN ルーチンを使用する代わりに、%SYS ネームスペースで SYS.LogDmnOpens in a new tab クラスを使用することもできます。詳細は、クラスリファレンスを参照してください。