Zabbix Server

自动伸缩支持 # 进阶

AWS 自动伸缩如何与 Zabbix 协同工作？

要在 Zabbix 中处理自动伸缩，需要考虑三件事：

1. 实例出现时把它加入 Zabbix。 可以用主动式 Zabbix agent 的自动注册来实现（6.4、6.0、4.0）。这样新实例出现时，Zabbix 会自动把它添加为新主机。
2. 把实例 ID 存入 Zabbix 资产清单。 实例消失（scale in）时我们会收到带有其 ID 的消息，因此需要在主机清单里保存这个 ID，才能查找并删除对应主机。
3. 接收 AWS 的伸缩消息。 发生伸缩事件时，AWS 会向你定义的 SNS 主题发布消息。把该主题接到 SQS 队列，我们就能从 Zabbix 读取消息，删除退出伸缩组的实例。

配置客户端

让客户端支持 Zabbix 自动伸缩需要两步：配置 Zabbix agent，并添加一个为 instance_id 监控项提供数据的用户参数文件。

Zabbix agent 配置

除了你可能需要的其他改动，Zabbix agent 的本地配置文件（通常是 /etc/zabbix/zabbix_agentd.conf）需要修改六处：

• 注释掉 Server 选项。
• 添加 ServerActive=YOUR__ZABBIX__IP__ADDRESS 以配置主动模式服务器。
• 注释掉 Hostname 选项。
• 把 StartAgents 设为 0。
• 把 HostnameItem 设为 system.hostname。
• 把 HostMetadataItem 设为 system.uname。

这样配置后，Zabbix 客户端工作在主动模式（由客户端向服务器推送信息，而不是接受服务器的检查）。同时让 Zabbix 用机器名作为主机名，省去每次新服务器启动时都要改名。最后，让 Zabbix 把 uname 的输出作为主机元数据发送：AWS 实例使用特殊内核，其中会出现 aws 字样，可用于注册服务器。

instance_id 参数

默认情况下，自动伸缩产生的新服务器在 Zabbix 中会关联到名为 AWS EC2 Template 的特殊模板，其中的 instance_id 监控项与资产清单的 alias 字段绑定。为它提供数据，需要在 Zabbix 客户端上创建如下文件添加用户参数：

UserParameter=aws.ec2.instance_id,curl -s http://169.254.169.254/latest/meta-data/instance-id

配置服务器

客户端配置完成后，下一步是让服务器删除已被移除的实例。最快最简单的做法分两步：把伸缩消息发送到 SQS 队列，并配置服务器读取该队列。

把伸缩消息发送到 SQS 队列

我们希望自动伸缩服务发出的通知保存在 SQS 队列中，以获得持久性与扩展性。由于 AWS 自动伸缩把通知发布到 SNS 主题，我们需要：

• 创建一个 SNS 主题。
• 创建一个 SQS 队列。
• 配置 SNS 把消息投递到 SQS。
• 创建一个可以读取消息的 IAM 用户。

由于这类配置比较繁琐，你可以用我们的 CloudFormation 模板栈在任意区域一次创建全部资源。部署完成后，Outputs 标签页会给出四个需要记录的值：

• SNSTopicARN：所创建 SNS 主题的 ARN。
• SQSQueueURL：SQS 队列的 URL。
• SQSReadIAMUserAccessKey 与 SQSReadIAMUserSecretKey：IAM 用户的密钥与密钥串。

配置时需要这些值。编辑 /etc/zabbix/zabbix_ami.yml，找到类似下面的代码块：

sqs:
  delay_seconds: 60
  default_region: us-east-1
  queues:
    - url:
      access_key_id:
      secret_access_key:
      region:

每个带伸缩通知的 SQS 队列，都按已有条目的样子在数组中新增一项，填入 CloudFormation 给出的值。关于这个文件的更多说明见重要文件一节。

重要文件 # 进阶

Zabbix 镜像里有几个你应当了解的特殊文件。

/etc/zabbix/zabbix_ami.yml

这是最重要的一个文件，它掌管着伸缩检查、SNS 通知等特色功能的配置。示例如下（数据为虚构）：

zabbix:
  api:
    user: autoscaler_api_user
    password: i-073672daf01037aea94
sns:
  aws:
    access_key_id: AKK4L6A3OXZZ5HE2POQRU7V
    secret_access_key: cICycAg26hSDpsJwbhZjbaaYlt4Tz3n1xqE7Oxp6X2Hf
    region: us-east-1
  topics:
    not_classified: arn:aws:sns:us-east-1:000000000:Zabbix-General-SNS
    information:    arn:aws:sns:us-east-1:000000000:Zabbix-General-SNS
    warning:        arn:aws:sns:us-east-1:000000000:Zabbix-General-SNS
    average:        arn:aws:sns:us-east-1:000000000:Zabbix-General-SNS
    high:           arn:aws:sns:us-east-1:000000000:Zabbix-General-SNS
    disaster:       arn:aws:sns:us-east-1:000000000:Zabbix-General-SNS
sqs:
  delay_seconds: 60
  default_region: us-east-1
  queues:
    - url: https://sqs.us-east-1.amazonaws.com/000000000/zabbix-pro-sqs-queue
      access_key_id: AKIA3OXZZ5HEWUR5A16CNWH
      secret_access_key: 8ttYO3Ba9K6p0C+aj3fH5cDt2eRLHmlkHbMtlrpv18S7KRbC
      region: us-east-1

目前该文件分为三部分：

• zabbix：删除过期主机需要连接 Zabbix 服务器，因此要有 API 访问权限。我们会为此创建专用用户，其连接信息写在这里。
• sns：通过 SNS 发送告警所需的配置。这里设置 IAM 用户信息和将要使用的 SNS 主题。
• sqs：处理 AWS 伸缩消息的配置。这里定义队列的轮询间隔（delay_seconds）以及要检查的各个队列。

/var/log/zabbix-sqs-reader/zabbix-sqs-reader.log

该文件记录从 SQS 读取到的各类自动伸缩事件。

完成配置之前，你会看到消息 Ops! It looks like the file /etc/zabbix/zabbix_ami.yml hasn't been configured yet. We better sleep for 5 minutes.——这是正常的，配置好 zabbix_ami.yml 后就会消失。

镜像更新 # 进阶

Zabbix 会不断发布带来新功能与改进的新版本，因此最好定期更新我们的镜像。遗憾的是，这些新特性往往伴随数据库与内部结构的变化，升级既有安装时可能带来麻烦。

我们的 Zabbix 镜像正是规避这些问题的最佳方式：我们提供了一条比常规做法更快、更简单也更安全的大版本升级路径。

升级概览

我们镜像的升级流程相当简单：

• 导出当前数据库。
• 用最新稳定版本启动一个新镜像。
• 把数据库导出文件上传到新实例。
• 运行我们的迁移脚本。

这样新旧两个版本可以同时运行，你可以充分测试，确认一切正常后再迁移该实例的 EIP，或逐步切换客户端。

升级流程

第 1 步：备份源端服务器

第一步是为源端服务器创建镜像，以免意外丢失数据。可参考 AWS 创建 AMI 的文档。

第 2 步：导出数据库并记录 Zabbix 版本

通过 SSH 登录实例并切换到 root：

sudo /bin/su -

随后把数据库导出到文件：

mysqldump zabbix > zabbix_origin_database.sql

最后把该文件下载到本机，以便稍后上传到新服务器。同时记录当前使用的 Zabbix 版本：在 Web 界面即可看到，形如 4.0、4.2、4.4 或 5.4。

第 3 步：启动新的 Zabbix 实例

下一步是用最新稳定版镜像创建新的 Zabbix 实例，可在我们的 AWS Marketplace 卖家主页找到。至少需要使用我们 Zabbix 镜像的 6.0 版本。

这个新实例就是我们迁移数据的目标端，它已经预装并更新到最新版本。启动之后，把源端服务器的数据库导出文件复制上去。

第 4 步：升级数据库

要导入现有数据库、升级到新版本并补齐必要配置，使用脚本 /opt/tools/bin/zabbix-ami-upgrade.sh。以 ubuntu 用户运行，并传入原 Zabbix 版本和导出文件。例如从 Zabbix 4.0 迁移：

/opt/tools/bin/zabbix-ami-upgrade.sh 4.0 zabbix_origin_database.sql

过程中会逐步提示所执行的操作，结束后即可继续使用新的 Zabbix 服务器。

第 5 步：访问 Web 界面

迁移完成后即可打开 Web 界面查看服务器的整体状况。注意：需要使用与原服务器相同的用户名和密码。

第 6 步：迁移特殊配置并切换客户端

数据库可用之后，还要考虑此前可能安装在服务器上的其他配置，例如：

• 监控脚本。
• 额外的系统软件包。
• 已安装的 SSL 证书。

还需要把为该实例配置的 EIP 迁移过来，这样客户端就无需改动。

如果尚未使用 EIP，现在是开始使用的好时机；否则你必须在所有客户端上修改新服务器的 IP。