Collect performance metrics#

plans-img Available on Enterprise plans

deployment-img Cloud and self-hosted deployments

System admins can collect and store the same performance monitoring metrics as Prometheus, without having to deploy these third-party tools. Data is collected every minute and is stored in a path you configure. The data is synchronized to either a cloud-based or local file store every hour, and retained for 15 days.

Download and share the collected data with Mattermost to understand application performance, troubleshoot system stability and performance, as well as inform route cause analysis.

Tip

Already have Prometheus and Grafana deployed? You can use these tools to monitor performance of your Mattermost deployment.

Mattermost configuration#

Note

For Mattermost Cloud deployments, no setup is required. See the usage section below for details on collecting performance metrics.

For a self-hosted Mattermost deployment, a Mattermost system admin must perform the following steps in Mattermost.

  1. Log in to your Mattermost workspace as a system administrator.

  2. Download the latest version of the plugin binary release, compatible with Mattermost v8.0.1 and later. If you are using an earlier version of Mattermost, follow our documentation to upgrade to Mattermost v8.0.1 or later.

  3. Go to System Console > Plugins > Plugin Management > Upload Plugin, and upload the plugin binary you downloaded in the previous step.

  4. Go to System Console > Plugins > Plugin Management. In the Installed Plugins section, scroll to Mattermost Metrics Plugin, and select Enable Plugin.

  5. Specify the path of the time-series database, and select Save.

  6. Go to System Console > Environment > Performance Monitoring, and set Enable Performance Monitoring to true. Select Save.

Upgrade#

We recommend upgrading this feature as new versions are released. Generally, updates are seamless and don’t interrupt the user experience in Mattermost. Visit the Releases page for the latest release, available releases, and compatibiilty considerations.

Usage#

You need to be a Mattermost system admin to collect performance metrics. Select Create Dump to generate dump files.

To use the generated dump file, you can simply clone the Dockprom repository. Change the Prometheus data volume to point to the dump that you just downloaded. The downloaded file is compressed, so to be able to use it, you need to decompress it first.

The volume configuration for Prometheus should look like the code below in the docker-compose.yml file:

volumes:
  - ./prometheus:/etc/prometheus
  - /Path/To/Dump/Directory:/prometheus/data

Once you set this up, run docker-compose as described in Dockprom Repository.

You can also use our Mattermost Performance Monitoring v2 dashboard by simply importing it into Grafana.

  1. Open Grafana (<localhost>:3000 by default) and then log into it.

  2. Once you log in, go to the Plus The Plus icon provides access to channel and direct message functionality. icon on the left sidebar, and then select Import.

  3. Enter the dashboard ID (15582) in the Grafana.com Dashboard field, and then select Load to fetch the dashboard.

What’s collected?#

Mattermost provides custom metrics and standard Go metrics that can be used to monitor your system’s performance.