Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space TEADOC and version 5.0
Sv translation

Teamstudio Usage Auditor is configured by creating Server Configuration documents and specifying options to control how data is collected.   

Server Configurations can be disabled or enabled by selecting configuration documents and clicking the Deactivate or Activate action in the view.

To create a new Server Configuration, navigate to the Admin > Server Configurations view via the left-hand navigator, and click the Create Configuration action. 

A new Server Configuration document will appear.  Inline help is visible when the document is in edit mode. See below for detailed descriptions of these settings.





Servers To Scan: Enter or choose the name of the server(s) that should be scanned when this configuration is run.  Multiple servers can be listed, one per line, if the same settings are desired for each.   Alternately, separate configuration documents can be used for each server.

Status: Active server configurations will be scanned when the specified Scanning Server instance runs scans.  Configurations can be marked Inactive to temporarily disable scanning.

Scanning Server: Select Local to run the scan on the current workstation.  Because of the intensive processing involved in collecting and reporting on usage statistics, it is not currently recommended to run Usage Auditor on server.


Mail Folder: List folder(s) one per line whose content should be identified as Mail databases.  Databases marked as Mail can be hidden from Database views to make it easier to analyze usage of other applications.


User Lookup: Choose Yes to enable Domino Directory (Address Book) lookups when user names are processed.  Enabling this feature will identify the type of user as User, Server, or Unknown.

If this setting is set to No, no lookup will occur, and all user names will be marked as Users.

On Notes/Domino prior to version 8, the file name of the address book must also be specified.  This file name is ignored on Notes/Domino 8+.

Ignore Threshold: This setting can be configured to limit the number of users added to the User table on Database documents.  Once the limit is hit, the Database document will be automatically marked Ignore (see Cutoff Action below), and user-level activity will not be tracked.  Ignored databases can also be hidden from views.

This setting is useful for focusing analysis on databases that fall within lower usage limits.  For example, if only applications with less than 50 user will be considered for decommission

or moved to another server, this setting can be used to reduce clutter from higher use databases in the views.


Size Limit Cutoff Action: Defines what action will be taken when the User table on Database documents has grown too large to store.  

Usage Auditor stores user names of users who have accessed an application in the Database document, to provide a consolidated view of usage.  Notes/Domino limits the amount of “summary data” (data that can be displayed in views) to approximately 64K.  This limit is typically hit in the vicinity of 1000 names, although it can vary greatly depending on the average length of the names in use. In order to manage this limitation, Usage Auditor can do one of two things when this limit is approached:

Ignore marks the Database document as ignored, and user-level tracking is disabled for this application going forward.  This is useful when the goal is to categorize applications into usage bands, where it may be assumed anything with a large number of users will fall in a certain category.

Reset removes all values from the user table and begins over.  This option can be used when it is desirable to know which users most recently used the application.

Database level statistics, for example the total number of hits, continue to be tracked regardless of which setting is chosen.


Use Common Name: Specifies whether the Database documents track users by Common name (e.g. John Smith) or by the Abbreviated name (e.g. John Smith/Sales/Acme).  Storing common name reduces the byte size of the name and allows more names to be stored before hitting the Size Limit Cutoff as described above.  However, if users have the same user name (for example, IDs in multiple organizational units or domains), they will not be distinguishable in Database documents.


Save Supporting Data: Choosing Yes for this setting will cause Usage Auditor to save compressed versions of the raw usage data collected from the server’s Activity Log.  Saving this data can help Teamstudio support troubleshoot, should any issues arise. 

Saving this data may also allow Teamstudio support to regenerate usage statistics for the entire period of usage tracked by Usage Auditor (vs. the default 2 week period tracked by the Domino server) if needed.

It is recommended to enable this setting unless file size of the Usage Auditor database is an issue.


Detailed Logging: Detailed logging can be enabled to provide additional information about the scanning process, for troubleshooting purposes.  Additional logging increases the file size of the Usage Auditor database.

Sv translation

Teamstudio Usage Auditor は「Server Configuration」文書を作成し、データ収集方法の制御オプションを指定して設定を行います。

Server Configuration」はビュー上に表示されている設定文書を選択し「Deactivate」や「Activate」アクションをクリックして無効化したり有効化できます。

新規の「Server Configuration」を作成するには、左のナビゲーターから「Admin」> 「Server Configuration」ビューから「Create Configuration」アクションをクリックします。

「Server Configuration」文書が表示されます。文書が編集モードのときにインラインヘルプが利用できます。これらの設定に関しての説明は以下に説明します。


Servers To Scan: この設定でスキャンする対象のサーバー名を入力または選択します。複数サーバーにまたがる場合には、一行ごとにサーバーをリストしてください。あるいは、別のサーバー設定文書を作成してひとつひとつサーバーを指定しても構いません。

Status: 有効化(Active)にすると Scanning Server で指定した対象のサーバーをスキャンするようになります。逆にスキャンを無効にしたい場合には、設定を無効化します。

Scanning Server: 現在のワークステーション上でスキャンを実行するには Local を選択します。利用状況の統計を収集し、レポートするのに負荷の大きい処理が必要なため、現在のところ Usage Auditor をサーバー上で起動するのは推奨されていません。

Mail Folder: メールデータベースが存在するフォルダーを一行につきひとつフォルダー名を指定してください(通常は「mail」)。メールとして認識されたデータベース群は Database ビューで非表示となり、他の業務アプリケーションの利用状況を分析するが容易になります。

User Lookup: Yes を選択するとドミノディレクトリー(アドレス帳)を参照し、ユーザー名が処理されます。この機能を有効にするとユーザーのタイプを User, Server, または Unknown のタイプに振り分けます。

No を指定すると、参照は行わず、すべてのユーザー名は Users として識別されます。

Notes/Domino のバージョン 8 より前のバージョンでは、アドレス帳のファイル名を必ず指定してください。このファイル名は Notes/Domino 8 以上では無視されます。

Ignore Threshold: この設定で Database 文書内の User List テーブルに追加するユーザーの数を制限できます。制限値に到達すると、Database 文書は自動的に無視されるよう振り分けられ(下の Cutoff Action を参照)、ユーザーレベルでのアクティビティは追跡しなくなります。無視された文書はビューからも非表示になります。

この設定は利用の制限を低く抑えることでデータベースの解析に役立ちます。例えば、使用頻度の低いデータベースを棚卸しするうえで、アプリケーションの利用ユーザーが 50 にも満たないものは削除したり、アーカイブ用の他のサーバーに移したいと考えたとき、ビュー上には高頻度で使用されるデータベースは考慮から除外され、低使用頻度のアプリケーションによりフォーカスできるようになっています。

Size Limit Cutoff Action: Database 文書の User List テーブルが情報を格納するのに大きくなりすぎた場合にどのようなアクションをとるかを指定します。

Usage Auditor は Database 文書にアプリケーションにアクセスしたユーザー名を格納し、利用状況のユーザー別ビューにその内容を表示します。 Notes/Domino は「サマリーデータ」(ビューに表示するデータ)はおおよそ 64K というサイズ制限があります。ユーザー名の平均的な長さにもよりますが、この制限はおおよそ 1000 の名前に相当するものと想定されます。この制限に到達したときに、Usage Auditor がこの制限に対して行うふたつの対処からひとつを選択できます:
Ignore は Database 文書に対し今後無視するようにフラグが立ち、ユーザーレベルでのこれ以降のこのデータベース追跡を無効にします。とりわけアプリケーションの利用状況の多さや利用ユーザー数をアプリケーション毎に分類することを目的する場合にはとても効果的で、ある一定量の利用ユーザーがあることを証明するものです。

Reset は User List 内の値をすべて削除して最初から記録を開始します。このオプションは、このアプリケーションを最近利用したユーザーを知る手がかりになります。

Use Common Name: Database 文書の追跡をユーザーの共通名(例 John Smith) で行うか、階層名(例 John Smith/Sales/Acme) で行うかを指定します。共通名のほうが、ユーザー名の情報を格納するには少ないサイズで行うことができ、上記の Size Limit Cutoff に到達する機会を少なくさせます。言うまでもなく、共通名を使用すると、複数の組織やドメインに所属しているユーザーを追跡する場合には Database 文書ではそのユーザーがどの ID でアクセスしたか区別が付かなくなることがあります。

Save Supporting Data: この設定を Yes に選択すると、Usage Auditor はサーバーのアクティビティログから収集した利用状況の生データを圧縮して保存します。このデータを保存しておくと問題が発生した際に、チームスタジオのサポートがこのデータから Usage Auditor で利用状況を追跡した全期間の利用状況の統計(一方、Domino からでは 2週間分しか追跡できません)を再生成することができ、トラブルシューティングに役立ちます。

Usage Auditor データベースのファイルサイズが問題にならない限り、この設定を Yes に選択することをお勧めします。


Detailed Logging: この設定ではトラブルシューティングが目的でスキャンのプロセスに関する詳細の情報を提供されるよう設定できます。この追加のログ出力では Usage Auditor データベースのファイルサイズを増加させますので、適時判断してください。