使用 pywin32 库中的 win32evtlog 写入 Windows 事件日志

Question

我有一个将在 Windows 服务器上运行的简单 Python 脚本，我想将整个脚本中的特定事件记录到 Windows 事件日志中。有没有人有一个简单而精确的写入 Windows 事件日志的示例，以便我可以从事件查看器查看事件。我已经阅读了 pywin32 库的文档，但找不到任何明确的示例。我尝试使用以下方法构建事件：

win32evtlogutil.ReportEvent(ApplicationName, EventID, EventCategory,
                EventType, Inserts, Data, SID)

我没有成功，有人可以更深入地解释一下 ReportEvent 吗？

Answer 1

一个简单的例子：

>>> import sys
>>> import win32evtlogutil
>>> import win32evtlog
>>> import time
>>>
>>>
>>> "Python {0:s} on {1:s}".format(sys.version, sys.platform)
'Python 3.5.4 (v3.5.4:3f56838, Aug  8 2017, 02:17:05) [MSC v.1900 64 bit (AMD64)] on win32'
>>>
>>> DUMMY_EVT_APP_NAME = "Dummy Application"
>>> DUMMY_EVT_ID = 7040  # Got this from another event
>>> DUMMY_EVT_CATEG = 9876
>>> DUMMY_EVT_STRS = ["Dummy event string {0:d}".format(item) for item in range(5)]
>>> DUMMY_EVT_DATA = b"Dummy event data"
>>>
>>> "Current time: {0:s}".format(time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()))
 'Current time: 2018-07-18 20:03:08'
>>>
>>> win32evtlogutil.ReportEvent(
...     DUMMY_EVT_APP_NAME, DUMMY_EVT_ID, eventCategory=DUMMY_EVT_CATEG,
...     eventType=win32evtlog.EVENTLOG_WARNING_TYPE, strings=DUMMY_EVT_STRS,
...     data=DUMMY_EVT_DATA)
>>>

输出：

您可以在 Event Viewer (mmc) 窗口的（上）图像中看到我从代码中输入的值与事件字段之间的对应关系。

win32evtlogutil.ReportEvent 是[GitHub]: mhammond/pywin32 - Python for Windows (pywin32) Extensions 的一部分，[GitHub]: mhammond/pywin32 - Python for Windows (pywin32) Extensions 是 WINAPI 之上的 Python 包装器。

[MS.Docs]: ReportEventW function 解释了您需要了解的所有内容，这是用于完成此任务的 WINAPI。请务必仔细阅读它（以及它引用的其他一些 URL），以便更熟悉参数、它们的值可能是什么以及其他信息。

确保不要滥用（包括测试），否则您最终可能会被大量垃圾数据污染事件日志。