Check_mk数据收集器

名称：Check_mk数据采集器

版本:0.1.0

发布:2016-05-20

描述：解析数据并将其从check_mk导入到iTop中

itop-version：2.0, 2.1, 2.2

关键词：inventory, data synchronization, check_mk, nagios, itomig

依赖项：itop-config-mgmt

作者：ITOMIG GmbH

下载：[  /shop/product/check-mk-collector-126]shop/product/check-mk-collector-126[/url]

这个独立的PHP应用收集由check_mk的库存特性管理的数据。它使用同步数据源将硬件信息与iTop实例同步。

特征

• 收集服务器和PC库存以及型号，品牌，操作系统家族和版本。
• 通过Web界面连接到iTop。
  

局限性

需要直接（读取）访问check_mk的库存文件。这意味着它必须在安装了check_mk的计算机上运行（具有足够的权限）。或者，必须将check_mk使用的库存数据文件复制到库存可以访问它们的位置

。

必须通过手动指定主机名模式来实现PC与服务器之间的区分。请参阅下面的配置。

要求

• PHP版本5.3.0
• 读取check_mk的库存文件的访问权限
• 访问iTop REST服务
  

安装

• 提取归档的内容。
• 使用您的iTop凭据编辑conf/params.local.xml。
• 从 collectors/params.distrib.xml创建 collectors/params.template.xml，然后编辑配置选项。
  

归档的根目录中的README和README_checkmk包含更多文档。

配置强制参数

在conf/params.local.xml中编辑以下参数：

<itop_url>https://localhost/</itop_url>
<itop_login>admin</itop_login>
<itop_password>admin</itop_password>

参数	含义	样品价值
itop_url	iTop应用的URL	https://localhost/itop
itop_login	权利的用户名称。必须具有管理员连接到iTop才能执行数据同步。	管理员
itop_password	iTop账号的密码。

还必须在collectors/params.distrib.xml中设置以下参数：

参数	含义	样品价值
default_org_id	iTop组织的名称，应该在其下存储库存项。	演示版
check_mk_dir	采集器应该在其中检查库存数据文件的目录。	/var/lib/check_mk/inventory/
type_mapping	映射表指定应如何根据check_mk中的主机名对主机进行分类。采用pattern/replacement格式的模式，其中pattern是与主机名匹配的正则表达式，并且替换必须是服务器或PC。与模式不匹配的主机名将被忽略。	<pattern >>。**Server<< pattern>-捕获所有模式，将所有主机分类为服务器

可选参数

可以在collectors/params.distrib.xml中设置以下布尔参数：

<use_network_hostname>false</use_network_hostname>
<skip_gz>true</skip_gz>
<skip_dot>true</skip_dot>

参数	含义	样品价值
use_network_hostname	使用给定库存机器在网络上使用的主机名，而不使用存储在check_mk下的主机名。默认为false。	假
skip_gz	查找库存文件时，如果找到.gz副本，则跳过它们。默认为true。	真正
skip_dot	跳过库存文件目录中遇到的任何点文件。默认为true。	真正

文件collectorssparams.template.xml包含所有配置项目的默认值以及有关其效果的更多文档。

默认字段

给出一个常量价值，将其分配给采集器不会填充的特定字段可能会很有用。这是在collectors/params.distrib.xml中完成的：

<default_fields type="hash">  
<field_name>field value</field_name>  
<field_name2>another field value</field_name2>
</default_fields>

如果正在使用诸如status和business_criticity之类的字段，这将特别有用。仅应指定服务器和PC都具有的字段。

数据映射

check_mk中的数据是从各种来源收集的，因此可能并不总是适合现有的iTop数据。映射表用于定义在将以上项添加到iTop时应如何转换数据以使其适合数据。

在此采集器中，这适用于品牌，OS家族和OS版本对象。

映射表在collectors/params.distrib.xml中进行编辑。归档中提供的文件collectors/params.template.xml包含示例和更多文档。

例：

这将映射Linux，Windows，Mac OS，Solaris和BSD OS家族版本。 <pattern >>。** $ 1 $ s << pattern>将允许采集器向iTop添加任何不适合任何其他模式的值，而无需对其进行操作。

如果要忽略在映射表中未定义的OS系列（或OS版本或品牌），请省略<pattern >>。** $ 1 $ s << pattern>。这是默认的行为。

用法

首次运行采集器时，建议使用以下命令：

php exec.php --configure_only

如果它们不存在，这将创建同步数据源。

要在不与iTop同步的情况下收集数据，请运行

php exec.php --collect_only

这会将收集到的数据存储在采集器的dataa子目录中的CSV文件中-这对于在将数据传递给iTop之前进行检查很有用。可以检查映射的值并更新映射表-但是，请注意，在进行此类更改后，应再次运行收集。

最后，要与收集的数据执行iTop同步：

php exec.php --synchro_only

如果需要，可以在一个步骤中执行数据收集和同步（如果需要，还可以进行数据源更新）：

php exec.php

尽管这更简单，但与同步流程相比，它提供的控制更少。

有关运行采集器的更多信息，请参见基于itop-数据-采集器 页。

数据系列引用服务器和PC

服务器和PC收集了相同的数据。

iTop中的字段	check_mk库存条目
name*	check_mk主机名，即check_mk库存数据文件的名称，或网络主机名（请参阅上面的配置）
org_id*	取自配置中的default_org_id
cpu	硬件→CPU→模型
ram	硬件→内存→total_ram_usable（在MiB中）
osfamily_id	使用osfamily_mapping模式列表在软件→操作系统→类型或软件→操作系统→名称中使用数据进行映射
osversion_id	使用osversion_mapping模式列表从软件→os→名称映射
serial	硬件→系统→串行
brand_id	使用brand_mapping模式列表从硬件→系统→供应商映射
model_id	从硬件映射到系统→家族

*表示必填字段-如果check_mk中不存在相关的数据，则其余字段将被忽略,而不会阻止对象同步.

Check_mk数据收集器

名称：Check_mk数据采集器

版本:0.1.0

发布:2016-05-20

描述：解析数据并将其从check_mk导入到iTop中

itop-version：2.0, 2.1, 2.2

关键词：inventory, data synchronization, check_mk, nagios, itomig

依赖项：itop-config-mgmt

作者：ITOMIG GmbH

下载：[  /shop/product/check-mk-collector-126]shop/product/check-mk-collector-126[/url]

这个独立的PHP应用收集由check_mk的库存特性管理的数据。它使用同步数据源将硬件信息与iTop实例同步。

特征

• 收集服务器和PC库存以及型号，品牌，操作系统家族和版本。
• 通过Web界面连接到iTop。
  

局限性

需要直接（读取）访问check_mk的库存文件。这意味着它必须在安装了check_mk的计算机上运行（具有足够的权限）。或者，必须将check_mk使用的库存数据文件复制到库存可以访问它们的位置

。

必须通过手动指定主机名模式来实现PC与服务器之间的区分。请参阅下面的配置。

要求

• PHP版本5.3.0
• 读取check_mk的库存文件的访问权限
• 访问iTop REST服务
  

安装

• 提取归档的内容。
• 使用您的iTop凭据编辑conf/params.local.xml。
• 从 collectors/params.distrib.xml创建 collectors/params.template.xml，然后编辑配置选项。
  

归档的根目录中的README和README_checkmk包含更多文档。

配置强制参数

在conf/params.local.xml中编辑以下参数：

<itop_url>https://localhost/</itop_url>
<itop_login>admin</itop_login>
<itop_password>admin</itop_password>

参数	含义	样品价值
itop_url	iTop应用的URL	https://localhost/itop
itop_login	权利的用户名称。必须具有管理员连接到iTop才能执行数据同步。	管理员
itop_password	iTop账号的密码。

还必须在collectors/params.distrib.xml中设置以下参数：

参数	含义	样品价值
default_org_id	iTop组织的名称，应该在其下存储库存项。	演示版
check_mk_dir	采集器应该在其中检查库存数据文件的目录。	/var/lib/check_mk/inventory/
type_mapping	映射表指定应如何根据check_mk中的主机名对主机进行分类。采用pattern/replacement格式的模式，其中pattern是与主机名匹配的正则表达式，并且替换必须是服务器或PC。与模式不匹配的主机名将被忽略。	<pattern >>。**Server<< pattern>-捕获所有模式，将所有主机分类为服务器

可选参数

可以在collectors/params.distrib.xml中设置以下布尔参数：

<use_network_hostname>false</use_network_hostname>
<skip_gz>true</skip_gz>
<skip_dot>true</skip_dot>

参数	含义	样品价值
use_network_hostname	使用给定库存机器在网络上使用的主机名，而不使用存储在check_mk下的主机名。默认为false。	假
skip_gz	查找库存文件时，如果找到.gz副本，则跳过它们。默认为true。	真正
skip_dot	跳过库存文件目录中遇到的任何点文件。默认为true。	真正

文件collectorssparams.template.xml包含所有配置项目的默认值以及有关其效果的更多文档。

默认字段

给出一个常量价值，将其分配给采集器不会填充的特定字段可能会很有用。这是在collectors/params.distrib.xml中完成的：

<default_fields type="hash">  
<field_name>field value</field_name>  
<field_name2>another field value</field_name2>
</default_fields>

如果正在使用诸如status和business_criticity之类的字段，这将特别有用。仅应指定服务器和PC都具有的字段。

数据映射

check_mk中的数据是从各种来源收集的，因此可能并不总是适合现有的iTop数据。映射表用于定义在将以上项添加到iTop时应如何转换数据以使其适合数据。

在此采集器中，这适用于品牌，OS家族和OS版本对象。

映射表在collectors/params.distrib.xml中进行编辑。归档中提供的文件collectors/params.template.xml包含示例和更多文档。

例：

这将映射Linux，Windows，Mac OS，Solaris和BSD OS家族版本。 <pattern >>。** $ 1 $ s << pattern>将允许采集器向iTop添加任何不适合任何其他模式的值，而无需对其进行操作。

如果要忽略在映射表中未定义的OS系列（或OS版本或品牌），请省略<pattern >>。** $ 1 $ s << pattern>。这是默认的行为。

用法

首次运行采集器时，建议使用以下命令：

php exec.php --configure_only

如果它们不存在，这将创建同步数据源。

要在不与iTop同步的情况下收集数据，请运行

php exec.php --collect_only

这会将收集到的数据存储在采集器的dataa子目录中的CSV文件中-这对于在将数据传递给iTop之前进行检查很有用。可以检查映射的值并更新映射表-但是，请注意，在进行此类更改后，应再次运行收集。

最后，要与收集的数据执行iTop同步：

php exec.php --synchro_only

如果需要，可以在一个步骤中执行数据收集和同步（如果需要，还可以进行数据源更新）：

php exec.php

尽管这更简单，但与同步流程相比，它提供的控制更少。

有关运行采集器的更多信息，请参见基于itop-数据-采集器 页。

数据系列引用服务器和PC

服务器和PC收集了相同的数据。

iTop中的字段	check_mk库存条目
name*	check_mk主机名，即check_mk库存数据文件的名称，或网络主机名（请参阅上面的配置）
org_id*	取自配置中的default_org_id
cpu	硬件→CPU→模型
ram	硬件→内存→total_ram_usable（在MiB中）
osfamily_id	使用osfamily_mapping模式列表在软件→操作系统→类型或软件→操作系统→名称中使用数据进行映射
osversion_id	使用osversion_mapping模式列表从软件→os→名称映射
serial	硬件→系统→串行
brand_id	使用brand_mapping模式列表从硬件→系统→供应商映射
model_id	从硬件映射到系统→家族

*表示必填字段-如果check_mk中不存在相关的数据，则其余字段将被忽略,而不会阻止对象同步.