Home

 

View and collect Bookmarks metrics

Enter a URL to view a standard set of Bookmarks metrics, or use administrative commands to collect metrics for the Bookmarks feature and write them to a file. No file check out or server restart is required when using these commands.


There are two ways to view and collect metrics. The simplest way is to enter the following URL and view the full set of metrics available for the feature.

where <servername.com:port> is the appropriate host name and port number for your server. The metrics in the first two columns display. The third column is the corresponding wsadmin command that you can use to retrieve individual commands or aggregate metrics in a file, as described below.

Description Metric key
Total number of bookmarks (public and private) dogear.metric.bookmarks
Total number of unique bookmarks dogear.metric.unique.urls
Average number of bookmarks per user dogear.metric.users.avg_bookmark
Average number of bookmarks for top 10% of users who have bookmarks dogear.metric.topusers.avg_bookmark
Percent of bookmarks that are public dogear.metric.percent.public.bookmarks
Number of bookmarks posted to Bookmarks in the past 7 days dogear.metric.newbookmarks.lastweek
Number of new (unique) bookmarks added in the past 7 days dogear.metric.unique.urls.lastweek
Number of bookmarks with at least 1 tag dogear.metric.urls.onemoretag
Total number of watchlisted items dogear.metric.subscriptions
Total number of tags dogear.metric.tags
Total number of unique tags dogear.metric.unique.tags
Average number of tags per bookmark dogear.metric.average.tags
Number of tags added in the past 7 days dogear.metric.newtags.lastweek
Number of new (unique) tags added in the past 7 days dogear.metric.tags.lastweek
Number of users with at least one bookmark dogear.metric.users.w_bookmark
Number of users with watchlists dogear.metric.users.subscriptions
Number of users who logged into Bookmarks in the past 24 hours dogear.metric.lastlogin.today
Number of users who logged into Bookmarks in the past 7 days dogear.metric.lastlogin.lastweek
Number of users who logged into Bookmarks in the past 30 days dogear.metric.lastlogin.lastmonth
Number of users who posted bookmarks in the past 7 days dogear.metric.users.submitbookmarks.lastweek
Number of users who have more than 10 bookmarks dogear.metric.users.morethanXbookmarks
Number of users who have not logged into Bookmarks for 90 days dogear.metric.users.notlogin4Xdays
Number of users who sent notifications in the past 7 days dogear.metric.users.notify.lastweek
Number of users who received notifications in the past 7 days dogear.metric.users.notified.lastweek

The metrics are cached for one hour. Within that hour, if you access the metrics URL (or access metrics using the wsadmin command) the metrics numbers will be the same – because they are read from the cache. Once the cache expires, then the next time you request metrics data, the database is queried for the updated information, and you will see updated numbers.


To exercise greater control over what metrics you want to view or to write them to a file, follow these steps to use wsadmin commands for managing metrics.

See Start the wsadmin client for details on using the wsadmin client.

  1. Open a command window and start the wsadmin command line tool as described in the topic, Starting the wsadmin client.

  2. Start the Bookmarks Jython script interpreter by entering the following command:

    • Single server: 

        execfile("dogearAdmin.py")

  3. Cluster: 

      execfile("WAS_HOME/dogear/DMGR/config/bin_lc_admin/dogearAdmin.py")

  4. Enter one of the following commands to collect the current metrics:

    • To collect all of the metrics at once, and have them returned as a hashtable: 

        DogearMetricsService.fetchMetrics()

  5. To collect one or a subset of metrics: 

      DogearMetricsService.fetchMetric("<metric_to_fetch>")

    where the <metric_to_fetch> is one of the metrics defined in the metrics table above.For example: 

      DogearMetricsService.fetchMetric("dogear.metric.bookmarks")  DogearMetricsService.fetchMetric("dogear.metric.tags")    DogearMetricsService.fetchMetric("dogear.metric.unique.tags")    DogearMetricsService.fetchMetric("dogear.metric.average.tags")    DogearMetricsService.fetchMetric("dogear.metric.subscriptions")  DogearMetricsService.fetchMetric("dogear.metric.users.subscriptions")

  6. Use one of the following commands:

    • To write all of the metrics to a file: 

        DogearMetricsService.saveMetricToFile("<file_name>",
<number>,"all")

    where you provide values for the following variables:

    • <file_name> – Full path to a text file in which to store the metric information. If the file does not exist, one will be created.

    • <number> – The number of entries to persist in the file. If you specify 20, and add one new entry to the file, the file retains the last 19 entries and adds your new entry. Any older entries are deleted.

    For example: 

      DogearMetricsService.saveMetricToFile(“C:/ibm/LotusConnections/Data/
	Bookmarks/AppSrv01_server1/metrics/AllDogs.txt”, 40, “all”)

  7. To write one metric to a file: 

      DogearMetricsService.saveMetricToFile("<file_name>",
<number>,"<metric_to_save>")

    where you provide values for the following variables:

    • <file_name> – Full path to a text file in which to store the metric information. If the file does not exist, one will be created.

    • <number> – The number of entries to persist in the file. If you specify 20, and add one new entry to the file, the file retains the last 19 entries and adds your new entry. Any older entries are deleted.

    • <metric_to_save> – Metric that you want to write to the file. See the metrics table above for a list of options.For example: 

        DogearMetricsService.saveMetricToFile(“C:/Connections/metrics/AllDogs.txt”,40,“all”) DogearMetricsService.saveMetricToFile(“C:/Connections/metrics/MetricLnks.txt”,40,“dogear.metric.bookmarks”) DogearMetricsService.saveMetricToFile(“C:/Connections/metrics/MetricTags.txt”,40, “dogear.metric.tags”) DogearMetricsService.saveMetricToFile(“C:/Connections/metrics/UniqueTags.txt”,40,“dogear.metric.unique.tags”) DogearMetricsService.saveMetricToFile(“C:/Connections/metrics/AvgTags.txt”,40,“dogear.metric.average.tags”) DogearMetricsService.saveMetricToFile(“C:/Connections/metrics/Subscripts.txt”,40,“dogear.metric.subscriptions”) DogearMetricsService.saveMetricToFile(“C:/Connections/metrics/UsrSubscrpts.txt”,40,“dogear.metric.users.subscriptions”)

  8. To write a subset of metrics to a file:

    1. Define an ArrayList java object variable named fldkeys.

    2. Add the subset of metrics that you want to write to a file to the array. For example: 

        from java.util import ArrayList  fldkeys=ArrayList()     fldkeys.add("dogear.metric.bookmarks") fldkeys.add("dogear.metric.tags")  fldkeys.add("dogear.metric.unique.tags")

    3. Use the following command to write the subset of metrics to a file: 

        DogearMetricsService.saveMetricsToFile(“C:/Connections/metrics/MetricLnks.txt”,40,fldkeys)


Administer Bookmarks

Collect metrics

+

Search Tips   |   Advanced Search