oracle

package
v0.0.0-...-5655933 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 20, 2023 License: MIT Imports: 0 Imported by: 0

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]] 配置段。

Documentation

The Go Gopher

There is no documentation for this package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL