$Id: README 12 2014-09-23 13:16:47Z abalama $
App::MonM v1.00 and later  
This document written in cp-866 (OEM) charset
=============================================

  
-----------------

App::MonM -  㬥⮢  ⮣ ਭ ࠡ ᭮ WEB-ࢨᮢ (ᠩ⮢,  
, 䥩ᮢ  ..).


-----------

    - ஢ઠ 㯭 -ᠩ⮢ (checkit http)
    - ஢ઠ ࠡᯮᮡ ࠧ   (checkit dbi)
    - ஢ઠ 譨 稪 ।⢮ 믮 ⥬  (checkit command)
    - ஢ઠ 㯭 ࢥ஢ SMTP, POP3, FTP, SSH  . (checkers)
    - 믮 ⫠ ᮢ SQL (dbi)
    - 믮 ⫠ ᮢ HTTP (http)
    - 䥩  SMS ନ (sendalertsms)
    -  ன ⥬ ⮣ ।஢ 䨣樮 䠩
    - ⠭ ஥ ।⢠ CPAN   筮 ० १ make install


-----------

। 砫 ⠭,  室 ஢ 稥 ᫥ ⮢, ⠭  襩
⥬  㤥 "ࠡ" App::MonM:

    - gcc ᫥ ᨨ
    - perl v5.10   (४   v5.12)
    - libwww (p5-libwww / perl-libwww)
    - libnet


---------

⠭ 믮  ﬨ.  - ⮬⨧஢; ன - 筮.

 ⮬⨧஢ ०  ⠭ 筮 믮 :

    # cpan install App::MonM

 ( ActivePerl):

    # ppm install App-MonM

 筮 ०  ॡ 믮 ᫥騩  権:

    -  ਡ⨢  CPAN  樠 ५  ᠩ SourceForge:
    
      https://metacpan.org/pod/App::MonM
      http://search.cpan.org/~abalama/
      https://sourceforge.net/projects/app-monm/
    
    - 娢஢ 祭 娢,  ३  祭    ᮫
    
    - 室  祭  믮 ᫥⥫쭮 ᫥騥 :
    
      perl Makefile.PL
      make
      make test
      make install
    
  ⠭ ⥬ । ⠭ 室 㫨 (), ᨬ 㫥
 ⠪      㦥 ⠭  襩 ⥬.


-------------

 樠樨 ⨢ ࠡ ਫ monm (  monm).  ਫ
 䥩ᮬ ⥬ 窨  ।⠢   㭪樮 
  App::MonM.

  樠樨  ᮧ 室 ४ਨ  䨣樮 䠩.

 樠樨 ᫥ 믮 ᫥ :

    # monm config

᫨   ⠭ 䨣樮 䠩  ᢮ ⠫,  ᫥  
樠  祬 -c DIRECTORY/monm.conf:

    # monm -c /my/config/files/monm.conf config

  "ࠧ୥" 䨣樮 䠩  ⠫ /my/config/files


------------

讥  ᫥ 㤥 䨣樨.  ࠢ쭮 ஥ ਫ ࠭
४ ࠡ ᥣ ਫ.

  樠樨     ࠭ ᮫ ,  ஬ ᯮ 
䨣樮 䠩.  䨣樮 ⠫ ᮤন  㬮砭 䠩: 

    conf.d/checkit-foo.conf
    conf.d/checkit-foo.conf.sample
    conf.d/dbi-foo.conf.sample
    conf.d/http-foo.conf.sample
    extra/sendmail.conf
    extra/checkit.conf
    monm.conf

 䨣樮 䠩  䠩 monm.conf.  ᮤন  ।  
।  ⥫ 䠩  ⠭  ᯮ짮.  extra/sendmail.conf
ᮤন ।  ࠢ ஭   㬮砭.  extra/checkit.conf
㦨  । ᯮ㥬  ᢮ ࠡ ࠡ稪 checkit.  ⠫ conf.d
餥ন 䠩 뢠騥 ᥪ樨  ࠡ  ࠡ稪, ਬ dbi, checkit, http

monm.conf
~~~~~~~~~~~~

 㦥 㯮 , 䠩 monm.conf ᮤন  ।.

    LogEnable   on
    LogEnable   off

४⨢    몫 ஢ ᮢ monm.  㬮砭 - off

    LogLevel warning

४⨢ । ஢ ⫠.  ᫥騩  ஢ ⫠: debug, info, 
notice, warning, error, crit, alert, emerg, fatal, except.  㬮砭 ᯮ 祭 debug

 ⫠ ଠ monm 뢠  䠩 monm.log ⥬ ⠫ ୠ 
䠩, ਬ: /var/log/monm.log

 砥 ᪠ ணࠬ monm  ࠬ஬ -l  䠩 monm.log 㤥 뢠 䠩 
⥬  - monm_debug.log.  䠩 㦥  ⠫쭮 ⫠ ࠡ ᨬ 
⮢ App::MonM.

extra/sendmail.conf
~~~~~~~~~~~~~~~~~~~

 ᮤন  । <SendMail>...</SendMail>  ।  ࠢ 
 ஭ .  ४⨢ ᮮ⢥  ⮪ SMTP,  ᪫祭 
᫥ :

    Sendmail   /usr/sbin/sendmail
    Flags      -t

४⨢ Sendmail । ୠ⨢ SMTP ਫ, ࠢ饥 쬮.  ਫ
室  箬 -t, । ४⨢ Flags

    SMTP       192.168.0.1

 
-------------

᫥ ᯥ譮 ࠡ  ⠭, 樠樨  ன - 室  ࢮ  ணࠬ
monm.  筥 ᨭ⠪ ᥣ  ᯮ짮 :

    # monm -h

騩 ᨭ⠪  monm ⠪:

    # monm [OPTIONS] [COMMANDS [ARGS]]

  祢 権 :

    -D DATADIR

  () ।  ,     ६ 䠩, 
室  ࠡ.  㬮砭 ᯮ ⥬ ⠫ ६ 䠩.

    -c CONFFILE
    --config=CONFFILE

 ⠢ ணࠬ ᯮ짮  ⢥ 䨣樮 䠩 CONFFILE.  㬮砭 
ᯮ ⥬   䠩 monm.conf.

    -v

    ࠭ १ ࠡ ணࠬ mbutiny.   ⠫쭮 ଠ樨
 ᯮ짮 ⥫ 祬 -d.

  
-------------------

ணࠬ monm ন ᫥騥 

test
~~~~

஢  ᭮ ⮢ ணࠬ. ᫥ ஢ 頥  , 
⠪ : ६ 㦥, 䨣樮 , ᯨ᮪ 祭 ४਩ ⥪

   ॡ  㬥⮢

void
~~~~

⮩ ⥪, ணࠬ ᪠  祣  . 頥 "⮩" ⢥

   ॡ  㬥⮢

dbi
~~~

஢ ࠡ ࠧ   ᯮ 䥩 DBI  믮 㪠 . 
 ਬ ᯮ짮

    monm dbi -d -F text -s TEST -u USER -p PASSWORD --sql="select sysdate from dual"

 ਬ    ࠡ⠥ ⮩  (select sysdate from dual)   Oracle. 
ᮥ ᯮ  SID ( -s),   ஫ ( -u  -p).

    echo select sysdate from dual | monm -d --stdin -F text -s TEST -u USER -p PASSWORD

 ਬ 祭 ।騬  ᪫祭 ⮣   ⢥ SQL ᯮ  㬥
 ப  ⠭ .

    monm dbi -d -F text -s TEST -u USER -p PASSWORD

 ਬ 祭 ࢮ,   ⢥ SQL  㯠   㬮砭.  
Oracle  ᯮ : SELECT SYSDATE FROM DUAL

    monm dbi -d -F xml -s TEST -u USER -p PASSWORD -o oracle.xml

  祭 ।饬 ⮫쪮 १⨢ XML 㬥 뢠  䠩. ᫨ 
  -d  -F  १⨢ XML 㬥 㤥 뢥  ⠭ 뢮,  ⭮, 
 ࠭. ਬ஬ ⠭⭮ XML . ࠧ "API"

    monm dbi -d -F yml --sid=TEST -u USER -p PASSWORD -T 10

 ਬ  ࠡ   ⢥ 뢮 ଠ  ᯮ  YAML
 ⠭ ⠩  ⨥ ᮥ    믮   㬮砭.

    monm dbi -d foo

ਬ ᭮뢠  ⠮। foo. ⮯। foo 뢠 ᥪ樥 䨣権 
<DBI foo>. ᠭ  .  䨣樮 䠩 dbi-foo.conf.sample.  室 
"砥" ࠡ   ப 뭮 設⢮ 室 㬥⮢  䨣樮 
䠩.

    monm dbi -dF text -s TEST -u USER -p PASSWORD 
       --sql="select rownum from dual connect by level <= 5"

ਬ 騩 㢨  ⠡ 頥 Oracle

    monm dbi -d -n DBI:mysql:database=MYBASE;host=www.example.com -u LOGIN -p PASSWORD

஢ ࠡ 㪠    믮 㪠 .   ࠪ᪨
 筠 ।騬  ᪫祭 ⮣   -s (--sid)  箬 -n (--dsn) 
㤠 ᫥ । DSN   .

http
~~~~

஢ ࠡ URL .   ᭮뢠  맮 LWP   롮஬ 権, 
ᯨ᮪  ਢ  ᥪ樨 䨣樨 <HTTP foo>. 
ᠭ  .  䨣樮 䠩 http-foo.conf.sample.  室 "砥" ࠡ 
  ப 뭮 設⢮ 室 㬥⮢  䨣樮 䠩.

  ⮨ ਢ ᪮쪮 ⨯ ਬ஢ ࠡ   ப.

    monm http -d -q http://www.example.com

 ਬ   ଠ  訢 ⥭  뢥   ࠭.

    monm http -q http://www.example.com

 ਬ 祭 ।饬,   ࠭ 뢮 ଠ  ଠ TXT

    monm http -q http://www.example.com -F xml

 ਬ  㢨  ࠭  ᠬ ᮤন  http://www.example.com  ᥪ樨
XML <result></result>

    monm http -q http://www.example.com -u LOGIN -p PASSWORD
    monm http -q http://LOGIN:PASSWORD@www.example.com

ਬ      ॡ饬 ਧ HTTP

    monm http -q http://www.example.com -m POST --request="foo=1&bar=2"

 ਬ    ।  ⮤ POST

    monm http -q http://www.example.com -f file.txt -T 20

 ਬ 뢠    "᪠祭" ⥭  䠩 file.txt.  ⮣  -T 
। ⠩ 

    echo foo=123 | monm http --stdin -m POST -q http://www.example.com

ਬ   ।   POST    ⠭⭮ 室 

    monm http foo

ਬ  ᯮ짮 ᥪ樨 䨣樨 <HTTP foo>  ⢥ 筨  
믮 ᮢ.  ⮣  ᥪ    室  , 㪥ᮢ 
⥫ .

checkit
~~~~~~~

   ᫮ ࠡ稪 ⥬,   ⮦ ६   ᠬ    
짮⥫. ࠡ稪 ஡  ᯨ 稪  ஢ . 稪 ᥣ 
  OK  ERROR  祣 譥.  ⢥ 筨      
१  ⮩  HTTP.  ⮣ ন 稪 믮騥 SHELL .

    monm checkit

ਬ  믮 ࠡ  ᥬ 묨 稪.

    monm checkit www.example.com

  ਬ 뢠   ࠡ ⮫쪮  稪   www.example.com

    稪 ࠡ뢠 ਣ, ਬ, ࠢ ᮮ饭 E-Mail  
SMS.    믮    ⥪饩 ⥬ (⠬,  ⠭ 
 App::MonM).

 ਬ 騩 ᠬ ⮩ 稪  ਣ:

    <Checkit "foo">
        Enable      yes
        URL         http://www.example.com
        Target      code
        IsTrue      200
        
        <Triggers>
            emailalert  foo@example.com
            emailalert  bar@example.com
            emailalert  baz@example.com

            smsalert    11231230001
            smsalert    11231230002
            smsalert    11231230003

            # ᮪ ,   믮  ࠡ뢠 ਣ
            #  ⠭:
            #   [SUBJECT] -- 
            #   [MESSAGE] -- 饭
            #command     "mycommand1 "[SUBJECT]" "[MESSAGE]""
            #command     "mycommand2 "[MESSAGE]""
            #command     "mycommand3"
        </Triggers>
    </Checkit>

alertgrid
~~~~~~~~~~

Coming soon...

rrd
~~~

Coming soon...

API
---

Coming soon...

__END__