用于将度量查询到pandas数据帧的python库
libmetric的Python项目详细描述
用于查询多个时间序列数据库中的度量的python库 熊猫数据帧。
它支持两种类型的度量查询,第一种是instantmetric, 及时准确地返回值。第二个是range 度量,为给定的时间范围和步骤提供一系列值。
安装
在基于debian的系统上安装所需的依赖项。
apt-get -y install librrd-dev libpython-dev
从pip包安装库。
pip install libmetric
从源安装库。
git clone https://github.com/cznewt/python-libmetric.git
cd python-libmetric
python setup.py install
输入参数
参数可以由环境参数设置,也可以作为命令传递 论据。
例如,将参数作为环境参数传递。
exportLIBMETRIC_ENGINE='prometheus'exportLIBMETRIC_URL='https://metric01:9090'exportLIBMETRIC_QUERY='alertmanager_notifications_total'exportLIBMETRIC_START='2017-11-12T00:00:00Z'exportLIBMETRIC_END='2017-11-16T00:00:00Z'exportLIBMETRIC_STEP='3600s' range_metric
以及将参数作为命令参数传递的示例。
range_metric --engine prometheus --url 'https://metric01:9090' --query '...'
公共参数
- libmetric_引擎
- 要进行查询的端点的类型。
- libmetric_url
- 端点服务的URL。
- 目标服务内点上的数据分区。
- libmetric_查询
- 查询以获取度量时间序列或值。
范围参数
仅适用于rangemeters的参数。
- libmetric_start
- 时间范围开始。
- libmetric结尾
- 时间范围结束。
- libmetric步骤
- 查询分辨率步长。
瞬时参数
仅适用于intantmeters的参数。
- libmetric\u矩
- 及时的单个时刻。
报警参数
仅适用于所有仪表/警报的参数。除了 LIBMETRIC_AGGREGATION仅适用于range米。
- libmetric_报警阈值
- 警报阈值。
- libmetric_alarm_运算符
- 用于报警评估的算术运算符。[gt,lt,gte,lte,eq]
- libmetric_聚合
- 给定时间序列的聚合函数[min,max,sum,avg]
支持的终结点
libmetric支持几个主要的时间序列数据库来获取 结果以标准化的方式。通过http api调用查询端点。
石墨
查询Graphite服务器的示例配置。
exportLIBMETRIC_ENGINE='graphite'exportLIBMETRIC_URL='http://graphite.host:80'exportLIBMETRIC_QUERY='averageSeries(server.web*.load)' ...
内流b
查询infloxdb服务器的配置示例。
exportLIBMETRIC_ENGINE='influxdb'exportLIBMETRIC_URL='http://influxdb.host:8086'exportLIBMETRIC_USER='user'exportLIBMETRIC_PASSWORD='password'exportLIBMETRIC_PARTITION='prometheus'exportLIBMETRIC_QUERY='SELECT mean("value") FROM "alertmanager_notifications_total"' ...
普罗米修斯
查询普罗米修斯服务器的示例配置。
exportLIBMETRIC_ENGINE='prometheus'exportLIBMETRIC_URL='https://prometheus.host:9090'exportLIBMETRIC_QUERY='alertmanager_notifications_total' ...
循环数据库
查询rrd文件的配置示例。查询是consolidation function,分区是data set。
exportLIBMETRIC_ENGINE='rrd'exportLIBMETRIC_URL='file:///tmp/port.rrd'exportLIBMETRIC_PARTITION='INOCTETS'exportLIBMETRIC_QUERY='AVERAGE' ...
报警选项
以下列表显示了报警功能的允许值,报警算法 rangemeters的运算符和聚合函数。
支持的报警操作员
- gt
- 大于>。
- gte
- 大于或等于>=。
- lt
- 低于<。
- lte
- 低于或等于<=。
- eq
- 等于==。
支持的时间序列聚合
- avg
- 序列值的算术平均值。
- min
- 使用序列中的最小值。
- max 使用序列的最大值。
- sum
- 将这些值相加。
更多信息动作
- {a1}
- {a2}
- {a3}
- {a4}