summaryrefslogtreecommitdiffstats
path: root/cddl/contrib/dtracetoolkit/Python/py_profile.d
blob: ff02df6e9327ecb5c7b680373e2e9bd7ecb43fe8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
#!/usr/sbin/dtrace -CZs
/*
 * py_profile.d - sample stack traces with Python translations using DTrace.
 *                Written for the Python DTrace provider.
 *
 * $Id: py_profile.d 19 2007-09-12 07:47:59Z brendan $
 *
 * USAGE: py_profile.d { -p PID | -c cmd }	# hit Ctrl-C to end
 *
 * This samples stack traces for the process specified. This stack trace
 * will cross the Python engine and system libraries, and insert 
 * translations for Python stack frames where appropriate. This is best
 * explained with an example stack frame output,
 *
 *            libpython2.4.so.1.0`PyEval_EvalFrame+0x2fbf
 *              [ ./func_loop.py:5 (func_c) ]
 *            libpython2.4.so.1.0`fast_function+0xa8
 *            libpython2.4.so.1.0`call_function+0xda
 *            libpython2.4.so.1.0`PyEval_EvalFrame+0xbdf
 *              [ ./func_loop.py:11 (func_b) ]
 *            libpython2.4.so.1.0`fast_function+0xa8
 *            libpython2.4.so.1.0`call_function+0xda
 *            libpython2.4.so.1.0`PyEval_EvalFrame+0xbdf
 *              [ ./func_loop.py:14 (func_a) ]
 *            libpython2.4.so.1.0`fast_function+0xa8
 *            libpython2.4.so.1.0`call_function+0xda
 *            libpython2.4.so.1.0`PyEval_EvalFrame+0xbdf
 *              [ ./func_loop.py:16 (?) ]
 *
 * The lines in square brackets are the native Python frames, the rest
 * are the Python engine.
 *
 * COPYRIGHT: Copyright (c) 2007 Brendan Gregg.
 *
 * CDDL HEADER START
 *
 *  The contents of this file are subject to the terms of the
 *  Common Development and Distribution License, Version 1.0 only
 *  (the "License").  You may not use this file except in compliance
 *  with the License.
 *
 *  You can obtain a copy of the license at Docs/cddl1.txt
 *  or http://www.opensolaris.org/os/licensing.
 *  See the License for the specific language governing permissions
 *  and limitations under the License.
 *
 * CDDL HEADER END
 *
 * 09-Sep-2007	Brendan Gregg	Created this.
 */

#pragma D option quiet
#pragma D option jstackstrsize=1024

/*
 * Tunables
 */
#define DEPTH	10		/* stack depth, frames */
#define RATE	1001		/* sampling rate, Hertz */
#define TOP	25		/* number of stacks to output */

dtrace:::BEGIN
{
	printf("Sampling %d-level stacks at %d Hertz... Hit Ctrl-C to end.\n",
	    DEPTH, RATE);
}

profile-RATE
/pid == $target/
{
	@stacks[jstack(DEPTH)] = count();
}

dtrace:::END
{
	trunc(@stacks, TOP);
	printf("Top %d most frequently sampled stacks,\n", TOP);
	printa(@stacks);
}
OpenPOWER on IntegriCloud