SoW-2020-0003: Trace Hit Counters

[lttng-tools.git] / doc / examples / map / demo.sh

diff --git a/doc/examples/map/demo.sh b/doc/examples/map/demo.sh
new file mode 100755 (executable)
index 0000000..ae48093
--- /dev/null
+++ b/doc/examples/map/demo.sh
@@ -0,0 +1,59 @@
+#!/bin/bash
+#
+# Copyright (C) 2021 Francis Deslauriers <francis.deslauriers@efficios.com>
+#
+# SPDX-License-Identifier: MIT
+
+SESSION_NAME="incr_value_ex_sess"
+MAP_NAME="incr_value_ex_map"
+TRIGGER_NAME="incr_value_ex_trigger"
+
+lttng list > /dev/null 2>&1
+if [ $? -ne 0 ]; then
+    echo "Could not connect to session daemon, are you sure it is running?"
+    exit 1
+fi
+
+echo "1. Creating a session"
+lttng create $SESSION_NAME
+echo ""
+
+echo "2. Creating a UST map with default configuration"
+lttng add-map --userspace $MAP_NAME
+lttng list $SESSION_NAME --map=$MAP_NAME
+echo ""
+
+echo "3. Registering a incr-value trigger named \"$TRIGGER_NAME\" for user-space events"
+echo "   The \"$TRIGGER_NAME\" trigger has 2 distinct \`incr-value\` actions."
+lttng add-trigger --id $TRIGGER_NAME \
+       --condition on-event -u "incr_value_ex:*" \
+       --action incr-value --session $SESSION_NAME --map $MAP_NAME --key 'Total number of events' \
+       --action incr-value --session $SESSION_NAME --map $MAP_NAME --key '${PROVIDER_NAME} -> ${EVENT_NAME}'
+lttng list-triggers
+echo ""
+
+
+echo "4. Start the tracing and run the application for 10 seconds"
+lttng start
+timeout 10 ./instrumented-app > /dev/null
+echo ""
+
+echo "5. Stop tracing"
+lttng stop
+echo ""
+
+echo "6. View the $MAP_NAME map"
+lttng view-map $MAP_NAME
+echo ""
+
+echo "7. View only on key of the $MAP_NAME map"
+lttng view-map $MAP_NAME --key "incr_value_ex -> event1"
+echo ""
+
+
+echo "8. Query a specific value using the C API"
+./query-example $SESSION_NAME $MAP_NAME "Total number of events"
+echo ""
+
+lttng destroy -a
+lttng remove-trigger $TRIGGER_NAME