Reporting configuration settings

plans-img Available on all plans

deployment-img Cloud and self-hosted deployments

View the following statistics for your overall deployment and specific teams, as well as access server logs, in the System Console by selecting the Product Navigate between Channels, collaborative playbooks, and boards using the product menu icon. menu, selecting System Console, and then selecting Reporting:


Site statistics

View statistics on a wide variety of activities in Mattermost, including: users, seats, teams, channels, posts, calls, sessions, commands, webhooks, websocket and database connections, and collaborative playbooks.

  • System Config path: Reporting > Site Statistics

  • config.json setting: N/A

  • Environment variable: N/A

Note

  • Bots, deactivated users, and synthetic users in Microsoft Teams integrations and connected workspaces users aren’t counted towards the total number of activated users. |

  • For billing purposes, activated guest accounts do consume a licensed seat, which is returned when the guest account is deactivated. This means that guest accounts count as a paid user in your Mattermost workspace


Team statistics

View statistics per team on number of activated users, number of public and private channels, total post count, and count of paid users (self-hosted only).

  • System Config path: Reporting > Team Statistics

  • config.json setting: N/A

  • Environment variable: N/A

Note

Bots, deactivated users, and synthetic users in Microsoft Teams integrations and connected workspaces users aren’t counted towards the total number of active users.


Server logs

Note

deployment-img-yellow Available only for self-hosted deployments

View logging of server-side events.

Reload data, download the mattermost.log file locally, and view full log event details for any log entry.

  • System Config path: Reporting > Server Logs

  • config.json setting: N/A

  • Environment variable: N/A

Tip

From Mattermost v10.9, you can toggle between JSON and plain text server logs in the System Console when console log output is configured as JSON by specifying the log format as JSON or Plain text. This option is located in the top right corner of the page Server logs page.


Statistics configuration settings

Note

deployment-img-yellow Available only for self-hosted deployments

The following configuration setting controls statistics collection behavior. This setting is not available in the System Console and can only be set in the config.json file.

Maximum users for statistics

Note

plans-img-yellow Available only on Enterprise and Professional plans

This setting is used to maximize performance for large Enterprise deployments and isn’t available in the System Console and can only be set in config.json.

Set the maximum number of users on the server before statistics for total messages, total hashtag messages, total file messages, messages per day, and activated users with messages per day are disabled.

Numerical input. Default is 2500 users.

  • System Config path: N/A

  • config.json setting: "AnalyticsSettings.MaxUsersForStatistics": 2500

  • Environment variable: N/A