If you want to generate auditing based dashboards from ARIS Connect content, you must set up and configure the external web analytics application Matomo. Matomo is not included in this ARIS package.
The following describes the Matomo usage in a distributed environment. You can also install Matomo on an existing ARIS server. In this case, ARIS Agent is already installed and you must only add the additional runnables to the ARIS server. Note that running ARIS and Matomo on one and the same server may result in a considerable loss of performance.
Procedure
Set up Matomo.
You must install a Web server, PHP, a database, and deploy the Matomo web application. For further information, refer to the Matomo installation guide.
During the Matomo setup, add the website:
Name =ARIS Connect, URL = http://<host>:<port>.
Alternatively, register ARIS Connect as a website in an existing Matomo installation.
After Matomo is set up, open the its configuration.
Enable unique visitors processing for day, week, month, and range. Day, week, and month are enabled by default.
Log in to Matomo.
Create a user with view permission on the ARIS Connect website and copy its authentication token to a text file.
Create a new Custom Dimension named tenant for visits and two Custom Dimensions named resource-path and resource-type for visit actions. Set all of them to active, and copy the IDs to the text file. You need the IDs to parameterize the Matomo reports later in ARIS Architect and to configure the eventsubscriber runnable.
Make sure that site search tracking is enabled for the ARIS Connect website.
If the ARIS Connect Portal usage is expected to be high, we recommend disabling archiving of browser-triggered Matomo reports. To prevent performance issues you are recommended to set up auto-archiving as a background task that runs in a fixed interval. You must complete this task before running any scheduled ARIS reports that access the Matomo data.