Mojolicious::Plugin::Surveil - Surveil user actions
0.03
Mojolicious::Plugin::Surveil is a plugin which allow you to see every event a user trigger on your web page. It is meant as a debug tool for seeing events, even if the browser does not have a JavaScript console.
CAVEAT: The JavaScript that is injected require WebSocket in the browser to run. The surveil events are attached to the "body" element, so any other event that prevent events from bubbling will not emit this to the WebSocket resource.
use Mojolicious::Lite; plugin "surveil";
Visit http://localhost:3000?_surveil=1 to enable the logging. Try clicking around on your page and look in the console for log messages.
use Mojo::Redis; use Mojo::JSON "encode_json"; plugin "surveil", { handler => sub { my ($c, $event) = @_; my $ip = $c->tx->remote_address; $c->redis->pubsub->notify("surveil:$ip" => encode_json $event); } };
The above example is useful if you want to publish the events to Redis instead of a log file. A developer can then run commands below to see what a given user is doing:
$ redis-cli psubscribe "surveil:*" $ redis-cli subscribe "surveil:192.168.0.100"
$self->register($app, \%config); $app->plugin("surveil" => \%config);
Used to add an "after_render" hook into the application which adds a JavaScript to every HTML document when the "enable_param" is set.
%config can have the following settings:
%config
enable_param
Used to specify a query parameter to be part of the URL to enable surveil.
Default is "_surveil".
events
The events that should be reported back over the WebSocket.
Defaults to blur, click, focus, touchstart, touchcancel and touchend.
Note that the default list might change in the future.
handler
A code ref that handles the events from the web page. This is useful if you want to post them to an event bus instead of in the log file.
path
The path to the WebSocket route.
Defaults to /mojolicious/plugin/surveil.
/mojolicious/plugin/surveil
Copyright (C) 2014-2018, Jan Henning Thorsen
This program is free software, you can redistribute it and/or modify it under the terms of the Artistic License version 2.0.
Jan Henning Thorsen - jhthorsen@cpan.org
jhthorsen@cpan.org
To install Mojolicious::Plugin::Surveil, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Mojolicious::Plugin::Surveil
CPAN shell
perl -MCPAN -e shell install Mojolicious::Plugin::Surveil
For more information on module installation, please visit the detailed CPAN module installation guide.