[JENKINS-41516] Add script console listener

core/src/main/java/hudson/cli/GroovyCommand.java

@@ -33,6 +33,7 @@
 import java.util.ArrayList;
 import java.util.List;
 import jenkins.model.Jenkins;
+import jenkins.model.ScriptListener;
 import org.apache.commons.io.IOUtils;
 import org.kohsuke.args4j.Argument;
 import org.kohsuke.args4j.CmdLineException;
@@ -70,7 +71,9 @@ protected int run() throws Exception {
         binding.setProperty("stderr", stderr);
 
         GroovyShell groovy = new GroovyShell(Jenkins.get().getPluginManager().uberClassLoader, binding);
-        groovy.run(loadScript(), "RemoteClass", remaining.toArray(new String[0]));
+        String script = loadScript();
+        ScriptListener.fireScriptFromCLIEvent(script);
+        groovy.run(script, "RemoteClass", remaining.toArray(new String[0]));
         return 0;
     }
 

core/src/main/java/hudson/cli/GroovyshCommand.java

@@ -39,6 +39,7 @@
 import java.util.ArrayList;
 import java.util.List;
 import jenkins.model.Jenkins;
+import jenkins.model.ScriptListener;
 import jline.TerminalFactory;
 import jline.UnsupportedTerminal;
 import org.codehaus.groovy.tools.shell.Groovysh;
@@ -79,6 +80,7 @@ protected int run() {
         }
 
         Groovysh shell = createShell(stdin, stdout, stderr);
+        ScriptListener.fireScriptFromCLIEvent(commandLine.toString());
         return shell.run(commandLine.toString());
     }
 

core/src/main/java/jenkins/model/Jenkins.java

@@ -142,6 +142,7 @@
 import hudson.model.listeners.SCMListener;
 import hudson.model.listeners.SaveableListener;
 import hudson.remoting.Callable;
+import hudson.remoting.Channel;
 import hudson.remoting.LocalChannel;
 import hudson.remoting.VirtualChannel;
 import hudson.scm.RepositoryBrowser;
@@ -4694,6 +4695,7 @@ public void run() {
      * Run arbitrary Groovy script.
      */
     public void doScript(StaplerRequest req, StaplerResponse rsp) throws IOException, ServletException {
+
         _doScript(req, rsp, req.getView(this, "_script.jelly"), FilePath.localChannel, getACL());
     }
 
@@ -4722,6 +4724,11 @@ public static void _doScript(StaplerRequest req, StaplerResponse rsp, RequestDis
             }
 
             try {
+                String runner = "Controller";
+                if (!(channel instanceof LocalChannel)) {
+                    runner = ((Channel) channel).getName();
+                }
+                ScriptListener.fireScriptConsoleEvent(text, runner);
                 req.setAttribute("output",
                         RemotingDiagnostics.executeGroovy(text, channel));
             } catch (InterruptedException e) {

core/src/main/java/jenkins/model/ScriptListener.java

@@ -0,0 +1,56 @@
+package jenkins.model;
+
+import hudson.ExtensionPoint;
+import jenkins.util.Listeners;
+import org.kohsuke.stapler.StaplerRequest;
+
+/**
+ * A listener to track Groovy scripts from the CLI and console.
+ *
+ * @see Jenkins#_doScript(StaplerRequest, org.kohsuke.stapler.StaplerResponse, javax.servlet.RequestDispatcher, hudson.remoting.VirtualChannel, hudson.security.ACL)
+ * @see hudson.cli.GroovyCommand#run()
+ * @see hudson.cli.GroovyshCommand#run()
+ */
+public interface ScriptListener extends ExtensionPoint {
+
+    /**
+     * Called when a groovy script is executed in Script console.
+     *
+     * @see Jenkins#_doScript(StaplerRequest, org.kohsuke.stapler.StaplerResponse, javax.servlet.RequestDispatcher, hudson.remoting.VirtualChannel, hudson.security.ACL)
+     * @param script The script to be executed.
+     * @param runner Descriptive name of the runner executing the script.
+     */
+    void onScriptFromConsole(String script, String runner);
+
+    /**
+     * Called when a groovy script is executed from the CLI.
+     *
+     * @see hudson.cli.GroovyCommand#run()
+     * @see hudson.cli.GroovyshCommand#run()
+     * @param script The script to be executed.
+     */
+    void onScriptFromCLI(String script);
+
+
+    /**
+     * Fires the {@link #onScriptFromConsole(String, String)} event to track the usage of the script console.
+     *
+     * @see Jenkins#_doScript(StaplerRequest, org.kohsuke.stapler.StaplerResponse, javax.servlet.RequestDispatcher, hudson.remoting.VirtualChannel, hudson.security.ACL)
+     * @param script The script to be executed.
+     * @param runner Descriptive name of the runner executing the script.
+     */
+    static void fireScriptConsoleEvent(String script, String runner) {
+        Listeners.notify(ScriptListener.class, true, listener -> listener.onScriptFromConsole(script, runner));
+    }
+
+    /**
+     * Fires the {@link #onScriptFromCLI(String)} event to track the usage of the script console.
+     *
+     * @see hudson.cli.GroovyCommand#run()
+     * @see hudson.cli.GroovyshCommand#run()
+     * @param script The script to be executed.
+     */
+    static void fireScriptFromCLIEvent(String script) {
+        Listeners.notify(ScriptListener.class, true, listener -> listener.onScriptFromCLI(script));
+    }
+}