Versions Compared

Version Old Version 1 New Version Current
Changes made by

Grey Shim

Jaden (Unlicensed)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

List of Contents

machcollectoradmin is the utility to manage machcollectormanager which is automatically installed with machcollectoradmin.

Options and Descriptions

...

machcollectoradmin 은 Collector Manger 를 관리하는 도구이다. 

옵션 목록

Code Block
[mach@localhost ~]$ machcollectoradmin --help
-----------------------------------------------------------------
     machcollector administration tool
     Release Version -

...

x.

...

x.

...

x.

...

official
     Copyright 2014, Machbase Inc. or its subsidiaries
     All Rights Reserved.
-----------------------------------------------------------------
<< Available option lists >>
  -u, --startup                         Startup collectormanager.
  -s, --shutdown                        Shutdown collectormanager.
  -d, --destroy                         Destroy meta data.
  -k, --kill                            Terminate collectormanager.
      --showcollectors                  Show collector list.
      --showservers                     Show server list.
  -h, --help                            Print collector argument guide.
      --createcollector=collector_name  Create collector.
      --dropcollector=collector_name    Drop collector.
      --startcollector=collector_name   Start collector.
      --stopcollector=collector_name    Stop collector.
  -m, --template=template_path          Set template path. Template path is required to issues createcollector command.
  -t, --trace=[0,1]                     Set trace option. Start collector mode (default: 0)
      --createserver=host:port          Manager registers itself to the server.
      --managername=managername         Specify a name of the manager. If not specified, default name will be used.

...

Execute machcollectormanager

Now execute machcollectormanager. Currently, it cannot be executed remotely. To connect to Machbase, execute machcollectormanager remotely by using machcollectoradmin.



목차
 Table of Contents
maxLevel3
indent30px
exclude목차
classtoc


Collector Manager 실행
Collector Manager 는 직접 실행할 수 없고, machcollectoradmin을 통해서 실행해야 한다.
 Code Block
[mach@localhost ~]$ machcollectoradmin --startup
-----------------------------------------------------------------
     machcollector administration tool
     Release Version - 
...
x.
...
x.
...
x.
...
official
     Copyright 2014, Machbase Inc. or its subsidiaries
     All Rights Reserved
-----------------------------------------------------------------
Waiting for collectormanager start.
Collectormanager started successfully.

Shutdown machcollectormanager
...

Collector Manager 종료
Collector Manager 를 중지하면 그 collectormanager가 관리하는 collector프로세스도 동시에 중지된다.
 Code Block
[mach@localhost ~]$ machcollectoradmin --shutdown
-----------------------------------------------------------------
     machcollector administration tool
     Release Version - 
...
x.
...
x.
...
x.
...
official
     Copyright 2014, Machbase Inc. or its subsidiaries
     All Rights Reserved
-----------------------------------------------------------------
CollectorManager server shutdown successfully.
...
Destroy machcollectormanager Meta Data
It can delete all meta data that were used within the machcollectormanager. It deletes all the information regarding the registered servers and executed collectors, but it cannot be executed if machcollectormanter is still operating.

Collector Manager 메타 정보 삭제
Collector Manager 가 관리하는 collector, 데이터베이스 서버 등에 대한 정보를 삭제한다. Collector Manager 가 실행중이면 이 명령은 오류로 처리된다.
 Code Block
[mach@localhost ~]$ machcollectoradmin --destroy
-----------------------------------------------------------------
machcollector administration tool
Release Version - 
...
x.
...
x.
...
x.
...
official
Copyright 2014, Machbase Inc. or its subsidiaries
All Rights Reserved.
-----------------------------------------------------------------
Destroyed meta data successfully.
...
Kill machcollectormanager
This command forces to terminate machcollectormanager. It terminates currently operating machcollectormanager with a kill signal, not waiting for other processes to shut down.
...

Collector Manager 강제 종료
Collector Manager 가 shutdown과정을 대기하지 않고 즉시 중지한다.
 Code Block
[mach@localhost ~]$ machcollectoradmin --kill
-----------------------------------------------------------------
     machcollector administration tool
     Release Version - 
...
x.
...
x.
...
x.
...
official
     Copyright 2014, Machbase Inc. or its subsidiaries
     All Rights Reserved.
-----------------------------------------------------------------
Waiting for collectormanager terminated.
Collectormanager terminated successfully.
...
Register Machbase Server
...

마크베이스 서버 등록
Collector Manager 에 연결된 마크베이스 데이터베이스 서버를 설정한다. 이후 machsql 을 통한 관리가 가능하다.
 Code Block
[mach@localhost ~]$ machcollectoradmin --createserver=127.0.0.1:5757  
-----------------------------------------------------------------
     machcollector administration tool
     Release Version - 
...
x.
...
x.
...
x.
...
official
     Copyright 2014, Machbase Inc. or its subsidiaries
     All Rights Reserved.
-----------------------------------------------------------------
Created the server successfully.
...
Specify a Server Name
When executing a command to add additional servers, you can specify a name of collector manager. Argument of --managername should be executed with --createserver. Therefore, it can be specified in machcollectoradmin when the manager is created. The example below shows that the manager name will be displayed as mach_manager.

Collector Manager 이름 지정
마크베이스 서버에 Collector Manager 를 등록할 때, 등록하는 Collector Manager 의 이름을 설정할 수 있다.
 Code Block
 [mach@localhost ~]$ machcollectoradmin --createserver=127.0.0.1:5757 --managername=mach_manager 
-----------------------------------------------------------------
     machcollector administration tool
     Release Version - 
...
x.
...
x.
...
x.
...
official
     Copyright 2014, Machbase Inc. or its subsidiaries
     All Rights Reserved.
-----------------------------------------------------------------
Created the server successfully.
...
Verify the Server List
...

등록된 마크베이스 서버 목록 출력
Collector Manager 에 등록된 데이터베이스 서버 리스트를 표시한다.
 Code Block
[mach@localhost ~]$ machcollectoradmin --showservers
...

-----------------------------------------------------------------
     machcollector administration tool
     Release Version - 
...
x.
...
x.
...
x.
...
official
     Copyright 2014, Machbase Inc. or its subsidiaries
     All Rights Reserved.
-----------------------------------------------------------------
ID   1
NAME 192.168.0.34:5757
ADDR 192.168.0.34
PORT 5757
...
...

Collector 
...
생성
Collector Manager 가 관리하는 collector 를 생성한다.
collector 를 생성할 때, 이름과 템플릿 파일의 경로를 필수적으로 입력받는다.
collector의 이름은 첫 번째 인자로 입력 받고, 템플릿 경로는 -m 또는 --template 옵션으로 지정해야 한다.
 Code Block
[mach@localhost ~]$ machcollectoradmin --createcollector=syslog --template=/home/hanchi/work/nfx/machbase_home/collector/syslog.tpl
-----------------------------------------------------------------
machcollector administration tool
Release Version - 
...
x.
...
x.
...
x.
...
official
Copyright 2014, Machbase Inc. or its subsidiaries
All Rights Reserved.
-----------------------------------------------------------------
Created the collector successfully.
...
Specify a Template
...

템플릿 파일 지정
collector 를 생성할 때, collector설정 파일인 템플릿 파일의 경로를 지정한다. 
상대 경로인 경우 $MACHBASE_HOME/collector/
...
 디렉토리를 기준으로 한다.
 Code Block
[mach@localhost ~]$ machcollectoradmin --createcollector=syslog --template=syslog.tpl
-----------------------------------------------------------------
     machcollector administration tool
     Release Version - 
...
x.
...
x.
...
x.
...
official
     Copyright 2014, Machbase Inc. or its subsidiaries
     All Rights Reserved.
-----------------------------------------------------------------
Created the collector successfully.
...
	
...

Collector 실행
...
등록된 collector 프로세스를 실행한다. 실행 시 collector 이름을 명시해야 한다.
 Code Block
[mach@localhost ~]$ machcollectoradmin --startcollector=syslog
-----------------------------------------------------------------
     machcollector administration tool
     Release Version - 
...
x.
...
x.
...
x.
...
official
     Copyright 2014, Machbase Inc. or its subsidiaries
     All Rights Reserved.
-----------------------------------------------------------------
Started the collector successfully.
...
...

Collector 
...
로그 메세지 설정
사용자가 collector  실행 시에 로그 메시지를 생성하도록 한다.
값을 1로 설정하면 생성되고 0으로 설정하면 생성하지 않는다.
 Code Block
[mach@localhost ~]$ machcollectoradmin --startcollector=syslog --trace=1
-----------------------------------------------------------------
     machcollector administration tool
     Release Version - 
...
x.
...
x.
...
x.
...
official
     Copyright 2014, Machbase Inc. or its subsidiaries
     All Rights Reserved.
-----------------------------------------------------------------
Started the collector successfully.
...
...

Collector 
...
중지
실행중 인 collector 를 중지시킨다.
 Code Block
[mach@localhost ~]$ machcollectoradmin --stopcollector=syslog
-----------------------------------------------------------------
     machcollector administration tool
     Release Version - 
...
x.
...
x.
...
x.
...
official
     Copyright 2014, Machbase Inc. or its subsidiaries
     All Rights Reserved.
-----------------------------------------------------------------
Stopped the collector successfully.
...
...

Collector 제거
It deletes a collector that is not currently operating. It enters the name of the collector as an argument.
collector 에 관련된 메타 정보를 삭제한다. 실행 시 collector 의 이름을 명시해야 한다.
 Code Block
[mach@localhost ~]$ machcollectoradmin --dropcollector=syslog
-----------------------------------------------------------------
     machcollector administration tool
     Release Version - 
...
x.
...
x.
...
x.
...
official
     Copyright 2014, Machbasae Inc. or its subsidiaries
     All Rights Reserved.
-----------------------------------------------------------------
Dropped the collector successfully.
...
...

Collector 
...
It can check the list of the registered collectors.
리스트 출력
등록된 collector의 리스트를 표시한다.
 Code Block
[mach@localhost ~]$ machcollectoradmin --showcollectors
...

-----------------------------------------------------------------
     machcollector administration tool
     Release Version - 
...
x.
...
x.
...
x.
...
official
     Copyright 2014, Machbase Inc. or its subsidiaries
     All Rights Reserved.
-----------------------------------------------------------------
ID                  1
NAME                  SYSLOG
TEMPLATE_PATH       syslog.tpl
COLLECT_TYPE        FILE
SOURCE_FILE         /var/log/syslog
LOG_TYPE            syslog
PREPROCESS_PATH     
REGEX_PATH          syslog.rgx
REGEX               (([a-zA-Z]+)\s+([0-9]+)\s+([0-9:]*))\s(\S+)\s+([^\n]+)
END_REGEX           \n
LANGUAGE            UTF-8
SLEEP_TIME          1000
PROCESS_BYTE        0
PROCESS_RECORD      0
PREV_PROCESS_BYTE   0
PREV_PROCESS_RECORD 0
RUN_FLAG            0