Statistics

webPDF has a statistics service called Billing that logs all web service operations.

A corresponding XML file is created in the logs/ directory every day.

webpdf-billing.<YYYY-MM-DD>.log = Statistical records for the webPDF Server (for each day).

In this file, each web service call is recorded in the form of an XML entry with the tag <entry>. This file can be used for accounting or statistical analysis purposes, for example. webPDF itself does not use these files for any purpose.

tip

The format of the document is described by the http://schema.webpdf.de/1.0/log/billing.xsd schema.

An entry is created for each web service call.

Following is an example of an entry made when a “docx” file is converted to PDF format with the "Converter" web service:

<entry>
    <error number="0"/>
    <execution>
        <start date="2013-08-02" time="07:28:33" zone="+0200"/>
        <end date="2013-08-02" time="07:28:36" zone="+0200"/>
        <job id="0"/>
        <runtime milliseconds="2499"/>
    </execution>
    <webservice name="Converter" operation="0">
        <application name="portal"/>
        <user name=""/>
        <customer code=""/>
    </webservice>
    <input>
        <size bytes="19725"/>
        <format name="docx"/>
    </input>
    <output>
        <size bytes="18946"/>
        <format name="pdf"/>
        <pages count="2"/>
    </output>
</entry>

The <error> entry indicates whether an error occurred during execution. If the value of the entry is “0”, the web service was successfully executed. If the value is negative, an error occurred.

The <execution> section contains information about how long the web service was executed.

Start time of execution

    <start date="..." time="..."/>

End time of execution

    <end date="..." time="..."/>

Internal server job number

<job id="..."/>

Runtime

<runtime milliseconds="..." />

The <webservice> section provides information regarding the selected web service.

• name = Name of web service (the name used in the web service API)
• operation = Operation number for Toolbox web service (corresponds to the order in toolbox). 0 for all others web services.

The <applicationname="...">, <username="...">, and <customercode="..."> values in the <webservice> section can be defined when calling the web service. The corresponding values can be passed in the billing parameter (e.g. in the Converter web service call) for each web service call.

<input> holds information concerning the file that was transferred to the web service for processing. The <sizebytes="..."> element indicates the file’s size. The file’s output format, which corresponds to the file extension, is saved in <formatname="...">.

The <output> element provides information concerning the file returned by the web service call. <sizebytes="..."> contains the file’s size. The return format is saved in <formatname="...">. The <pagescount="..."> element provides the number of pages if the return format is pdf; otherwise, a value of 0 will be entered (e.g., in the case of zip).