CACTI表结构和数据被动获取

cacti
我们也用了很久
了，但是它的表结构一直都没有去关心过，得空抽了半个晚上的时间，把它的库表结构大概看了下，某些字段的含义跟大家分享下：
cacti
的数据都是存放
在rrdtool
中的，数据库存放的其实只是配置数据，cacti
的逻辑对象主要分为三种，data
（数据）、graph
（图
片）、host
（设备），这在它的表设计中也能很容易的看出
来。所以，就分三个大类来讨论了。

一、
Host

cacti
的host
一般是要使用模板的，每个host
自己的信息，只存放在host
表中，其余的就都是模板的信息，模板的对应关系等等。
1
、host
表
host
表有34
个字段，用来存放设备信息，就是我们在console
的devices
选项中可以看到，并且配置的东东。具体字段的含义如下：
id
：就是设备的id
，自增
host_template_id
：
如果这个设备使用了模板，那这个就是模板的id

description
：
描述，在cacti
里看到的设备名
hostname
：设备ip
地址
notes
：不做解释
snmp_community
、snmp_version
、snmp*......
：snmp
相
关的配置选项，就是字面的意思
availability_method
：
在页面上看就是Downed
Device Detection
，我理解就是，如何看这台设备是否挂了
ping_method
：udp
ping
还是icmp
，还是tcp

ping*......
：ping
的相关选项，字面意思
max_oids
：一次最
多get
多少个oid

status*......
：
设备当前状态相关，字面意思

一堆time
：不太清楚，应该是pollor
相关的，具体单位不知
total_polls
：
总共取了多少次值了
failed_polls
：
失败了多少次
availability
：
可用性，上面两个字段算出来的

2
、host_template
表

设备模板，总共就三个字
段，第一个是id
，就是host_template_id
，在host
表里有引用，第二个是个哈希，就是模板的位置索引，第三个是索引名字。
3
、host_template_graph
表

模板的对应，存放的信息主
要是，一个设备模板，需要绘什么图，也就是设备模板和绘图模板的对应关系，就两个字段，host_template_id
和graph_template_id
，graph_template_id
就是graph_templates
里面的id
值。
4
、host_template_snmp_query
表

模板和数据抓取方式的对
应，对应的数据抓取方式就是snmp_query_id
，在snmp_query
表的id
值。

每个snmp_query
，都会对应有graph
，如果一个设备模板，对应了一个snmp_query
，这个snmp_query
又
对应了一系列的graph
，那这个设备模板就自动对应这些graph
，而这个关系在host_template_graph
里是没有的
5
、host_graph
表

设备和图片模板的对应，也
是两个id
，host_id
和graph_template_id
，graph_template_id
在graph_templates
表中定义。

一般来讲，这个设备下的图
片，会包含它所属的设备模板和图片模板的对应，也就是说，这个对应关系，和host_template_graph
表
中有些类似。
6
、host_snmp_cache
表

存放snmp
去取值时的临时值，例如网络流量，需要的是累加值，那这里就存上次
的总值，用来计算用
7
、host_snmp_query
表

设备和snmp_query
的对应，和host_graph
类似，这个对应关系，和host_template_snmp_query
表中的数据是对应的。

二、
Data

data

主要就是数据获取，获取数据，然后存放到
rrd

文件中，这里存放的数据，主要就是如何获取数据、和如何存放数据这两种。

1

、
data_input

表

数据获取的方式，在
console

中的
data_input_method

里可以看到。

id

：数据获取方式的
id

hash

：对应的磁盘索引

name

：数据获取方式的名字

input_string

：如果是脚本的话，那就是脚本的位置了

type_id

：
type

一直没找到对应的表，可能是程序里写死了，对应的是
input_type

，有
6

个选项，分别是：
snmp

、
snmp
query

、
script/command

、
script
query

、
script
– script server

、
script
query – script server

2

、
data_input_fields

表

这张表是用来存放一些
data_input

方法中所需要的对象，比如
snmp

的
oid

，那就是一个对象，
script

方式取硬盘时候，取回来值的名字，单位，都属于它所定义的范畴。表内容，主要是这些对象，
和
data_input

的对应。

id

：
input_fields

的
id

data_input_id

：对应
data_input

表中的
id

name

、
data_name

：名字

input_output

：输入还是输出

下面几个字段我也不清楚了……

3

、
data_input_data

表

存放的是每个
data

对象的
data_input_field

内容。

data_input_field_id

：
data_input_field

中的
id

data_template_data_id

：
data_template_data

中的
id

4

、
data_local

表

存放数据对象，就是在
console

中的
data
source

页面看到的东东。不过这张表只是简单
的定义一个对象和对应关系，对象的具体属性在另外的表中。

id

：
data

的
id

data_template_id

：采用了哪个数据模板，在
data_templates

模板中定义

host_id

：是哪个设备的数据，在
host

中定义

snmp_query_id

：如果是通过
snmp_query

方式获取的，那对应的
snmp_query

的
id

，如果不是，则为
0

snmp_index

：
snmp_query

方式获取数据时，获取数组的前缀。例如，流量获取中，端口的
index

5

、
data_template

表

数据模板，我们在
console

的
data
templates

中看到的东东。

id

：数据模板的
id

hash

：索引

name

：名字

6

、
data_template_data

表

具体数据对象的信息，包含模板。可以认为，每一个对象都代表一个
rrd

文件。

id

：
data

对象的
id

local_data_template_data_id

：如果使用了模板，那这个就是模板的
id

，定义的位置也是这个表

local_data_id

：对应的数据对象，在
data_local

表中定义

data_template_id

：
data_template

，数据模板，在
data_template

表中定义。

data_input_id

：数据获取的方式，在
data_input

表中定义

*name

：名字，就是字面的意思

data_source_path

：
rrd

文件的路径

t_*

：不知道……

active

：是否被激活，可以通过
enable/disable

来控制

rrd_step

：步长，默认是
300s

，就是
5

分钟，也就是多长时间存一个数据（
rrdcreate

的选项）

7

、
data_template_data_rra

表

数据对象和
rra

的对应，
rra

也是
rrdtool

中的概念，是一种数据归档压缩的机制。

data_template_data_id

：上张表中定义的
id

rra_id

：对应的
rra

的
id

，在
rra

表中定义

8

、
data_template_rrd

表

基本上也是
rrdtool

的配置选项，一个
rrd

文件可以存多列，叫做
ds

，每个列代表一组数据。这张表可以看成是对这个列的定义。

id

：
ds

的
id

local_data_template_rrd_id

：如果使用了
ds

的模板，则这里定义模板的
id

，模板定义也在这张表中

local_data_id

：数据
id

，在
data_local

表中定义

data_template_id

：采用的数据模板，在
data_template_data

中定义

其余的都是
rrdtool

在创建
rrd

文件时候，对这个
ds

的配置选项，例如最大值，名字等等。

data

部分还是比较复杂的，如果和
host

连起来看，就更复杂了。抛开模板不谈，一般来讲是有以下的对应关系：

1

、每个
host_id

，都有一组
local_data_id

，例如，一个
cisco

交换机的
cpu

就是一个
local_data_id

，它的一个端口——
te1/1

流量，也是一个
local_data_id

。一个
host_id

对应多个
local_data_id

。

2

、每个
local_data_id

，就是一个数据源，它必须有一个
rrd

文件与他对应，所以每个
local_data_id

在
data_template_data

中，必定对应一行记录，必定有一个
rrd

文件。别看
data_template_data

中有那么多记录，其中
local_data_id

为
0

的，或者
rrd

路径为空的，那都是模板。

3

、每个
rrd

文件，必然至少有一个
ds

，也就是在
data_template_rrd

中，至少有一条记录，例如流量，还是
cisco

的交换机，每个端口代表一个
local_data_id

，有一个
rrd

文件，有两个
ds

，流入和流出，那在
data_template_rrd

中就有两条记录。

4

、
data_input

那几张表，主要是数据获取方式，数据获取方式有
6

种，我们一般用的是三种：脚本直接取，就是
script

、
snmp

，给个
oid

直接
get

、
snmp
query

，就是
snmp

取回来一组数据，然后分组。

三、
Graph

绘图方面，自定义的方法其实很多，
cacti

并没有把
rrdtool

在绘图方面的参数全部表现出来，不过也已经够用了。

1

、
graph_local

表

本地的图片，和
data_local

类似，一般来讲，一个
data_local

的对象，都会对应一个
graph_local

的对象，意思就是，一个数据，对应一张图片，但是也有可能出现不对应的情况，那就是：我有
些数据并不绘图、或者有些图我需要多个数据。

表结构和
data_local

类似，不过
data_template_id

换成了
graph_template_id

，第一个
id

字段代表的含义也变了，代表
graph

对象。

2

、
graph_templates

表

绘图模板。

id

：模板的
id

hash

：索引

name

：名称

3

、
graph_template_input

表

graph_template

对应的具体对象类型，比如说这个类型是个颜色，这个类型是流量数据流入的数据源，等等。

id

：数据类型的
id

hash

：索引

graph_template_id

：图片模型的
id

，在
graph_template

中定义

name

：名字

description

：不作说明了

column_name

：对象的类型，是颜色，还是数据源，还是一段文字

4

、
graph_template_input_defs

表

定义图中的具体对象类型和
item

的对应。

graph_template_input_id

：
graph_template_input

的
id

，类型是什么

graph_template_item_id

：具体对象的
id

，在
graph_templates_item

中定义

5

、
graph_templates_gprint

表

输出格式

6

、
graph_templates_graph

表

绘图时候的选项，每张图在这张表中对应一条记录，大多是
rrdtool

的参数。和
data_template_data

类似。

id

：绘图选项的
id

local_graph_template_graph_id

：如果采用模板的话，这里就是模板的
id

。模板中定义好的东西，就不用重新定义了。在本张表中有定义

local_graph_id

：是哪张图，在
graph_local

中定义

graph_template_id

：在
graph_templates

表中定义的绘图模板

剩下的都是
rrd

绘图的选项了，例如绘的图有多高，多宽，图片的名字是啥等等
......

7

、
graph_templates_item

表

每张图上，对应的有些什么内容。内容主要是包含：线或者是面，就是趋势图、下面的标注，例如最大值，最小值，当前值。

id

：
item

的
id

hash

：

local_graph_template_item_id

：如果采用了模板，则写模板的
id

，在本表中定义

local_graph_id

：对象属于哪张图

graph_template_id

：在
graph_templates

表中定义的绘图模板

task_item_id

：如果对象的类型是
task_item_id

（在
graph_template_input

中定义），则这里的
id

就是数据源的
id

，在
data_template_rrd

中定义。

color_id

：颜色，在
color

表中定义

alpha

：透明度

graph_type_id

：图的类型？

cdef_id

：如果这个值是计算出来的（例如多个值的累加），那这里要有计算的公式，在
cdef

表中定义

consolidation_function_id

：功能函数，比如取平均值，取最大值等

text_format

：字符串，直接显示在图上的东东，可以理解为对象的名字

value

：值

hard_return

：不知

gprint_id

：输出格式

sequence

：
rrd

的绘图是有顺序的，
sequence

大的对象会覆盖
sequence

小的对象

绘图的地方，是最复杂的地方，因为
rrdtool

本身在绘图的时候参数就是最多的，也是最复杂的，把这些东西都封装到数据库中，那这些表结构
也是十分复杂的。一般情况下，可以这么理解：

1

、每个
host_id

的对象，可以对应多张图，但是也有可能有某些图并不对应任何
host

，例如汇总的图。但是每张图必然在
graph_local

中有定义，就是有一个
local_graph_id

。

2

、每张图片，在创建的时候肯定有很多参数，这些参数就是在
graph_template_graph

中定义的。如果采用了模板，那模板中定义过的参数，就不用再重复定义了。

3

、每张图片，必然包含一个以上的对象，那就是
graph_template_item

了，
item

有很多类型，例如，流量图中，绿色区域代表的流出、蓝色实线代表的流出，就分别代表一个对
象。还有些对象，例如下标的最大值，平均值等。这些对象，都是需要有数据源的，可能一个数据源，也可能需要多个，因为实际绘出来的值，是
cdef

把不同的数据源运算后得到的。这个数据源，就是
ds

，也就是
data_template_rrd

中的对象。

四、
Cacti

如何实现被动数据获取

了解到它的数据结构以后，我们就可以想办法来实现
cacti

数据的被动获取了，因为并不是所有场合，
snmp

都可以取到数据的，也许有时候我们要取的
ip

在另外一个局域网里，也许我们觉得
cacti

的负载太高，不能让它取太多的数据。

1

、方式

方式很简单，在
cacti

中定义好
host

，
data

，
graph

，然后只要我们能定时的把数据插入到它的
rrd

文件中就可以了。

2

、方法

方法可以有两种：

第一种用脚本，
cacti

支持自写脚本取数据。最土的办法，就是定时的将数据推送到
cacti

的机器上，追加到一个文件里，然后
cacti

通过一个脚本读取这个文件来获取数据。

第二种就是直接插
rrd

文件，
cacti

正常的获取数据方式是用
crontab

跑
poller

，或者
spine

，去定时取数据。我们在
poller

或者
spine

的过程中不需要让它去取数据，直接跳过，而定时的从外部把数据推送进来，然后插入
rrd

文件即可。

3

、步骤

a

、添加一个
host

（如果这个
host

无法访问到，那么可用性检查会失败，但是没关系）

b

、添加数据源，需要
insert

以下几张表：
data_local

、
data_template_data

、
data_template_data_rra

、
data_template_rrd

c

、创建
rrd

文件，打开
data
source

页面，应该已经可以看到我们添加的数
据源了，打开那个数据源的
debug

模式，将
rrdtool

的命令拷贝到
shell

中执行一次即可（注意权限）

d

、创建一个图片，需要
insert

以下几张表：
graph_local

、
graph_template_graph

、
graph_template_item

e

、定时的向
rrd

文件中插入数据（用你喜欢的方式，同时要注意
rrd

文件的权限）