How to: Use the Activity Log

VSPackages can write messages to the activity log. This feature is especially useful for debugging VSPackages in retail environments.

Tip

The activity log is always turned on. Visual Studio keeps a rolling buffer of the last one hundred entries as well as the first ten entries, which have general configuration information.

To write an entry to the activity log

  1. Insert this code in the Initialize method or in any other method except the VSPackage constructor:

    Dim log As IVsActivityLog
    log = GetService(GetType(SVsActivityLog))
    If log Is Nothing Then 
        Return 
    End If 
    
    Dim hr As Integer
    hr = log.LogEntry(CType(__ACTIVITYLOG_ENTRYTYPE.ALE_INFORMATION, UInt32),
        Me.ToString(),
        String.Format(CultureInfo.CurrentCulture,
        "Entering initializer for: {0}", Me.ToString()))
    
    IVsActivityLog log = GetService(typeof(SVsActivityLog)) as IVsActivityLog;
    if (log == null) return;
    
    int hr = log.LogEntry((UInt32)__ACTIVITYLOG_ENTRYTYPE.ALE_INFORMATION,
        this.ToString(),
        string.Format(CultureInfo.CurrentCulture,
        "Entering initializer for: {0}", this.ToString()));
    

    This code gets the SVsActivityLog service and casts it to an IVsActivityLog interface. LogEntry writes an informational entry into the activity log using the current cultural context.

  2. Load the VSPackage.

To examine the activity log

  1. Find the activity log in the subfolder for Visual Studio data.

    For example, %AppData%\Microsoft\VisualStudio\12.0\ActivityLog.XML.

  2. Open the activity log with any text editor.

    Following is a typical entry:

    50  Entering initializer for: Company.MyApp.MyAppPackage ...
    

Robust Programming

Because the activity log is a service, the activity log is unavailable in the VSPackage constructor.

You should obtain the activity log just before writing to it. Do not cache or save the activity log for future use.

See Also

Tasks

How to: Troubleshoot VSPackages

Reference

IVsActivityLog

__ACTIVITYLOG_ENTRYTYPE

Other Resources

VSPackages