Package io.jenkins.plugins.mcp.server.extensions

Class SystemLogExtension

java.lang.Object

io.jenkins.plugins.mcp.server.extensions.SystemLogExtension

All Implemented Interfaces:

ExtensionPoint, McpServerExtension

@Extension
public class SystemLogExtension
extends Object
implements McpServerExtension

Tools to read the Jenkins system log, both gated by Overall/SystemRead - the same permission Jenkins uses for its "Manage Jenkins > System Log" screen.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	SystemLogExtension.LogEntry
static final record	SystemLogExtension.SystemLogResponse

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Constructor Summary

Constructors

Constructor	Description
SystemLogExtension()

Method Summary

Modifier and Type	Method	Description
List<String>	getLogRecorders()
SystemLogExtension.SystemLogResponse	getSystemLog(Integer limit, String level, String recorder)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface io.jenkins.plugins.mcp.server.McpServerExtension

getSyncPrompts, getSyncResources, getSyncTools

Constructor Details

SystemLogExtension

public SystemLogExtension()

Method Details

getSystemLog

@Tool(description="Read recent Jenkins log entries, newest first. Reads the global system log, or a named Log Recorder when \'recorder\' is set. Requires the Overall/SystemRead permission.",
      permissions="hudson.model.Hudson.SystemRead",
      structuredOutput=true,
      annotations=)
public SystemLogExtension.SystemLogResponse getSystemLog(@ToolParam(description="Maximum number of entries to return, newest first. Defaults to 50.",required=false)
 Integer limit,
 @ToolParam(description="Minimum log level to include, e.g. SEVERE, WARNING, INFO. Defaults to all levels.",required=false)
 String level,
 @ToolParam(description="Name of a configured Log Recorder to read instead of the global system log. Use getLogRecorders to list them.",required=false)
 String recorder)

getLogRecorders

@Tool(description="List the names of configured Jenkins Log Recorders, for use with getSystemLog\'s \'recorder\' parameter. Requires the Overall/SystemRead permission.",
      permissions="hudson.model.Hudson.SystemRead",
      annotations=)
public List<String> getLogRecorders()