From 82f426c231754da7c58ddbeca29c3e36baa0b291 Mon Sep 17 00:00:00 2001 From: ddomingo Date: Mon, 8 Sep 2008 14:29:23 +1000 Subject: added content for Ch1 and 2, to add more later --- .../en-US/Introduction.xml | 33 ++++++++++++++++++---- 1 file changed, 27 insertions(+), 6 deletions(-) (limited to 'doc/SystemTap_Beginners_Guide/en-US/Introduction.xml') diff --git a/doc/SystemTap_Beginners_Guide/en-US/Introduction.xml b/doc/SystemTap_Beginners_Guide/en-US/Introduction.xml index 9285d0ae..f60ab2f3 100644 --- a/doc/SystemTap_Beginners_Guide/en-US/Introduction.xml +++ b/doc/SystemTap_Beginners_Guide/en-US/Introduction.xml @@ -5,15 +5,36 @@ Introduction - A short introduction on SystemTap_Beginners_Guide + SystemTap is a tracing and probing tool that provides users deep technical insight into what the operating system (particularly, the kernel) is doing at any given time. It provides information similar to the output of tools like netstat, ps, top, and iostat; however, SystemTap is designed to provide information that is more "granular" in nature. - + + For system administrators, SystemTap can be used as a performance monitoring tool for ∏. It is most useful when other similar tools cannot precisely pinpoint a bottleneck in the system, requiring a deep analysis of kernel activity. In the same manner, application developers can also use SystemTap to monitor, in finer detail, how their application behaves. + + + +
Goals - TBD - + The goal of SystemTap is to provide infrastructure to monitor the running Linux kernel for detailed analysis. This can assist in identifying the underlying cause of a performance or functional problem. + + Without SystemTap, monitoring the activity of a running kernel would require a tedious instrument, recompile, install, and reboot sequence. SystemTap is designed to eliminate this, allowing you to gather the same information by simply running its suite of tools against specific tapsets or SystemTap scripts. + + However, SystemTap was initially designed for users with intermediate to advanced knowledge of the kernel. This could present a steep learning curve for administrators or developers whose knowledge of the Linux kernel is little to none. + + In line with that, the main goal of the SystemTap Beginner's Guide is two-fold: + + + To introduce users to SystemTap, familiarize them with its architecture, and provide setup instructions for all kernel types. + + To provide pre-written SystemTap scripts for monitoring and forensic tasks, along with instructions on how to analyze their output. + + above, Short description on the underlying goals of SystemTap_Beginners_Guide, what we want to teach users. - +
Usage @@ -25,7 +46,7 @@
SystemTap Versus Other Monitoring Tools - Short summary; when is SystemTap suitable vs other popular monitoring tools (e.g. top, Oprofile, /proc) + ** Short summary; when is SystemTap suitable vs other popular monitoring tools (e.g. top, Oprofile, /proc) -- cgit