日志服务：采集Windows事件日志

原理

对于事件日志，Windows提供了Windows Event Log和Event Logging两套API，前者是后者的升级，仅在Windows Vista及以上的版本中提供。Logtail插件会根据所运行的系统，自动选择API（优先选择Windows Event Log）来获取Windows事件日志。

Windows事件日志采用发布订阅的模式，应用程序或者内核将事件日志发布到指定的通道（例如Application、Security、System），Logtail通过对应的Logtail插件调用Windows API，实现对这些通道的订阅，从而不断地获取相关的事件日志并发送到日志服务。

Logtail支持同时采集多个通道事件，例如同时采集应用程序和系统日志。

查看通道信息

您可以在Windows服务器的事件查看器中查看通道信息。

1. 单击开始。

2. 搜索并打开事件查看器。

3. 在左侧导航栏中展开Windows 日志。

4. 查看通道的全名。

   在Windows日志下，选择目标通道，右键单击属性，查看通道全名，包括：

   • 应用程序：Application

   • 安全：Security

   • Setup：Setup

   • 系统：System

5. 查看通道相关信息。

   在Windows日志下，单击目标通道，在页面中间区域查看事件的级别、日期和时间、来源和事件ID等信息。

   在Logtail配置中，您可根据这些信息进行日志过滤。

   

采集步骤

1. 登录日志服务控制台。

2. 在接入数据区域，单击Windows事件日志。

3. 选择目标Project和Logstore，单击下一步。

4. 在机器组配置页面，配置机器组。

   1. 根据实际需求，选择使用场景和安装环境。

      重要

      无论是否已有机器组，都必须根据实际需求正确选择使用场景和安装环境，这将影响后续的页面配置。

   2. 确认目标机器组已在应用机器组区域，单击下一步。

      已有机器组

      从源机器组列表选择目标机器组。

      

      没有可用机器组

      单击创建机器组，在创建机器组面板设置相关参数。机器组标识分为IP地址和用户自定义标识，更多信息请参见创建用户自定义标识机器组（推荐）或创建IP地址机器组。

      重要

      创建机器组后立刻应用，可能因为连接未生效，导致心跳为FAIL，您可单击重试。如果还未解决，请参见Logtail机器组无心跳进行排查。

5. 在数据源设置页签中，设置配置名称和插件配置，然后单击下一步。

   • inputs为数据源配置，必选项。

     重要

     一个inputs中只允许配置一个类型的数据源。

   • processors为处理配置，用于解析数据。可选项，您可以配置一种或多种处理方式。

     如果当前的inputs配置无法满足日志解析需求，您可以在插件配置中添加processors配置，即添加Logtail插件处理数据。例如提取字段、提取日志时间、脱敏数据、过滤日志等。更多信息，请参见使用Logtail插件处理数据。

   例如您要采集应用程序和系统两个通道对应的日志，则可以在inputs中添加两个元素，示例如下所示。

   {
       "inputs": [
           {
               "type": "service_wineventlog",
               "detail": {
                   "Name": "Application",
                   "IgnoreOlder": 259200
               }
           },
           {
               "type": "service_wineventlog",
               "detail": {
                   "Name": "System",
                   "IgnoreOlder": 259200
               }
           }
       ]
   }

   参数	类型	是否必选	说明
   type	String	是	数据源类型，固定为service_wineventlog。
   Name	String	是	待采集事件日志所属的通道名称。不配置时，默认为Application，表示采集应用程序通道中的事件日志。您可以在Windows系统中查看通道全名。更多信息，请参见步骤4。
   IgnoreOlder	UINT	否	根据事件时间过滤日志，此配置是相对于采集开始时间的偏移量，单位为秒，早于此设置的日志会被忽略。 例如： 设置为3600，表示相对于采集开始时间一小时前的日志都会被忽略。 设置为14400，表示相对于采集开始时间四小时前的日志都会被忽略。 默认为空，表示不根据事件时间进行过滤，采集服务器上所有的历史事件日志。 说明 该选项仅在首次配置采集时生效，Logtail会记录事件采集的Checkpoint，保证不会重复采集事件日志。
   Level	String	否	根据事件等级过滤日志，默认值为information, warning, error, critical，表示采集除了verbose等级外的其他所有日志。 可选值包括：information、warning、error、critical、verbose。您可以使用半角逗号（,）指定多个等级。 说明 该参数仅支持Windows Event Log API，即只能在Windows Vista及以上的操作系统上使用。
   EventID	String	否	根据事件ID过滤日志，可以指定正向过滤（单个或范围）或者反向过滤（不支持范围设置）。默认为空，表示采集所有事件。例如： 1-200表示只采集事件ID在1-200范围内的事件日志。 20表示只采集事件ID为20的事件日志。 -100表示采集除了事件ID为100以外的所有事件日志。 1-200,-100表示采集1-200范围内除了100以外的事件日志。 您可以使用半角逗号（,）指定多个值。 说明 该参数仅支持Windows Event Log API，即只能在Windows Vista及以上的操作系统上使用。
   Provider	String数组	否	根据事件来源过滤日志。例如设置为["App1", "App2"] 表示只采集来源名字为App1和App2的事件日志，其他事件日志都会被忽略。 默认为空，表示采集所有来源的事件。 说明 该参数仅支持Windows Event Log API，即只能在Windows Vista及以上的操作系统上使用。
   IgnoreZeroValue	Boolean	否	并非每条事件日志都拥有所有的字段，您可以使用此参数过滤空字段，空字段的定义根据类型而定，例如整数类型使用0表示空字段。 默认为false，表示不过滤空字段。

6. 创建索引和预览数据，然后单击下一步。日志服务默认开启全文索引。您也可以根据采集到的日志，手动创建字段索引，或者单击自动生成索引，日志服务将自动生成字段索引。更多信息，请参见创建索引。

   重要

   如果需要查询日志中的所有字段，建议使用全文索引。如果只需查询部分字段、建议使用字段索引，减少索引流量。如果需要对字段进行分析（SELECT语句），必须创建字段索引。

7. 单击查询日志，系统将跳转至Logstore查询分析页面。
   您需要等待1分钟左右，待索引生效后，才能在原始日志页签中，查看已采集到的日志。更多信息，请参见查询和分析日志。

问题排查

使用Logtail采集日志后，如果预览页面或查询页面无数据，您可以参见Logtail采集日志失败的排查思路进行排查。