◆イベントログ − VC++ 2005　その1

[ ホーム ] [ 上へ ] [ イベントログ - VC++ 2005　その2 ]

・概要

イベントログとはウィンドウズシステム全体や個々のアプリケーションの重要な 情報やエラー情報を統一的に管理するシステムかと思います。今回はその仕組みとイベントログで 何ができるか書いてみたいと思います。イベントログは上記の情報をログと呼ばれるファイル （拡張子がevt）に統一的な形式で書き込んでいき、いつでも閲覧して ハードウェア・ウィンドウズシステム・アプリケーションを解析できるツールです。

ログとして記録するデータがどんな形式かというと、 スタート→ファイル名を指定して実行(R)でeventvwrを実行して現れたダイアログで、 アプリケーションログを選択して表示される各レコードの１つを右クリックして プロパティ(R)を選択して表示される下記のようなデータです。

1. 日付・時刻
2. イベントソース
3. カテゴリ（分類）
4. イベントタイプ（種類）
5. イベントID
6. ユーザ
7. 説明(イベントIDに対応する内容）
8. データ

このような情報／エラーデータなどを適切なタイミングで任意のログに書き込んでいき、 後で解析・利用するのがイベントログの機能です。

イベントログシステムが機能するための重要な要素のひとつがレジストリ にあるのでまずはそちらから解説します。

＜レジストリデータ＞

（イベントキー）

イベントログシステムはレジストリデータの値に設定されている イベントログに情報を書き込もうとします。具体的な位置は HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\EventLog 以下にすべての情報が収められています。このキーをイベントキーと言います。 レジストリエディタで見ると

こんな感じになっているはずです。左ペインの「Eventlog」が イベントキーで、その下にある「Application」「Security」「System」にイベントログ と呼ばれるデータを記録していく器に関する情報が収められています。

（イベントログキー）

ここに挙げられた３つのイベントログキーは デフォルトで登録されていると思いますが、例えば「Application」ログではさまざまな アプリケーションのイベントが日付順にランダムに記録されています。これがいやだという場合には 「Eventlog」キーの配下に専用のイベントログキーを作って、上記のスナップショットの 右ペインのような各エントリを設定してあげれば自分専用のログに記録できます。これが何の メリットがあるかというと、イベントログをバックアップしたいときにごった煮のApplicationログから 選んで抽出しなくても、専用のログから一発でバックアップできます。今回は、カスタムイベントログ 作成に関しては書きません。既定である「Application」ログを使って以降の説明をしていきます。

Applicationログをはじめ、各イベントログ キーには上記右ペインのような各エントリがありますが、各エントリの意味は以下のとおりです。

これらの設定はイベントビューワでも確認／設定できるので、例えば、スタート→ファイル名を 指定して実行(R)でeventvwrを起動して、アプリケーションログのプロパティをご覧になってみてください。

（イベントソースキー）

各アプリケーション・サービスなどが 最初の方で書いた内容をイベントログに書き込む際に、 イベントタイプやカテゴリ、イベントIDを指定しますが、指定できるイベントタイプやイベントIDに 対応するイベント内容はイベントログキー配下のイベントソースと呼ばれるサブキーの 各エントリで設定することになります。

実際にイベントログを書き込む際には、このイベントソース名を APIのRegisterEventSourceの引数に渡してハンドルを取得し、ReportEventを実行します。 次のレジストリエディタのスナップショットには「Application」ログに書き込まれるアプリケーション （イベントソース）が左ペインに表示され、右ペインには各アプリケーション(イベントソース） に設定されるエントリ例が表示されています。ここに設定された値に基づいてデータを上部のキーである イベントログキーのFileエントリに設定されたログに記録していくことになります。

上記の右ペインに表示されている、イベントソースの 各エントリの意味は以下のとおりです。

イベントログキーはカスタムなログを作らなければデフォルトで存在していますが、 イベントソースに関するレジストリエントリは事実上、「Application」キー配下に自分で作成する ことになります。イベントソースキーを作らなくてもイベントログに記録できますが、システムは自動的に 「Application」ログを選択します。しかし、イベント内容 のうちイベントIDやそれに対応する説明、カテゴリは使用できないのでMSはイベントソースを作成する ことを推奨しています。

イベントソースでメッセージIDに対応するメッセージファイルやカテゴリIDに 対応するカテゴリメッセージファイルを指定しなければなりませんが、どんなイベントを記録し、 利用するかをユーザの好み？で自身で決めて作成することになります。通常、このファイルはDLLとして 作成しますが、次のセクションでこの点について触れます。

＜メッセージコンパイラ　＆　メッセージファイル＞

イベントソースを作るにはメッセージIDに対応するメッセージファイル、 カテゴリIDに対応するカテゴリメッセージファイルをDLLとして作成しなければなりまんが、 VC++などプログラミング言語で作成する部分は実はほとんどありません。 メッセージコンパイラ(mc.exe)がコンパイルできるようなテキストファイル （メッセージファイル）を作成することが作業の中心になります。

メッセージIDとそれに対応したメッセージ内容が記載されたメッセージファイルを mc.exeでコンパイルすると、

1. 32ビットのメッセージIDが定義されたヘッダファイル(.hファイル）
2. メッセージIDとそれに対応付けられた説明が収められているバイナリファイル(.binファイル）
3. binファイルをリソースに組み込むための記述がされたリソースファイル(.rcファイル)

の３つが作成されます。後は、ソリューションに加えてビルドするとメッセージIDに 対応した説明が含まれるDLLファイルが出来上がるので、レジストリのイベントソースのEventMessageFile、 CategoryMessageFileエントリに値をセットすればイベントビューワで説明が表示されるようになります。

ということでメッセージファイルを作成することに集中すればいいわけですが、 メッセージコンパイラが解釈できるような形式は次のようなテキストファイル（拡張子は.mc)です。

（メッセージファイルの形式）

;#ifndef _MSGFILE_H_
;#define _MSGFILE_H_

;//-------------ヘッダ部-----------------------
MessageIdTypedef=DWORD

SeverityNames=(Success=0x0
               Informational=0x1
               Warning=0x2
               Error=0x3
              )

FacilityNames=(System=0x0FF
               Application=0xFFF
              )

LanguageNames=(English=0x1:MSG000001)
LanguageNames=(Japanese=0x2:MSG000002)
;//
;//-----------メッセージ定義-------------------
;//
MessageId=0x1
Severity=Error
Facility=Application
SymbolicName=MSG_FILE_OPEN
Language=English
The AppFile has been Opened
.
Language=Japanese
ファイルが開かれました
.

;//
;#endif

メッセージファイルは以下のように大きく３つの部分から成り立っています。

次にヘッダ部・メッセージ定義部に何を記述するかは次のようになります。

    #define  ((データ型)0xnnnnnnnn)

上記のようなメッセージファイルを作成・保存後、 コマンドプロンプトを起動して、

C:\> mc.exe msgfile.mc [リターン]

を実行すると先に書いた３つのファイル が作られます。mc.exeでコンパイルする際にいろいろオプションスイッチを指定できますが、 ここでは説明しないので、必要ならmc.exe /?を実行してオプションの内容を確認してください。

生成された３つのファイルの内、 メッセージIDが定義されたC++のhファイルが後のコーディングで使用するので一番注目しなければ なりません。ここでどのように32ビットのメッセージIDが生成されるかを書いておきます。

1〜16    (16ビット)

17〜28   (12ビット)

29       (1ビット)

30       (1ビット)

31〜32   (2ビット)

このようになっているのでmcでコンパイルしてできた hファイルとmcファイルを比べてみてください。

＜イベントログでの作業＞

レジストリに適切な書込みをして、メッセージファイルをコンパイル後、DLLファイルを 作成するとイベントログを使って作業ができるようになります。どんなことができるかというと

1. イベントログの書込み
2. イベントログの検索　＆　読込み
3. イベントログのクリア　＆　バックアップ
4. イベントログのモニタリング

４．以外は分かるかと思いますが、４はイベントログを監視してイベントログに 書込みがあると通知してくれるようにすることができます。次項からこれらを実際にやってみます。

[スポンサー リンク]

スポンサー リンク

[ ホーム ] [ 上へ ] [ イベントログ - VC++ 2005　その2 ]