oracle

README

oracle

该采集插件的原理，就是连上 oracle 实例，执行各种 sql 获取监控数据，oracle 是一个非常完备的老牌的数据库，所有的监控数据都在自己的库里存储，有相关视图供用户查询。

配置文件在 conf/input.oracle 目录下，oracle.toml 是配置连接地址，metric.toml 是配置查询监控数据的 sql，每个配置段的含义：

• mesurement: 自定义的一个指标前缀
• request: sql 语句
• label_fields: sql 查到的内容，会有多列，哪些列作为时序数据的 label
• metric_fields: sql 查到的内容，会有多列，哪些列作为时序数据的值
• field_to_append: 是否要把某列的内容附到指标名称里
• timeout: sql 执行的超时时间

有些字段可以为空，如果 mesurement、metric_fields、field_to_append 三个字段都配置了，会把这 3 部分拼成 metric 的最终名字，参考下面的代码：

func (o *Oracle) parseRow(row map[string]string, metricConf MetricConfig, slist *types.SampleList, tags map[string]string) error {
	labels := make(map[string]string)
	for k, v := range tags {
		labels[k] = v
	}

	for _, label := range metricConf.LabelFields {
		labelValue, has := row[label]
		if has {
			labels[label] = strings.Replace(labelValue, " ", "_", -1)
		}
	}

	for _, column := range metricConf.MetricFields {
		value, err := conv.ToFloat64(row[column])
		if err != nil {
			log.Println("E! failed to convert field:", column, "value:", value, "error:", err)
			return err
		}

		if metricConf.FieldToAppend == "" {
			slist.PushFront(types.NewSample(metricConf.Mesurement+"_"+column, value, labels))
		} else {
			suffix := cleanName(row[metricConf.FieldToAppend])
			slist.PushFront(types.NewSample(metricConf.Mesurement+"_"+suffix+"_"+column, value, labels))
		}
	}

	return nil
}

instantclient

oracle 采集插件需要依赖 instantclient ，这是 Oracle 官方提供的lib库，启动 Categraf 之前，要导出 LD_LIBRARY_PATH 环境变量，举例：

export LD_LIBRARY_PATH=/opt/oracle/instantclient_21_5
cd /opt/categraf
nohup ./categraf &> stdout.log &

如果遇到报错 ORA-01804: Error while trying to retrieve text for error ORA-01804 请添加ORACLE_HOME环境变量

监控大盘

本 README 文件的同级目录下，提供了 dashboard.json 就是 Oracle 的监控大盘，可以导入夜莺使用。

更新 2022-06-24

从 v0.1.8 版本开始，每个 instances 实例下面也可以配置 SQL 了，这些 SQL 只生效到对应的实例，相当于：所有Oracle都要采集的 SQL 配置到全局的 metrics.toml，某个实例特殊的配置则配置在 instances 下面，配置文件中给了一个例子，[[instances.metrics]] 配置段。