oeAware用户指南

yum install oeAware-manager

systemctl start oeaware

log_path: /var/log/oeAware #日志存储路径
log_level: 1 #日志等级 1:DUBUG 2:INFO 3:WARN 4:ERROR
enable_list: #默认使能插件
	- name: libtest.so #只配置插件，使能本插件的所有实例
	- name: libtest1.so #配置插件实例，使能配置的插件实例
	  instances:
		- instance1 
		- instance2
		...
	...
plugin_list: #可支持下载的包
  - name: test #名称需要唯一，如果重复取第一个配置
    description: hello world
    url: https://gitee.com/openeuler/oeAware-manager/raw/master/README.md #url非空
  ...

systemctl restart oeaware

oeawarectl -l | --load <插件名>

[root@localhost ~]# oeawarectl -l libthread_collect.so
Plugin loaded successfully.

oeawarectl -r <插件名> | --remove <插件名>

[root@localhost ~]# oeawarectl -r libthread_collect.so
Plugin remove successfully.

oeawarectl -q  #查询系统中已经加载的所有插件
oeawarectl --query <插件名> #查询指定插件

[root@localhost ~]# oeawarectl -q
Show plugins and instances status.
------------------------------------------------------------
libthread_collector.so
        thread_collector(available, close)
libpmu.so
        pmu_cycles_sampling(available, close)
        pmu_cycles_counting(available, close)
        pmu_uncore_counting(available, close)
        pmu_spe_sampling(available, close)
libthread_tune.so
        thread_tune(available, close)
libthread_scenario.so
        thread_scenario(available, close)
------------------------------------------------------------
format:
[plugin]
        [instance]([dependency status], [running status])
dependency status: available means satisfying dependency, otherwise unavailable.
running status: running means that instance is running, otherwise close.

oeawarectl -Q  #查询已加载实例的依赖关系图
oeawarectl --query-dep= <插件实例>  #查询指定实例依赖关系图

oeawarectl -e | --enable <插件实例>

oeawarectl -d | --disable <插件实例>

oeawarectl --list

Supported Packages: #可下载的包
[name1] #config中配置的plugin_list
[name2]
...
Installed Plugins: #已安装的插件
[name1]
[name2]
...

oeawarectl -i | --install <rpm包名> #指定--list下查询得到的包名称(Supported Packages下的包)

usage: oeawarectl [options]...
  options
    -l|--load [plugin]      load plugin.
    -r|--remove [plugin]    remove plugin from system.
    -e|--enable [instance]  enable the plugin instance.
    -d|--disable [instance] disable the plugin instance.
    -q                      query all plugins information.
    --query [plugin]        query the plugin information.
    -Q                      query all instances dependencies.
    --query-dep [instance]  query the instance dependency.
    --list                  the list of supported plugins.
    -i|--install [plugin]   install plugin from the list.
    --help                  show this help message.

struct DataBuf {
    int len;
    void *data;
};

struct DataRingBuf {
    const char *instance_name;
    int index;
    uint64_t count;
    struct DataBuf *buf;
    int buf_len;
};

struct Param {
   const struct DataRingBuf **ring_bufs;
   int len;
};

struct Interface {
    const char* (*get_version)();
    /* The instance name is a unique identifier in the system. */
    const char* (*get_name)();
    const char* (*get_description)();
    /* Specifies the instance dependencies, which is used as the input information
     * for instance execution.
     */
    const char* (*get_dep)();
    /* Instance scheduling priority. In a uniform time period, a instance with a 
     * lower priority is scheduled first.
     */
    int (*get_priority)();
    int (*get_type)();
    /* Instance execution period. */
    int (*get_period)();
    bool (*enable)();
    void (*disable)();
    const struct DataRingBuf* (*get_ring_buf)();
    void (*run)(const struct Param*);
};

int get_instance(Interface **interface);