› ›

在 Windows 上运行 Logstash

在 Windows 上运行 Logstash编辑

在阅读本节之前，请参阅安装 Logstash以开始使用。您还需要熟悉从命令行运行 Logstash，因为命令行选项用于测试在 Windows 上运行 Logstash。

在测试 Logstash 时，指定命令行选项非常有用。但是，在生产环境中，我们建议您使用logstash.yml来控制 Logstash 执行。使用设置文件可以更轻松地指定多个选项，并且它为您提供了一个可版本化的文件，您可以使用该文件在每次运行时一致地启动 Logstash。

Logstash 在安装后不会自动启动。如何在 Windows 上启动和停止 Logstash 取决于您是要手动运行它，作为服务运行（使用NSSM），还是作为计划任务运行。本指南提供了一些在 Windows 上运行 Logstash 的方法示例。

建议在将 Logstash 作为服务或计划任务运行之前，通过手动运行 Logstash 来验证您的配置是否有效。

在 Windows 上验证 JVM 先决条件编辑

安装受支持的 JVM后，打开PowerShell会话并运行以下命令以验证是否设置了LS_JAVA_HOME以及 Java 版本

`Write-Host $env:LS_JAVA_HOME`编辑

输出应指向 JVM 软件所在的位置，例如

PS C:\> Write-Host $env:LS_JAVA_HOME
C:\Program Files\Java\jdk-11.0.3

如果未设置LS_JAVA_HOME，请执行以下操作之一
- 使用 GUI 设置
  - 导航到 Windows环境变量窗口
  - 在“环境变量”窗口中，编辑 LS_JAVA_HOME 以指向 JDK 软件所在的位置，例如：C:\Program Files\Java\jdk-11.0.3
- 使用 PowerShell 设置
  - 在管理 PowerShell 会话中，执行以下SETX命令
    
    PS C:\Windows\system32> SETX /m LS_JAVA_HOME "C:\Program Files\Java\jdk-11.0.3" PS C:\Windows\system32> SETX /m PATH "$env:PATH;C:\Program Files\Java\jdk-11.0.3\bin;"
  - 退出 PowerShell，然后打开一个新的 PowerShell 会话并运行Write-Host $env:LS_JAVA_HOME进行验证

`Java -version`编辑

此命令将生成类似于以下内容的输出

PS C:\> Java -version
java version "11.0.3" 2019-04-16 LTS
Java(TM) SE Runtime Environment 18.9 (build 11.0.3+12-LTS)
Java HotSpot(TM) 64-Bit Server VM 18.9 (build 11.0.3+12-LTS, mixed mode)

截至本文档发布之日，请在继续操作之前查看此影响 Java 11 的已知问题。

完成设置和运行 Logstash并验证 JVM 先决条件后，您可以继续。

对于下面列出的示例，我们运行的是 Windows Server 2016、Java 11.0.3，已将Logstash ZIP 包解压缩到C:\logstash-8.14.2\，并使用下面显示的示例syslog.conf文件（存储在C:\logstash-8.14.2\config\中）。

手动运行 Logstash编辑

可以使用PowerShell手动运行 Logstash。打开管理PowerShell会话，然后运行以下命令

PS C:\Windows\system32> cd C:\logstash-8.14.2\
PS C:\logstash-8.14.2> .\bin\logstash.bat -f .\config\syslog.conf

在生产环境中，我们建议您使用logstash.yml来控制 Logstash 执行。

等待以下消息出现，以确认 Logstash 已成功启动

[logstash.runner          ] Starting Logstash {"logstash.version"=>"8.14.2"}
[logstash.inputs.udp      ] Starting UDP listener {:address=>"0.0.0.0:514"}
[logstash.agent           ] Successfully started Logstash API endpoint {:port=>9600}

使用 NSSM 将 Logstash 作为服务运行编辑

建议您在继续操作之前，通过手动运行 Logstash 来验证您的配置是否有效。

下载NSSM，然后将nssm.exe从nssm-<version.number>\win64\nssm.exe解压缩到C:\logstash-8.14.2\bin\。然后打开管理PowerShell会话，然后运行以下命令

PS C:\Windows\system32> cd C:\logstash-8.14.2\
PS C:\logstash-8.14.2> .\bin\nssm.exe install logstash

出现NSSM 服务安装程序窗口后，在应用程序选项卡中指定以下参数

在应用程序选项卡中
- 路径：logstash.bat的路径：C:\logstash-8.14.2\bin\logstash.bat
- 启动目录：bin目录的路径：C:\logstash-8.14.2\bin
- 参数：对于此示例，要启动 Logstash：-f C:\logstash-8.14.2\config\syslog.conf
  
  在生产环境中，我们建议您使用logstash.yml来控制 Logstash 执行。
在详细信息选项卡中查看并进行必要的更改
- 确保启动类型设置正确
- 将显示名称和描述字段设置为相关内容
查看任何其他必需的设置（对于本示例，我们不做任何其他更改）
- 请务必确定是否需要设置登录用户
验证服务名称是否设置正确
- 对于本示例，我们将其设置为logstash-syslog
单击安装服务
- 出现服务“logstash-syslog”已成功安装！窗口时，单击“确定”

使用 NSSM 安装服务后，请按照PowerShell 管理服务文档验证并启动服务。

使用任务计划程序运行 Logstash编辑

建议您在继续操作之前，通过手动运行 Logstash 来验证您的配置是否有效。

打开 Windows任务计划程序，然后在“操作”窗口中单击创建任务。在操作选项卡中指定以下参数

在操作选项卡中
- 单击新建，然后指定以下内容
- 操作：启动程序
- 程序/脚本：C:\logstash-8.14.2\bin\logstash.bat
- 添加参数：-f C:\logstash-8.14.2\config\syslog.conf
- 起始于：C:\logstash-8.14.2\bin\
  
  在生产环境中，我们建议您使用logstash.yml来控制 Logstash 执行。
在常规、触发器、条件和设置选项卡中查看并进行必要的更改。
单击确定以完成创建计划任务。
创建新任务后，等待它按计划运行，或选择该服务，然后单击运行以启动该任务。

可以通过选择服务，然后在“任务计划程序”窗口中单击结束来停止 Logstash。

示例 Logstash 配置编辑

我们将使用此配置（文件名是syslog.conf）配置 Logstash 以侦听端口 514 上的系统日志消息

# Sample Logstash configuration for receiving
# UDP syslog messages over port 514

input {
  udp {
    port => 514
    type => "syslog"
  }
}

output {
  elasticsearch { hosts => ["localhost:9200"] }
  stdout { codec => rubydebug }
}

« 在 Kubernetes 上运行 Logstash 日志记录 »

在 Windows 上运行 Logstash