概述

ZStack Cloud支持添加日志服务器至云平台，通过该日志服务器，用户可便捷收集管理节点日志，快速定位问题，提高云平台运维效率。

Note: 需要日志服务器中已安装

syslog
                    server

，才能使用该功能。

工作原理

ZStack Cloud支持按照已设置的日志级别，通过日志服务器中的syslog server收集所有管理节点日志并储存。

注意事项

需要设置日志级别与日志服务器的配置完全一致，才能正常接收日志信息，日志级别支持设置LOCAL0-7，仅为了匹配日志服务器，无高低之分。
需确保云平台管理节点与日志服务器的连通性。
配置成功后，管理节点的全部日志均会发送至日志服务器，不区分DEBUG、INFO、ERROR等输出级别。
仅admin/平台管理员支持设置日志服务器。

准备工作

本教程假定用户已安装最新版本ZStack Cloud，并部署完成必要的资源。
详情可参考《用户手册》的安装部署章节。
本教程将从添加日志服务器的步骤开始，详细介绍日志服务器功能的使用方法。
用户需提前准备好日志服务器，用于储存管理节点的日志信息。

典型场景实践

日志服务器记录管理节点日志

背景信息

假定某用户需要使用日志服务器收集管理节点的日志信息，用于分析云平台健康状态，可使用以下方案。

用户需要部署一套最新的ZStack Cloud环境。

具体流程如下：

在日志服务器中配置syslog server。
在云平台创建日志服务器。
验证日志服务器。

操作步骤

在日志服务器中配置syslog server。
用户需提前准备好用于接收日志信息的日志服务器，并确保日志服务器中已安装syslog server。
- 在日志服务器中进行以下配置：
  1. 进入/etc/rsyslog.conf文件，找到以下命令行：
    #$ModLoad imudp #$UDPServerRun 514
    修改为以下内容，表示开启UDP配置：
    $ModLoad imudp $UDPServerRun 514
  2. 新增以下命令行，表示设置日志级别为LOCAL1（可配置任意日志级别，本场景以LOCAL1为例）：
    local1.* /var/log/test.log
  3. 配置完成后保存，并使用以下命令重启syslog服务：
    systemctl restart rsyslog
  如图 1所示：
  图 1. 配置syslog server
Note: 如在云平台创建日志服务器过程UI界面报错日志服务器不可达，则需在日志服务器执行命令行开启7/tcp端口监听Inet Address isReachable：
```
iptables -I INPUT -p tcp --dport 7 -j ACCEPT
```
或执行：
```
firewall-cmd --zone=public --add-port=7/tcp --permanent
```
在云平台创建日志服务器。
在ZStack Cloud主菜单，点击设置 > 系统设置 > 日志服务器按钮，进入日志服务器界面，点击添加日志服务器按钮，参考以下内容进行配置：
- 名称：设置日志服务器名称
- 简介：可选项，可留空不填
- IP地址：输入日志服务器的IP地址
- UDP端口：输入为UDP协议提供服务的端口，在上一步中可获取到端口为514
- 日志级别：选择需要接收的日志级别，本示例设置为LOCAL1
  Note: 需要设置日志级别与日志服务器的配置完全一致，才能正常接收日志信息。
- 测试连接：检测IP地址的连通性
  Note:
  
  若无法连通，请检查IP地址是否输入正确、网络是否正常、以及设置的日志级别是否与日志服务器的配置完全一致。
  
  请按实际情况填写相关信息，如有疑问请联系相关日志服务器提供商。
如图 2所示：
图 2. 添加日志服务器
验证日志服务器。
配置完成后，在日志服务器中输入以下命令，查看是否已正常获取管理节点日志：
```
cat /var/log/test.log
```
如图 3所示：
图 3. 获取管理节点日志

如上所述，日志服务器已成功接收到管理节点日志信息，日志服务器配置生效。

上一篇账户管理使用教程下一篇自定义主题外观配置教程