#!/usr/bin/env php
<?php
/**
* ======================================================================
*
* IML APPMONITOR CLIENT
* AS CLI APP
*
* ---------------------------------------------------------------------
* 2025-03-04 v0.1 Initial version
* 2025-03-05 v0.2 slack notification as hash from ini; check params can be an hash value or JSON
* 2025-03-07 v0.3 set argc and argv from $_SERVER; update help output
* 2025-03-09 v0.4 more colors in output of debug and help
* ======================================================================
*/
// needed when starting compiled binary built from a PHAR file
$argc = $_SERVER['argc'];
$argv = $_SERVER['argv'];
$FLAG_DEBUG = 0;
$VERSION = "0.5";
$AMCLI_BUILD_DATE = "never";
// ---MARK---INCLUDE-CHECKS---START---
@include "amcli__build.php";
if (!file_exists(__DIR__ . "/include_checks.php")) {
echo "❌ ERROR: File 'include_checks.php' does not exist yet..\n";
echo "Run the ../installer.php first!\n";
exit(1);
}
if (!include __DIR__ . "/include_checks.php") {
echo "❌ ERROR: Include of generated 'include_checks.php' failed.\n";
echo "Check its generation by installer or run the installer again.\n";
exit(2);
}
// ---MARK---INCLUDE-CHECKS---END
// --------------------------------------------------------------------
//
// FUNCTIONS
//
// --------------------------------------------------------------------
/**
* Call $oMonitor-><METHODNAME> with 1 or 2 params.
* This function was introduced to shorten the code.
*
* @param string $sMethod method name of appmonitor class
* @param mixed $value
* @param mixed $value2
* @return void
*/
function _set(string $sMethod, mixed $value = null, mixed $value2 = null)
{
global $oMonitor;
if (!isset($value)) {
_wd("SKIP \$oMonitor->$sMethod(<no_value>)");
} else {
if (!isset($value2)) {
_wd("calling \$oMonitor->$sMethod('$value')");
$oMonitor->$sMethod($value);
} else {
_wd("calling \$oMonitor->$sMethod('$value', '$value2')");
$oMonitor->$sMethod($value, $value2);
}
}
}
/**
* Write debug output if FLAG_DEBUG is true (use -v or --verbose on command line)
* @param string $s message to show; a prefix "DEBUG:" will be added in front
* @return void
*/
function _wd($s): void
{
global $FLAG_DEBUG;
if ($FLAG_DEBUG) {
fwrite(STDERR, "\e[90mDEBUG: $s\e[0m\n");
}
}
/**
* Show help text
* @return void
*/
function _showHelp(): void
{
global $VERSION;
$_self = str_replace('.php', '', basename(__FILE__));
echo "
\e[1m IML Appmonitor as CLI client $VERSION\e[0m
This client performs appmonitor checks and puts the results as JSON to stdout.
It contains all checks that are available in the PHP appmonitor client.
You can use the compiled binary to monitor any non PHP webapp without
implementing the checks for your programming language.
You need to reference an INI file that contains the metadata and all checks.
Have a look to the online documentation for details.
You find example snippets in the source code of this project in tests/config/.
👤 Author: Axel Hahn
📄 Source: https://git-repo.iml.unibe.ch/iml-open-source/appmonitor-cli-client
📜 License: GNU GPL 3.0
📗 Docs: https://os-docs.iml.unibe.ch/appmonitor-cli-client/
(c) 2025 Institute for Medical Education * University of Bern
...............................................................................
✨ \e[1mSYNTAX:\e[0m
$_self [OPTIONS] --ini=<INI-FILE>
🔷 \e[1mOPTIONS:\e[0m
-h, --help Print this help and exit
-i, --ini Set an INI File to parse
-v, --verbose Enable verbose output (written to STDERR)
-b, --buildinfos show build information and exit
-l, --list list available checks and exit
-m, --modules list available Php modules in this binary and exit
-V, --version Show version and exit
👉 \e[1mEXAMPLES:\e[0m
$_self -i=my.ini
$_self --ini=my.ini
Execute checks from INI file 'my.ini'.
$_self --list
List available checks.
";
}
// --------------------------------------------------------------------
//
// MAIN
//
// --------------------------------------------------------------------
// put params to $ARGS
if ($argc > 1) {
parse_str(implode('&', array_slice($argv, 1)), $ARGS);
}
// check params
if (isset($ARGS['-v']) || isset($ARGS['--verbose'])) {
$FLAG_DEBUG = 1;
_wd("Verbose mode enabled. Showing debug infos on STDERR.");
}
_wd("CLI ARGS: " . print_r($ARGS ?? [], 1));
_wd("Initializing appmonitor class");
$oMonitor = new appmonitor();
$sPreSpace = " - ";
// show version
if (isset($ARGS['-V']) || isset($ARGS['--version'])) {
_wd("Showing version");
echo "amcli $VERSION\n";
exit(0);
}
// show build infos
if (isset($ARGS['-b']) || isset($ARGS['--buildinfos'])) {
$aMods = get_loaded_extensions();
sort($aMods);
_wd("Showing build infos");
echo "amcli v$VERSION (".PHP_OS.")\n\n";
echo "Build date: $AMCLI_BUILD_DATE\n";
echo "\n";
echo "Compiled with PHP ".PHP_VERSION."\n";
echo "Including these modules:\n";
$sModules=" ";
$i=0;
foreach($aMods as $sModulename){
$i++;
$sModules.="$sModulename ";
if($i % 10 == 0){
$sModules.="\n ";
}
}
echo "$sModules\n\n";
exit(0);
}
// show help
if (isset($ARGS['-h']) || isset($ARGS['--help'])) {
_wd("Showing help");
_showHelp();
exit(0);
}
// ----------------------------------------------------------------------
// show builtin checks
if (isset($ARGS['-l']) || isset($ARGS['--list'])) {
_wd("Showing checks");
echo $sPreSpace . implode("\n$sPreSpace", $oMonitor->listChecks());
exit(0);
}
// show builtin modules
if (isset($ARGS['-m']) || isset($ARGS['--modules'])) {
_wd("Showing php modules");
$aMods = get_loaded_extensions();
sort($aMods);
echo $sPreSpace . implode("\n$sPreSpace", $aMods);
exit(0);
}
$inifile = $ARGS["--ini"] ?? ($ARGS["-i"] ?? "");
if (!$inifile) {
echo "❌ ERROR: Missing INI File. Use -h (or --help) for more infos.\n";
exit(3);
}
_wd("Using ini file '$inifile'.");
if (!file_exists($inifile)) {
echo "❌ ERROR: INI File '$inifile' does not exist.\n";
exit(4);
}
try {
$aIni = parse_ini_file($inifile, true);
} catch (Exception $e) {
echo "❌ ERROR: INI File '$inifile' could not be parsed.\n";
exit(5);
}
if (!is_array($aIni)) {
echo "❌ ERROR: INI File '$inifile' could not be parsed as array.\n";
exit(5);
}
_wd("Parsed INI data: " . print_r($aIni, 1));
// ----------------------------------------------------------------------
// set metadata
_set("setHost", $aIni['meta']['host'] ?? null);
_set("setWebsite", $aIni['meta']['website'] ?? null);
_set("setTtl", $aIni['meta']['ttl'] ?? null);
foreach ($aIni['notifications']['email'] ?? [] as $sValue) {
_set("addEmail", $sValue);
}
foreach ($aIni['notifications']['slack'] ?? [] as $sChannel => $sWebhook) {
_set("addSlackWebhook", $sChannel, $sWebhook);
}
// ----------------------------------------------------------------------
// loop over checks
$aChecks = $aIni;
unset($aChecks["meta"]);
unset($aChecks["notifications"]);
foreach ($aChecks as $sKey => $aCheck) {
$aChecks[$sKey]['name'] = $aCheck['name'] ?? $sKey;
$aArray = $aCheck['params'] ?? [];
if ($aArray) {
if (!is_array($aCheck['params'])) {
$aArray = json_decode($aCheck['params'], 1);
if (!is_array($aArray)) {
echo "❌ ERROR: key 'params' for check [$sKey] must be valid JSON.\n";
echo "Value in $inifile: $aCheck[params]\n";
echo "OR: Try to use multiple lines 'params[<KEY>]=<VALUE>' instead.\n";
exit(6);
}
}
} else {
$aArray = [];
}
$aAddCheck = [
"name" => $aCheck['name'] ?? $sKey,
"description" => $aCheck['description'] ?? "",
"check" => [
"function" => $aCheck['function'],
"params" => $aArray ?? [],
],
];
foreach (["group", "parent", "worstresult"] as $sCustomKey) {
if (isset($aCheck[$sCustomKey])) {
$aAddCheck[$sCustomKey] = $aCheck[$sCustomKey];
}
}
_wd("Execute Check '$sKey': " . print_r($aAddCheck, 1));
$oMonitor->addCheck($aAddCheck);
}
// ----------------------------------------------------------------------
// send the response
_wd("Setting result");
$oMonitor->setResult();
_wd("Send response");
$oMonitor->render();
// ----------------------------------------------------------------------