EventLog

[C#] EventLogの使い方をわかりやすく解説

2025-04-15更新日: 2025-04-15

EventLogは、WindowsのイベントログにアクセスするためのC#クラスです。

これを使うことで、アプリケーションの動作状況を記録したり、システムのイベントを監視したりできます。

基本的な使い方としては、まずEventLogオブジェクトを作成し、Logプロパティで対象のログ(例: “Application”)を指定します。

次に、Sourceプロパティでイベントの発生元を設定し、WriteEntryメソッドを使ってログにメッセージを書き込みます。

イベントログの読み取りには、Entriesプロパティを使用してログエントリを取得し、必要な情報を処理します。

イベントログの管理には管理者権限が必要な場合があるため、注意が必要です。

目次から探す

EventLogとは
EventLogの基本的な使い方
EventLogの設定と管理
EventLogを使ったアプリケーションの監視
EventLogの応用例
まとめ

EventLogとは

EventLogは、Windowsオペレーティングシステムにおいて、アプリケーションやシステムのイベントを記録するための仕組みです。

これにより、開発者やシステム管理者は、アプリケーションの動作状況やエラー、警告などの情報を追跡し、問題の診断やパフォーマンスの監視を行うことができます。

C#では、System.Diagnostics名前空間に含まれるEventLogクラスを使用して、イベントログへの書き込みや読み取りが可能です。

これにより、アプリケーションの信頼性を向上させ、ユーザーにとっての利便性を高めることができます。

EventLogの基本的な使い方

EventLogオブジェクトの作成

EventLogを使用するためには、まずEventLogオブジェクトを作成する必要があります。

以下のサンプルコードでは、”MyApplication”という名前のイベントログを作成しています。

using System.Diagnostics;
partial class MyForm
{
    public MyForm()
    {
        InitializeComponent(); // フォームの初期化
        // EventLogオブジェクトの作成
        EventLog eventLog = new EventLog("MyApplication");
    }
}

ログの指定とソースの設定

EventLogを使用する際には、ログの指定とソースの設定が重要です。

以下のコードでは、”MySource”というソースを登録し、”Application”ログに書き込む準備をしています。

using System.Diagnostics;
partial class MyForm
{
    public MyForm()
    {
        InitializeComponent(); // フォームの初期化
        // ソースの登録
        if (!EventLog.SourceExists("MySource"))
        {
            EventLog.CreateEventSource("MySource", "Application");
        }
    }
}

メッセージの書き込み

EventLogにメッセージを書き込むには、WriteEntryメソッドを使用します。

以下のサンプルコードでは、”Hello, EventLog!”というメッセージを”Application”ログに書き込んでいます。

using System.Diagnostics;
partial class MyForm
{
    public MyForm()
    {
        InitializeComponent(); // フォームの初期化
        // メッセージの書き込み
        EventLog.WriteEntry("MySource", "Hello, EventLog!", EventLogEntryType.Information);
    }
}

イベントログの読み取り

イベントログからメッセージを読み取るには、EventLogクラスのEntriesプロパティを使用します。

以下のコードでは、”Application”ログから最新のエントリを取得し、表示しています。

using System.Diagnostics;
partial class MyForm
{
    public MyForm()
    {
        InitializeComponent(); // フォームの初期化
        // イベントログの読み取り
        EventLog eventLog = new EventLog("Application");
        foreach (EventLogEntry entry in eventLog.Entries)
        {
            // エントリの情報を表示
            Console.WriteLine(entry.Message);
        }
    }
}

このように、EventLogを使用することで、アプリケーションのイベントを簡単に記録し、管理することができます。

EventLogの設定と管理

ログの作成と削除

EventLogを使用する際には、ログの作成と削除が必要になることがあります。

以下のサンプルコードでは、”MyCustomLog”という名前のカスタムログを作成し、必要に応じて削除する方法を示しています。

using System.Diagnostics;
partial class MyForm
{
    public MyForm()
    {
        InitializeComponent(); // フォームの初期化
        // カスタムログの作成
        if (!EventLog.Exists("MyCustomLog"))
        {
            EventLog.CreateEventSource("MySource", "MyCustomLog");
        }
        // カスタムログの削除
        // EventLog.DeleteEventSource("MySource"); // ソースを削除する場合
    }
}

ソースの登録と削除

EventLogにメッセージを書き込むためには、ソースを登録する必要があります。

以下のコードでは、”MySource”というソースを登録し、必要に応じて削除する方法を示しています。

using System.Diagnostics;
partial class MyForm
{
    public MyForm()
    {
        InitializeComponent(); // フォームの初期化
        // ソースの登録
        if (!EventLog.SourceExists("MySource"))
        {
            EventLog.CreateEventSource("MySource", "MyCustomLog");
        }
        // ソースの削除
        // EventLog.DeleteEventSource("MySource"); // ソースを削除する場合
    }
}

権限とセキュリティの考慮

EventLogを使用する際には、適切な権限とセキュリティを考慮することが重要です。

以下のポイントに注意してください。

管理者権限: イベントログに書き込むためには、アプリケーションが管理者権限で実行されている必要があります。
セキュリティ設定: イベントログのセキュリティ設定を確認し、必要に応じてアクセス権を設定します。
エラーハンドリング: イベントログへの書き込み時にエラーが発生する可能性があるため、適切なエラーハンドリングを実装します。

これらの考慮事項を守ることで、EventLogを安全かつ効果的に利用することができます。

EventLogを使ったアプリケーションの監視

イベントログの監視方法

アプリケーションの動作状況を把握するために、イベントログを監視することが重要です。

C#では、EventLogクラスを使用して特定のログを監視することができます。

以下のサンプルコードでは、”Application”ログを監視し、新しいエントリが追加された際に通知を受け取る方法を示しています。

using System.Diagnostics;
partial class MyForm
{
    private EventLog eventLog;
    public MyForm()
    {
        InitializeComponent(); // フォームの初期化
        // イベントログの監視
        eventLog = new EventLog("Application");
        eventLog.EntryWritten += new EntryWrittenEventHandler(OnEntryWritten);
        eventLog.EnableRaisingEvents = true; // イベントの発生を有効にする
    }
    private void OnEntryWritten(object sender, EntryWrittenEventArgs e)
    {
        // 新しいエントリが追加されたときの処理
        Console.WriteLine($"新しいエントリ: {e.Entry.Message}");
    }
}

イベントハンドラの設定

イベントログの監視を行うためには、EntryWrittenイベントに対してイベントハンドラを設定する必要があります。

上記のコードでは、OnEntryWrittenメソッドが新しいエントリが追加された際に呼び出されます。

このメソッド内で、エントリのメッセージを取得し、必要な処理を行うことができます。

リアルタイムでのログ監視

リアルタイムでのログ監視を実現するためには、EnableRaisingEventsプロパティをtrueに設定する必要があります。

これにより、指定したイベントログに新しいエントリが追加されるたびに、設定したイベントハンドラが自動的に呼び出されます。

これにより、アプリケーションの状態をリアルタイムで把握し、迅速な対応が可能になります。

このように、EventLogを使用することで、アプリケーションの監視を効率的に行うことができ、問題の早期発見やパフォーマンスの最適化に役立てることができます。

EventLogの応用例

システムエラーの記録

EventLogは、システムエラーを記録するための強力なツールです。

アプリケーションがエラーを検出した際に、エラーメッセージをイベントログに書き込むことで、後から問題を分析することができます。

以下のサンプルコードでは、例外が発生した場合にエラーメッセージを”Application”ログに記録しています。

using System;
using System.Diagnostics;
partial class MyForm
{
    public MyForm()
    {
        InitializeComponent(); // フォームの初期化
        try
        {
            // 何らかの処理
            throw new Exception("システムエラーが発生しました。"); // エラーを発生させる
        }
        catch (Exception ex)
        {
            // エラーメッセージの記録
            EventLog.WriteEntry("MySource", ex.Message, EventLogEntryType.Error);
        }
    }
}

アプリケーションのパフォーマンス監視

EventLogを使用して、アプリケーションのパフォーマンスを監視することも可能です。

特定の処理の実行時間やリソース使用状況をログに記録することで、パフォーマンスのボトルネックを特定できます。

以下のサンプルコードでは、処理の開始と終了時にログを記録しています。

using System;
using System.Diagnostics;
using System.Threading;
partial class MyForm
{
    public MyForm()
    {
        InitializeComponent(); // フォームの初期化
        // パフォーマンス監視
        EventLog.WriteEntry("MySource", "処理を開始します。", EventLogEntryType.Information);
        // 処理のシミュレーション
        Thread.Sleep(2000); // 2秒待機
        EventLog.WriteEntry("MySource", "処理が完了しました。", EventLogEntryType.Information);
    }
}

セキュリティイベントの追跡

EventLogは、セキュリティ関連のイベントを追跡するためにも利用されます。

ユーザーのログインやログアウト、権限の変更などの重要なイベントを記録することで、セキュリティの監視を強化できます。

以下のサンプルコードでは、ユーザーのログインイベントを記録しています。

using System.Diagnostics;
partial class MyForm
{
    public MyForm()
    {
        InitializeComponent(); // フォームの初期化
        // セキュリティイベントの記録
        EventLog.WriteEntry("MySource", "ユーザーがログインしました。", EventLogEntryType.SuccessAudit);
    }
}