tracer: rename GST_TRACER_PLUGINS env var to GST_TRACERS

This commit is contained in:
Tim-Philipp Müller 2016-01-22 12:50:08 +00:00
parent ec75b68984
commit 63421675b1
3 changed files with 11 additions and 11 deletions

View file

@ -36,8 +36,8 @@ condition to check if active.
Certain GStreamer core function (such as gst_pad_push or gst_element_add_pad)
will call into the tracer subsystem to dispatch into active tracing modules.
Developers will be able to select a list of plugins by setting an environment
variable, such as GST_TRACER_PLUGINS="meminfo;dbus". One can also pass parameters to
plugins: GST_TRACER_PLUGINS="log(events,buffers);stats(all)".
variable, such as GST_TRACERS="meminfo;dbus". One can also pass parameters to
plugins: GST_TRACERS="log(events,buffers);stats(all)".
When then plugins are loaded, we'll add them to certain hooks according to which
they are interested in.
@ -83,7 +83,7 @@ In addition to api hooks we should also provide timer hooks. Interval timers are
useful to get e.g. resource usage snapshots. Also absolute timers might make
sense. All this could be implemented with a clock thread. We can use another
env-var GST_TRACE_TIMERS="100ms,75ms" to configure timers and then pass them to
the tracers like, GST_TRACER_PLUGINS="rusage(timer=100ms);meminfo(timer=75ms)". Maybe
the tracers like, GST_TRACERS="rusage(timer=100ms);meminfo(timer=75ms)". Maybe
we can create them ad-hoc and avoid the GST_TRACE_TIMERS var.
Hooks (* already implemented)
@ -339,19 +339,19 @@ Problems / Open items
Try it
======
GST_DEBUG="GST_TRACER:7,GST_BUFFER*:7,GST_EVENT:7,GST_MESSAGE:7" GST_TRACER_PLUGINS=log gst-launch-1.0 fakesrc num-buffers=10 ! fakesink
GST_DEBUG="GST_TRACER:7,GST_BUFFER*:7,GST_EVENT:7,GST_MESSAGE:7" GST_TRACERS=log gst-launch-1.0 fakesrc num-buffers=10 ! fakesink
- traces for buffer flow in TRACE level
GST_DEBUG="GST_TRACER:7" GST_TRACER_PLUGINS="stats;rusage" GST_DEBUG_FILE=trace.log gst-launch-1.0 fakesrc num-buffers=10 sizetype=fixed ! queue ! fakesink
GST_DEBUG="GST_TRACER:7" GST_TRACERS="stats;rusage" GST_DEBUG_FILE=trace.log gst-launch-1.0 fakesrc num-buffers=10 sizetype=fixed ! queue ! fakesink
gst-stats-1.0 trace.log
- print some pipeline stats on exit
GST_DEBUG="GST_TRACER:7" GST_TRACER_PLUGINS="stats;rusage" GST_DEBUG_FILE=trace.log /usr/bin/gst-play-1.0 --interactive $HOME/Videos/movie.mp4
GST_DEBUG="GST_TRACER:7" GST_TRACERS="stats;rusage" GST_DEBUG_FILE=trace.log /usr/bin/gst-play-1.0 --interactive $HOME/Videos/movie.mp4
./scripts/gst-plot-traces.sh --format=png | gnuplot
eog trace.log.*.png
- get ts, average-cpuload, current-cpuload, time and plot
GST_DEBUG="GST_TRACER:7" GST_TRACER_PLUGINS=latency gst-launch-1.0 audiotestsrc num-buffers=10 ! audioconvert ! volume volume=0.7 ! autoaudiosink
GST_DEBUG="GST_TRACER:7" GST_TRACERS=latency gst-launch-1.0 audiotestsrc num-buffers=10 ! audioconvert ! volume volume=0.7 ! autoaudiosink
- print processing latencies
Performance

View file

@ -66,7 +66,7 @@ GHashTable *_priv_tracers = NULL;
void
_priv_gst_tracing_init (void)
{
const gchar *env = g_getenv ("GST_TRACER_PLUGINS");
const gchar *env = g_getenv ("GST_TRACERS");
if (env != NULL && *env != '\0') {
GstRegistry *registry = gst_registry_get ();

View file

@ -27,12 +27,12 @@ function test() {
}
echo "$tracer"
GST_DEBUG="GST_TRACER:7" GST_TRACER_PLUGINS="$tracer" test
GST_DEBUG="GST_TRACER:7" GST_TRACERS="$tracer" test
GST_DEBUG=
echo "no-log"
GST_TRACER_PLUGINS="$tracer" test
GST_TRACER_PLUGINS=
GST_TRACERS="$tracer" test
GST_TRACERS=
echo "reference"
test