# LogstashInstall

**Repository Path**: brianchou/logstash-install

## Basic Information

- **Project Name**: LogstashInstall
- **Description**: 使用脚本部署Logstash服务
- **Primary Language**: Shell
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-18
- **Last Updated**: 2025-04-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: shell, logstash

## README

# 安装Logstash

[toc]

> [!NOTE]
>
> `Logstash`一般跟`Elasticsearch`部署在一起，可以在每个节点都部署一个。在部署`Logstash`前，需要先保证`Elasticsearch`正常和`Kafka`正常运行。

## 获取安装包

在服务器上执行以下命令

```shell
curl https://brianhsiung.oss-cn-hangzhou.aliyuncs.com/health
```

出现`echo ok`字样，则表示服务器可访问外网，如下图。

![image-20250310144533806](README.assets/image-20250310144533806.png)

**若服务器不能访问外网，有两种获取方式。可以访问外网的话跳过此步骤。**

### 官网下载

访问 https://www.elastic.co/downloads/past-releases/logstash-7-16-3, 根据服务器的CPU架构选择合适的版本，本文下载的是`LINUX_X86_64`。请注意，脚本只可使用`LINUX_X86_64`和`LINUX_AARCH64` ，勿下载其它格式的安装包。

### 三方下载

浏览器访问以下地址下载。

- **x86_64架构**： https://brianhsiung.oss-cn-hangzhou.aliyuncs.com/deploy/elastic/x64/logstash-7.16.3-linux-x86_64.tar.gz
- **aarch64架构**：https://brianhsiung.oss-cn-hangzhou.aliyuncs.com/deploy/elastic/aarch64/logstash-7.16.3-linux-aarch64.tar.gz

## 执行安装

1. 修改脚本`install_logstash.sh`，**`ES_USERNAME`，`ES_HOSTS`，`ES_PASSWORD`和`KAFKA_SERVERS`必须根据实际情况修改**。

| 变量名        | 含义                                                         | 示例值                                                       |
| ------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| LS_USER       | 运行用户（建议非root用户）                                   | elkuser                                                      |
| LS_BASE       | 安装目录                                                     | /data/logstash                                               |
| LS_VERSION    | 安装版本（固定值）                                           | 7.16.3                                                       |
| KAFKA_SERVERS | Kafka集群地址                                                | "172.26.85.159:9092,172.26.85.160:9092,172.26.85.161:9092"   |
| ES_USERNAME   | Elasticsearch账号                                            | elastic                                                      |
| ES_PASSWORD   | Elasticsearch密码（根据Elasticsearch集群安装设置的密码来调整） | TawqcNpekz23wYrdAemL                                         |
| ES_HOSTS      | Elasticsearch集群地址                                        | "172.26.85.159:9200" "172.26.85.160:9200" "172.26.85.161:9200" |

脚本中的换行符如果是`CRLF`，需要使用`vs code`或其他编辑器将其调整为如下图的`LF`。

![image-20250310134442034](README.assets/image-20250310134442034.png)

`topics => [ "SeiLoggerPlatform", "SeiLoggerAccess"]` 里的`SeiLoggerPlatform`和`SeiLoggerAccess`为`运维平台上的sei.topic.logger.access和system对应的值`，两边需要保持一致。

2. 控制台输入`id`，查看用户是否为`root`，如果不是，则执行以下命令切换为root。

```shell
sudo su -
```

3. 执行以下命令创建临时目录。

```shell
mkdir -p /tmp/logstash_install
```

4. 上传脚本`install_logstash.sh`至服务器的`/tmp/logstash_install`目录，若服务器不能访问外网，还需要上传安装包。并执行以下命令安装。

```shell
bash install_logstash.sh
```

5. 以下是脚本在`aarch64`架构服务器上运行的日志。

![image-20250305102042525](README.assets/image-20250305102042525.png)

6. 查看日志

```shell
tail -200f /data/logstash/logstash/logs/logstash-plain.log
```

7. 安装完成后删除脚本和安装包。

```shell
rm -rf /tmp/logstash_install
```