Sample Lync Server Archiving Report Available
Update 11/26/13 - I have release an updated version of the reports. This version of the reports includes a Dashboard. See the changelog below for more details on what's new.
The Sample Lync Server Archiving Report is an update to the popular Sample OCS Archiving Report, however this report has been completely redesigned based on feedback from the community. We've expanded the report to include more information from the archiving database and we've changed the layout of the report to make the information easy to consume.
Features
- Dashboard report to provide an overview about information in the archiving database
- View detailed information about P2P IM conversations and conferences
- Search for IMs and Conferences by SIP address and date
- Select from multiple Lync Server Archiving databases to search against
- Web-based SSRS reports can be used by anyone with rights and a web browser
The reports have been tested against Lync Server 2010 and Lync Server 2013 using SQL Reporting Services 2012. You will need to have a functioning SQL Reporting Services server before trying to deploy this report.
Installing the Reports
- Download the latest version of the Sample Lync Server Archiving Report
- Extract the zip file
- Open Report Manager – http(s)://<SRS Server>/Reports
- Click on New Folder
- Give the folder a name – i.e. LyncArchivingReport
- Click OK
- Click on the folder you just created
- Click on Upload File
- Browse to the location where you extracted the LyncArchivingReport zip file and select Search.rdl
- Click OK to upload the report
- Repeat Steps 9 and 10 for the rest of the reports
- (Optional) - To remove the reports from the default view, since you can't directly access them:
- Go to the properties of the Conference Details Report by clicking on the drop-down and selecting Manage
- Click on Hide in tile view
- Click Apply
- Go back to the LyncArchivingReport folder and repeat for the Conversation Details Report
- To configure the report to use your SQL Server(s), you will need to open the Search report in SQL Server Report Builder
- Click on the drop-down for the Search report and select Edit in Report Builder
- If this is the first time you've used Report Builder on this computer, select Run when the Do you want to run this application? prompt appears
- In SQL Server Report Builder, in the Report Data section, expand Parameters and double-click on SqlConnectionString
- In the Report Parameter Properties window, click on Available Values
- Click on Specify values
- Click on Add
- Enter your Lync Server Archiving Server SQL Server information in boxes in the following format:
- Label: SQL Server Friendly Name
- Value: Data Source=<SQL Server FQDN\Instance>;Failover Partner=<SQL Server FQDN\Instance>;Initial Catalog=LcsLog
- i.e. Data Source=LAB-SQL1\Lync;Failover Partner=LAB-SQL2\Lync;Initial Catalog=LcsLog
- Note: If you're not using SQL Mirroring for the LcsLog database, then you don't need to include the Failover Partner piece.
- Repeat Steps 17 and 18 for all Lync Server archiving databases in your environment
- (Optional) - If you only have one archiving database, you can set the default value so that you don't need to select the SQL Server every time you use the report
- Click on Default Values
- Click on Specify values
- Click on Add
- In the drop down, select your SQL Server
- Click on General
- Select Hidden under Select parameter visibility
- Click OK
- Click Save in the Quick Access Toolbar to save the changes to the reporting server
- Close SQL Server Report Builder
- Repeat Steps 13 through 23 for the Dashboard report.
If there are users that will be running the Dashboard report that don't have dbo rights to the LcsLog database, they may get the following error:
An error has occurred during report processing. (rsProcessingAborted)
Query execution failed for dataset 'DatabaseVersion'. (rsErrorExecutingCommand)
The EXECUTE permission was denied on the object 'DbGetVersion2', database 'LcsLog', schema 'dbo'.
This is because they don't have access to run the DbGetVersion2 stored procedure. You will need to perform the following additional steps to grant access:
In SQL Server Management Studio, add the user or group that contains the users you want to be able to run the Dashboard report in the Security > Users folder under the LcsLog database. Right-click on the user and select Properties. Make sure that the Securables page is displayed:
Click on the Search button:
Make sure that Specific objects is selected and click OK. Click on the Object Types button:
Select Stored procedures and click OK. Click on the Browse button:
Select [dbo].DbGetVersion2] and click OK:
Click OK:
Select the Grant check box for the Execute permission. Click OK.
The reports are now ready to be used.
Using the Reports
Dashboard
Note: You may need to click on the image above in order to read the text.
The Dashboard report shows you an overview about information contained in the archiving database. You can see information about the SQL Server that hosts the archiving database, as well as, information about the archiving database itself. The number of instant messages and conferences are shown for the time period selected as well as top users for instant messages and conferences.
Search
Note: You may need to click on the image above in order to read the text.
The Search report is the main report that you will use. As it's name implies, this is the report that you will use to generate your queries against the archiving database. The report requires a couple pieces of data, namely the SIP addresses of the user's that you want to search against and the date range of the search. If you want to search every user or if you only want to search for any communications to/from a single user, use the NULL option. This essentially means any user. You can also pick the SQL Server you want to run the query against.
The results are broken up into two sections, Instant Messages and Conferences. Clicking on the link will drill down into more information for that conversation.
Conversation Details Report
Note: You may need to click on the image above in order to read the text.
Drilling down into an instant message conversation will display something similar to above. You can see when and who sent the initial message, as well as the client versions of the users, and a transcript of the conversation.
Conference Details Report
Note: You may need to click on the image above in order to read the text.
Drilling down into a conference shows you a lot of information gathered by the Archiving Server role. You can expand each section to take a look at the data that was captured.
Please leave any questions/comments/feedback in the comments section below.
Click here to download the latest version of the report.
Changelog
November 2013 Release
Search - 1.2
- Increased width of "Data from" textbox
- Changed End Date range to -1 day from the current date
- Added support for SQL mirroring
- Other formatting changes
Conversation Details Report.rdl - 1.1
- Increased width of "Data from" textbox
- Fixed conversations missing from federated contacts
Conference Details Report - 1.1
- Increased width of "Data from" textbox
- Fixed column formatting issues - changed to a landscape layout
- Added Expand All/Collapse All toggle
- Added additional sorting options
- Other formatting changes
Dashboard - 1.0
- Initial Release
Known Issues
- Meeting Data Location for Lync Server 2010 conferences is not a valid link.
- All times are displayed in UTC. Trying to convert the times to local time zones automatically isn't possible.
- IM conversations that contain Unicode characters may not be displayed correctly. SSRS doesn't natively have a way to parse RTF text. If the conversation is stored in the archiving database in RTF, some non-Latin characters may be stored as Unicode. This means that the report will not display those IM messages correctly.