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

Posted 2020-12-21

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监控系统通过企业微信推送图文混排告警消息

往期回顾：
【逗老师带你学IT】PRTG监控系统合并多个传感器通道数据
【逗老师带你学IT】PRTG监控系统通过企业微信推送告警消息
【逗老师带你学IT】PRTG监控系统配合树莓派采集企业内部无线网络质量
【逗老师带你学IT】vMware ESXi 6.7合并第三方硬件驱动
【逗老师带你学IT】Kiwi Syslog Server安装和配置教程
【逗老师带你学IT】Kiwi Syslog Web Access与Active Directory集成认证
【逗老师带你学IT】vMware ESXi 6.7合并第三方硬件驱动
【逗老师带你学IT】Windows Server Network Policy Service（NPS）记账与审计
【逗老师带你学IT】Windows Server NPS服务构建基于AD域控的radius认证
【逗老师带你学IT】AD域控和freeradius集成认证环境，PAP，MSCHAPV2
【逗老师带你学IT】深信服SSL远程接入与深信服行为审计同步登陆用户信息