本页内容
- 前提条件
- 添加 Sensu 仓库
- 安装 Sensu Backend
- 安装 Sensuctl 命令行工具
- 安装 Sensu Agent
- 使用 Checks 监控服务器资源
- 结论
Sensu 是一个开源的基础设施和应用监控系统,专为容器与非容器监控以及多云基础设施而设计。Sensu 是一套可扩展、安全且集成化的监控解决方案,适用于你的技术栈和服务器基础设施。它可用于监控服务器、应用健康状况和服务,并通过第三方集成将告警通知发送到多个目标。
在本教程中,你将学习如何在 Debian 11 服务器上安装 Sensu 监控软件。你还将学习如何设置 Sensu CLI 来管理 Sensu。最后,你将学习如何通过 Sensu Agent 使用 Sensu 设置服务器监控。
前提条件
对于本次 Sensu 部署,你需要满足以下要求:
- 一台配备 4 GB RAM 和 2 个 CPU 的 Debian 11 服务器。此要求很大程度上取决于你的基础设施环境。
- 一个具有 sudo/administrator 权限的非 root 用户。
- 一台 Linux 机器将用作被监控的目标。
添加 Sensu 仓库
要开始安装 Sensu,你需要将 Sensu 软件包仓库添加到所有系统中,包括 Sensu Backend 和目标服务器。
Sensu 仓库可在 packagecloud.io 上获取,你可以手动将其添加到系统,也可以通过 packagecloud.io 提供的 bash 脚本添加。
在添加 Sensu 仓库之前,运行下面的 apt 命令来安装基本的软件包依赖。出现确认安装提示时,按 Y 和 Enter。
sudo apt install debian-archive-keyring curl gnupg apt-transport-https
现在运行以下命令来添加 Sensu 仓库。此 bash 脚本将自动把 Sensu 仓库和 GPG key 添加到你的 Debian 服务器。
curl -s https://packagecloud.io/install/repositories/sensu/stable/script.deb.sh | sudo bash

如果你想手动添加 Sensu 仓库,请按照以下步骤操作:
创建一个 keyring 目录,用于存储 Sensu 仓库的 GPG key。
mkdir -p /etc/apt/keyrings/
curl -fsSL https://packagecloud.io/sensu/stable/gpgkey | gpg --dearmor > /etc/apt/keyrings/sensu_stable-archive-keyring.gpg
使用以下命令添加 Sensu 仓库。该仓库适用于 Debian 11 Bullseye 以及最新稳定版本的 Sensu。
cat <<EOF | sudo tee /etc/apt/sources.list.d/sensu_stable.list
deb [signed-by=/etc/apt/keyrings/sensu_stable-archive-keyring.gpg] https://packagecloud.io/sensu/stable/debian bullseye main
deb-src [signed-by=/etc/apt/keyrings/sensu_stable-archive-keyring.gpg] https://packagecloud.io/sensu/stable/debian bullseye main
EOF

现在你可以使用以下 apt 命令更新并刷新 Debian 软件包索引。
sudo apt update

安装 Sensu Backend
Sensu 监控解决方案的核心是一个 "Sensu Backend",它提供 HTTP API,管理员可通过 "sensuctl" 命令行使用;还提供供 "Sensu Agent" 用于监控的 WebSocket API,以及用于管理 Sensu 的 web UI 仪表板。
此外,Sensu 使用 " etcd " 来存储数据,尤其是在大型 Sensu Cluster 部署中。
要安装 Sensu Backend,运行下面的 apt 命令。安装将自动开始。
sudo apt install sensu-go-backend

安装完成后,将 Sensu backend 配置示例下载到 "/etc/sensu/backend.yml"。然后,使用以下命令编辑文件 "/etc/sensu/backend.yml"。
sudo curl -L https://docs.sensu.io/sensu-go/latest/files/backend.yml -o /etc/sensu/backend.yml
sudo nano /etc/sensu/backend.yml
取消以下配置的注释。
cache-dir: "/var/cache/sensu/sensu-backend" config-file: "/etc/sensu/backend.yml" log-level: "debug" state-dir: "/var/lib/sensu/sensu-backend"
完成后,保存并关闭文件。
接下来,运行以下 systemctl 命令来启动 Sensu Backend 服务并将其设为开机启用。Sensu Backend 服务将在系统启动时自动运行。
sudo systemctl start sensu-backend
sudo systemctl enable sensu-backend

使用下面的命令检查并验证 Sensu backend 服务。你应该会看到 Sensu Backend 服务当前正在运行且已启用。
sudo systemctl status sensu-backend

在 Sensu backend 运行之后,你现在将初始化 Sensu Backend 的安装和配置。这可以通过使用 Sensu Backend 软件包提供的命令行 "sensu-backend init" 来完成。
此外,在 Sensu Backend 初始化过程中,你将为你的 Sensu 监控解决方案设置管理员用户和密码。
运行以下命令,为 Sensu 管理员用户和密码创建新的系统环境变量。在本示例中,你将创建一个名为 " adminsensu "、密码为 " SensuRocks " 的新 Sensu 管理员用户。
export SENSU_BACKEND_CLUSTER_ADMIN_USERNAME=adminsensu
export SENSU_BACKEND_CLUSTER_ADMIN_PASSWORD=SensuRocks
现在使用下面的命令开始初始化 Sensu backend。你应该会看到初始化过程,Sensu 会将数据存储在 "etcd" 数据存储中。
sensu-backend init

要检查并验证你的 Sensu backend 安装,你将通过 curl 命令对运行在默认端口 "8080" 上的 Sensu HTTP API 执行 Sensu 健康检查。
运行下面的 curl 命令对你的 Sensu backend 安装执行健康检查。你应该会在终端屏幕上看到类似 " health: OK " 的输出消息。
curl http://127.0.0.1:8080/health

你也可以通过 TCP 端口 " 3000 " 访问 Sensu web UI 仪表板。打开你的 web 浏览器,访问你的服务器 IP 地址并跟上端口 3000(即:http://192.168.5.100:3000)。你应该会看到 Sensu 登录页面。
输入管理员用户 " adminsensu " 和密码 " SensuRocks "。然后点击 " SIGN-IN " 登录到 Sensu web UI 仪表板。

现在你应该会看到 Sensu web 管理仪表板。

安装 Sensuctl 命令行工具
在 Sensu 中,管理员可以通过 Sensu web UI 管理仪表板管理 Sensu 监控解决方案,也可以通过命令行终端使用 " sensuctl " 进行管理。
" sensuctl " 是一个用于管理 Sensu 资源的命令行工具。它使用 HTTP API 与 Sensu Backend 通信,使你能够创建、读取和删除资源、事件和实体。
" sensuctl " 可以安装在多种操作系统上,例如 Linux、Windows 和 macOS。"sensuctl" 的功能类似于 Sensu web UI 仪表板,你可以将其安装在本地工作站或基础设施中安全的 "bastion" 服务器上。
对于基于 Debian/Ubuntu 的系统,运行下面的 apt 命令来安装 " sensuctl " 命令行工具。安装将自动开始。
sudo apt install sensu-go-cli

安装完成后,运行以下 " sensuctl " 命令,开始配置并连接到 Sensu Backend 服务器的 API。
sensuctl configure
系统将提示你进行以下配置:
- 对于身份验证方式,选择 "username/password"。
- 输入你服务器的 Sensu Backend API URL。在本示例中,我们将在同一台服务器上设置 "sensuctl",因此主机为 localhost 或 "127.0.0.1"。Sensu HTTP API 的默认端口是 "8080" - http://127.0.0.1:8080。
- 对于 namespace 配置,选择 "default"。
- 对于输出格式,你可以选择 "tabular" 样式,或使用 "yaml" 输出格式。
- 最后,输入你的 Sensu Backend 的管理员用户和密码。
现在你已完成 " sensuctl " 的基本配置,并已连接到 Sensu Backend API 服务器。

运行下面的 " sensuctl " 命令来检查你的配置。你应该会看到 " sensuctl " 的详细 API 配置。
sensuctl config view

此外,"sensuctl" 还为你的 shell 提供自动补全功能。如果你使用 bash,需要安装 "bash-completion" 软件包,并在 " ~/.bashrc " 配置文件中添加一些配置。
运行以下 apt 命令来安装 "bash-completion" 软件包。
sudo apt install bash-completion
现在使用以下命令编辑 "~/.bashrc" 配置。
sudo nano ~/.bashrc
将以下配置添加到文件中。
if [ -f /usr/share/bash-completion/bash_completion ]; then . /usr/share/bash-completion/bash_completion elif [ -f /etc/bash_completion ]; then . /etc/bash_completion fi source <(sensuctl completion bash)
完成后,保存并关闭文件。
接下来,使用下面的命令重新加载当前 shell 会话。
source ~/.bashrc
最后,输入命令 " sensuctl " 并按 TAB 键以获取所有可用的命令选项。你应该会得到 " sensuctl " 命令的所有可用选项。
sensuctl TAB

安装 Sensu Agent
要使用 Sensu 监控主机或机器,你必须在所有主机上安装 Sensu Agent 软件包。Sensu Agent 几乎适用于所有 Linux 发行版和 Windows。
要在 Linux 系统上安装 Sensu Agent,请确保已添加 Sensu 仓库。
对于基于 Debian/Ubuntu 的系统,运行以下 apt 命令来安装 Sensu Agent 软件包。现在安装将开始。
sudo apt install sensu-go-agent
安装完成后,将 Sensu Agent 配置下载到 " /etc/sensu/agent.yml "。然后,使用下面的命令编辑配置 " /etc/sensu/agent.yml "。
sudo curl -L https://docs.sensu.io/sensu-go/latest/files/agent.yml -o /etc/sensu/agent.yml
sudo nano /etc/sensu/agent.yml
取消以下这些配置的注释。请务必将此处的 "name" 改为系统主机名,并将 " backend-url " 改为 Sensu Backend 服务器的 IP 地址。
在本示例中,我们将添加一台主机名为 " linux-host1 "、位于 " default " namespace 的 Debian 机器。此处的 Sensu Backend 服务器是 " 192.168.5.100 ",使用 Sensu Backend 的默认 WebSocket API 端口 " 8081 "。
name: "linux-host1" namespace: "default" ... backend-url: - "ws://192.168.5.100:8081" cache-dir: "/var/cache/sensu/sensu-agent" config-file: "/etc/sensu/agent.yml"
完成后,保存并关闭文件。
接下来,运行以下命令来启动 Sensu Agent 服务,并将其设为在系统启动时自动运行。
sudo systemctl start sensu-agent
sudo systemctl enable sensu-agent

现在运行以下命令来检查并验证 Sensu Agent 服务。你应该会看到 Sensu Agent 正在运行且已启用。
sudo systemctl status sensu-agent

接下来,回到你的 web 浏览器并选择 namespace " default "。你应该会看到新的实体主机 " linux-host1 " 已可用。
你也可以在终端命令行中使用如下的 " sensuctl " 命令进行检查。你应该会看到 agent " linux-host1 " 已添加到 Sensu 监控解决方案中。
sensuctl entity list --format tabular

使用 Checks 监控服务器资源
Sensu Agent 的作用只是为 agent 节点或目标服务器提供一条通过 WebSocket API 连接到 Sensu Backend 的通道。要监控服务器资源,例如 CPU 使用率、带宽使用率和磁盘使用率,你需要设置 "Subscription" 并在其之上创建一些 "Check"。然后,你可以向 Sensu Agent 或目标服务器添加多个 "Subscriptions"。
要使用 Sensu 监控服务器资源,你需要执行以下步骤:
- 创建 Subscription
- 注册 Sensu Runtime Assets
- 定义用于检查系统资源的 Checks 命令
在继续之前,运行以下 "sensuctl" 命令,为 " linux-host1 " 实体创建一个名为 " system " 的新 subscription。
sensuctl entity update linux-host1
系统将提示你回答以下问题:
- 对于 'Entity Class",保持默认值 " agent " 并按 ENTER。
- 对于 "Subscriptions",输入 subscription 的名称 " system " 并按 ENTER。

在 Sensu 中," Checks " 基本上只是定义了一个可用于监控服务器资源的命令。" Checks " 是你可以在 Sensu "Assets" 和 "Subscriptions" 之上定义的命令行,以满足你所有的监控需求。要创建 " Checks ",你将通过 "sensuctl" 命令设置动态 runtime assets。所有 Sensu "Assets" 都可以在 https://bonsai.sensu.io/ 上找到。
现在运行下面的 " sensuctl " 命令来创建并注册用于监控 CPU 使用率的 Sensu "Assets"。你应该会看到类似 "added asset: sensu/check-cpu-usage:0.2.2" 的输出消息。在本示例中,我们还使用 "-r" 选项将 asset 的默认名称重命名为 "check-cpu-usage"。
sensuctl asset add sensu/check-cpu-usage:0.2.2 -r check-cpu-usage

现在运行以下命令来检查 Sensu assets 列表。你应该会看到 asset " check-cpu-usage " 在 Sensu 中可用。
sensuctl asset list

接下来,运行以下命令来创建用于监控 CPU 使用率的 " Checks " 命令。在本示例中,你将创建一个名为 " check_cpu " 的新 check 命令,它将在 "system" subscription 上可用,并基于 asset " check-cpu-usage "。你也可以在 "--command" 选项中修改此处的参数。你应该会得到类似 " Created " 的输出消息。
sensuctl check create check_cpu \
--command 'check-cpu-usage -w 75 -c 90' \
--interval 60 \
--subscriptions system \
--runtime-assets check-cpu-usage
运行以下 " sensuctl " 命令来检查并验证 " check_cpu "。你应该会看到刚创建的 " check_cpu " 的 " Checks " 详细信息。
sensuctl check info check_cpu --format yaml

现在你可以使用下面的命令验证 " check_cpu " 的事件监控。你应该会看到 " linux-host1 " 的 CPU 使用率监控已配置完成。
sensuctl event list --format tabular

现在转到 Sensu 管理仪表板并选择 " default " namespace。在 " Entity " 菜单上,你应该会看到 " linux-host1 " agent 已添加到 Sensu 监控系统中。

现在如果你点击 " linux-host1 " agent 的详细信息,你将看到刚创建的 " Checks " 监控 " check_cpu "。

接下来,你可以为你的监控系统添加并创建更多 "Checks"。
结论
你现在已经在 Debian 11 服务器上完成了 Sensu 监控解决方案的安装。你还学习了用于管理 Sensu backend 的 Sensuctl 命令的基本用法。此外,你已通过 Sensu Agent 成功监控了 Linux 主机,并设置了用于监控目标服务器的 "checks"。