Usage Reports Gotcha

A few weeks ago, I did a post on using the WSS usage reports even though they are hidden when MOSS is installed (The Other Usage Reports). Well, this week I discovered a quirk with them that’s worth noting.

The setup:

I have a client that is storing documents in SharePoint. These documents are getting categorized several ways with additional metadata. We are then targeting, filtering, rolling up, and displaying links to these documents on various pages using the Content Query Web Part (CQWP).

The catch is that some of these files are too large to be pushed into SharePoint, others are not actually files, but instead are external web sites or Lotus Notes applications. To the end user however, these are all just resources to be categorized and displayed. To those ends we are using the Link to Document content type in our document libraries.

The impact:

When you create a link with the link to document content type, an actual .aspx redirect page gets saved into your document library. To the end user, this solution is working great, but this week the site admin got curious about the usage stats and his confusion helped me uncover something strange.

Within the context of the MOSS usage reports (for a publishing site at least), these link to document .aspx pages are excluded. The reasoning for this exclusion may be that these are intended to be documents that live elsewhere in your SharePoint environment and you would want to count their hits in with the actual document and not the link. Whatever the reason, it’s unfortunate for us because these are links to external resources and it would be nice to know whether the link here is being used.

Within the context of the hidden WSS usage reports, these redirect pages show up, but the numbers are not accurate. It seems that the intelligence that excludes the search engine hits from documents in a library or publishing pages (.aspx) in the pages library is not applied to the link to document (.apsx) items in a document library. The good news is that it’s pretty easy to spot the indexing hits – if you have 50 redirect links and half of them all have exactly x number of hits, it’s a fair bet that you can subtract x from the hit counts on the other half. The bad news is, well, pretty much everything else. It’s going to be difficult to explain the problem to your users. If your users aren’t thoroughly interested in the stats, they won’t go through the trouble to get the accurate. And if they ARE thoroughly interested in the stats, then they’re going to want them accurate and this solution will likely not be sufficient.

Conclusion:

Meh. I think it’s widely accepted that out of the box SharePoint usage reports are not good. They are difficult to interpret, but at least they’re inaccurate J.

 

 

The Other Usage Reports

Just about everyone is aware of the Site & Site Collection Usage Reports that are available in MOSS. These are the reports that are linked from the settings page in MOSS. They give you some basic roll information about the last 30 days’ activities. Though the numbers aren’t completely intuitive, Mark Arend explained them quite a while ago.

However, there is another, lesser known, set of reports that have come over from WSS. These reports aren’t linked anywhere from MOSS, but they remain available to anyone that knows the right url, which is <site collection>/_layouts/usage.aspx

Three pages make up this set of reports.

Usage.aspx:

/_layouts/usage.aspx – This is the page url you need to remember.

In addition to providing you links to the other pages, it gives you some high level information that isn’t really available anywhere else.

  • Current Storage Used
  • Number of unique users defined.
  • Recent Bandwidth usage.

  

Storman.aspx:

Linked from usage.aspx in the storage description section

Caveat – this report is only available if you have your site quota turned on. It gives you some great information though that you can’t find anywhere else, so that may be a sufficient reason to turn on your site quota on.

At the top, it will give you a quick graph of how much space you have used vs how much is left in your quota. Below that, you can get more specific information about the content that makes up that space.

A drop down control lets you choose to see detail about Libraries, Documents, Lists, or the Recycle Bin.

You can see in that clip that the largest file in my site is my Branding presentation within my documents library. The presentation is taking up 13.1MB of space, of which 6.8MB actually storage of previous versions.

UsageDetails.aspx:

Linked from usage.aspx in the user and activity description sections.

These reports will give you 30 day totals or the daily detail for page requests, user activity, OS, Browser or referrers. Most of this information has been improved in the MOSS usage reports, but sometimes it’s nice to supplement the data with this more-raw format.