9.3 Generating Filr-Monitoring Reports

The report information displays on the same page or gets downloaded to your computer in CSV format. The CSV file downloads in a new tab that automatically opens in the same browser. So, you must ensure that your browser allows pop-ups. Downloading large reports might take considerable time.

IMPORTANT:The Filr server captures logs based on the user's local time zone. Hence, when you generate a report, it is recommended to consider + or - one day depending on the time zone difference between you and the user.

Path: Port 8443 Filr Admin Console System > Reports

Table 9-3 Using the Reports dialog

Field, Option, or Button

Information and/or Action

About the Reports

  • Most reports are created in CSV format for importing into a spreadsheet and manipulating the data to suit your needs.

    A few reports are displayed in the Reports window.

  • The default file name for CSV-format reports is report.csv.

    If you create multiple reports without manually renaming them, the default file name is incremented—report (n).csv.

  • CSV-format reports are saved in the default download directory for the browser being used.

  • Run a Report:

  • Click the drop-down list and select a report to run.

    The following sections describe the contents of each report.

9.3.1 Credits Report

Path: Port 8443 Filr Admin ConsoleSystem > Reports > Run a Report: > Credits

This report displays the portions of Filr that are subject to third-party copyrights and licenses.

9.3.2 Data Quota Exceeded Report

Path: Port 8443 Filr Admin ConsoleSystem > Reports > Run a Report: > Data Quota Exceeded Report

  • This report is only available when Data Quotas are enabled.

  • It lists users who have exceeded their data quota.

  • The CSV-formatted report contains the following:

9.3.3 Data Quota Highwater Exceeded Report

Path: Port 8443 Filr Admin ConsoleSystem > Reports > Run a Report: > Data Quota Highwater Exceeded Report

  • This report is only available when Data Quotas are enabled and one or more high-water marks are exceeded.

  • It lists users who have exceeded their data high-water mark.

  • The CSV-formatted report contains the following:

9.3.4 Disk Usage Report

Path: Port 8443 Filr Admin ConsoleSystem > Reports > Run a Report: > Disk Usage Report

  • This report is only available when Personal Storage is enabled.

  • You specify which of the following information to include in the CSV-formatted report:

    • Total Usage by User: Lists all Filr users whose disk space usage is above the amount specified in the Include only users or workspaces with usage greater than field.

    • Total Usage by Workspace: Lists all workspaces where disk space usage is above the amount specified in the Include only users or workspaces with usage greater than field. Disk space usage for each folder in each workspace is listed separately. The data is organized by workspace and folder ID.

    • Total Usage by User and Workspace: Combines the user and workspace data into a single report.

    • Usage Greater Than: The number of megabytes above which you want to list disk space usage. Use this to eliminates smaller disk space usages from being reported.

9.3.5 Email Report

Path: Port 8443 Filr Admin ConsoleSystem > Reports > Run a Report: > Email Report

  • Date Range: The date range defaults to the past month, but dates can be set by clicking in the date fields and using drop-down widgets to change the range.

  • Sent emails: Information about sent emails displays in the Reports window.

  • Error emails: Information about email-associated errors displays in the Reports window.

  • Received emails: Not operational because Filr cannot receive emails.

  • Displayed reports include the following information:

    • Send Date: When the email was sent.

    • From Address: Address that the email was sent from.

      This is the email address defined in the user profile.

    • To Address: Address that the email was sent to.

    • Type: Action that caused the message to be sent.

      For example, sendMail indicates that an item was shared.

    • Status: Status of the message.

    • Subject Line: Subject line of the message.

    • Attached Files: File name of any attachments that were included in the email message.

    • Errors: Any errors associated with the email message.

9.3.6 External User Report

Path: Port 8443 Filr Admin ConsoleSystem > Reports > Run a Report: > External User Report

  • Lists the following information about the external users you include in the People field. If the People field is left blank, all external users are included.

    • User ID

    • First Name

    • Last Name

    • Email Address

    • Creation Date

    • Terms Acceptance Date

9.3.7 File Block Report

Path: Port 8443 Filr Admin ConsoleSystem > Reports > Run a Report: > File Block Report

This report lists information about all the files blocked from uploading during a specified period of time.

  • Date Range: The date range defaults to the past month, but dates can be set by clicking in the date fields and using drop-down widgets to change the range.

  • People: All users are covered by default, but you can begin typing names and use the name-completion widget to select specific users for the report.

  • This report lists the following information about the files that were blocked from uploading.

    • User

    • File Name

    • File Operation

    • File Operation Time

    • Reason

    • IP Address

    NOTE:For files that are being uploaded through the web browser, Filr does a minimal check on the files at the browser level itself and does not upload or save files that must be blocked. This report does not include any entry for files that Filr blocks at the browser level.

9.3.8 Filr Outlook Report

Path: Port 8443 Filr Admin ConsoleSystem > Reports > Run a Report: > Filr Outlook Report

  • Date Range: The date range defaults to the past month, but dates can be set by clicking in the date fields and using drop-down widgets to change the range.

  • This report lists the following information about the email sent through Outlook and the details of the file uploaded on the Filr server and shared in the email:

    • Sender: The account from which the Outlook email is sent.

    • File Name: The name of the file on the Filr server that is shared in the email.

    • File Size: The size of the file on the Filr server whose link is shared in the email.

    • Sent Date: The date on which the email is sent.

    • Subject: The subject of the email.

    • Recipients: The email addresses to which the email was sent.

    • Accessed on: The date and time when the Filr file shared in the email was last accessed.

    • Expiration Date: The date and time when the Filr file link sent in the email expires.

    • Downloads Allowed: The total number of times that the Filr file whose link is shared in the email can be accessed.

    • Downloads Remaining: The number of times that the Filr file whose link is shared in the email can still be accessed.

9.3.9 License Report

Path: Port 8443 Filr Admin ConsoleSystem > Reports > Run a Report: > License Report

The License report lists the following information in the Reports window:

  • Filr version (ProductTitle)

  • License key type (Key uid)

  • Date the license key was issued (Key issued)

  • Date range when the license key is valid (Effective)

  • Information regarding registered and external user allowances.

  • The Date Range covered by the report (as set before Create Report is clicked)

  • Current Active User Count—user accounts that are not disabled.

  • List of dates in the date range with the following user license information:

    • Date: The date for which the data in the row applies.

    • Local Users: User accounts created within Filr and not being synchronized from an LDAP directory.

    • Users Synchronized from LDAP: User accounts created from an LDAP source. (Only synchronized accounts that are not marked as Deleted or Disabled are counted.)

    • Users with OpenID Accounts: OpenID is no longer supported. Users that self-provisioned using an OpenID account.

    • Self Registered Users: User accounts created when users self-provisioned.

    • Guest Access Enabled: Whether Guest access was enabled on the listed date.

    • Users in the Past 365 Days: Users who have logged in at least once in the past year.

    • Checksum: <waiting for information from Sanjeev.>

9.3.10 Login Report

Path: Port 8443 Filr Admin ConsoleSystem > Reports > Run a Report: > Login Report

NOTE:This report only covers web client users. Mobile and Desktop users are not currently tracked.

  • Date Range: The date range defaults to the past month, but dates can be set by clicking in the date fields and using drop-down widgets to change the range.

  • People: All users are covered by default, but you can begin typing names and use the name-completion widget to select specific users for the report.

  • Summarize Login Entries: Summarizes how many times the selected users have logged in using a web browser.

    The Sort Report By drop-down list, lets you presort the data alphanumerically by User, Last Login, or Number of Logins.

  • List All Login Entries: Lists each successful log in to the web client and includes the following data about the action:

    • User (first name, last name, and user ID)

    • Account type

    • Login date and time

    • IP address

    The Sort report by drop-down list lets you presort the data alphanumerically by either Login Date or User.

9.3.11 Orphaned User Share Report

Path: Port 8443 Filr Admin ConsoleSystem > Reports > Run a Report: > Orphaned User Share Report

The Orphaned User Share report lists the following information in the Reports window:

  • User: The name of the user who shared files or folders with other users and whose account is now either disabled or deleted. No information is displayed if the user object is deleted.

  • User State: The state of the account of the user who shared the files: disabled or deleted.

  • Entity Type: The type of entity (file or folder) that the user shared with other users.

  • Entity Name: The name of the file or the folder that the user shared with other users.

  • Path: The path of the shared entity.

  • Revoke: Displays Yes or No depending on whether the orphaned user shares are already revoked.

9.3.12 System Error Logs Report

Path: Port 8443 Filr Admin ConsoleSystem > Reports > Run a Report: > System Error Logs

Use this to download a logfiles.zip file of the error logs currently on the system.

  • Download Log: Generates a logfiles.zip file that contains the error logs currently on the system.

    • The zip file is downloaded to the browser’s download directory.

    • If you download multiple zip files without manually renaming them, the file name is incremented—logfiles (n).zip

9.3.13 User Access Report

Path: Port 8443 Filr Admin ConsoleSystem > Reports > Run a Report: > User Access Report

This report shows each Filr location that the specified user has access to.

  • User: Use the name-completion widget (type then select a name) to select a user you want to check.

    A report for the user is automatically displayed in the Reports window, showing each location that the user has access to.

9.3.14 User Activity Report

Path: Port 8443 Filr Admin ConsoleSystem > Reports > Run a Report: > User Activity Report

This report summarizes the significant actions that specified users have taken on the Filr site during a specified period of time.

  • Date Range: The date range defaults to the past month, but dates can be set by clicking in the date fields and using drop-down widgets to change the range.

  • People: All users are covered by default, but you can begin typing names and use the name-completion widget to select specific users for the report.

  • Activity Summary: This report lists how many times the selected users have performed the following actions in the Filr site:

    • User reported on

    • Views

    • Adds

    • Edits

    • Renames

    • Deletes (purge)

    • Pre-Delete (delete but not purge)

    • Restores (restore a deleted item that has not been purged)

    • ACL changes

    • Add shares

    • Modify shares

    • Delete shares

  • Workspace or Folder Activity: This report lists each individual user action and includes the following data about the action:

    • User performing the action

    • Activity type

    • Count

    • Activity date and time

    • Folder

    • Entry title

    • Entity type

    • Share Recipient

    • Recipient Type

    • Share Role

9.3.15 XSS (Cross-Site Scripting) Report

Cross-site scripting (XSS) is a client-side computer attack that is aimed at web applications. Because XSS attacks can pose a major security threat, Filr contains a built-in security filter that protects against XSS vulnerabilities. For more general information about XSS, see XSS—Filr Is Secure in the OpenText Filr 24.4: Maintenance Best Practices Guide.

Path: Port 8443 Filr Admin ConsoleSystem > Reports > Run a Report: > User Activity Report

  • Select the binders to be checked: Navigate the directory structure and select the directories you want to scan, then click Create Report.

    The generated lets you to remove potentially harmful XSS threats from your Filr site.

    IMPORTANT:Because XSS attacks often are designed to wait for users with extra privileges (such as the administrator) to view the page where the attack was set, it is important that you don’t navigate to the page after you run the report.

    For information about how to run the XSS report and safely remove XSS threats, see TID 7007381: Running the XSS Report in Filr in the Novell Support Knowledgebase.