X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/fdd43f09c482715dc07d4479ca161c03046a14ed..2f6675522a8094f454db80dd2de6b7c6e2f3a741:/doc/tracing.doc
diff --git a/doc/tracing.doc b/doc/tracing.doc
index 407a0c4cf9..4a7fe288c0 100644
--- a/doc/tracing.doc
+++ b/doc/tracing.doc
@@ -219,6 +219,40 @@ triva/uncategorized
--cfg=triva/categorized:graph_uncategorized.plist
\endverbatim
+\subsection tracing_tracing_example_parameters Case studies
+
+Some scenarios that might help you decide which tracing options
+you should use to analyze your simulator.
+
+\li I want to trace the resource utilization of all hosts
+and links of the platform, and my simulator does not use
+the tracing API. For that, you can run a uncategorized trace
+with the following parameters (it will work with any Simgrid
+simulator):
+\verbatim
+./your_simulator \
+ --cfg=tracing:1 \
+ --cfg=tracing/uncategorized:1 \
+ --cfg=tracing/filename:mytracefile.trace \
+ --cfg=triva/uncategorized:uncat.plist
+\endverbatim
+
+\li I want to trace only a subset of my MSG (or SimDAG) tasks.
+For that, you will need to create tracing categories using the
+TRACE_category (...) function (as explained above),
+and then classify your tasks to a previously declared category
+using the TRACE_msg_set_task_category (...)
+(or TRACE_sd_set_task_category (...) for SimDAG tasks). After
+recompiling, run your simulator with the following parameters:
+\verbatim
+./your_simulator \
+ --cfg=tracing:1 \
+ --cfg=tracing/categorized:1 \
+ --cfg=tracing/filename:mytracefile.trace \
+ --cfg=triva/categorized:cat.plist
+\endverbatim
+
+
\subsection tracing_tracing_example Example of Instrumentation
A simplified example using the tracing mandatory functions.