[comment]: # translation:outdated

[comment]: # ({49147b90-35f3262a})
# Zabbix agent 模板操作

下面步骤确保当前操作模板能通过 [Zabbix
agent](/zh/manual/concepts/agent)正常收集监控对象数据:

1\. 请确保主机上已安装Zabbix agent。Zabbix agent active
模式检查，确保主机ip信息填写入参数 'ServerActive'在 Zabbix agent
配置文件中 [配置文件](/zh/manual/appendix/config/zabbix_agentd).\
2. [链接](/zh/manual/config/templates/linking#linking_a_template)
将模板关联上目标主机
(如果在Zabbix中没有agent可用的模板，您可能需要首先导入模板的.xml文件-参见
- 看 [开箱即用的模板](/zh/manual/config/templates_out_of_the_box)
说明部分).\
3. 根据提示修改强制宏值修改。\
4. 配置监控对象实例允许zabbix去获取数据 -
请参阅附加步骤/注释栏中的说明。

::: notetip
 本页仅包含适当模板操作所需的最小宏集和设置步骤。
模板的详细描述，包括宏、项和触发器的完整列表，都可以在模板中找到
Readme.md 文件 (点击模板名称即可访问). 
:::

|模板名称                                                                                                                                                                                                                                                                                              必要宏|额外的步骤/|明|
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------|---|
|[Microsoft Exchange Server 2016 by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/exchange/README.md)/[Microsoft Exchange Server 2016 by Zabbix agent active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/exchange_active/README.md)|<|Note, 模板没有提供关于Windows服务状态的信息。建议配合使用 *OS Windows by Zabbix agent* 或者 *OS Windows by Zabbix agent active* 模板.|
|[Template App Apache by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/apache_agent/README.md)|**{$APACHE.STATUS.HOST}** - Apache状态页面的主机名或IP地址(默认: 127.0.0.1)\                                                       应该设置Apache模块**{$APACHE.STATUS.PATH}** - URL 路径 (默认: server-status?auto)\                                                                   检查可**{$APACHE.STATUS.PORT}** - Apache状态页面的端口 (默认: 80)                                                                        `httpd -|mod 状态(通过 Apache [文档](https://httpd.apache.org/docs/current/mod/mod_status.html) 查看详情).<br>性, 运行:<br>2>/dev/null \| grep status_module`<br><br>Apache配置示例:<br>`<Location "/server-status">`<br>`SetHandler server-status`<br>`Require host example.com`<br>`</Location>`|
|[Template App HAProxy by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/haproxy_agent/README.md)|**{$HAPROXY.STATS.PATH}** - HAProxy统计页面的路径 (默认: stats)\                                                                   应该设置启用HA**{$HAPROXY.STATS.PORT}** - HAProxy的端口统计主机或容器 (默认: 8404)<br>**{$HAPROXY.STATS.SCHEME}** - HAProxy的scheme统计页面. 支持协议: http (默认), https|roxy统计页面 (通过HAProxy [博客](https://www.haproxy.com/blog/exploring-the-haproxy-stats-page/)查看详细信息或模板的 README.md 配置示例).|
|[Template App IIS by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/iis_agent) / [Template App IIS by Zabbix agent active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/iis_agent_active/README.md)|**{$IIS.PORT}** - IIS Server 监听端口 (默认: 80)\                                                                                  服务应该遵**{$IIS.SERVICE}** -端口检查服务 (默认: http)。查看 [net.tcp.service](/zh/manual/config/items/itemtypes/simple_checks) 更多细节.   [Web Server](h|以下规则:<br>tps://docs.microsoft.com/en-us/iis/web-hosting/web-server-for-shared-hosting/installing-the-web-server-role)<br>[IIS Management Scripts and Tools](https://docs.microsoft.com/en-us/iis/manage/scripting/managing-applications-and-application-pools-on-iis-with-wmi)<br><br>更多详细内容轻擦好看IIS 文档。|
|[Template App Nginx by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_agent/README.md)|**{$NGINX.STUB\_STATUS.HOST}** - 主机名或者IP地址 是 Nginx stub\_status系统主机或者容器 (默认: localhost)\                         `ngx_http_stub_st**{$NGINX.STUB\_STATUS.PATH}** - Nginx stub\_status 页面路径 (默认: basic\_status)\                                                检查可用性**{$NGINX.STUB\_STATUS.PORT}** - Nginx stub\_status主机或容器的端口 (默认: 80)                                                     `nginx -V|tus_module` 需要被设置 (更多信息请查看Nginx [文档](https://nginx.org/en/docs/http/ngx_http_stub_status_module.html) 或者 模板的 Readme.md 对于配置示例).<br>运行:<br>2>&1 \| grep -o with-http_stub_status_module`|
|[Template App PHP-FPM by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/php-fpm_agent/README.md)|**{$PHP\_FPM.HOST}** - PHP-FPM状态主机或容器的主机名或IP (默认: `localhost`)\                                                      1\. 打开php-fpm**{$PHP\_FPM.PING.PAGE}** - PHP-FPM ping 页面路径 (默认:`ping`)\                                                                   `pm.s**{$PHP\_FPM.PORT}** - PHP-FPM状态主机或容器的端口 (默认: `80`)\                                                                   `ping.path**{$PHP\_FPM.PROCESS\_NAME}** - PHP-FPM 进程名称 (默认:`php-fpm`)\                                                                 <br>**{$PHP\_FPM.STATUS.PAGE}** - PHP-FPM 状态页面路径 (默认:`status`)                                                                 2. 验证命令|置文件并启用状态页面:<br>atus_path = /status`<br>/ping`<br>查格式: `$ php-fpm7 -t`<br><br>3. 重新加载 php-fpm 服务.<br><br>4. 在Nginx配置文件server块(虚拟主机) , 添加 (更多信息请查看模板 *Readme.md* 带有注释的扩展示例):<br>`location ~ ^/(status\|ping)$ {`<br>`access_log off;`<br>`fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;`<br>`fastcgi_index index.php;`<br>`include fastcgi_params;`<br>`fastcgi_pass 127.0.0.1:9000;`<br>`}`<br><br>5. 命令检查配置文件格式: `$ nginx -t`<br><br>6. 重新加载Nginx<br><br>7. 验证: `curl -L 127.0.0.1/status`|
|[Template App RabbitMQ cluster by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/rabbitmq_agent)|**{$RABBITMQ.API.CLUSTER\_HOST}** - RabbitMQ集群API端点的主机名或IP地址 (默认:`127.0.0.1`)\                                        启用RabbitMQ管理**{$RABBITMQ.API.USER}**, **{$RABBITMQ.API.PASSWORD}** -RabbitMQ登录凭证 (默认username: zbx\_monitor, password: zabbix)            <br>|件 (see [RabbitMQ 文档](https://www.rabbitmq.com/management.html)).<br>创建一个RabbitMQ用户，该用户具有nessesary的监控权限, 运行:<br>'' rabbitmqctl add\_user zbx\_monitor <PASSWORD> ''<br>`rabbitmqctl set_permissions -p / zbx_monitor %% "" "" ".*"%%`<br>`rabbitmqctl set_user_tags zbx_monitor monitoring`<br><br>如果集群由多个节点组成, 建议将集群模板单独分配到其中的一台监控主机上。 单节点安装时，可将集群模板分配给已安装节点模板的主机。|
|[Template DB MySQL](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_agent/README.md)|**{$MYSQL.HOST}** - MySQL主机或容器的主机名或IP地址 (默认: localhost)\                                                             1\. 如果需要，将mys**{$MYSQL.PORT}** - 数据库服务端口 (默认: 3306)                                                                                    <br>|l和mysqladmin实用程序的路径添加到全局环境变量PATH中。<br>2. 复制 `template_db_mysql.conf` 文件从 *templates* 将Zabbix的目录放入Zabbix代理配置的文件夹中 (/etc/zabbix/zabbix\_agentd.d/ by 默认) 然后重启Zabbix agent.<br><br>3. 创建 MySQL 用户 `zbx_monitor`. 将所需的权限授予用户, 运行:<br>`GRANT USAGE,REPLICATION CLIENT,PROCESS,SHOW DATABASES,SHOW VIEW ON %% *.* TO '<username>'@'%';%%`<br>(访问[MYSQL 文档](https://dev.mysql.com/doc/refman/8.0/en/grant.html)查看更多信息).<br><br>4. 创建`.my.cnf` 在Zabbix agent 主目录下 Linux版本 (/var/lib/zabbix by 默认 ) 或者 `my.cnf` 在 c:\\ windows版本. 该文件必须有三个字符串:<br>`[client]`<br>''user='zbx\_monitor' ''<br>''password='<password>' ''|
|[Template DB PostgreSQL](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql/README.md)|**{$PG.DB}** - 库名去连接 postgres数据库服务 (默认: postgres)\                                                                     1\. 创建一个只读用**{$PG.HOST}** - 数据库主机地址或者socket目录 (默认:127.0.0.1)\                                                                    `CREATE USER**{$PG.PORT}** - 数据库服务端口 (默认: 5432)\                                                                                      `GRANT p**{$PG.USER}** - 数据库用户名 (默认: zbx\_monitor)                                                                                 For old|`zbx_monitor` 可以正常访问PostgreSQL服务器。 适用于PostgreSQL 10及更新版本, 运行:<br>zbx_monitor WITH PASSWORD '<PASSWORD>' INHERIT;`<br>_monitor TO zbx_monitor;`<br>r PostgreSQL versions, run:<br>`CREATE USER zbx_monitor WITH PASSWORD '<PASSWORD>';`<br>`GRANT SELECT ON pg_stat_database TO zbx_monitor;`<br><br>2. 复制 `postgresql/` 到 Zabbix agent 主目录下 (/var/lib/zabbix/).<br><br>3. 复制 `template_db_postgresql.conf` 从Zabbix的 *templates* 目录到Zabbix agent 配置目录 (/etc/zabbix/zabbix\_agentd.d/) and restart Zabbix agent.<br><br>4. 编辑 `pg_hba.conf` 允许从Zabbix agent连接 (访问[PostgreSQL 文档](https://www.postgresql.org/docs/current/auth-pg-hba-conf.html)查看更多详情).<br>配置行样例:<br>`host all zbx_monitor 127.0.0.1/32 trust`<br>`host all zbx_monitor 0.0.0.0/0 md5`<br>`host all zbx_monitor ::0/0 md5`<br><br>5. 监控远程服务, 创建一个 `.pgpass` Zabbix agent 主目录下的文件 (/var/lib/zabbix/) 并使用实例添加行, 端口, 数据库名, 用户 和 密码 信息 (访问 [PostgreSQL文档](https://www.postgresql.org/docs/current/libpq-pgpass.html)查看更多详情).<br>配置行样例:<br>`<REMOTE_HOST1>:5432:postgres:zbx_monitor:<PASSWORD>`<br>`*:5432:postgres:zbx_monitor:<PASSWORD>`|

[comment]: # ({/49147b90-35f3262a})
