Download the PHP package vrok/monitoring-bundle without Composer
On this page you can find all versions of the php package vrok/monitoring-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download vrok/monitoring-bundle
More information about vrok/monitoring-bundle
Files in vrok/monitoring-bundle
Package monitoring-bundle
Short Description Symfony bundle to send 'alive' emails to a monitoring address (cron-triggered)
License MIT
Homepage https://vrok.de
Informations about the package monitoring-bundle
Monitoring-Bundle
Schedule sending email messages from the console to check if cron is running and mails can be sent by the system (e.g. your Docker container running the application). If the Symfony messenger is configured, the messages are pushed to the queue and processed by a worker, so this also checks if queue & workers are up.
Installation
Make sure Composer is installed globally, as explained in the installation chapter of the Composer documentation.
Applications that use Symfony Flex
Open a command console, enter your project directory and execute:
Applications that don't use Symfony Flex
Step 1: Download the Bundle
Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:
Step 2: Enable the Bundle
Then, enable the bundle by adding it to the list of registered bundles
in the config/bundles.php
file of your project:
Configuration
The Symfony Mailer must be configured and should set a default sender (FROM address) via listener / config.
Create config/packages/vrok_monitoring.yaml
:
Optionally get this options from the ENV with '%env(MONITOR_ADDRESS)%'
etc.
Usage
Call bin/console monitor:send-alive-message
from console, best triggered via
a cron every 30min etc.:
Email subject will be "Service [app_name] is alive!". The text body contains an integer timestamp which is later used by the Icinga check to purge all but the newest message):
Icinga configuration
Retrieval of the sent messages requires the check_imap_receive Nagios/Icinga plugin, make sure this is installed and working on a server monitored with Icinga, can be the same as the application server but doesn't have to.
Create the check script & replace the mailserver domain, receiver address & password with your values, we don't use arguments for those to not store those credentials on the Icinga master.
/usr/lib/nagios/plugins/contrib/check_service_alive
:
Add the command definition in the Icinga master:
Also the service definition:
Finally, enable & configure the service in your host definition,
replace "dev.domain.tld" with the _appname you configured in the
packages/vrok_monitoring.yaml
. You can monitor multiple applications with one _monitoraddress, just make sure the
app_names are different (subject is matched by pattern, so using "domain.tld is alive" and "dev.domain.tld is alive will
collide, prefix with "Service " to prevent this):
All versions of monitoring-bundle with dependencies
symfony/config Version ^6.3.0|^7.0.0
symfony/console Version ^6.3.0|^7.0.0
symfony/dependency-injection Version ^6.3.0|^7.0.0
symfony/framework-bundle Version ^6.3.0|^7.0.0
symfony/http-kernel Version ^6.3.0|^7.0.0
symfony/mailer Version ^6.3.0|^7.0.0
symfony/monolog-bundle Version ^3.8.0
symfony/yaml Version ^6.3.0|^7.0.0