›

Winlogbeat 快速入门：安装和配置

编辑

Winlogbeat 快速入门：安装和配置

编辑

本指南介绍如何快速开始使用 Windows 日志监控。您将学习如何

在您要监控的每个系统上安装 Winlogbeat
指定日志文件的位置
将日志数据解析成字段并将其发送到 Elasticsearch
在 Kibana 中可视化日志数据

开始之前

编辑

您需要 Elasticsearch 来存储和搜索数据，以及 Kibana 来可视化和管理数据。

要快速入门，请启动我们托管的 Elasticsearch 服务的部署。Elasticsearch 服务可在 AWS、GCP 和 Azure 上使用。免费试用。

步骤 1：安装 Winlogbeat

编辑

从下载页面下载 Winlogbeat zip 文件。
将内容解压缩到 C:\Program Files。
将 winlogbeat-<version> 目录重命名为 Winlogbeat。
以管理员身份打开 PowerShell 提示符（右键单击 PowerShell 图标并选择“以管理员身份运行”）。
在 PowerShell 提示符下，运行以下命令以安装服务。

PS C:\Users\Administrator> cd 'C:\Program Files\Winlogbeat'
PS C:\Program Files\Winlogbeat> .\install-service-winlogbeat.ps1

Security warning
Run only scripts that you trust. While scripts from the internet can be useful,
this script can potentially harm your computer. If you trust this script, use
the Unblock-File cmdlet to allow the script to run without this warning message.
Do you want to run C:\Program Files\Winlogbeat\install-service-winlogbeat.ps1?
[D] Do not run  [R] Run once  [S] Suspend  [?] Help (default is "D"): R

Status   Name               DisplayName
------   ----               -----------
Stopped  winlogbeat         winlogbeat

如果您的系统上禁用了脚本执行，则需要将当前会话的执行策略设置为允许脚本运行。例如：PowerShell.exe -ExecutionPolicy UnRestricted -File .\install-service-winlogbeat.ps1。

要使用本地非管理员帐户运行 Winlogbeat，请遵循这些附加步骤。

步骤 2：连接到 Elastic Stack

编辑

需要连接到 Elasticsearch 和 Kibana 才能设置 Winlogbeat。

在 winlogbeat.yml 中设置连接信息。要找到此配置文件，请参阅目录布局。

指定 Elasticsearch 服务的 cloud.id，并将 cloud.auth 设置为有权设置 Winlogbeat 的用户。例如

cloud.id: "staging:dXMtZWFzdC0xLmF3cy5mb3VuZC5pbyRjZWM2ZjI2MWE3NGJmMjRjZTMzYmI4ODExYjg0Mjk0ZiRjNmMyY2E2ZDA0MjI0OWFmMGNjN2Q3YTllOTYyNTc0Mw=="
cloud.auth: "winlogbeat_setup:YOUR_PASSWORD"

此示例显示了一个硬编码的密码，但您应该将敏感值存储在密钥存储中。

设置 Winlogbeat 可以找到 Elasticsearch 安装程序的主机和端口，并设置有权设置 Winlogbeat 的用户的用户名和密码。例如

output.elasticsearch:
  hosts: ["https://myEShost:9200"]
  username: "winlogbeat_internal"
  password: "YOUR_PASSWORD" 
  ssl:
    enabled: true
    ca_trusted_fingerprint: "b9a10bbe64ee9826abeda6546fc988c8bf798b41957c33d05db736716513dc9c"

此示例显示了一个硬编码的密码，但您应该将敏感值存储在密钥存储中。

此示例显示了一个硬编码的指纹，但您应该将敏感值存储在密钥存储中。指纹是 CA 证书的十六进制编码 SHA-256，当您首次启动 Elasticsearch 时，Elasticsearch 会默认启用网络加密 (TLS) 等安全功能。如果您使用的是 Elasticsearch 首次启动时生成的自签名证书，则需要在此处添加其指纹。指纹会打印在 Elasticsearch 启动日志中，或者您可以参考将客户端连接到 Elasticsearch 文档以获取其他检索选项。如果您为 Elasticsearch 提供自己的 SSL 证书，请参考有关如何设置 SSL 的 Winlogbeat 文档。

如果您计划使用我们预构建的 Kibana 仪表板，请配置 Kibana 端点。如果 Kibana 在与 Elasticsearch 相同的主机上运行，请跳过此步骤。

  setup.kibana:
    host: "mykibanahost:5601" 
    username: "my_kibana_user"  
    password: "{pwd}"

	运行 Kibana 的机器的主机名和端口，例如 `mykibanahost:5601`。如果您在端口号后面指定路径，请包含方案和端口：`http://mykibanahost:5601/path`。
	Kibana 的 `username` 和 `password` 设置是可选的。如果您未为 Kibana 指定凭据，则 Winlogbeat 将使用为 Elasticsearch 输出指定的 `username` 和 `password`。
	要使用预构建的 Kibana 仪表板，此用户必须有权查看仪表板或具有 `kibana_admin` 内置角色。

要了解有关所需角色和权限的更多信息，请参阅 授予用户访问受保护资源的权限。

步骤 3：配置 Winlogbeat

编辑

在 winlogbeat.yml 中，配置您要监控的事件日志。

在 winlogbeat.event_log 下，指定要监控的事件日志列表。默认情况下，Winlogbeat 会监控应用程序、安全和系统日志。
```
winlogbeat.event_logs:
  - name: Application
  - name: Security
  - name: System
```
要获取可用事件日志的列表，请在 PowerShell 中运行 Get-EventLog *。有关此命令的更多信息，请参阅 event_logs.name 的配置详细信息。

（可选）设置日志记录选项以将 Winlogbeat 日志写入文件

logging.to_files: true
logging.files:
  path: C:\ProgramData\winlogbeat\Logs
logging.level: info

保存配置文件后，使用以下命令对其进行测试。

PS C:\Program Files\Winlogbeat> .\winlogbeat.exe test config -c .\winlogbeat.yml -e

有关配置 Winlogbeat 的更多信息，另请参阅

配置 Winlogbeat
配置文件格式
winlogbeat.reference.yml：此参考配置文件显示所有非弃用选项。您可以在与 winlogbeat.yml 相同的位置找到它。

步骤 4：设置资产

编辑

Winlogbeat 带有用于解析、索引和可视化数据的预定义资产。要加载这些资产

确保在 winlogbeat.yml 中指定的用户有权设置 Winlogbeat。
从安装目录运行
```
PS > .\winlogbeat.exe setup -e
```

此步骤加载写入 Elasticsearch 的推荐索引模板，加载用于解析事件的摄取管道（仅限 x-pack），并部署用于在 Kibana 中可视化数据的示例仪表板。

需要连接到 Elasticsearch（或 Elasticsearch 服务）才能设置初始环境。如果您使用的是其他输出，例如 Logstash，请参阅

步骤 5：启动 Winlogbeat

编辑

在启动 Winlogbeat 之前，请修改 winlogbeat.yml 中的用户凭据，并指定有权发布事件的用户。

要启动 Winlogbeat 服务，请运行

PS C:\Program Files\Winlogbeat> Start-Service winlogbeat

Winlogbeat 现在应该正在运行。如果您使用了此处描述的日志记录配置，则可以在 C:\ProgramData\winlogbeat\Logs\winlogbeat 中查看日志文件。

您可以从 Windows 中的服务管理控制台查看服务的状况并控制它。要启动管理控制台，请运行以下命令

PS C:\Program Files\Winlogbeat> services.msc

停止 Winlogbeat

编辑

使用以下命令停止 Winlogbeat 服务

PS C:\Program Files\Winlogbeat> Stop-Service winlogbeat

步骤 6：在 Kibana 中查看您的数据

编辑

Winlogbeat 带有用于可视化日志数据的预构建 Kibana 仪表板和 UI。您在运行 setup 命令时已加载了仪表板。

要打开仪表板

启动 Kibana
1. 登录您的 Elastic Cloud 帐户。
2. 导航到部署中的 Kibana 端点。
将浏览器指向 https://127.0.0.1:5601，将 localhost 替换为 Kibana 主机名。
在侧边导航栏中，单击发现。要查看 Winlogbeat 数据，请确保已选择预定义的 winlogbeat-* 数据视图。

如果在 Kibana 中看不到数据，请尝试将时间过滤器更改为更大的范围。默认情况下，Kibana 会显示过去 15 分钟的数据。
在侧边导航栏中，单击 仪表板，然后选择要打开的仪表板。

这些仪表板作为示例提供。我们建议您自定义它们以满足您的需求。

使用本地非管理员帐户运行 Winlogbeat

编辑

默认情况下，Winlogbeat 服务以 Local System 帐户运行。如果要以非管理员的本地用户帐户运行 Winlogbeat 服务，请按照以下步骤操作。必须在安全策略中授予本地用户帐户 以服务登录 权限，并将其设为 Builtin\Event Log Readers 组的一部分以读取事件日志。

使用此命令打开服务管理控制台

PS C:\Program Files\Winlogbeat> services.msc

右键单击名为 winlogbeat 的服务，然后选择 属性
在 登录 选项卡下，选择 此帐户： 并浏览要以其运行 Winlogbeat 服务的本地帐户用户。
输入本地用户帐户的密码，然后单击 应用。
在 Windows 搜索中搜索并打开 本地组策略编辑器 或从 Powershell 运行 gpedit.msc。
导航到路径：计算机设置 → 安全设置 → 本地策略，然后在其中打开 用户权限分配。
在 用户权限分配 中，将您的本地用户帐户添加到名为 以服务登录 的策略中。这应该允许您的本地用户帐户以服务登录。
通过在 Powershell 中运行 lusrmgr.msc 打开 本地用户和组管理器。
在 用户 下，右键单击您的本地帐户用户并打开 属性。
选择 成员 选项卡，然后单击 添加...
查找并选择名为 Event Log Readers 的组，然后单击 应用。这应该允许您的本地帐户用户读取事件日志。

接下来是什么？

编辑

现在您已将日志流式传输到 Elasticsearch，请了解如何统一您的日志、指标、正常运行时间和应用程序性能数据。

通过安装和配置其他 Elastic Beat 从其他来源摄取数据

Elastic Beat 捕获

Metricbeat

基础设施指标

Filebeat

日志

Heartbeat

正常运行时间信息

APM

应用程序性能指标

Auditbeat

审计事件

Elastic Beat	捕获
Metricbeat	基础设施指标
Filebeat	日志
Heartbeat	正常运行时间信息
APM	应用程序性能指标
Auditbeat	审计事件

使用 Kibana 中的可观察性应用程序搜索所有数据

Elastic 应用程序	用于
指标应用程序	探索有关整个生态系统中系统和服务的指标
日志应用程序	实时跟踪相关日志数据
正常运行时间应用程序	监控您应用和服务中的可用性问题
APM 应用	监控应用程序性能
SIEM 应用	分析安全事件

« Winlogbeat 概述设置和运行 Winlogbeat »