本页内容

  • 前提条件
  • 添加 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

在 Debian 11 系统上完整安装 Sensu 监控解决方案教程

如果你想手动添加 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

在 Debian 11 系统上完整安装 Sensu 监控解决方案教程

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

sudo apt update

在 Debian 11 系统上完整安装 Sensu 监控解决方案教程

安装 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

在 Debian 11 系统上完整安装 Sensu 监控解决方案教程

安装完成后,将 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

在 Debian 11 系统上完整安装 Sensu 监控解决方案教程

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

sudo systemctl status sensu-backend

在 Debian 11 系统上完整安装 Sensu 监控解决方案教程

在 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

在 Debian 11 系统上完整安装 Sensu 监控解决方案教程

要检查并验证你的 Sensu backend 安装,你将通过 curl 命令对运行在默认端口 "8080" 上的 Sensu HTTP API 执行 Sensu 健康检查。

运行下面的 curl 命令对你的 Sensu backend 安装执行健康检查。你应该会在终端屏幕上看到类似 " health: OK " 的输出消息。

curl http://127.0.0.1:8080/health

在 Debian 11 系统上完整安装 Sensu 监控解决方案教程

你也可以通过 TCP 端口 " 3000 " 访问 Sensu web UI 仪表板。打开你的 web 浏览器,访问你的服务器 IP 地址并跟上端口 3000(即:http://192.168.5.100:3000)。你应该会看到 Sensu 登录页面。

输入管理员用户 " adminsensu " 和密码 " SensuRocks "。然后点击 " SIGN-IN " 登录到 Sensu web UI 仪表板。

在 Debian 11 系统上完整安装 Sensu 监控解决方案教程

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

在 Debian 11 系统上完整安装 Sensu 监控解决方案教程

安装 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

在 Debian 11 系统上完整安装 Sensu 监控解决方案教程

安装完成后,运行以下 " 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 服务器。

在 Debian 11 系统上完整安装 Sensu 监控解决方案教程

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

sensuctl config view

在 Debian 11 系统上完整安装 Sensu 监控解决方案教程

此外,"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

在 Debian 11 系统上完整安装 Sensu 监控解决方案教程

安装 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

在 Debian 11 系统上完整安装 Sensu 监控解决方案教程

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

sudo systemctl status sensu-agent

在 Debian 11 系统上完整安装 Sensu 监控解决方案教程

接下来,回到你的 web 浏览器并选择 namespace " default "。你应该会看到新的实体主机 " linux-host1 " 已可用。

你也可以在终端命令行中使用如下的 " sensuctl " 命令进行检查。你应该会看到 agent " linux-host1 " 已添加到 Sensu 监控解决方案中。

sensuctl entity list --format tabular

在 Debian 11 系统上完整安装 Sensu 监控解决方案教程

使用 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。

在 Debian 11 系统上完整安装 Sensu 监控解决方案教程

在 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

在 Debian 11 系统上完整安装 Sensu 监控解决方案教程

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

sensuctl asset list

在 Debian 11 系统上完整安装 Sensu 监控解决方案教程

接下来,运行以下命令来创建用于监控 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

在 Debian 11 系统上完整安装 Sensu 监控解决方案教程

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

sensuctl event list --format tabular

在 Debian 11 系统上完整安装 Sensu 监控解决方案教程

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

在 Debian 11 系统上完整安装 Sensu 监控解决方案教程

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

在 Debian 11 系统上完整安装 Sensu 监控解决方案教程

接下来,你可以为你的监控系统添加并创建更多 "Checks"。

结论

你现在已经在 Debian 11 服务器上完成了 Sensu 监控解决方案的安装。你还学习了用于管理 Sensu backend 的 Sensuctl 命令的基本用法。此外,你已通过 Sensu Agent 成功监控了 Linux 主机,并设置了用于监控目标服务器的 "checks"。