审计代理插件（Agent）是安装在数据库系统或者业务系统上的插件，其功能是捕获访问数据库系统的数据包，并将数据包发送至天翼云数据库审计。当数据库系统部署在公有云、私有云或者实际场景下无法进行端口镜像时，可以通过流量代理的方式抓取数据库流量。

Agent支持的操作系统版本请参考使用限制。

Agent工作原理

• Agent在数据库服务器的接口上抓取属于资产下发的IP+Port 的数据库操作的流量。
• Agent 包含两个进程：dbagent.exe 和 dbMonitor.exe。DBAgent与天翼云数据库审计的13002端口建立连接负责流量转发，DBMonitor与天翼云数据库审计的13001端口建立连接负责控制部分，包含接收天翼云数据库审计下发的资产和其他配置。

通过SSH远程安装Agent

您可以通过SSH协议将Agent自动安装到需要审计的服务器上，目前仅支持Linux系统。

在界面上输入需要审计的服务器IP、SSH端口、root用户名、密码，天翼云数据库审计通过scp协议将agent安装包传输到宿主机上并自动安装。

1.在菜单栏选择“系统管理 > Agent管理”进入“Agent管理”页面，选择“Agent安装”页签。

2.单击“开始安装”进入通过SSH远程安装Agent页面，编辑审计服务器IP，并添加安装Agent的服务器，单击“安装”。填写参数说明请参见下表

说明
单击“安装状态”可进入“安装状态”查看页面，可进行以下操作：
单击“卸载”可远程卸载已经成功安装了的Agent。
单击“重新安装”可对未成功安装Agent的服务器重新安装。
将光标悬停至“安装失败”后的图标，查看安装失败原因。

手动安装Agent

您可手动下载Agent安装包，并将其手动安装到需要审计的服务器上。目前支持Windows系统和部分Linux系统，支持的操作系统可查看使用限制章节。

使用Linux系统安装Agent

1.在左侧菜单栏选择“系统管理 > Agent管理”进入“Agent管理”页面，选择“Agent安装”页签，点击下载对应版本的Agent安装包。

注意
下载的Agent默认会将流量转发给当前的天翼云数据库审计实例。如需转发到其他天翼云数据库审计实例，请在解压后的Agent路径下agent.ini配置文件中找到serviceIp选项进行地址修改。
无论是Linux版本安装包、AIX版本安装包还是Windows版本安装包，文件夹中均有“ReadMe”文档，文档内包含使用说明、文件说明、注意事项、运行环境说明、配置文件说明。在安装前请仔细阅读该文档并严格按照要求进行操作。

2.安装包下载完之后，将Agent安装包上传到Linux服务器指定目录。

说明
禁止直接运行二进制文件。
解压目录不能出现空格。
每次更换运行或解压目录需重新运行安装脚本。
Linux环境需以root用户运行脚本，指定解释器bash，或不指定解释器直接运行。

3.使用 tar –xf dbAgent_V2.28.tar.gz命令解压Agent安装包，进入Agent安装目录。

4.在安装目录执行 ./install.sh命令即可安装Agent程序。

使用Windows系统安装Agent

1.在左侧菜单栏选择“系统管理 > Agent管理”进入“Agent管理”页面，选择“Agent安装”页签，点击下载对应版本的Agent安装包。

注意
下载的Agent默认会将流量转发给当前的天翼云数据库审计实例。如需转发到其他天翼云数据库审计实例，请在解压后的Agent路径下agent.ini配置文件中找到serviceIp选项进行地址修改。
无论是Linux版本安装包、AIX版本安装包还是Windows版本安装包，文件夹中均有“ReadMe”文档，文档内包含使用说明、文件说明、注意事项、运行环境说明、配置文件说明。在安装前请仔细阅读该文档并严格按照要求进行操作。

2.安装包下载完成之后，将Agent安装包上传到Windows服务器上。

3.解压压缩包到指定运行目录。在Agent的安装目录以管理员身份运行“dbAgent-setup.exe”进入安装向导，单击“下一步”。

4.单击“下一步”之后显示“Install winpcap”和“Install npcap”两个选项，根据实际需求选择完成后单击“下一步”。

说明
如果没有本地审计的需求请选择“Install winpcap”；
如果需要部署本地审计，则选择“Install npcap”。
默认推荐使用“Install winpcap”安装方式，对于Windows操作系统的兼容性较好。
“Data encrypted transmission”仅需要配置agent数据传输加密情况下才需要勾选。

5.单击“安装”。

6.点击“I Agree”同意安装协议后，之后按照提示进行操作。

说明
由于第四步选择的差异，“Wincap”和“Npcap”安装操作选项会有些许差别。
“Wincap”插件根据默认选择安装即可。
“Npcap”插件需要选择Legacy loopback support for Nmap 7,80 and older , Not needed for Wireshark. 和 Install Npcap in WinPcap API-compatible Mode. 两个选项。

7.安装完成后点击“完成”退出安装向导。

监控Agent状态

在“Agent管理”页面，在已安装Agent列表的操作列下点击“监控”进入“Agent监控信息”页面，用户可以根据需要设置监控的时段，或者选择不同的监控指标（CPU占用、内存占用、转发速率、丢包数量、磁盘读写）。

修改Agent配置

1.在“Agent管理”页面，选择需要修改配置的Agent，在列表中单击“操作”列中的“配置”。

2.弹出修改配置对话框，可根据需要修改相关参数，修改完成后单击“确定”，各配置项参数请参见下表。

Agent标签管理

1.在“Agent管理”页面，点击标签显示列对应区域。

2.选择标签或者输入新的标签点击阅读即可完成标签添加。

3.对应已经有标签的Agent，可以点击“X”移除该标签。

其他操作