【译】openTSDB详解之Configuration
本文译自:http://opentsdb.net/docs/build/html/user_guide/configuration.html
1.Configuration
openTSDB能够通过一个本地文件系统的文件、通过一个命令行参数或者是两者结合来配置。
1.1 Configuration File
配置文件符合java 属性规则。配置名均是小写,以逗号分割,且无空格。每个名字后紧跟着一个等于号,然后是该属性的值。所有的openTSDB属性均已tsd.开头。注释或者是不起作用的配置行均以一个散列符号#
开头。例如:
# List of Zookeeper hosts that manage the HBase cluster
tsd.storage.hbase.zk_qudorum = 192.168.1.100
这个配置将会使得TSD连接到192.168.1.100所在的zookeeper上。
当有多个配置文件,以及命令行参数时,处理顺序如下:
- 1.加载默认参数值
- 2.加载配置文件的值,覆写默认值
- 3.加载命令行参数值,覆写配置文件值和默认值
1.2 File Locations
你可以使用--cofig
命令指定配置文件的全路径。否则,如果不指定的话,openTSDB以及一些命令行工具将会尝试寻找一个有效的配置文件,从下列的路径中:
-
./opentsdb.conf
-
/etc/opentsdb.conf
-
/etc/opentsdb/opentsdb.conf
-
/opt/opentsdb/opentsdb.conf
如果一个有效的配置文件不能被找到,以及要求的属性值没有设置,TSD将不会开启。请查看下列的属性表中一些要求配置的属性。【此处省略配置表字段信息】
1.3 Properties
下列的配置选项表针对所有的工具。当命令行重写可用时,它将覆盖相应的命令。需要注意的是:单个命令行工具可能有它们自己的值,因此请参阅它们的文档以了解详细信息
这里的暂不列出配置选项表,若有需要,请直接参考上述原文链接中的配置表。
1.4 Note
对于AsyncHbase
客户端调优的其它参数,可见:http://opentsdb.github.io/asynchbase/docs/build/html/configuration.html
1.4 Data Types
一些配置值需要特殊考虑
Booleans:下列的文字将会被解析成true
- 1
- true
- yes
任何其它的值将会被处理成false。解析过程是不区分大小写的。
Strings:字符串,设置包括空格的,并不要求引号,但是一些情况需要考虑:
- 特殊的字符(包括
#,!,=,:
)必须转义处理:
my.property = Hello world\!
- Unicode 字符必须使用它们的十六进制表示。例如:
my.property = \u0009