Zephyr Audit Logs

Owned by Kevin Pham (Deactivated)
Apr 15, 2020
7 min read

 

About Zephyr Audit Logs

Zephyr provides the audit logs to the administrators to keep track and view the changes that have been made to your Zephyr instance. This is extremely useful as it allows you the flexibility and support to troubleshoot a problem. Keeping a well kept audit log of the events happening in your Zephyr instance is key as it allows you to record all the important events happening. Utilizing your audit logs can also be beneficial when troubleshooting issues that arise as it lets you see what events are happening and when they occur.

Zephyr has added comprehensive data for events that occur in your Zephyr application for the following:

  • Requirements

  • Test case management

  • Admin and configuration setting changes

  • Re-indexing attempts and results

  • Customization changes

    • Updating the estimated time and execution status creation

  • User setup events

    • Creation, role updates, exporting functionality and any user update action

  • Group setup events

    • Adding, Editing, Deleting, Syncing and Importing Groups

Whether your tracking permission changes or project re-indexes, Zephyr’s audit log tracks and provides meta-data according to the events happening.

The audit logs has been moved directly within your Zephyr instance. To view your audit logs for your instance, please navigate to the About Zephyr page under the System Setup section of Zephyr Administration.

To view your audit logs, please navigate to the System Setup page of Zephyr:

View Audit Log Details

Administrators can view the individual log meta-data by clicking on the ShowData button for the individual event in the list of the logs.

This will display a pop-up with the meta-data for the event that occurred.

The information displayed will correspond to the event that is being viewed. For example, the data displayed for copying a test case is different from the data displayed for performing a requirement mapping.

All individual logs will contain a log ID, time the action was performed, entity (general category of the action), operation/action (the type of action performed), and the user that performed the operation.

Log Entry for a Test Case Copy Operation:

Log Entry for Mapping requirement to test case Operation:

Search Audit Logs using Filters

Audit logs can contain hundreds or even thousands of events tracked daily, especially if you have multiple teams/users working within the Zephyr application. We understand that this can be frustrating when you want to look for something specific in regards to a tracked event. With this in mind, we’ve created a way for you to search through and narrow your audit logs to look for exactly what’s needed. By using filters, we can narrow our search of tracked events in the audit log.

The filters that can be applied to search through your tracked events are the following:

  • Entities: Category of the action being performed (testcase, requirement, etc.).

  • Operation: The type of action that is performed by the user (test case creation, re-index, etc.).

  • User: The user that performed the operation/action.

  • From and To: The date range for the tracked events that you want view within that timeframe. “From” is the start date of the timeframe and “To” is the end date of the timeframe.

1. To search through your audit logs using filters, simply use the drop-downs for each filter or type in the correct operation filter.

Note: The Operation filter uses a text field and to search by Operation, the user needs to enter the EXACT text for the operation to match. For example, if a user wants to search for the operation “Test case Deletion”, the user cannot enter “Test case” and get the expected results. The user must enter the EXACT name and enter in “Test case Deletion” in the field to retrieve the expected results when searching.

2. Once you’ve selected your search filters, click on the Submit button and this will search your audit logs for the tracked events that match the filters selected.

Export Audit Logs

We understand that the audit log can be very long and we’re providing the administrators the ability to export their entire audit logs. The exporting function currently will export the audit log to a file that is downloaded. The format for the exported file will be a CSV file format.

1. To export the audit logs in the table, click on the Export button at the top right of the interface and then click on the CSV file format to export.

The file will be downloaded once exporting is complete.

Truncate Audit Logs

Truncating your audit logs is essentially permanently deleting all of the events within a specific timeframe. When truncating, the truncated logs cannot be retrieved again and this is a permanent removal. We recommend you to make sure all logs within the timeframe are ready to be truncated before proceeding. If you’re ready to truncate your audit log, you may want to export the logs to have a CSV file so that you have an extra copy of the logs before truncating.

1. To truncate your audit logs, click on the Truncate Audit Log button at the top right of the interface.

This will display a pop-up where you must select the date where you want to truncate from.

2. Select the end date for when you want to truncate your audit logs and then click the Truncate Log button.

Zephyr will truncate and permanently delete all the log entries on the date selected as well as all the log entries prior to the date. So essentially, it will permanently delete all logged events on this date and all events before the given date. Every log entry after the date will remain in the audit log.

3. You will then be prompted with a warning about truncating your audit log. This is here to confirm you are ready to truncate your logs and remove all log entries on the date selected and everything prior to the date selected as well. Click the Yes, Truncate Audit Log button to confirm and proceed to truncating your audit log. This will remove the audit log entries for the selected timeframe and will display the audit log table after truncating is complete.

Share Usage Data with SmartBear

You can opt-in to share your usage data with SmartBear. This allows us to get a better insight on what our customers are up and what sort of features are being used the most throughout Zephyr. With this information, we can see where our users are running into problems and it helps us gather information for troubleshooting. By providing us with this usage information, we have insight in how we can improve our product to increase the efficiency for our users. We do not collect any personally identifiable information regarding our users or the actions done within your Zephyr system.

1. To share your usage data with SmartBear, navigate to the Customizations page under System Setup.

2. Under the Advanced section, click on the Miscellaneous button.

3. When the pop-up display appears, make sure the Share anonymous usage data with SmartBear option is selected.

4. Once selected, simply click the Save button and that’s it! Now, you’re successfully sharing your usage data with our team at SmartBear and we appreciate this as it helps us improve our product.

Zephyr Application Log Files

Zephyr log files can be accessed in the Zephyr folder after you download the application. These Zephyr logs are now capped. The log files are now tracked on a daily basis by breaking the log file up.

  • The log files are broken up at midnight and will append the date for the previous day to the recorded log file.

  • Log files essentially record up to 24 hours allowing users to navigate to the specific log file rather than parsing one enormous log file.