plugins/tracers/gststats.c

   1 /* GStreamer
   2  * Copyright (C) 2013 Stefan Sauer <ensonic@users.sf.net>
   3  *
   4  * gststats.c: tracing module that logs events
   5  *
   6  * This library is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Library General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 2 of the License, or (at your option) any later version.
  10  *
  11  * This library is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Library General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Library General Public
  17  * License along with this library; if not, write to the
  18  * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
  19  * Boston, MA 02110-1301, USA.
  20  */
  21 /**
  22  * SECTION:gststats
  23  * @short_description: log event stats
  24  *
  25  * A tracing module that builds usage statistic for elements and pads.
  26  */
  27
  28 #ifdef HAVE_CONFIG_H
  29 #  include "config.h"
  30 #endif
  31
  32 #include "gststats.h"
  33
  34 #include <stdio.h>
  35
  36 GST_DEBUG_CATEGORY_STATIC (gst_stats_debug);
  37 #define GST_CAT_DEFAULT gst_stats_debug
  38
  39 static GQuark data_quark;
  40 G_LOCK_DEFINE (_elem_stats);
  41 G_LOCK_DEFINE (_pad_stats);
  42
  43 #define _do_init \
  44     GST_DEBUG_CATEGORY_INIT (gst_stats_debug, "stats", 0, "stats tracer"); \
  45     data_quark = g_quark_from_static_string ("gststats:data");
  46 #define gst_stats_tracer_parent_class parent_class
  47 G_DEFINE_TYPE_WITH_CODE (GstStatsTracer, gst_stats_tracer, GST_TYPE_TRACER,
  48     _do_init);
  49
  50 static GstTracerRecord *tr_new_element;
  51 static GstTracerRecord *tr_new_pad;
  52 static GstTracerRecord *tr_buffer;
  53 static GstTracerRecord *tr_element_query;
  54 static GstTracerRecord *tr_event;
  55 static GstTracerRecord *tr_message;
  56 static GstTracerRecord *tr_query;
  57
  58 typedef struct
  59 {
  60   /* we can't rely on the address to be unique over time */
  61   guint index;
  62   /* for pre + post */
  63   GstClockTime last_ts;
  64   /* hierarchy */
  65   guint parent_ix;
  66 } GstPadStats;
  67
  68 typedef struct
  69 {
  70   /* we can't rely on the address to be unique over time */
  71   guint index;
  72   /* for pre + post */
  73   GstClockTime last_ts;
  74   /* time spend in this element */
  75   GstClockTime treal;
  76   /* hierarchy */
  77   guint parent_ix;
  78 } GstElementStats;
  79
  80 /* data helper */
  81
  82 static GstElementStats no_elem_stats = { 0, };
  83
  84 static GstElementStats *
  85 fill_element_stats (GstStatsTracer * self, GstElement * element)
  86 {
  87   GstElementStats *stats = g_slice_new0 (GstElementStats);
  88
  89   stats->index = self->num_elements++;
  90   stats->parent_ix = G_MAXUINT;
  91   return stats;
  92 }
  93
  94 static void
  95 log_new_element_stats (GstElementStats * stats, GstElement * element,
  96     GstClockTime elapsed)
  97 {
  98   gst_tracer_record_log (tr_new_element, (guint64) (guintptr) g_thread_self (),
  99       elapsed, stats->index, stats->parent_ix, GST_OBJECT_NAME (element),
 100       G_OBJECT_TYPE_NAME (element), GST_IS_BIN (element));
 101 }
 102
 103 static void
 104 free_element_stats (gpointer data)
 105 {
 106   g_slice_free (GstElementStats, data);
 107 }
 108
 109 static GstElementStats *
 110 create_element_stats (GstStatsTracer * self, GstElement * element)
 111 {
 112   GstElementStats *stats;
 113
 114   stats = fill_element_stats (self, element);
 115   g_object_set_qdata_full ((GObject *) element, data_quark, stats,
 116       free_element_stats);
 117
 118   return stats;
 119 }
 120
 121 static inline GstElementStats *
 122 get_element_stats (GstStatsTracer * self, GstElement * element)
 123 {
 124   GstElementStats *stats;
 125   gboolean is_new = FALSE;
 126
 127   if (!element) {
 128     no_elem_stats.index = G_MAXUINT;
 129     return &no_elem_stats;
 130   }
 131
 132   G_LOCK (_elem_stats);
 133   if (!(stats = g_object_get_qdata ((GObject *) element, data_quark))) {
 134     stats = create_element_stats (self, element);
 135     is_new = TRUE;
 136   }
 137   G_UNLOCK (_elem_stats);
 138   if (G_UNLIKELY (stats->parent_ix == G_MAXUINT)) {
 139     GstElement *parent = GST_ELEMENT_PARENT (element);
 140     if (parent) {
 141       GstElementStats *parent_stats = get_element_stats (self, parent);
 142       stats->parent_ix = parent_stats->index;
 143     }
 144   }
 145   if (G_UNLIKELY (is_new)) {
 146     log_new_element_stats (stats, element, GST_CLOCK_TIME_NONE);
 147   }
 148   return stats;
 149 }
 150
 151 /*
 152  * Get the element/bin owning the pad.
 153  *
 154  * in: a normal pad
 155  * out: the element
 156  *
 157  * in: a proxy pad
 158  * out: the element that contains the peer of the proxy
 159  *
 160  * in: a ghost pad
 161  * out: the bin owning the ghostpad
 162  */
 163 /* TODO(ensonic): gst_pad_get_parent_element() would not work here, should we
 164  * add this as new api, e.g. gst_pad_find_parent_element();
 165  */
 166 static GstElement *
 167 get_real_pad_parent (GstPad * pad)
 168 {
 169   GstObject *parent;
 170
 171   if (!pad)
 172     return NULL;
 173
 174   parent = GST_OBJECT_PARENT (pad);
 175
 176   /* if parent of pad is a ghost-pad, then pad is a proxy_pad */
 177   if (parent && GST_IS_GHOST_PAD (parent)) {
 178     pad = GST_PAD_CAST (parent);
 179     parent = GST_OBJECT_PARENT (pad);
 180   }
 181   return GST_ELEMENT_CAST (parent);
 182 }
 183
 184 static GstPadStats no_pad_stats = { 0, };
 185
 186 static GstPadStats *
 187 fill_pad_stats (GstStatsTracer * self, GstPad * pad)
 188 {
 189   GstPadStats *stats = g_slice_new0 (GstPadStats);
 190
 191   stats->index = self->num_pads++;
 192   stats->parent_ix = G_MAXUINT;
 193
 194   return stats;
 195 }
 196
 197 static void
 198 log_new_pad_stats (GstPadStats * stats, GstPad * pad)
 199 {
 200   gst_tracer_record_log (tr_new_pad, (guint64) (guintptr) g_thread_self (),
 201       stats->index, stats->parent_ix, GST_OBJECT_NAME (pad),
 202       G_OBJECT_TYPE_NAME (pad), GST_IS_GHOST_PAD (pad),
 203       GST_PAD_DIRECTION (pad));
 204 }
 205
 206 static void
 207 free_pad_stats (gpointer data)
 208 {
 209   g_slice_free (GstPadStats, data);
 210 }
 211
 212 static GstPadStats *
 213 get_pad_stats (GstStatsTracer * self, GstPad * pad)
 214 {
 215   GstPadStats *stats;
 216   gboolean is_new = FALSE;
 217
 218   if (!pad) {
 219     no_pad_stats.index = G_MAXUINT;
 220     return &no_pad_stats;
 221   }
 222
 223   G_LOCK (_pad_stats);
 224   if (!(stats = g_object_get_qdata ((GObject *) pad, data_quark))) {
 225     stats = fill_pad_stats (self, pad);
 226     g_object_set_qdata_full ((GObject *) pad, data_quark, stats,
 227         free_pad_stats);
 228     is_new = TRUE;
 229   }
 230   G_UNLOCK (_pad_stats);
 231   if (G_UNLIKELY (stats->parent_ix == G_MAXUINT)) {
 232     GstElement *elem = get_real_pad_parent (pad);
 233     if (elem) {
 234       GstElementStats *elem_stats = get_element_stats (self, elem);
 235
 236       stats->parent_ix = elem_stats->index;
 237     }
 238   }
 239   if (G_UNLIKELY (is_new)) {
 240     log_new_pad_stats (stats, pad);
 241   }
 242   return stats;
 243 }
 244
 245 static void
 246 do_buffer_stats (GstStatsTracer * self, GstPad * this_pad,
 247     GstPadStats * this_pad_stats, GstPad * that_pad,
 248     GstPadStats * that_pad_stats, GstBuffer * buf, GstClockTime elapsed)
 249 {
 250   GstElement *this_elem = get_real_pad_parent (this_pad);
 251   GstElementStats *this_elem_stats = get_element_stats (self, this_elem);
 252   GstElement *that_elem = get_real_pad_parent (that_pad);
 253   GstElementStats *that_elem_stats = get_element_stats (self, that_elem);
 254
 255   gst_tracer_record_log (tr_buffer, (guint64) (guintptr) g_thread_self (),
 256       elapsed, this_pad_stats->index, this_elem_stats->index,
 257       that_pad_stats->index, that_elem_stats->index, gst_buffer_get_size (buf),
 258       GST_BUFFER_PTS (buf), GST_BUFFER_DTS (buf), GST_BUFFER_DURATION (buf),
 259       GST_BUFFER_FLAGS (buf));
 260 }
 261
 262 static void
 263 do_query_stats (GstStatsTracer * self, GstPad * this_pad,
 264     GstPadStats * this_pad_stats, GstPad * that_pad,
 265     GstPadStats * that_pad_stats, GstQuery * qry, GstClockTime elapsed,
 266     gboolean have_res, gboolean res)
 267 {
 268   GstElement *this_elem = get_real_pad_parent (this_pad);
 269   GstElementStats *this_elem_stats = get_element_stats (self, this_elem);
 270   GstElement *that_elem = get_real_pad_parent (that_pad);
 271   GstElementStats *that_elem_stats = get_element_stats (self, that_elem);
 272
 273   gst_tracer_record_log (tr_query, (guint64) (guintptr) g_thread_self (),
 274       elapsed, this_pad_stats->index, this_elem_stats->index,
 275       that_pad_stats->index, that_elem_stats->index, GST_QUERY_TYPE_NAME (qry),
 276       gst_query_get_structure (qry), have_res, res);
 277 }
 278
 279 static void
 280 do_element_stats (GstStatsTracer * self, GstPad * pad, GstClockTime elapsed1,
 281     GstClockTime elapsed2)
 282 {
 283   GstClockTimeDiff elapsed = GST_CLOCK_DIFF (elapsed1, elapsed2);
 284   GstObject *parent = GST_OBJECT_PARENT (pad);
 285   GstElement *this =
 286       GST_ELEMENT_CAST (GST_IS_PAD (parent) ? GST_OBJECT_PARENT (parent) :
 287       parent);
 288   GstElementStats *this_stats = get_element_stats (self, this);
 289   GstPad *peer_pad = GST_PAD_PEER (pad);
 290   GstElementStats *peer_stats;
 291
 292   if (!peer_pad)
 293     return;
 294
 295   /* walk the ghost pad chain downstream to get the real pad */
 296   /* if parent of peer_pad is a ghost-pad, then peer_pad is a proxy_pad */
 297   parent = GST_OBJECT_PARENT (peer_pad);
 298   if (parent && GST_IS_GHOST_PAD (parent)) {
 299     peer_pad = GST_PAD_CAST (parent);
 300     /* if this is now the ghost pad, get the peer of this */
 301     get_pad_stats (self, peer_pad);
 302     if ((parent = GST_OBJECT_PARENT (peer_pad))) {
 303       get_element_stats (self, GST_ELEMENT_CAST (parent));
 304     }
 305     peer_pad = GST_PAD_PEER (GST_GHOST_PAD_CAST (peer_pad));
 306     parent = peer_pad ? GST_OBJECT_PARENT (peer_pad) : NULL;
 307   }
 308   /* walk the ghost pad chain upstream to get the real pad */
 309   /* if peer_pad is a ghost-pad, then parent is a bin and it is the parent of
 310    * a proxy_pad */
 311   while (peer_pad && GST_IS_GHOST_PAD (peer_pad)) {
 312     get_pad_stats (self, peer_pad);
 313     get_element_stats (self, GST_ELEMENT_CAST (parent));
 314     peer_pad = gst_ghost_pad_get_target (GST_GHOST_PAD_CAST (peer_pad));
 315     parent = peer_pad ? GST_OBJECT_PARENT (peer_pad) : NULL;
 316   }
 317
 318   if (!parent) {
 319     printf ("%" GST_TIME_FORMAT
 320         " transmission on unparented target pad %s_%s -> %s_%s\n",
 321         GST_TIME_ARGS (elapsed), GST_DEBUG_PAD_NAME (pad),
 322         GST_DEBUG_PAD_NAME (peer_pad));
 323     return;
 324   }
 325   peer_stats = get_element_stats (self, GST_ELEMENT_CAST (parent));
 326
 327   /* we'd like to gather time spend in each element, but this does not make too
 328    * much sense yet
 329    * pure push/pull-based:
 330    *   - the time spend in the push/pull_range is accounted for the peer and
 331    *     removed from the current element
 332    *   - this works for chains
 333    *   - drawback is sink elements that block to sync have a high time usage
 334    *     - we could rerun the ests with sync=false
 335    * both:
 336    *   - a.g. demuxers both push and pull. thus we subtract time for the pull
 337    *     and the push operations, but never add anything.
 338    *   - can we start a counter after push/pull in such elements and add then
 339    *     time to the element upon next pad activity?
 340    */
 341 #if 1
 342   /* this does not make sense for demuxers */
 343   this_stats->treal -= elapsed;
 344   peer_stats->treal += elapsed;
 345 #else
 346   /* this creates several >100% figures */
 347   this_stats->treal += GST_CLOCK_DIFF (this_stats->last_ts, elapsed2) - elapsed;
 348   peer_stats->treal += elapsed;
 349   this_stats->last_ts = elapsed2;
 350   peer_stats->last_ts = elapsed2;
 351 #endif
 352 }
 353
 354 /* hooks */
 355
 356 static void
 357 do_push_buffer_pre (GstStatsTracer * self, guint64 ts, GstPad * this_pad,
 358     GstBuffer * buffer)
 359 {
 360   GstPadStats *this_pad_stats = get_pad_stats (self, this_pad);
 361   GstPad *that_pad = GST_PAD_PEER (this_pad);
 362   GstPadStats *that_pad_stats = get_pad_stats (self, that_pad);
 363
 364   do_buffer_stats (self, this_pad, this_pad_stats, that_pad, that_pad_stats,
 365       buffer, ts);
 366 }
 367
 368 static void
 369 do_push_buffer_post (GstStatsTracer * self, guint64 ts, GstPad * pad,
 370     GstFlowReturn res)
 371 {
 372   GstPadStats *stats = get_pad_stats (self, pad);
 373
 374   do_element_stats (self, pad, stats->last_ts, ts);
 375 }
 376
 377 typedef struct
 378 {
 379   GstStatsTracer *self;
 380   GstPad *this_pad;
 381   GstPadStats *this_pad_stats;
 382   GstPad *that_pad;
 383   GstPadStats *that_pad_stats;
 384   guint64 ts;
 385 } DoPushBufferListArgs;
 386
 387 static gboolean
 388 do_push_buffer_list_item (GstBuffer ** buffer, guint idx, gpointer user_data)
 389 {
 390   DoPushBufferListArgs *args = (DoPushBufferListArgs *) user_data;
 391
 392   do_buffer_stats (args->self, args->this_pad, args->this_pad_stats,
 393       args->that_pad, args->that_pad_stats, *buffer, args->ts);
 394   return TRUE;
 395 }
 396
 397 static void
 398 do_push_buffer_list_pre (GstStatsTracer * self, guint64 ts, GstPad * this_pad,
 399     GstBufferList * list)
 400 {
 401   GstPadStats *this_pad_stats = get_pad_stats (self, this_pad);
 402   GstPad *that_pad = GST_PAD_PEER (this_pad);
 403   GstPadStats *that_pad_stats = get_pad_stats (self, that_pad);
 404   DoPushBufferListArgs args = { self, this_pad, this_pad_stats, that_pad,
 405     that_pad_stats, ts
 406   };
 407
 408   gst_buffer_list_foreach (list, do_push_buffer_list_item, &args);
 409 }
 410
 411 static void
 412 do_push_buffer_list_post (GstStatsTracer * self, guint64 ts, GstPad * pad,
 413     GstFlowReturn res)
 414 {
 415   GstPadStats *stats = get_pad_stats (self, pad);
 416
 417   do_element_stats (self, pad, stats->last_ts, ts);
 418 }
 419
 420 static void
 421 do_pull_range_pre (GstStatsTracer * self, guint64 ts, GstPad * pad)
 422 {
 423   GstPadStats *stats = get_pad_stats (self, pad);
 424   stats->last_ts = ts;
 425 }
 426
 427 static void
 428 do_pull_range_post (GstStatsTracer * self, guint64 ts, GstPad * this_pad,
 429     GstBuffer * buffer)
 430 {
 431   GstPadStats *this_pad_stats = get_pad_stats (self, this_pad);
 432   guint64 last_ts = this_pad_stats->last_ts;
 433   GstPad *that_pad = GST_PAD_PEER (this_pad);
 434   GstPadStats *that_pad_stats = get_pad_stats (self, that_pad);
 435
 436   if (buffer != NULL) {
 437     do_buffer_stats (self, this_pad, this_pad_stats, that_pad, that_pad_stats,
 438         buffer, ts);
 439   }
 440   do_element_stats (self, this_pad, last_ts, ts);
 441 }
 442
 443 static void
 444 do_push_event_pre (GstStatsTracer * self, guint64 ts, GstPad * pad,
 445     GstEvent * ev)
 446 {
 447   GstElement *elem = get_real_pad_parent (pad);
 448   GstElementStats *elem_stats = get_element_stats (self, elem);
 449   GstPadStats *pad_stats = get_pad_stats (self, pad);
 450
 451   elem_stats->last_ts = ts;
 452   gst_tracer_record_log (tr_event, (guint64) (guintptr) g_thread_self (), ts,
 453       pad_stats->index, elem_stats->index, GST_EVENT_TYPE_NAME (ev));
 454 }
 455
 456 static void
 457 do_post_message_pre (GstStatsTracer * self, guint64 ts, GstElement * elem,
 458     GstMessage * msg)
 459 {
 460   GstElementStats *stats = get_element_stats (self, elem);
 461   const GstStructure *msg_s = gst_message_get_structure (msg);
 462
 463   stats->last_ts = ts;
 464   gst_tracer_record_log (tr_message, (guint64) (guintptr) g_thread_self (), ts,
 465       stats->index, GST_MESSAGE_TYPE_NAME (msg),
 466       (msg_s ? msg_s : gst_structure_new_empty ("dummy")));
 467 }
 468
 469 static void
 470 do_element_new (GstStatsTracer * self, guint64 ts, GstElement * elem)
 471 {
 472   GstElementStats *stats;
 473
 474   stats = create_element_stats (self, elem);
 475   log_new_element_stats (stats, elem, ts);
 476 }
 477
 478 static void
 479 do_element_query_pre (GstStatsTracer * self, guint64 ts, GstElement * elem,
 480     GstQuery * qry)
 481 {
 482   GstElementStats *stats = get_element_stats (self, elem);
 483
 484   stats->last_ts = ts;
 485   gst_tracer_record_log (tr_element_query,
 486       (guint64) (guintptr) g_thread_self (), ts, stats->index,
 487       GST_QUERY_TYPE_NAME (qry));
 488 }
 489
 490 static void
 491 do_query_pre (GstStatsTracer * self, guint64 ts, GstPad * this_pad,
 492     GstQuery * qry)
 493 {
 494   GstPadStats *this_pad_stats = get_pad_stats (self, this_pad);
 495   GstPad *that_pad = GST_PAD_PEER (this_pad);
 496   GstPadStats *that_pad_stats = get_pad_stats (self, that_pad);
 497
 498   do_query_stats (self, this_pad, this_pad_stats, that_pad, that_pad_stats,
 499       qry, ts, FALSE, FALSE);
 500 }
 501
 502 static void
 503 do_query_post (GstStatsTracer * self, guint64 ts, GstPad * this_pad,
 504     GstQuery * qry, gboolean res)
 505 {
 506   GstPadStats *this_pad_stats = get_pad_stats (self, this_pad);
 507   GstPad *that_pad = GST_PAD_PEER (this_pad);
 508   GstPadStats *that_pad_stats = get_pad_stats (self, that_pad);
 509
 510   do_query_stats (self, this_pad, this_pad_stats, that_pad, that_pad_stats,
 511       qry, ts, TRUE, res);
 512 }
 513
 514 /* tracer class */
 515
 516 static void
 517 gst_stats_tracer_class_init (GstStatsTracerClass * klass)
 518 {
 519   /* announce trace formats */
 520   /* *INDENT-OFF* */
 521   tr_buffer = gst_tracer_record_new (gst_structure_new ("buffer.class",
 522       "thread-id", GST_TYPE_STRUCTURE, gst_structure_new ("scope",
 523           "type", G_TYPE_GTYPE, G_TYPE_UINT64,
 524           "related-to", GST_TYPE_TRACER_VALUE_SCOPE, GST_TRACER_VALUE_SCOPE_THREAD,
 525           NULL),
 526       "ts", GST_TYPE_STRUCTURE, gst_structure_new ("value",
 527           "type", G_TYPE_GTYPE, G_TYPE_UINT64,
 528           "description", G_TYPE_STRING, "event ts",
 529           NULL),
 530       "pad-ix", GST_TYPE_STRUCTURE, gst_structure_new ("scope",
 531           "type", G_TYPE_GTYPE, G_TYPE_UINT,
 532           "related-to", GST_TYPE_TRACER_VALUE_SCOPE, GST_TRACER_VALUE_SCOPE_PAD,
 533           NULL),
 534       "element-ix", GST_TYPE_STRUCTURE, gst_structure_new ("scope",
 535           "type", G_TYPE_GTYPE, G_TYPE_UINT,
 536           "related-to", GST_TYPE_TRACER_VALUE_SCOPE, GST_TRACER_VALUE_SCOPE_ELEMENT,
 537           NULL),
 538       "peer-pad-ix", GST_TYPE_STRUCTURE, gst_structure_new ("scope",
 539           "type", G_TYPE_GTYPE, G_TYPE_UINT,
 540           "related-to", GST_TYPE_TRACER_VALUE_SCOPE, GST_TRACER_VALUE_SCOPE_PAD,
 541           NULL),
 542       "peer-element-ix", GST_TYPE_STRUCTURE, gst_structure_new ("scope",
 543           "type", G_TYPE_GTYPE, G_TYPE_UINT,
 544           "related-to", GST_TYPE_TRACER_VALUE_SCOPE, GST_TRACER_VALUE_SCOPE_ELEMENT,
 545           NULL),
 546       "buffer-size", GST_TYPE_STRUCTURE, gst_structure_new ("value",
 547           "type", G_TYPE_GTYPE, G_TYPE_UINT,
 548           "description", G_TYPE_STRING, "size of buffer in bytes",
 549           "min", G_TYPE_UINT, 0,
 550           "max", G_TYPE_UINT, G_MAXUINT,
 551           NULL),
 552       "buffer-ts", GST_TYPE_STRUCTURE, gst_structure_new ("value",
 553           "type", G_TYPE_GTYPE, G_TYPE_UINT64,
 554           "description", G_TYPE_STRING, "timestamp of the buffer in ns",
 555           "min", G_TYPE_UINT64, G_GUINT64_CONSTANT (0),
 556           "max", G_TYPE_UINT64, G_MAXUINT64,
 557           NULL),
 558       "buffer-duration", GST_TYPE_STRUCTURE, gst_structure_new ("value",
 559           "type", G_TYPE_GTYPE, G_TYPE_UINT64,
 560           "description", G_TYPE_STRING, "duration of the buffer in ns",
 561           "min", G_TYPE_UINT64, G_GUINT64_CONSTANT (0),
 562           "max", G_TYPE_UINT64, G_MAXUINT64,
 563           NULL),
 564       /* TODO(ensonic): "buffer-flags" */
 565       NULL));
 566   tr_event = gst_tracer_record_new (gst_structure_new ("event.class",
 567       "thread-id", GST_TYPE_STRUCTURE, gst_structure_new ("scope",
 568           "type", G_TYPE_GTYPE, G_TYPE_UINT64,
 569           "related-to", GST_TYPE_TRACER_VALUE_SCOPE, GST_TRACER_VALUE_SCOPE_THREAD,
 570           NULL),
 571       "ts", GST_TYPE_STRUCTURE, gst_structure_new ("value",
 572           "type", G_TYPE_GTYPE, G_TYPE_UINT64,
 573           "description", G_TYPE_STRING, "event ts",
 574           NULL),
 575       "pad-ix", GST_TYPE_STRUCTURE, gst_structure_new ("scope",
 576           "type", G_TYPE_GTYPE, G_TYPE_UINT,
 577           "related-to", GST_TYPE_TRACER_VALUE_SCOPE, GST_TRACER_VALUE_SCOPE_PAD,
 578           NULL),
 579       "element-ix", GST_TYPE_STRUCTURE, gst_structure_new ("scope",
 580           "type", G_TYPE_GTYPE, G_TYPE_UINT,
 581           "related-to", GST_TYPE_TRACER_VALUE_SCOPE, GST_TRACER_VALUE_SCOPE_ELEMENT,
 582           NULL),
 583       "name", GST_TYPE_STRUCTURE, gst_structure_new ("value",
 584           "type", G_TYPE_GTYPE, G_TYPE_STRING,
 585           "description", G_TYPE_STRING, "name of the event",
 586           NULL),
 587       NULL));
 588   tr_message = gst_tracer_record_new (gst_structure_new ("message.class",
 589       "thread-id", GST_TYPE_STRUCTURE, gst_structure_new ("scope",
 590           "type", G_TYPE_GTYPE, G_TYPE_UINT64,
 591           "related-to", GST_TYPE_TRACER_VALUE_SCOPE, GST_TRACER_VALUE_SCOPE_THREAD,
 592           NULL),
 593       "ts", GST_TYPE_STRUCTURE, gst_structure_new ("value",
 594           "type", G_TYPE_GTYPE, G_TYPE_UINT64,
 595           "description", G_TYPE_STRING, "event ts",
 596           NULL),
 597       "element-ix", GST_TYPE_STRUCTURE, gst_structure_new ("scope",
 598           "type", G_TYPE_GTYPE, G_TYPE_UINT,
 599           "related-to", GST_TYPE_TRACER_VALUE_SCOPE, GST_TRACER_VALUE_SCOPE_ELEMENT,
 600           NULL),
 601       "name", GST_TYPE_STRUCTURE, gst_structure_new ("value",
 602           "type", G_TYPE_GTYPE, G_TYPE_STRING,
 603           "description", G_TYPE_STRING, "name of the message",
 604           NULL),
 605       "structure", GST_TYPE_STRUCTURE, gst_structure_new ("structure",
 606           "type", G_TYPE_GTYPE, GST_TYPE_STRUCTURE,
 607           "description", G_TYPE_STRING, "message structure",
 608           NULL),
 609       NULL));
 610   tr_element_query = gst_tracer_record_new (gst_structure_new (
 611       "element-query.class",
 612       "thread-id", GST_TYPE_STRUCTURE, gst_structure_new ("scope",
 613           "type", G_TYPE_GTYPE, G_TYPE_UINT64,
 614           "related-to", GST_TYPE_TRACER_VALUE_SCOPE, GST_TRACER_VALUE_SCOPE_THREAD,
 615           NULL),
 616       "ts", GST_TYPE_STRUCTURE, gst_structure_new ("value",
 617           "type", G_TYPE_GTYPE, G_TYPE_UINT64,
 618           "description", G_TYPE_STRING, "event ts",
 619           NULL),
 620       "element-ix", GST_TYPE_STRUCTURE, gst_structure_new ("scope",
 621           "type", G_TYPE_GTYPE, G_TYPE_UINT,
 622           "related-to", GST_TYPE_TRACER_VALUE_SCOPE, GST_TRACER_VALUE_SCOPE_ELEMENT,
 623           NULL),
 624       "name", GST_TYPE_STRUCTURE, gst_structure_new ("value",
 625           "type", G_TYPE_GTYPE, G_TYPE_STRING,
 626           "description", G_TYPE_STRING, "name of the query",
 627           NULL),
 628       NULL));
 629   tr_query = gst_tracer_record_new (gst_structure_new ("query.class",
 630       "thread-id", GST_TYPE_STRUCTURE, gst_structure_new ("scope",
 631           "type", G_TYPE_GTYPE, G_TYPE_UINT64,
 632           "related-to", GST_TYPE_TRACER_VALUE_SCOPE, GST_TRACER_VALUE_SCOPE_THREAD,
 633           NULL),
 634       "ts", GST_TYPE_STRUCTURE, gst_structure_new ("value",
 635           "type", G_TYPE_GTYPE, G_TYPE_UINT64,
 636           "description", G_TYPE_STRING, "event ts",
 637           NULL),
 638       "pad-ix", GST_TYPE_STRUCTURE, gst_structure_new ("scope",
 639           "type", G_TYPE_GTYPE, G_TYPE_UINT,
 640           "related-to", GST_TYPE_TRACER_VALUE_SCOPE, GST_TRACER_VALUE_SCOPE_PAD,
 641           NULL),
 642       "element-ix", GST_TYPE_STRUCTURE, gst_structure_new ("scope",
 643           "type", G_TYPE_GTYPE, G_TYPE_UINT,
 644           "related-to", GST_TYPE_TRACER_VALUE_SCOPE, GST_TRACER_VALUE_SCOPE_ELEMENT,
 645           NULL),
 646       "peer-pad-ix", GST_TYPE_STRUCTURE, gst_structure_new ("scope",
 647           "type", G_TYPE_GTYPE, G_TYPE_UINT,
 648           "related-to", GST_TYPE_TRACER_VALUE_SCOPE, GST_TRACER_VALUE_SCOPE_PAD,
 649           NULL),
 650       "peer-element-ix", GST_TYPE_STRUCTURE, gst_structure_new ("scope",
 651           "type", G_TYPE_GTYPE, G_TYPE_UINT,
 652           "related-to", GST_TYPE_TRACER_VALUE_SCOPE, GST_TRACER_VALUE_SCOPE_ELEMENT,
 653           NULL),
 654       "name", GST_TYPE_STRUCTURE, gst_structure_new ("value",
 655           "type", G_TYPE_GTYPE, G_TYPE_STRING,
 656           "description", G_TYPE_STRING, "name of the query",
 657           NULL),
 658       "structure", GST_TYPE_STRUCTURE, gst_structure_new ("value",
 659           "type", G_TYPE_GTYPE, GST_TYPE_STRUCTURE,
 660           "description", G_TYPE_STRING, "query structure",
 661           NULL),
 662       "res", GST_TYPE_STRUCTURE, gst_structure_new ("value",
 663           "type", G_TYPE_GTYPE, G_TYPE_BOOLEAN,
 664           "description", G_TYPE_STRING, "query result",
 665           "flags", GST_TYPE_TRACER_VALUE_FLAGS, GST_TRACER_VALUE_FLAGS_OPTIONAL,
 666           NULL),
 667       /* TODO(ensonic): "buffer-flags" */
 668       NULL));
 669   tr_new_element = gst_tracer_record_new (gst_structure_new (
 670       "new-element.class",
 671       "thread-id", GST_TYPE_STRUCTURE, gst_structure_new ("scope",
 672           "type", G_TYPE_GTYPE, G_TYPE_UINT64,
 673           "related-to", GST_TYPE_TRACER_VALUE_SCOPE, GST_TRACER_VALUE_SCOPE_THREAD,
 674           NULL),
 675       "ts", GST_TYPE_STRUCTURE, gst_structure_new ("value",
 676           "type", G_TYPE_GTYPE, G_TYPE_UINT64,
 677           "description", G_TYPE_STRING, "event ts",
 678           NULL),
 679       "ix", GST_TYPE_STRUCTURE, gst_structure_new ("scope",
 680           "type", G_TYPE_GTYPE, G_TYPE_UINT,
 681           "related-to", GST_TYPE_TRACER_VALUE_SCOPE, GST_TRACER_VALUE_SCOPE_ELEMENT,
 682           NULL),
 683       "parent-ix", GST_TYPE_STRUCTURE, gst_structure_new ("scope",
 684           "type", G_TYPE_GTYPE, G_TYPE_UINT,
 685           "related-to", GST_TYPE_TRACER_VALUE_SCOPE, GST_TRACER_VALUE_SCOPE_ELEMENT,
 686           NULL),
 687       "name", GST_TYPE_STRUCTURE, gst_structure_new ("value",
 688           "type", G_TYPE_GTYPE, G_TYPE_STRING,
 689           "description", G_TYPE_STRING, "name of the element",
 690           NULL),
 691       "type", GST_TYPE_STRUCTURE, gst_structure_new ("value",
 692           "type", G_TYPE_GTYPE, G_TYPE_STRING,
 693           "description", G_TYPE_STRING, "type name of the element",
 694           NULL),
 695       "is-bin", GST_TYPE_STRUCTURE, gst_structure_new ("value",
 696           "type", G_TYPE_GTYPE, G_TYPE_BOOLEAN,
 697           "description", G_TYPE_STRING, "is element a bin",
 698           NULL),
 699       NULL));
 700   tr_new_pad = gst_tracer_record_new (gst_structure_new ("new-pad.class",
 701       "thread-id", GST_TYPE_STRUCTURE, gst_structure_new ("scope",
 702           "type", G_TYPE_GTYPE, G_TYPE_UINT64,
 703           "related-to", GST_TYPE_TRACER_VALUE_SCOPE, GST_TRACER_VALUE_SCOPE_THREAD,
 704           NULL),
 705       "ix", GST_TYPE_STRUCTURE, gst_structure_new ("scope",
 706           "type", G_TYPE_GTYPE, G_TYPE_UINT,
 707           "related-to", GST_TYPE_TRACER_VALUE_SCOPE, GST_TRACER_VALUE_SCOPE_PAD,
 708           NULL),
 709       "parent-ix", GST_TYPE_STRUCTURE, gst_structure_new ("scope",
 710           "type", G_TYPE_GTYPE, G_TYPE_UINT,
 711           "related-to", GST_TYPE_TRACER_VALUE_SCOPE, GST_TRACER_VALUE_SCOPE_ELEMENT,
 712           NULL),
 713       "name", GST_TYPE_STRUCTURE, gst_structure_new ("value",
 714           "type", G_TYPE_GTYPE, G_TYPE_STRING,
 715           "description", G_TYPE_STRING, "name of the pad",
 716           NULL),
 717       "type", GST_TYPE_STRUCTURE, gst_structure_new ("value",
 718           "type", G_TYPE_GTYPE, G_TYPE_STRING,
 719           "description", G_TYPE_STRING, "type name of the pad",
 720           NULL),
 721       "is-ghostpad", GST_TYPE_STRUCTURE, gst_structure_new ("value",
 722           "type", G_TYPE_GTYPE, G_TYPE_BOOLEAN,
 723           "description", G_TYPE_STRING, "is pad a ghostpad",
 724           NULL),
 725       "pad-direction", GST_TYPE_STRUCTURE, gst_structure_new ("value",
 726           "type", G_TYPE_GTYPE, GST_TYPE_PAD_DIRECTION,
 727           "description", G_TYPE_STRING, "ipad direction",
 728           NULL),
 729       NULL));
 730   /* *INDENT-ON* */
 731 }
 732
 733 static void
 734 gst_stats_tracer_init (GstStatsTracer * self)
 735 {
 736   GstTracer *tracer = GST_TRACER (self);
 737
 738   gst_tracing_register_hook (tracer, "pad-push-pre",
 739       G_CALLBACK (do_push_buffer_pre));
 740   gst_tracing_register_hook (tracer, "pad-push-post",
 741       G_CALLBACK (do_push_buffer_post));
 742   gst_tracing_register_hook (tracer, "pad-push-list-pre",
 743       G_CALLBACK (do_push_buffer_list_pre));
 744   gst_tracing_register_hook (tracer, "pad-push-list-post",
 745       G_CALLBACK (do_push_buffer_list_post));
 746   gst_tracing_register_hook (tracer, "pad-pull-range-pre",
 747       G_CALLBACK (do_pull_range_pre));
 748   gst_tracing_register_hook (tracer, "pad-pull-range-post",
 749       G_CALLBACK (do_pull_range_post));
 750   gst_tracing_register_hook (tracer, "pad-push-event-pre",
 751       G_CALLBACK (do_push_event_pre));
 752   gst_tracing_register_hook (tracer, "element-new",
 753       G_CALLBACK (do_element_new));
 754   gst_tracing_register_hook (tracer, "element-post-message-pre",
 755       G_CALLBACK (do_post_message_pre));
 756   gst_tracing_register_hook (tracer, "element-query-pre",
 757       G_CALLBACK (do_element_query_pre));
 758   gst_tracing_register_hook (tracer, "pad-query-pre",
 759       G_CALLBACK (do_query_pre));
 760   gst_tracing_register_hook (tracer, "pad-query-post",
 761       G_CALLBACK (do_query_post));
 762 }