Class LogsCLI

java.lang.Object

com.scivicslab.actoriac.cli.LogsCLI

All Implemented Interfaces:

Callable<Integer>

public class LogsCLI
extends Object
implements Callable<Integer>

CLI tool for querying workflow execution logs from H2 database.

Usage examples:

# Show summary of the latest session
java -jar actor-IaC.jar logs --db logs --summary

# Show logs for a specific node
java -jar actor-IaC.jar logs --db logs --node node-001

# Show only error logs
java -jar actor-IaC.jar logs --db logs --level ERROR

# List all sessions
java -jar actor-IaC.jar logs --db logs --list

Author:

devteam@scivics-lab.com

Field Summary

Fields

Modifier and Type	Field	Description
private File	dbPath
private String	endedSince
private String	inventoryFilter
private static final DateTimeFormatter	ISO_FORMATTER	ISO 8601 format with timezone offset (e.g., 2026-01-05T10:30:00+09:00).
private int	limit
private boolean	listNodes
private boolean	listSessions
private LogLevel	minLevel
private String	nodeId
private String	overlayFilter
private String	server
private Long	sessionId
private String	since
private String	startedAfter
private boolean	summaryOnly
private static final ZoneId	SYSTEM_ZONE	System timezone for display.
private String	workflowFilter

Constructor Summary

Constructors

Constructor	Description
LogsCLI()

Method Summary

Modifier and Type	Method	Description
Integer	call()
private H2LogReader	createReader()	Creates an H2LogReader, using TCP connection if --server is specified.
private String	formatTimestamp(LocalDateTime timestamp)	Formats a LocalDateTime as ISO 8601 string with timezone offset.
private String	getLevelPrefix(LogLevel level)
private Integer	listNodesInSession(H2LogReader reader, long targetSession)
private Integer	listRecentSessions(H2LogReader reader)
static void	main(String[] args)	Main entry point for the logs CLI.
private LocalDateTime	parseSince(String sinceStr)	Parses a relative time string into a LocalDateTime.
private Integer	showLogs(H2LogReader reader, long targetSession)
private Integer	showSummary(H2LogReader reader, long targetSession)

Methods inherited from class Object

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

Field Details

ISO_FORMATTER

private static final DateTimeFormatter ISO_FORMATTER

ISO 8601 format with timezone offset (e.g., 2026-01-05T10:30:00+09:00).

SYSTEM_ZONE

private static final ZoneId SYSTEM_ZONE

System timezone for display.

dbPath

private File dbPath

server

private String server

sessionId

private Long sessionId

nodeId

private String nodeId

minLevel

private LogLevel minLevel

summaryOnly

private boolean summaryOnly

listSessions

private boolean listSessions

workflowFilter

private String workflowFilter

overlayFilter

private String overlayFilter

inventoryFilter

private String inventoryFilter

startedAfter

private String startedAfter

since

private String since

endedSince

private String endedSince

limit

private int limit

listNodes

private boolean listNodes

Constructor Details

LogsCLI

public LogsCLI()

Method Details

main

public static void main(String[] args)

Main entry point for the logs CLI.

Parameters:

args - command line arguments

call

public Integer call()

Specified by:

call in interface Callable<Integer>

createReader

private H2LogReader createReader()
                          throws SQLException

Creates an H2LogReader, using TCP connection if --server is specified.

Returns:

H2LogReader instance

Throws:

SQLException - if connection fails

listRecentSessions

private Integer listRecentSessions(H2LogReader reader)

listNodesInSession

private Integer listNodesInSession(H2LogReader reader,
 long targetSession)

showSummary

private Integer showSummary(H2LogReader reader,
 long targetSession)

showLogs

private Integer showLogs(H2LogReader reader,
 long targetSession)

getLevelPrefix

private String getLevelPrefix(LogLevel level)

formatTimestamp

private String formatTimestamp(LocalDateTime timestamp)

Formats a LocalDateTime as ISO 8601 string with timezone offset.

Example output: 2026-01-05T10:30:00+09:00

Parameters:

timestamp - the timestamp to format

Returns:

ISO 8601 formatted string, or "N/A" if null

parseSince

private LocalDateTime parseSince(String sinceStr)

Parses a relative time string into a LocalDateTime.

Supported formats:

• 12h - 12 hours ago
• 1d - 1 day ago
• 3d - 3 days ago
• 1w - 1 week ago

Parameters:

sinceStr - the relative time string

Returns:

LocalDateTime representing the calculated time, or null if invalid format