Welcome to EMC Consulting Blogs Sign in | Join | Help

John Brookmyre's Blog

User Adoption - Avoid the White Elephant

You have created an awesome new BI solution it is superior to the incumbent system and it is full of cool new features, good job? But what if no one uses it...

Regardless of whether you are going for a Big Bang, Parallel, Phased or other adoption approach; knowing more than anecdotal evidence of who is accessing the system and using which features can often be a difficult task. For MOSS deployments the command line tool, LogParser offers an easy to use SQL-esque interface directly onto the log files of IIS. Here are some sample queries. The basic format for the queries is:

UserAdoption 

The different parameters that can be entered are detailed below and are shown when you launch LogParser without parameters:

Usage:   LogParser [-i:<input_format>] [-o:<output_format>] <SQL query> |

                   file:<query_filename>[?param1=value1+...]

                   [<input_format_options>] [<output_format_options>]

                   [-q[:ON|OFF]] [-e:<max_errors>] [-iw[:ON|OFF]]

                   [-stats[:ON|OFF]] [-saveDefaults] [-queryInfo]

         LogParser -c -i:<input_format> -o:<output_format> <from_entity>

                   <into_entity> [<where_clause>] [<input_format_options>]

                   [<output_format_options>] [-multiSite[:ON|OFF]]

                   [-q[:ON|OFF]] [-e:<max_errors>] [-iw[:ON|OFF]]

                   [-stats[:ON|OFF]] [-queryInfo]

-i:<input_format>   :  one of IISW3C, NCSA, IIS, IISODBC, BIN, IISMSID,

                        HTTPERR, URLSCAN, CSV, TSV, W3C, XML, EVT, ETW,

                        NETMON, REG, ADS, TEXTLINE, TEXTWORD, FS, COM (if

                        omitted, will guess from the FROM clause)

-o:<output_format>  :  one of CSV, TSV, XML, DATAGRID, CHART, SYSLOG,

                        NEUROVIEW, NAT, W3C, IIS, SQL, TPL, NULL (if omitted,

                        will guess from the INTO clause)

-q[:ON|OFF]         :  quiet mode; default is OFF

-e:<max_errors>     :  max # of parse errors before aborting; default is -1

                        (ignore all)

-iw[:ON|OFF]        :  ignore warnings; default is OFF

-stats[:ON|OFF]     :  display statistics after executing query; default is

                        ON

-c                  :  use built-in conversion query

-multiSite[:ON|OFF] :  send BIN conversion output to multiple files

                        depending on the SiteID value; default is OFF

-saveDefaults       :  save specified options as default values

-restoreDefaults    :  restore factory defaults

-queryInfo          :  display query processing information (does not

                        execute the query)

Here are some which I have used:

  • Basic Access Stats:
    • Logparser -i:iisw3c "SELECT Date, cs-username, COUNT (*) FROM C:\UsageStats\Source\W3SVC919260928\*.log WHERE cs-username <> NULL AND cs-uri-stem LIKE '/sites/Insight/%'  GROUP BY DATE, cs-username" -q:Off -e:1 -o:datagrid
  • Access For Specific Pages:
    • Logparser -i:iisw3c "SELECT Date, cs-username, cs-uri-stem, COUNT (*) FROM C:\UsageStats\Source\W3SVC919260928\*.log WHERE cs-username <> NULL AND cs-uri-stem LIKE '/sites/Insight/%' GROUP BY DATE,cs-username,cs-uri-stem" -q:Off -e:1 -o:datagrid
  • Access to Reports in Report Centre:
    • Logparser -i:iisw3c "SELECT DATE,cs-username,cs-uri-stem,COUNT (*) FROM C:\UsageStats\Source\W3SVC919260928\*.log WHERE (cs-username <> NULL) AND (cs-uri-stem LIKE '/sites/Insight/ReportCentre/ReportsLibrary/%.aspx' OR cs-uri-stem LIKE '/sites/Insight/ReportCentre/ReportsLibrary/%.aspx') GROUP BY DATE,cs-username,cs-uri-stem" -q:Off -e:1 -o:datagrid

To find out where the log files are, follow these steps:

  1. Run Internet Information Services (Go to Start -> Control Panel -> Administrative Tools > IIS)
  2. Find your Web site under the tree on the left.
  3. Right-click on it and choose Properties.
  4. On the Web site tab, you will see an option near the bottom that says "Active Log Format." Click on the Properties button.
  5. At the bottom of the General Properties tab, you will see a box that contains the log file directory and the log file name. 

For example, if the window displayed the following values:

  • Log file directory: C:\Windows\System32\LogFiles
  • Log file name: W3SVC164203344\exyymmdd.log

Your FROM statement would be FROM C:\Windows\System32\LogFiles\W3SVC164203344\*.log

Comments welcome,

John

 

Comment Notification

If you would like to receive an email when updates are made to this post, please register here

Subscribe to this post's comments using RSS

Comments

No Comments

Leave a Comment

(required) 
(optional)
(required) 
Submit

This Blog

Syndication

News

Powered by Community Server (Personal Edition), by Telligent Systems