TP (required)

In order to determine what event is being sent, there must be an event code sent as well. The TP parameter will be specified along with each event in this documentation.

SS (required)

Every time data is sent to the API, it must have a session ID associated with it. This session ID is used to help gather information and remove it later on. The session ID is a randomly generated MD5 hash that is generated every time an application is ran.

TS (required)

In order to accurately keep track of how the software was being used during different time periods, a time-stamp is required to do this.  The time-stamp is the current Unix time (or POSIX time) which is the number of seconds that have elapsed since January 1, 1970. The reason Little Software Stats uses Unix time is because it uses Coordinated Universal Time (UTC) which means there’s no timezone and its the same worldwide. Data sent with a time-stamp that is newer then 3 days (from the current day) is considered to be invalid.

FL (optional)

The order in which the data is read is specified by the flow ID which can be sent along with events. If the flow ID is not used then the events are read in no chronological order except for the start and stop events which are first and last (by default). The following XML example shows use of the flow ID to have events read in a certain order:

<Events>
<Event>
<tp>strApp</tp>
<aid>463f37d98c8219a9906b6d579311fb07</aid>
<aver>1.0</aver>
<ID>BC72D802A0340B3DF7B664D233011B28</ID>
<ss>3FAB840C61C6E2B07E369F38D287CDE5</ss>
<ts>1358746946</ts>
<osv>Windows 7</osv>
<ossp>1</ossp>
<osar>64</osar>
<osjv>1.8</osjv>
<osnet>4.0</osnet>
<osnsp>0</osnsp>
<oslng>1033</oslng>
<osscn>1024x768</osscn>
<cnm>IntelCorei7CPU950@3.07GHz</cnm>
<cbr>genuineintel</cbr>
<cfr>3076</cfr>
<ccr>8</ccr>
<car>64</car>
<mtt>6144</mtt>
<mfr>512</mfr>
<dtt>1048576</dtt>
<dfr>1024</dfr>
</Event>
<Event>
<tp>ev</tp>
<ts>1358748847</ts>
<ss>3FAB840C61C6E2B07E369F38D287CDE5</ss>
<ca>Events</ca>
<nm>Sent</nm>
<fl>1</fl>
</Event>
<Event>
<tp>lg</tp>
<ts>1358748986</ts>
<ss>3FAB840C61C6E2B07E369F38D287CDE5</ss>
<ms>Hello World!</ms>
<fl>2</fl>
</Event>
<Event>
<tp>stApp</tp>
<ts>1358749014</ts>
<ss>3FAB840C61C6E2B07E369F38D287CDE5</ss>
</Event>
</Events>

This would have these events sent in the following order:

  1. Start
  2. Event
  3. Log
  4. Stop

Comments