Reporting configuration settings

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.

  • Single-channel Guests shows the number of active guest accounts that belong to exactly one channel. Direct messages and group messages don’t affect whether a guest is counted as a single-channel guest. Single-channel guests are counted separately from the primary paid seat count and are free up to a 1:1 ratio with licensed seats. When this count exceeds the allowance, the statistic is highlighted as a warning for system admins.

  • Guests in multiple channels continue to count as paid active users. See the guest accounts documentation for details.


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

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

Note

  • This setting is applicable to self-hosted deployments only.

  • 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

The following self-hosted deployment 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

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