Loadrunner日志参数的设置与使用

一、Run-Time Setting日志参数的设置  

在loadrunner的vuser菜单下的Run-Time Setting的General的LOG选项中可以对在执行脚本时Loadrunner对日志的操作行为进行定义，下面我们在逐一介绍：

1、  Enable logging启用日志记录

如果选中该选项Loadrunner在执行脚本时，进行日志的记录，否则不记录日志

2、  Send messages only when an error occurs 仅在出错时发送消息

       也称为 JIT （实时）消息传递，仅当错误发生时才写入日志，选择该选项后则可以设置高级选项，指明日志缓存的大小，loadrunner默认的日志到小为1k

3、  Always send messages

始终发送消息

4、  Standard log

       标准日志：创建在脚本执行期间发送的函数和消息的标准日志，供调试时使用。

对于大型负载测试场景、优化会话或配置文件禁用此选项。

如果日志记录级别设置为“标准”，当把脚本添加到场景、会话步骤或配置文件

中时，日志记录模式将被自动设置为“Send messages only when an error occurs”。但是，如果日志记录模式被禁用或者设置为“扩展”，则将脚本添加到场景、会话步骤或配置文件中将不会影响其日志记录设置。

5、  Extended log-----Parameter substitution

参数替换：选择此选项可以记录指定给脚本的所有参数及其相应的值

当脚本进行参数化、插入事务、关联等优化后，在执行脚本过程中，参数化的值、事务所耗时间、关联函数取出的变量值均会在日志中输出，这个选项对调试脚本查看参数化取值、关联取值是否正确有着重要的作用

6、  Extended log-----Data returned by server

   选择此选项可以记录服务器返回的所有数据。

   Loadrunner会将所有对服务器发出请求后的response情况记录在日志中，从这个日志中可以查看到服务器对请求的回应是否正确，在使用关联取值时往往需要到该日志中查看需要关联的值，从而确认所取数据左右边界。

7、  Extended log-----Advanced trace  高级跟踪

       选择此选项可以记录 Vuser 在会话期间发送的所有函数和消息。

调试 Vuser 脚本时，该选项非常有用。

二、日志函数的使用  

Loadrunner提供了一下几个message函数：
1、lr_message
int lr_message (const char * format, exp1, exp2,...expn.);
中文解释：lr_message函数将信息发送到日志文件和输入窗口。在VuGen中运行时，输入文件为output.txt。

例如：

char* abort="aborting"; 

  lr_message ("login failed: %s", abort);

    在日志中将会看到:login failed: aborting

2、lr_log_message
int lr_log_message (const char * format, exp1, exp2,...expn.);
中文解释：lr_log_message函数将消息发送到Vuser或代理日志文件（取决于应用程序），而不是发送到输出窗口。通过向日志文件发送错误消息或其他信息性消息，可以将该函数用于调试。

3、lr_error_message
int lr_error_message (const char *format, exp1, exp2,...expn. );
中文解释：lr_error_message函数将错误消息发送到输出窗口和Vuser日志文件。

如果Run-time settings > General > Miscellaneous >Continue on error未被选中，当脚本执行到此处时将终止执行，这个函数所输出的错误级别较高的信息，所以一般情况下如果使用该函数时选中Continue on error

4、lr_output_message
int lr_output_message (const char *format, exp1, exp2,...expn.);
中文解释：lr_output_message函数将带有脚本部分的行号的消息发送到输出窗口和日志文件。



三、在脚本中定义日志的输出模式

int lr_debug_message (unsigned int message_level, const char *format, ... );

中文解释：lr_debug_message函数在指定的消息级别处于活动状态时发送一条调试信息。如果指定的消息级别未出于活动状态，则不发送消息。您可以从用户界面或者使用lr_set_debug_message，将处于活动状态的消息级别设置为MSG_CLASS_BRIEF_LOG 或MSG_CLASSS_EXTENDED_LOG。要确定当前级别，请使用lr_get_debug_message。

unsigned int lr_get_debug_message ( );
中文解释：lr_get_debug_message函数返回当前的日志运行时设置。该设置确定发送到输出端的信息。日志设置是使用运行时设置对话框或通过使用lr_set_debug_message函数指定的。

int lr_set_debug_message (unsigned int message_level, unsigned int on_off);
中文解释：lr_set_debug_message函数设置脚本执行的调试消息级别message_lvl。通过设置消息级别，可以确定发送哪些信息。启 动设置的方法是将LR_SWITCH_ON作为on_off传递，禁用设置的方法是传递LR_SWITCH_OFF。

参数message_level说明：

日志级别
  C语言标志
  值
  Runtime-setting - Log操作

Disabled
  LR_MSG_CLASS_DISABLE_LOG
  0
  不勾选Enable logging

Brief
  LR_MSG_CLASS_BRIEF_LOG
  1
  勾选Standard log

Extended Log
  LR_MSG_CLASS_EXTENDED_LOG
  16
  勾选Extended log

Result Data
  LR_MSG_CLASS_RESULT_DATA
  2
  勾选Data returned by server

Parameter Substitution
  LR_MSG_CLASS_PARAMETERS
  4
  勾选Parameter substitution

Full Run-Time Trace
  LR_MSG_CLASS_FULL_TRACE
  8
  勾选 Advanced trace

Only on error
  LR_MSG_CLASS_JIT_LOG_ON_ERROR
  512
  勾选send messages only when an error occurs


参数on_off说明：
【LR_SWITCH_ON】启用设置
【LR_SWITCH_OFF】禁用设置


看下面的小例子：
Action()
{
int log_leavl;
log_leavl = lr_get_debug_message();
lr_error_message ("当前是:%d",log_leavl);
return 0;
}
当我设置只有错误信息(error)打印【勾选send messages only when an error occurs】，例子运行结果是：当前是:513；为什么不是512呢，我发现我实际选择的是【Enable logging + send messages only when an error occurs】，按上面的参数说明，就是【1+512】，也就是513了；因此：lr_get_debug_message返回的int数其实是所有勾选操作的代表值相加！

再看下面设置的例子：

Action()
{
//设置runtime-setting的日志选项【不勾选Enable logging】
char *a;
a = "ABC";
lr_set_debug_message (LR_MSG_CLASS_EXTENDED_LOG |LR_MSG_CLASS_PARAMETERS,LR_SWITCH_ON);
//打开Runtime-setting Log 的Parameter substitution设置
lr_debug_message(LR_MSG_CLASS_PARAMETERS,"打开参数保存的系统日志");
lr_save_string("aa",a);
lr_debug_message(LR_MSG_CLASS_PARAMETERS,"关闭参数保存的系统日志");
lr_set_debug_message (LR_MSG_CLASS_EXTENDED_LOG |LR_MSG_CLASS_PARAMETERS,LR_SWITCH_OFF);
//关闭Runtime-setting Log 的Parameter substitution设置

return 0;
}

因为设置了runtime-setting不打印任何日志，所以正常运行脚本应该没有任何日志输出；
但是使用lr_set_debug_message函数打开了日志的设置(输出保存参数操作的日志)
因此脚本运行到lr_save_string("aa",a)时，就输出了日志如下：

打开参数保存的系统日志
Action.c(7): Notify: Saving Parameter "ABC = aa"
关闭参数保存的系统日志