PNP

PNP Grafana 数据源 - 使用 PNP4Nagios 访问 RRD 文件的 Grafana 后端数据源

安装

在 Grafana 插件目录中搜索 pnp 或直接使用 grafana-cli 命令

%> grafana-cli plugins install sni-pnp-datasource

此外，OMD-Labs 也包含了此数据源，因此如果您使用 OMD-Labs，则所有设置都已完成。

否则，请按照以下步骤操作

%> cd var/grafana/plugins
%> git clone -b release-1.0.7  https://github.com/sni/grafana-pnp-datasource.git
%> restart grafana

将 release-1.0.7 替换为最新的可用发布分支。

PNP API

为了使此数据源工作，您需要 PNP API。这是一个目前独立的项目，未来将成为官方 PNP 的一部分。您可以从 https://github.com/lingej/pnp-metrics-api 获取 api.php 并将其放置在您的 controller 文件夹中。

在标准 PNP 设置中，您基本上可以使用简单的 wget 命令将 api 直接下载到 controller 文件夹中

wget "https://github.com/lingej/pnp-metrics-api/raw/master/application/controller/api.php" \
     -O /usr/share/pnp4nagios/html/application/controllers/api.php

调整输出路径以匹配您的安装。

创建数据源

添加新的数据源并选择

- Type 'PNP'
- Url to pnp, ex.: 'https:///sitename/pnp4nagios'

示例仪表盘

此数据源附带了一个示例仪表盘，可帮助您快速入门并显示内部 PNP 统计信息。

查询

只需在查询编辑器中选择主机、服务和标签。通过添加斜杠，如 /.*/，主机和服务字段支持正则表达式。

变量

您可以在 alias 字段中使用以下变量

- $tag_host: will be replaced with the hostname
- $tag_service: will be replaced with the service name
- $tag_label: will be replaced with the label
- $tag_perflabel: same as label

所有标准变量也都可以使用。

模板

有基本的模板变量支持。有 3 种不同的查询可用

- $host:    hosts
- $service: services where host = /^$host$/
- $label:   labels where host = /^$host$/ and service = /^$service$/

开发

为了测试和改进插件，您可以在 Docker 中运行 Grafana 实例，使用以下命令（在此插件的源目录中）

%> make grafanadev

这将把您机器上的本地插件暴露给 Grafana 容器。现在运行 make buildwatch 来编译 dist 目录并启动变更监视器

%> make buildwatch

创建发布

如何创建新发布

%> export RELVERSION=1.0.9
%> export GRAFANA_API_KEY=...
%> vi package.json # replace version
%> vi CHANGELOG.md # add changelog entry
%> git commit -am "Release v${RELVERSION}"
%> git tag -a v${RELVERSION} -m "Create release tag v${RELVERSION}"
%> make GRAFANA_API_KEY=${GRAFANA_API_KEY} clean releasebuild
# upload zip somewhere and validate on https://plugin-validator.grafana.net/
# create release here https://github.com/sni/grafana-pnp-datasource/releases/new
# submit plugin update here https://grafana.org.cn/orgs/sni/plugins

变更日志

参见 CHANGELOG.md