【逗老师带你学IT】PRTG HTTP API获取指定传感器流量图表图片

2024-03-26 20:32:28

PRTG服务器支持通过HTTP API获取监控数据和监控图表。本文主要介绍HTTP API的方式拉取任意传感器流量图表。文章内容翻译和重新整理自PRTG用户手册。
原文链接：
PRTG Manual: Application Programming Interface (API) Definition

@TOC

一、PRTG API身份认证方式

1、身份认证URL格式

PRTG API的所有请求都是无状态的，仅需要在所有请求的URL里包含认证信息即可。有两种认证方式：

1、username+password （铭文密码）
2、username+passhas（哈希密码）

两种认证方式构建的URL基本相同，举例如下：
passhash方式：

 https://x.x.x.x/api/table.xml?username=myuser&passhash=hash

password方式：

 https://x.x.x.x/api/table.xml?username=myuser&password=mypassword

2、passhas密码哈希获取方式

有两种方式获取passhas密码哈希

2.1API调用请求passhas

可以使用以下API调用来请求帐户的密码，最简单的是直接在浏览器访问此API URL即可以看到passhas

https://yourserver/api/getpasshash.htm?username=myuser&password=mypassword

2.2管理员控制台查看

使用管理员账号登录PRTG Web管理控制台，访问设置->系统管理->用户账户
进入一个账户后即可查看该账户的passhash

二、实时图表API

1、实时图片API URL

可以使用PRTG API获取实时传感器图。PRTG将图形呈现为.png或.svg文件。
PNG格式图片：

/chart.png?type=graph&width=300&height=160&graphid=2&id=0

SVG格式矢量图片

/chart.svg?type=graph&width=300&height=160&graphid=2&id=0

注意：
1）API URL中必须包含身份验证部分，username=myuser&password=mypassword
2）URL包含帐户用户名和密码/密码。这可能意味着安全问题。建议在PRTG中设置一个专用的只读用户帐户，该帐户是专用用户组的成员，例如，该帐户仅具有根组和所有基础条目的读取权限，甚至更好的是，仅具有对象ID的读取权限，用于请求API URL。

2、实时图形URL的参数

附图1：传感器ID和通道ID的查看位置如下：
下期讲：如何通过企业微信群消息机器人发送带图片的图文消息
【逗老师带你学IT】PRTG监控系统通过企业微信推送图文混排告警消息

码农公寓