Statistics

webPDF features a statistics service (called "Billing") that keeps a record of all of the web services' 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).

This file keeps a record of every web service call in the form of an XML entry called "<``entry``>". This file can be used for billing or statistical analysis purposes, for example. webPDF does not use these files for any purpose.

tip

The document’s format 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 uses "numbers" to indicate the error code for the relevant web service call. If the entry's value is "0," the web service was run successfully. If the value is negative, an error has occurred.

The <execution> section provides information concerning how long the web service was run.

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 in the web service URL)
operation = Operation number (pdf.pdfOperation) for "Toolbox" web service. "0" for all others.

The <applicationname="...">, <username="...">, and <customercode="..."> values in the <webservice> section can be defined when calling the web service. The corresponding values are passed with the web service parameters.

<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").