Loupe - Log - Monitor - Resolve
Loupe / Developer's Guide / For ASP.NET MVC / Developer's Reference - Packaging and Sending Data
In This Topic
    Developer's Reference - Packaging and Sending Data
    In This Topic

    Once the Loupe Agent has captured data about your application, you need to be able to get that data moved to where you are so it can be analyzed and aggregated with other data.  To make this easy, the Agent includes data packaging and sending tools:

    Packager Wizard in Action

    Packager Wizard in Action

    What Does the Packager Do?

    The packager selects session files from the local repository on the computer where it's run, stores them into a Package Repository, and then stores the package repository to a location of your choosing.  With the packager, you (or the user) specify:

    The packager then safely gathers all of the matching sessions into a single, highly compressed Package Repository File which is then sent to its destination. 

     How Sessions are Selected by the Packager

    When creating a package, the Packager looks for sessions that are for a provided Product and optionally an Application within that Product.  If you use the Packager or Packager Dialog by default the current Product will be used (without an application filter, so any session for any application associated with that product will be eligible to be included).  Within that set of sessions, you have to specify additional criteria to tell the Packager what type of sessions you're interested in:

    Criterion Description
    Completed Sessions Sessions that have completed executing, regardless of whether they exited normally or crashed.
    Crashed Sessions Sessions that did not exit normally.
    Active Session The currently executing application session (does not apply to Gibraltar.Package)
    New Sessions Sessions that have never been sent before.
    Critical Sessions Sessions with at least one log message with severity Critical
    Error Sessions Sessions with at least one log message with severity Error
    Warning Sessions Sessions with at least one log message with severity Warning.

    You can combine multiple criterion together with each adding all of the sessions that match.  For example, adding Completed Sessions and Active Session gets all sessions that match either.

    If you're trying to report a problem or issue from an application while it's still running you'll want to use the New Sessions and Active Session option.  This will select every session that hasn't been successfully packaged previously and the current running session.  This will provide you with all of the historical data you haven't seen before (providing a good background perspective on what the user has been experiencing) and their current situation up to the moment the packager is run.
     Where can the Packager store the Session Data?

    If you have configured a Loupe Server connection and the Server is available the user won't be prompted to select how to transport the data and the Server will be used. 

    Otherwise, The packager provides the user with three options: 

    1. Send the sessions via email:  The package will be attached to an email.  A summary of the sessions will be written into the body of the email and a useful email subject line will be generated.  The user can optionally provide a reply-to email address.  To use this option, you (or the end user) will need to have configured email server information into the .NET configuration file.
    2. Send the sessions to a file:  The package will be stored to a file name & path of your choosing.
    3. Send the sessions to removable media:  This is a variation of sending to a file where the user selects just the removable media or network drive to store the sessions to and they are stored with a unique, descriptive package file name automatically.  This is specifically designed to be useful in embedded systems or other scenarios where no Internet connection is available.

    You can selectively disable these options by configuring the Loupe Agent which will affect how the Packager Dialog or Gibraltar.Package work.  If you use the Packager class directly, the configuration options can be ignored.  For more information on the configuration options available see Developer's Reference - Packager Configuration.

    Where To Next?

    See Also