SystemTap新手指南

 主页   资讯   文章   代码   电子书 

3.5. 数组操作

本节将列举SystemTap中若干常用的数组操作。

设置给定键的值

使用=来设置给定键所对应的值,正如:

foo[tid()] = gettimeofday_s()

SystemTap会把tid()的结果作为一个键,并把gettimeofday_s()的结果赋给这个键。如果这个键已经存在foo中,原先关联的值会被覆盖掉。

获取给定键的值

使用array_name[index_expression]可以获取对应键上的值。比如:

delta = gettimeofday_s() - foo[tid()]

如果数组中没有index_expression对应的键,默认情况下它会返回0(在数值计算中)或者空字符串(在字符串操作中)。

自增给定键的值

使用++来增加对应键上的值,比如:array_name[index_expression] ++。在下面的例子里,每次vfs.read都会把当前进程名所关联的值加一:

probe vfs.read
{
  reads[execname()] ++
}

你可以用if (index_expression in array_name)来判断数组是否有指定的键。

遍历数组中的多个元素

一旦已经收集了足够的信息到数组里,你往往需要去遍历它。正如上面的例子中,在收集了各个进程的读次数后,你可能需要遍历它,输出每个进程的结果。那该怎么做呢?

最好的方法就是使用foreach语句。看下这个例子:

global reads
probe vfs.read
{
  reads[execname()] ++
}

probe timer.s(3)
{
  foreach (count in reads)
    printf("%s : %d \n", count, reads[count])
}

在第二个探针中的foreach语句里,count引用了reads的键,所以可以通过reads[count]读取对应键所关联的值。

在这个foreach语句里面,我们依次遍历reads的每个值。假如我们不想遍历整个数组,或者想指定遍历的顺序,该怎么做呢?你可以给数组名加个后缀+来表示按升序遍历,或-按降序遍历。另外,你可以用limit加一个数字来限制迭代的次数。 看下这个类似于上一个探针的例子:

probe timer.s(3)
{
  foreach (count in reads- limit 10)
    printf("%s : %d \n", count, reads[count])
}

上面的foreach语句会按关联的值降序遍历数组。limit 10表示foreach语句只会迭代10次(也即输出最高的10个值)。

清除数组或数组中某个元素

有时,你需要清除数组值某个值,或者清空整个数组以便于在另一个探针值重用。在之前统计vfs.read的例子里,每三秒统计一次各个进程的调用读操作的次数。如果要想统计三秒内各个进程的数据,需要每三秒清空一次数组。你可以使用delete运算符来删除数组中的某个元素,或整个数组。看下下面的例子:

global reads
probe vfs.read
{
  reads[execname()] ++
}

probe timer.s(3)
{
  foreach (count in reads)
    printf("%s : %d \n", count, reads[count])
  delete reads
}

在上面的例子中,第二个探针仅输出三秒内每个进程的读次数。这里的delete语句清空了整个reads数组。

使用聚集变量(use aggregates)

有时候你需要快速处理新的数值,并且数据量较大,这时候可以考虑使用聚集变量(aggregates),因为它实现了对数据的流式处理。聚集变量可以用作全局变量,也可以用作数组中的值。使用<<<运算符可以往聚集变量中添加新数据。

global reads
probe vfs.read
{
  reads[execname()] <<< $count
}

假设在上面的例子中,$count的值是一段时间内当前进程的读次数。<<<会把$count的值存储到reads数组execname()关联的聚集变量中。请注意,我们是把值存储在聚集变量里面;它们既没有加到原来的值上,也没有覆盖掉原来的值。可以这么说,就像是reads数组值每个键都有多个关联的值,并且探针的每次触发都会添加新的值。

要想从聚集变量中获取汇总的结果,使用这样的语法@extractor(variable/array index expression)extractor可以取以下的函数:

count

返回variable/array index expression中存储的数值的数目。以上面为例,@count(reads[execname()])返回对应进程的聚集变量所存储的数据数。

sum

返回variable/array index expression中存储的数值的和。以上面为例,@count(reads[execname()])返回对应进程的读总数。

min

返回variable/array index expression中存储的数值的最小值。

max

返回variable/array index expression中存储的数值的最大值。

avg

返回variable/array index expression中存储的数值的数目。

你可以使用多重索引表达式在数组里关联一个聚集变量(最多使用9个索引)。这么做的好处在于,你可以在数组中附加更多的上下文信息。举个例子:

global reads
probe vfs.read
{
  reads[execname(),pid()] <<< 1
}

probe timer.s(3)
{
  foreach([var1,var2] in reads)
    printf("%s (%d) : %d \n", var1, var2, @count(reads[var1,var2]))
}

在上面的例子中,第一个探针记录每个进程的vfs.read次数。跟之前的例子不同的是,这里的数组同时使用进程名和PID作为索引。

在第二个探针里,我们使用foreach语句遍历并输出每个进程的数据。注意这里我们分别使用var1var2来引用进程名和PID。