zabbix小结(十五)Hostname与HostMetadata相关项详解

2019年2月14日 发表评论 阅读评论

在zabbix agent端有四项比较神似的四个配置项:Hostname、HostnameItem、HostMetadata、HostMetadataItem 。本篇就作为一个单独的篇幅说下这四项。先看下官方给出的解释。

### Option: Hostname
#       Unique, case sensitive hostname.
#       Required for active checks and must match hostname as configured on the server.
#       Value is acquired from HostnameItem if undefined.
#
# Mandatory: no
# Default:
# Hostname=
### Option: HostnameItem
#       Item used for generating Hostname if it is undefined. Ignored if Hostname is defined.
#       Does not support UserParameters or aliases.
#
# Mandatory: no
# Default:
# HostnameItem=system.hostname
### Option: HostMetadata
#       Optional parameter that defines host metadata.
#       Host metadata is used at host auto-registration process.
#       An agent will issue an error and not start if the value is over limit of 255 characters.
#       If not defined, value will be acquired from HostMetadataItem.
#
# Mandatory: no
# Range: 0-255 characters
# Default:
# HostMetadata=
### Option: HostMetadataItem
#       Optional parameter that defines an item used for getting host metadata.
#       Host metadata is used at host auto-registration process.
#       During an auto-registration request an agent will log a warning message if
#       the value returned by specified item is over limit of 255 characters.
#       This option is only used when HostMetadata is not defined.
#
# Mandatory: no
# Default:
# HostMetadataItem=

其实官方的说明还是比较清晰的。

一、hostname与HostnameItem

这部分在上一篇 zabbix小结(十三)zabbix自动注册 中也提过了。这两者之间是冲突的,当配置了Hostname了以后,再使用HostnameItem时,在启动zabbix agent服务时会出现如下信息:Starting Zabbix agent: zabbix_agentd [21988]: Warning: both Hostname and HostnameItem defined, using [www.361way.com]

接下来说下两者之间的区别。

  • Hostname 在主动模式(对于agent而言的,agent主动)时,会和服务器之间对Hostname信息,即web端配置的名称要和这个名称一致,才会成功。在使用被动模式时,实际上该参数是没用的。但该项配置后主机名称是固定的,比如 Hostname=www.361way.com;
  • HostnameItem 作用其实和Hostname是一样的,不过该项是动态的,其支持通过key进行配置,如system.hostname 。当然也支持其他key,只要是zabbix_get能正常取的数据的key理论都是支持的,但并不表示都能用,比如将HostnameItem的值设置为system.uname时,在启动时就报了里面使用特殊字符#,这是不允许的。

Starting Zabbix agent: zabbix_agentd [28795]: ERROR: invalid "Hostname" configuration parameter:
'Linux www.361way.com 2.6.32-431.el6.x86_64 #1 SMP Fri Nov 22 03:15:09 UTC 2013 x86_64': name contains invalid character '#'

有人说这不是重复功能吗?因为默认情况下监控用的主机名一般都是system.hostname。实际上官方是有一些考量的,比如举一个场景,当我们要对一大批主机进行自动配置时,这里就可以使用HostnameItem ,所有的主机都使用一个模板进行批量部署,就避免了每台主机再去单独设置hostname的麻烦。

二、HostMetadata和HostMetadataItem

这两个又和上面的名字比较像,我在配置自动注册时,就看错过,错使用了HostnameItem,后来排错的时候才发现使用了不对的参数。接下来还说HostMetadata和HostMetadataItem这两个参数,这两个参数在官方文档https://www.zabbix.com/documentation/4.0/manual/discovery/auto_registration 里说的比较详细。这里也再介绍下。

两者都是用于自动注册使用的,HostMetadata属于静态配置,HostMetadataItem属于动态配置,当然还是使用的zabbix key。官方举了两个示例,这里翻译下吧。

第一个示例是关于HostnameMetadataItem的,比如配置如下key :

HostMetadataItem=system.uname

使用了该key后,在不同的操作系统上会获取到不同的信息,比如windows和linux执行后,可能会返回如下信息:

Linux: Linux server3 3.2.0-4-686-pae #1 SMP Debian 3.2.41-2 i686 GNU/Linux
Windows: Windows WIN-0PXGGSTYNHO 6.0.6001 Windows Server 2008 Service Pack 1 Intel IA-32

这时候我们就可以通过自动注册功能,确认包含了Linux或windows而链接不同的模板或主机组。

第二个示例是关于HostMetadata的。这个属于静态配置,上面已经说过了。

HostMetadata=Linux    21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae

比如,我们所有需要自动注册的linux主机,我们可以配置以上的信息,这时候就可以通过匹配两项,一项是linux,另一项可以看作密码key,进而确认匹配的主机会错。同样不同类型的主机我们还可以加不同的字符串进行区分,比如:

HostMetadata=MySQL on Linux 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae

上面这个我们就可以通过三个关键字,mysql、linux、密码串进行区分出主机是运行的mysql服务,所以就把他自动链接到了mysql模板上。




本站的发展离不开您的资助,金额随意,欢迎来赏!

You can donate through PayPal.
My paypal id: itybku@139.com
Paypal page: https://www.paypal.me/361way

分类: 开源软件 标签:
  1. 本文目前尚无任何评论.
  1. 本文目前尚无任何 trackbacks 和 pingbacks.