Search the Confluence 4.1.x Documentation:

Index
Downloads (PDF, HTML & XML formats)
Other versions

This documentation relates to Confluence 4.1.x
If you are using an earlier version, please view the previous versions of the Confluence documentation and select the relevant version.
Skip to end of metadata
Comment: Corrected links that should have been relative instead of absolute.
Go to start of metadata

Note that the space activity information is disabled by default. See notes below.

If enabled, the space activity screen displays statistics on the activity in each space. These include:

  • How many pages and blog posts have been viewed, added or updated over a given period.
  • Which content is the most popular (most frequently viewed).
  • Which content is the most active (most frequently edited).
  • Which people are the most active contributors/editors of content.

To view the activity in a space:

  1. Go to a page in the space and choose Browse > Space Admin.

  2. Go to the Activity tab.

Confluence will show a graphic display of the number of pages and blog posts that have been viewed, added and edited, showing trends over a period of time. For example:


Screenshot 1: Number of viewed pages and blog posts in a week

The top ten most popular and most active pages and/or blog posts will be listed, with a link to each.


Screenshot 2: Popular content

Notes

  • The Confluence Usage Stats plugin, which provides the 'Space Activity' screen, is known to cause performance problems on large installations. This plugin is disabled by default. A status report on the progress of the performance issues with this plugin is available in this issue: USGTRK-15.
  • Your Confluence system administrator can enable the plugin, but please be aware of the possible impact upon your site's performance.
  • The plugin is sometimes called 'Confluence Usage Tracking'.
  • If your Confluence site is clustered, the space activity information will not be available.

Related Topics

Browsing a space
Viewing Space Details
Page History and Page Comparison Views
Watching Changes
Finding Unused Spaces
How Do I Get More Statistics From Confluence?
Installing and Configuring Plugins
Viewing Site Statistics

Take me back to Confluence User's Guide

34 Comments

Hide/Show Comments

  1. Apr 13, 2007

    Chris Novak

    Is there a way to show the  top 10 most popular and most active pages on another page somewhere?  I would like to put that info via a macro on another page.

    1. May 02, 2007

      Andrej Danko

      displays 10 newest pages that are children of abc:

      {tracking-table:scope=abc>children|types=page|sort=creation date desc|maxResults=10}
      {tracking-column:value=title|title=Ten Newest}
      {tracking-table}

      1. Oct 03, 2007

        David Soul [Atlassian]

        Users will need to install the free Tracking Plugin that contains these tracking macros

  2. Feb 27, 2008

    Joseph Kreke

    I'm looking for a way to list all users who have accessed (view, edit, comment) a page within a space.  The closest thing I've found is the contributors-summary command which has an option to limit the scope to a particular page, but it doesn't have the option to count and identify those who merely view the page.  This is an important feature that we need.  I think the command could be "tweaked" to have the option of including views since it can capture "edits" as well as "edited" counts.  The view option seems that it would be an easy change(my guess). 

    1. Feb 28, 2008

      Ming Giet Chong

      Hi Joseph,

      I would suggest you to raise a feature request at the Contributor plugin's issue tracker at:

      Regards,
      MG

    2. Sep 15, 2010

      Remo Siegwart

      You may want to check out our viewtracker plugin for tracking page views per user: https://plugins.atlassian.com/plugin/details/28637

      It's free & open source

  3. Jun 20, 2008

    Paul Csapo

    Hi,
    If a page is very active, and then later it is deleted, will the activity page still show it for the timeframe that it was active? (assuming that it was one of the most active).

    thanks,
    Paul

    1. Jun 23, 2008

      Ming Giet Chong

      Hi Paul,

      I have done a quick test in Confluence 2.8.1 and the deleted page will still show on the Space Activity page.

      Regards,
      MG

      1. Jun 23, 2008

        Paul Csapo

        Ahh, many thanks for the confirmation, Ming.
        thanks,
        Paul

  4. Aug 19, 2008

    Kevin Aubeelack

    I've been looking at the sources for the usage stats and I'm a bit confused. I know that these stats aren't stored in the confluence DB. They seem to be stored in an index file that's accessed by Lucene? Where is this index file stored? Does lucene do the logging (writing) into this index file or is there some kind of logger that writes usage events from confluence into that file?

    1. Aug 25, 2008

      Azwandi Mohd Aris [Atlassian]

      Hi Kevin,

      The plugin that does the job for tracking Confluence activity is Usage Tracking Plugin. You might want to study the source of this plugin to understand more on the indexing mechanism and the implementation of Confluence listener plugin.

      As far as I am concerned, the data is stored as Lucene Index File Format that resides in the <confluence-home>/index/plugin/usage directory. You can try to use Luke to view the contents of those index files.

      Hope this helps.

      Cheers,
      Azwandi

      1. Sep 24, 2008

        Anonymous

        Dude big thanks! That was very useful (smile)

  5. Oct 19, 2008

    Anonymous

    Is it possible to view more the top 10 pages?

    1. Oct 22, 2008

      Azwandi Mohd Aris [Atlassian]

      Hi,

      You can use the {popular} macro bundled in Confluence Usage Tracking Plugin and set the maximum count:

      {popular:max=20}

      Hope this helps.

      Cheers,
      Azwandi

      1. Oct 18, 2011

        camomile

        the {popular} macro starts counting after the page is saved. It does not present the popular pages for the previous period before the page is saved. If the page is edided often, this macro do not have sense ((

  6. Mar 04, 2009

    Todd Hamrick

    The statistics presented to a user are different if he or she is logged-in vs. "anonymous." It makes sense that if a page is restricted, and the user doesn't have access, those statistics would not be presented.

    Is there any place that documents the full logic/rules applied to Space Activity when logged-in vs. "anonymous?" For example, if a page was restricted and then restriction is removed at a later date, it appears those users who had the restricted access see a different number than those who didn't and who gained access when the restriction was lifted.

    Many thanks!

    1. Apr 22, 2009

      Arie Murdianto

      Hi,

      I am sorry that this feature is not implemented yet in Confluence. I would suggest you to raise a new feature request to our jira:

      Cheers,

  7. Jun 29, 2009

    Karen Wright

    We have upgraded from 2.10 to 3.0 and the 'Activity' tab has disappeared.

    Where is the 'Activity' tab in Confluence 3.0?

    1. Jun 29, 2009

      Mark Hrynczak [Atlassian]

      Due to performance issues in high load environments, the Confluence Usage Tracking Plugin is disabled by default in Confluence 3.0. While upgrading to Confluence 3, the plugin will be turned off even if it was active before. We do still deliver the plugin as part of Confluence (and have even improved its performance since 2.10), so if you don't have a high load environment and are happy with the performance of the plugin, you can easily reactivate this plugin through the Administration Console.

      1. Aug 24, 2010

        Adam Dry

        Hi Mark,

        I'm running Confluence 3.1.2.

        What counts as a "high load environment"? 100+, 1000+?

        Also what are the measures to restore performance, simply disable the plugin or is a restart required as well?

        Cheers!

        1. Aug 24, 2010

          Mark Hrynczak [Atlassian]

          Hi Adam,

          We find that when most customers go past the 2,000 user mark this plugin generates issues for them. It also depends on the number of concurrent views/edits, which differs regardless of the number of users you have.

          I'm not too sure about the steps needed for restoring performance. I would guess that just disabling it would be enough, but if you want a more authoritative answer then raise a ticket at https://support.atlassian.com

          Cheers,
          Mark

          1. Aug 25, 2010

            Adam Dry

            Thanks for getting back to me Mark.

            I checked this KB article (http://confluence.atlassian.com/display/CONFKB/Poor+Performance+due+to+Confluence+Usage+Plugin+-+Space+Activity) and it just says disable the plugin but I have raised a ticket just to make sure as my client won't be happy if I say no downtime is required and it is! :)

            Might be worth putting the 2000+ users as a guidline on the KB article?

            Again, cheers for replying, v helpful! :)

            Adam

  8. Jul 06, 2009

    Anonymous

    Is it possible to use the

    code on the dashboard? I tried to include it but it gives an exception error.

    1. Jul 21, 2009

      Sashidaran Jayaraman [Atlassian]

      Hi,

      Most probably you have left out the spaces parameter in the macro.
      The spaces parameter is required in this context as the dashboard doesn't belong to any space.
      When you use the same macro in a page, the current space will be used as the parameter.

      The following code in Global Layout works for me:

      Hope that helps.

      Cheers
      JSashi

      1. Aug 17, 2009

        Anonymous

        Thanks a lot. That worked

        1. Aug 18, 2009

          Sashidaran Jayaraman [Atlassian]

          Hi,

          Glad that it worked for you.
          Have a nice day.

          Cheers
          JSashi

  9. Aug 17, 2010

    Anonymous

    Hello,

    a question about the View Pages Statistics.

    Does Confluence count unique users or every click on a page from the same User?

    So, is there a way to see the count of unique users over a period?

  10. Sep 27, 2010

    Anonymous

    Hi,

    Does the acitvity plugin only record activity once the Confluence User Lister plugin is enabled?

    Cheers
    Sabera

  11. Nov 08, 2010

    Anonymous

    What if I want to trace 20 of 100, How many have added, edited or commented by each of them?

  12. Nov 18, 2010

    John Kung

    If your Confluence site is clustered, Space Activity will not be available? When will this be fixed? Usage reporting capability is a very fundamental feature if Confluence is positioned to be an enterprise grade produce. Thanks.

    1. May 20, 2011

      Anonymous

      Old topic, but when would space activity work in clustered confluence?  Confluence wiki is an enterprise wiki solution, having space activity types of reports is a must.  Thanks.

  13. Mar 25, 2011

    Anonymous

    Is there a way to get the global stats page to display elsewhere in Confluence for general consumption. I love the information, but I would like to have everyone see the information in that format.

    Thanks!

    Michael

    1. May 06, 2011

      Brent Lewis

      See this: http://confluence.atlassian.com/display/DISC/Confluence+Reporting+HOWTO

      and this: http://confluence.atlassian.com/pages/viewpage.action?pageId=154239308

  14. Jan 26, 2012

    Bill Bailey

    I have enabled v0.16 on Confluence 4.0. At first, all reports were not working. all I get is "no data available" . Then the Global report worked, but in the Space Activity report I get is "no data available" , and the bottom three reports return "Error in macro: java.lang.NullPointerException"

    Not sure what is up? Any help appreciated

    Thanks,

    Bill