Exporting statistics data

BOINC projects may export data describing teams, users and hosts. This data is exported in XML files that can be downloaded by HTTP from a designated server.

The data is presented in several different "views": teams ordered by credit, teams ordered by ID, etc. To increase the efficiency of data access, views are broken into a number of files, each containing a fixed number of records.

The entries in a given file are in either "summary" or "detail" form. For example, the summary of a team gives its ID, name, and credit, while the detailed from also contains a list of its members.

These files can be zipped or gzipped by passing the "-zip" or "-gzip" command to the db_dump program.

The files are as follows:

tables.xml

For each table (team, user, and host) this gives

the total number of records
the number of records per file for summary files
the number of records per file for detail files

It also includes the UNIX time when the files were last generated.
For example:

<tables>
    <update_time>1046220857</nupdate_time>
    <nusers_total>127</nusers_total>
    <nusers_per_file_summary>1000</nusers_per_file_summary>
    <nusers_per_file_detail>100</nusers_per_file_detail>
    <nteams_total>14</nteams_total>
    <nteams_per_file_summary>1000</nteams_per_file_summary>
    <nteams_per_file_detail>100</nteams_per_file_detail>
    <nhosts_total>681</nhosts_total>
    <nhosts_per_file_summary>1000</nhosts_per_file_summary>
    <nhosts_per_file_detail>100</nhosts_per_file_detail>
</tables>

team_total_credit_N.xml
Team summaries, ordered by decreasing total credit<. N is 0, 1, ...

team_expavg_credit_N.xml
Team summaries, ordered by decreasing recent-average credit.

team_id_N.xml
Team details, ordered by increasing ID.

user_total_credit_N.xml
User summaries, ordered by decreasing total credit.

user_expavg_credit_N.xml
User summaries, ordered by decreasing recent-average credit.

user_id_N.xml
User details, ordered by increasing ID.

host_total_credit_N.xml
Host summaries, ordered by decreasing total credit.

host_expavg_credit_N.xml
Host summaries, ordered by decreasing recent-average credit.

host_id_N.xml
Host details, ordered by increasing ID.

The format of the various XML elements is as follows:

Team summary

<team>
 <id>5</id>
 <name>Broadband Reports Team Starfire</name>
 <total_credit>153402.872429</total_credit>
 <expavg_credit>503030.483254</expavg_credit>
 <nusers>14</nusers>
</team>

Team detail

<team>
 <id>5</id>
 <name>Broadband Reports Team Starfire</name>
 <total_credit>153402.872429</total_credit>
 <expavg_credit>503030.483254</expavg_credit>
 <nusers>14</nusers>
 <create_time>0</create_time>
<name_html>%3Ca%20href%3D%27http%3A%2F%2Fbroadbandreports%2Ecom%2Fforum%2Fseti%2
7%3E%3Cimg%20src%3D%27http%3A%2F%2Fi%2Edslr%2Enet%2Fpics%2Ffaqs%2Fimage2067%2Ejp
g%27%3E</name_html>
 <country>None</country>
 <user>
  <id>12</id>
  <name>John Keck</name>
  <total_credit>42698.813543</total_credit>
  <expavg_credit>117348.653646</expavg_credit>
  <teamid>5</teamid>
 </user>
 <user>
  <id>14</id>
  <name>Liontaur</name>
  <total_credit>46389.595430</total_credit>
  <expavg_credit>122936.372641</expavg_credit>
  <teamid>5</teamid>
 </user>
</team>

User summary

<user>
 <id>12</id>
 <name>John Keck</name>
 <total_credit>42698.813543</total_credit>
 <expavg_credit>117348.653646</expavg_credit>
 <teamid>5</teamid>
</user>

User detail

<user>
 <id>3</id>
 <name>Eric Heien</name>
 <total_credit>4897.904591</total_credit>
 <expavg_credit>9820.631754</expavg_credit>
 <country>United States</country>
<create_time>1046220857</ncreate_time>
 <teamid>14</teamid>
 <host>
    <id>27</id>
    <total_credit>0.000000</total_credit>
    <expavg_credit>0.000000</expavg_credit>
    <p_vendor></p_vendor>
    <p_model></p_model>
    <os_name>Darwin</os_name>
    <os_version>6.2</os_version>
 </host>
 <host>
    <id>266</id>
    <total_credit>0.000000</total_credit>
    <expavg_credit>0.000000</expavg_credit>
    <p_vendor>GenuineIntel</p_vendor>
    <p_model>Intel(R)</p_model>
    <os_name>Linux</os_name>
    <os_version>2.4.18-18.7.x</os_version>
 </host>
</user>

Host summary

<host>
  <id>266</id>
  <total_credit>0.000000</total_credit>
  <expavg_credit>0.000000</expavg_credit>
  <p_vendor>GenuineIntel</p_vendor>
  <p_model>Intel(R)</p_model>
  <os_name>Linux</os_name>
  <os_version>2.4.18-18.7.x</os_version>
</host>

Host detail

<host>
  <id>102</id>
  <userid>3</userid>
  <total_credit>0.000000</total_credit>
  <expavg_credit>0.000000</expavg_credit>
  <p_vendor>GenuineIntel</p_vendor>
  <p_model>Pentium</p_model>
  <os_name>Windows XP</os_name>
  <os_version>5.1</os_version>
  <create_time>1040170006</create_time>
  <timezone>28800</timezone>
  <ncpus>2</ncpus>
  <p_fpops>45724737.082762</p_fpops>
  <p_iops>43233895.373973</p_iops>
  <p_membw>4032258.064516</p_membw>
  <m_nbytes>670478336.000000</m_nbytes>
  <m_cache>1000000.000000</m_cache>
  <m_swap>1638260736.000000</m_swap>
  <d_total>9088008192.000000</d_total>
  <d_free>3788505088.000000</d_free>
  <n_bwup>24109.794088</n_bwup>
  <n_bwdown>57037.049858</n_bwdown>
</host>