View and Edit Log Configuration Settings

Starting in Strategy (September 2026), you can reset all log configuration settings with one click. You can also set automatic expiration dates for logs. After the expiration date and time is reached, log configuration entries are no longer available.

Starting in Strategy (July 2026), logs not available out-of-the-box can not be saved to DSSErrors.log to prevent extra entries that can cause high cloud ingestion and storage costs. Logs not available out-of-the-box have a default expiration date of seven days after enabling the log. Once the log expires, they will not be logged in the defined file.

This expiration behavior only applies to newly added or modified logs.

Starting in MicroStrategy 2021 Update 5, you can view and edit all log configuration settings. Administrators can make changes to the information that is logged and the location where it is saved. Administrators can also modify diagnostics or performance logs.

• Configure Diagnostic Logs

• Configure Performance Logs

• Manage Log File Destinations

• Reset Log Configuration

• Log Auto Expiration

Check out the video below to learn more!

Configure Diagnostic Logs

1. Open the Workstation window.
2. In the Navigation pane, click Environments.
3. Right-click a connected environment and choose Properties.

4. In the left pane, click Log Configuration.

5. Select the Diagnostics Log tab.

   

6. By default, the logs are grouped by component, as shown above. To change the display, from the Group By drop-down list, select File Log.

7. If you have multiple nodes in this environment, do one of the following:

   • To apply the changes to all nodes, select the Apply Changes to all Nodes check box.

   • To specify the node, select it from the Apply Changes to all Nodes drop-down list.

8. In the File Log column, choose the Log Destination for each one of the Log Type Entries.

   • If the log destination does not exist, you can add it. In the Log Destination drop-down list, click New Log Destination. Specify the File Name and Max File Size. Click OK.

9. To export all the current settings, click Export.

10. Click OK.

Configure Performance Logs

1. Open the Workstation window.
2. In the Navigation pane, click Environments.
3. Right-click a connected environment and choose Properties.
4. In the Navigation pane, click Environment Settings.
5. In the left pane, click Log Configuration.

6. Select the Performance Log tab.

   

7. If you have multiple nodes in this environment, do one of the following:

   • To apply the changes to all nodes, select the Apply Changes to all Nodes check box.

   • To specify the node, select it from the Apply Changes to all Nodes drop-down list.

8. In the File Log column, select all the counters to log to a file.

9. In the File Log Properties area:

   1. Choose the Log Destination from the available log destinations.

   2. Type the Logging Frequency.

10. In the Statistics column, select all the counters to log statistics.
11. In the Statistics Properties area:
    1. Enter the Logging Frequency.
    2. Select whether to Persist Statistics.

12. To export all the current settings, click Export.

13. Click OK.

Manage Log File Destinations

You can view, delete and modify file log destinations.

1. Open the Workstation window.
2. In the Navigation pane, click Environments.
3. Right-click a connected environment and choose Properties.
4. In the Navigation pane, click Environment Settings.
5. In the left pane, click Log Configuration.

6. To the right of the Performance Log tab, click More . and choose Manage File Log Destinations.

   

7. You can change the Max File Size for any file log destination.

8. To add a new file log destination:

   1. Click Log Destination.

   2. Specify the File Name and Max File Size.

   3. Select the File Type from the drop-down list.

   4. Click OK.

9. To remove a file log destination, hover your cursor over the entry and click Delete .

10. Click Log Destination to add a new file log to the list of entries.

11. Click OK to save the file log destination changes.

12. Click OK.

Reset Log Configuration

One-click reset is only available if you are using a Managed Cloud Enterprise or Managed Cloud Standard environment.

One-Click Reset allows administrators to restore all log configuration options to their default settings in a single action. A confirmation dialog is shown before the reset is applied to prevent accidental changes. A confirmation dialog displays before the reset applies to prevent accidental changes. The reset is useful when multiple log settings have been modified over time and the administrator wants to return to a clean, known-good baseline quickly.

If you reset log configuration, all custom log settings, including any configured expiry dates, are permanently removed. This action can not be undone.

1. Open the Workstation window.
2. In the Navigation pane, click Environments.
3. Right-click a connected environment and choose Properties.

4. In the left pane, click Log Configuration.

5. Select the Diagnostics Log tab.

   

6. In the top navigation, click Reset.

7. Review the confirmation dialog and click Reset.

8. Click Save.

   All log entries return to their out-of-the-box default. Any configured dates are removed.

Log Auto Expiration

Auto expiration is only available if you are using a Managed Cloud Enterprise or Managed Cloud Standard environment.

Auto expiration allows administrators to set a specific date and time on any log configuration entry to expire. After the expiry date and time is reached, the log configuration is disabled.

To enable any log not available out-of-the-box, you must select the file name and an expiry date. Logs not available out-of-the-box have a default expiration of 7 days after enabling the log. You can change the expiry date as needed, up to a maximum of 30 days. The maximum expiration limit can be configured using a environment variable set to a desired value.

To resume logging after expiration, you must manually re-enable the log and set a new expiry date. This is useful when temporarily increasing log verbosity for troubleshooting, the setting rolls back on its own without manual intervention, which prevents forgotten high-verbosity logs from consuming storage or impact performance.

Configure Auto Expiration

1. Open the Workstation window.
2. In the Navigation pane, click Environments.
3. Right-click a connected environment and choose Properties.

4. In the left pane, click Log Configuration.

5. Select the Diagnostics Log tab.

   

6. Find the log you want to add an expiration date to.

7. Click the value in the Expiry Date column and choose a date and time.

8. Click Save.