Usage

#Show help

./amcli -h

   _____ _____ __                   _____         _ _           
  |     |     |  |      ___ ___ ___|     |___ ___|_| |_ ___ ___ 
  |-   -| | | |  |__   | .'| . | . | | | | . |   | |  _| . |  _|
  |_____|_|_|_|_____|  |__,|  _|  _|_|_|_|___|_|_|_|_| |___|_|  
                           |_| |_|                              
                                               CLI client v0.7

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

...............................................................................


 ✨ SYNTAX:

    amcli [OPTIONS] --ini=<INI-FILE>


 🔷 OPTIONS:

    -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


 👉 EXAMPLES:

    amcli -i=my.ini
    amcli --ini=my.ini
        Execute checks from INI file 'my.ini'.

    amcli --list
        List available checks.

#Execute checks

Checks can be defined by writing an INI file that contains meta information and sections for each check. To execute it use the --ini parameter and reference the file (as absolute path or relative to your current working directory).

[<PATH>]amcli --ini=<FILENAME>

Recommendations:

• The output is JSON in a single line. You can use jq to beautify it, eg [<PATH>]amcli --ini=<FILENAME> | jq
• If the bahaviuor seems to be unwanted use -v to enable verbose mode. You get more debug output during the execution, showing parsed ini file and more. [<PATH>]amcli --ini=<FILENAME> -v

#Exitcodes

The binary could stop and exit with non zero exitcode.

#amcli

#appmonitor-client class

#appmonitor-checks class