This article applies to PRTG Network Monitor 17.4.35 or later
Modify Report Templates
PRTG Network Monitor includes a powerful reporting engine that allows to generate a variety of reports in order to review your network's data the way you need.
Important
This Knowledge Base article was written for technically savvy users with good technical knowledge (especially as regards HTML and file templates). We do not encourage modifying the template files that come with PRTG!
The reason is that we cannot supply updates and/or bugfixes for template files that have been changed by users when we publish new versions of PRTG. Also, editing template files is not covered by our usual support offering due to the complex nature of this process.
Our recommendation is to stick with the report options included in the web interface unless it's unavoidable. Please see the manual section Reports to check if you can create your reports with the functionality provided by the web interface.
Still Want to Proceed?
However, if you still want to change templates, this article cannot go into every detail, but it will give you a brief overview of the possibilities you have, in order to do the following:
Make a backup of every file you are going to change!
Using Custom Filenames
Every time a PRTG update is installed, all template files are overwritten to provide updates and bugfixes for these files. This is one reason why modifying report templates is not officially supported.
Report templates, images, and include files are located in the \webroot folder of your PRTG installation directory and spread across several subfolders. Whenever you install a PRTG update, all original PRTG template files are overwritten.
To avoid losing your changes, please create your own report template files with different filenames: simply duplicate the file that you want to start from and give it a different name. To keep changed images, please write-protect them using Windows Explorer.
Note: The folder has changed as of PRTG version 13.2.3. In previous versions the folder is \website. Please see this article for more information.
Locating the Files You Want to Modify
A template consists of several template files. When creating a report, the web engine pastes all of these files together into one HTML file to generate the report. In the \webroot\reporttemplates subfolder of your PRTG installation, locate the main report template file of the report you want to modify.
You can identify a template in the source code of the HTM file: The name as it appears in the PRTG web interface is written in the first line (as an HTML comment). The format is category: name.
The template or sub-template file will contain the following:
- printheading.htm: the visible header
- printfooter.htm: the visible footer
- <#report> tag: defines a sub-template to be included in the name attribute, for example
<#report ... name="details\Graph plus 30day graph and Table.htm"...>
Note: Please make sure you do not make changes to printhead.htm or printfoot.htm as these do NOT include the visible header/footer but only styling and closing tags.
If you cannot locate the heading or the footer in the main template, consider looking in the sub-template in the \webroot\reporttemplates\details subfolder of your PRTG installation.
See Also
1 comment