[LTTng实操]------编写Linux应用程序控制Trace过程

前略。

简单Makefile编写

因为编译要依赖LTTng的库，所以写几行makefile 避免重复敲命令行。

LTTNG_Lib = $(shell pkg-config --cflags --libs lttng-ctl lttng-ust)

all:
	g++ my_lttng_ctl.cpp  $(LTTNG_Lib) 

clean:
	rm a.out

启动 session daemon

lttng-sessiond --daemonize

这个参考我之前发文章，有很多中方法添加在开机启动里。

目前方便起见，直接手敲了。

Note that some Linux distributions could manage the LTTng session daemon as a service. In this case, we suggest that you use the service manager to start, restart, and stop session daemons.

还有一问题是启动用户。每个用户都可以有一个daemon。

在嵌入式设备中一般只用root账号即可。在开发host中监控用户程序的话，当前用户权限即可。

Trace 过程控制API #include 判断当前是否有session daemon

LTTNG_EXPORT extern int lttng_session_daemon_alive(void);

start/stop trace record

LTTNG_EXPORT extern int lttng_start_tracing(const char *session_name);


LTTNG_EXPORT extern int lttng_stop_tracing(const char *session_name);


LTTNG_EXPORT extern int lttng_stop_tracing_no_wait(const char *session_name);

检查Trace data数据是否准备好

LTTNG_EXPORT extern int lttng_data_pending(const char *session_name);

已被包含在lttng.h中。

create

LTTNG_EXPORT extern int lttng_create_session(const char *name, const char *url);

LTTNG_EXPORT extern int lttng_create_session_live(const char *name, const char *url,
		unsigned int timer_interval);

destory

LTTNG_EXPORT extern int lttng_destroy_session(const char *name);

list

LTTNG_EXPORT extern int lttng_list_sessions(struct lttng_session **sessions);

struct lttng_session

#define LTTNG_SESSION_PADDING1             8
struct lttng_session {
	char name[LTTNG_NAME_MAX];
	
	char path[PATH_MAX];
	uint32_t enabled;	
	uint32_t snapshot_mode;
	unsigned int live_timer_interval;	

	

	
	char alignment_padding[4];
	union {
		
		char padding[LTTNG_SESSION_PADDING1];
		void *ptr;
	} extended;
};

enable & disable event

extern int lttng_enable_event(struct lttng_handle *handle,
		struct lttng_event *ev, const char *channel_name);


extern int lttng_enable_event_with_filter(struct lttng_handle *handle,
		struct lttng_event *event, const char *channel_name,
		const char *filter_expression);


extern int lttng_enable_event_with_exclusions(struct lttng_handle *handle,
		struct lttng_event *event, const char *channel_name,
		const char *filter_expression,
		int exclusion_count, char **exclusion_names);


extern int lttng_disable_event(struct lttng_handle *handle,
		const char *name, const char *channel_name);


extern int lttng_disable_event_ext(struct lttng_handle *handle,
		struct lttng_event *ev, const char *channel_name,
		const char *filter_expression);

Trace 过程控制必须要有的步骤 1、开启 session daemon

指令:

lttng-sessiond --daemonize

2、create a recording session

指令：

lttng create my-session --output=/tmp/some-directory

API：

LTTNG_EXPORT extern int lttng_create_session(const char *name, const char *url);

参数可以传自定义的名字和绝对地址（相对我没试过）两个字符串常量。

3、使能 event rules

指令：

lttng enable-event --kernel --syscall open,write,read,close

lttng enable-event --userspace my_app:'*' 
                   --exclude=my_app:set_user,my_app:handle_sig

API:

extern int lttng_enable_event(struct lttng_handle *handle,
		struct lttng_event *ev, const char *channel_name);

extern int lttng_enable_event_with_filter(struct lttng_handle *handle,
		struct lttng_event *event, const char *channel_name,
		const char *filter_expression);

extern int lttng_enable_event_with_exclusions(struct lttng_handle *handle,
		struct lttng_event *event, const char *channel_name,
		const char *filter_expression,
		int exclusion_count, char **exclusion_names);

在代码实现中，前两个接口是后面那个（除了…使能所有）接口的套壳。

参数需要自己定义，下面是原型以供参考：

#define LTTNG_HANDLE_PADDING1              16
struct lttng_handle {
	char session_name[LTTNG_NAME_MAX];
	struct lttng_domain domain;

	char padding[LTTNG_HANDLE_PADDING1];
};


#define LTTNG_EVENT_PADDING1               12
#define LTTNG_EVENT_PADDING2               LTTNG_SYMBOL_NAME_LEN + 32
struct lttng_event {
	
	enum lttng_event_type type;

	
	char name[LTTNG_SYMBOL_NAME_LEN];

	
	enum lttng_loglevel_type loglevel_type;

	
	int loglevel;

	
	int32_t enabled;	

	
	pid_t pid;

	
	unsigned char filter;	

	
	unsigned char exclusion; 

	
	char padding2[2];

	
	
	enum lttng_event_flag flags;

	
	char padding[4];

	
	union {
		uint64_t padding;
		void *ptr;
	} extended;

	
	
	union {
		struct lttng_event_probe_attr probe;
		struct lttng_event_function_attr ftrace;

		char padding[LTTNG_EVENT_PADDING2];
	} attr;
};

我爬了一下源码，似乎lttng_event这个结构体，name的部分。是一次一个。也就是说名字是单个event的名字，以""结束符结尾了。对于命令行中多个参数以逗号隔开的输入，是使用了字符串拆分和循环。我看到不是很仔细，先暂且记录一下。

写代码我无所谓，一行写一个好了。

对于ev这个参数能不能是NULL，API的注释居然出现了冲突。

有待实验。保险起见不要设NULL。显示化设置一个。

4、Start and stop a recording session

指令：

lttng start

lttng stop

API：

LTTNG_EXPORT extern int lttng_start_tracing(const char *session_name);


LTTNG_EXPORT extern int lttng_stop_tracing(const char *session_name);

5、destroy record session

指令：

lttng destroy

API:

LTTNG_EXPORT extern int lttng_destroy_session(const char *name);

session daemon 不归 liblttng-ctl管，如果要杀，直接Kill。。。实际上可能也没必要。因为已经后台服务化了。

[LTTng实操]------编写Linux应用程序控制Trace过程

Linux相关栏目本月热门文章