History: GlitchTip

            New in ((Tiki23))

!!!# Introduction
GlitchTip is an Open Source error tracking system and you can self-host GlitchTip or subscribe to [https://glitchtip.com/|GlitchTip.com]

It also does:
* Uptime Monitoring
* Application Performance Monitoring (not yet supported in Tiki, but you can use ((Real User Measurement))).


The recommended and fully functional way to track your Tiki errors in GlitchTip is (where yourtiki.org is your Tiki instance and glitchtip.example.com is your GlitchTip instance):

!!!# Setup GlitchTip for a new project:
* Add a new project in your GlitchTip instance by clicking the "Create New Project"
* Choose PHP as your platform, input the project name (yourtiki.org) and select your team
{img type="attId" attId="100"}
* Tiki23+ bundles sentry/sdk so you should not run Composer

* Note and copy your DSN from the left panel, it will be used in the Tiki .ini file:
{img type="attId" attId="102"}

!!!# Create a new system configuration .ini file or add a new rule and modify local.php:

^ It is not recommended to use tiki-admin.php Setup Error Tracking feature in Admin > General > Error Tracking because it loads later and will miss some error messages ^

For more information about system configuration and tiki.ini (or tiki.ini.php), see: ((System Configuration))

* Create a new folder named tikiconfig outside the web accessible directory, and inside this folder create a new prefs.ini file containing
{CODE(caption="../tikiconfig/prefs.ini" colors=php)}
[glitchtip]
preference.error_tracking_enabled_php = y
preference.error_tracking_enabled_js = y
preference.error_tracking_dsn = https://4bd1dec539c9496b9d3f3ef5bd284f70@glitchtip.example.com/4
{CODE}
Of course, replace the preference.error_tracking_dsn link with the DSN generated by GlitchTip

* Now add the following lines to your existing local.php file in the /db folder
{CODE(caption="db/local.php" colors=php)}
if (is_readable('../tikiconfig/prefs.ini')) {
    $system_configuration_file = '../tikiconfig/prefs.ini';
} else {
    trigger_error('Ini file not found: ../tikiconfig/prefs.ini', E_USER_WARNING);
}
$system_configuration_identifier = 'glitchtip';
{CODE}

!!!# You are done
Check the errors reported in your GlitchTip instance, by navigating to your project.


Original commit: https://gitlab.com/tikiwiki/tiki/-/merge_requests/825


!! Sample rate
Sampling allows you to better manage the number of reported events, so you can tailor the volume of data needed. Use a value between 0 and 1. E.g.: 0.25 (will report 25% of the events)
Preference name: error_tracking_sample_rate


!! Usage for the Tiki development process
* ((dev:Using GlitchTip as part of the Tiki development process))

!! Related links
* https://glitchtip.com/blog/2023-2-17-analytics