external 指标采集

简介

external 采集源支持执行一些外部采集器，这些外部采集器通常对运行环境有一定依赖（如依赖特定动态库，或者依赖 Python 环境）。

前置条件

• 已安装 DataKit datakit 安装文档）

配置

进入 DataKit 安装目录下的 conf.d/external 目录，复制 external.conf.sample 并命名为 external.conf。示例如下：

[[inputs.external]]

# 外部采集器名称
name = 'some-external-inputs'  # required

# 是否以后台方式运行外部采集器
daemon = false

# 如果以非 daemon 方式运行外部采集器，则以该间隔多次运行外部采集器
#interval = '10s'

# 运行外部采集器所需的环境变量
#envs = ['LD_LIBRARY_PATH=/path/to/lib:$LD_LIBRARY_PATH',]

# 外部采集器可执行程序路径(尽可能写绝对路径)
cmd = "python" # required

args = []

比如 oraclemonitor 采集器就是通过 external 这个采集器来实现的：

[[inputs.external]]

daemon = true   # oraclemonitor 采集器启动之后，在后台运行
name = 'oraclemonitor'

# 外部采集器的程序路径
cmd  = "/usr/local/cloudcare/dataflux/datakit/externals/oraclemonitor" 

# 外部采集器参数列表
args = [ 
    '-instance-id'    , '<your-instance-id>'        ,
    '-metric-name'    , 'oracle_monitor'            ,
    '-internal'       , '1m'                        ,
    '-instance-desc'  , '<your-oracle-description>' ,
    '-host'           , '<your-oracle-host>'        ,
    '-port'           , '1521'                      ,
    '-username'       , '<oracle-user-name>'        ,
    '-password'       , '<oracle-password>'         ,
    '-service-name'   , '<oracle-service-name>'     ,
    '-cluster-type'   , 'single'                    ,
    '-oracle-version' , '11g'                       ,
]

# 外部采集器所需的动态库链接路径
envs = [ 
    'LD_LIBRARY_PATH=/opt/oracle/instantclient_19_8:$LD_LIBRARY_PATH',
]