For a solid and secure website, it is important to get notified about all the errors and exceptions that occur. This helps prevent unnoticed repeating errors and keeps customers happy as they won't have to complain.
With the Error Api module, you can send all exceptions to your personal Error Api and get notify by email or Slack. If an exception occurs on the customer website, you will be notified with the full error stack and a slack notification will be sent (if configured).
For the installation of modules Composer is required:
composer require luyadev/luya-module-errorapi
After installation via Composer include the module to your configuration file within the modules section.
'modules' => [
// ...
'errorapi' => [
'class' => 'luya\errorapi\Module',
'adapters' => [
[
'class' => 'luya\errorapi\adapters\MailAdapter',
'recipient' => ['[email protected]'],
],
[
'class' => 'luya\errorapi\adapters\SlackAdapter',
'token' => 'xyz.xyz.xyz.xyz',
],
[
'class' => 'luya\errorapi\adapters\SentryAdapter',
'token' => 'YOUR_SENTRY_USER_AUTH_TOKEN',
'organisation' => 'organisationslug',
'team' => 'teamslug',
]
],
],
]After successfully installation and configuration run the migrate, import and setup command to initialize the module in your project.
1.) Migrate your database.
./vendor/bin/luya migrate2.) Import the module and migrations into your LUYA project.
./vendor/bin/luya importIt is very important to run the
./vendor/bin/luya migrateand./vendor/bin/luya importcommands in order for these changes to take effect.
To enable the error api for your website you need to configure the default LUYA error handler in the component section of your config file with the current setup server (error api):
'components' => [
// ...
'errorHandler' => [
'api' => 'https://example.com/errorapi', // where example is the domain you have setup error api above
'transferException' => true,
],
]