EventLog (Javadocs [I2P+ 2.13.0+] - API Version 0.9.70+)

java.lang.Object
- net.i2p.router.util.EventLog

```
public class EventLog
extends Object
```
Event logging utility with caching and file-based persistence.
Provides simple event logging for occasional router events with efficient caching for read operations and file-based persistence. Does not maintain open file handles to avoid resource leaks.
Supports event categorization and timestamp tracking with configurable caching behavior. Optimized for low-frequency logging scenarios where performance is more important than comprehensive event tracking.
Includes predefined event types for router lifecycle events, network changes, and critical system events. Provides both append-only and read-write access patterns with proper synchronization for thread safety.

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`ABORTED` for convenience, not required
`static String`	`BECAME_FLOODFILL` BECAME_FLOODFILL.
`static String`	`CHANGE_IP` CHANGE_IP.
`static String`	`CHANGE_PORT` CHANGE_PORT.
`static String`	`CLOCK_SHIFT` CLOCK_SHIFT.
`static String`	`CRASHED` CRASHED.
`static String`	`CRITICAL` CRITICAL.
`static String`	`DEADLOCK` DEADLOCK.
`static String`	`INSTALL_FAILED` INSTALL_FAILED.
`static String`	`INSTALLED` INSTALLED.
`static String`	`NETWORK` NETWORK.
`static String`	`NEW_IDENT` NEW_IDENT.
`static String`	`NOT_FLOODFILL` NOT_FLOODFILL.
`static String`	`OOM` OOM.
`static String`	`REACHABILITY` REACHABILITY.
`static String`	`REKEYED` REKEYED.
`static String`	`RESEED` RESEED.
`static String`	`SOFT_RESTART` SOFT_RESTART.
`static String`	`STARTED` STARTED.
`static String`	`STOPPED` STOPPED.
`static String`	`UPDATED` UPDATED.
`static String`	`WATCHDOG` WATCHDOG.

Constructor Summary
Constructors
Constructor and Description
EventLog(I2PAppContext ctx, File file)

Constructors
Constructor and Description
`EventLog(I2PAppContext ctx, File file)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addEvent(String event)` Append an event.
`void`	`addEvent(String event, String info)` Append an event.
`SortedMap<Long,String>`	`getEvents(long since)` All events since a given time.
`SortedMap<Long,String>`	`getEvents(String event, long since)` Caches.
`long`	`getLastEvent(String event, long since)` Timestamp of last event.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - ABORTED
```
public static final String ABORTED
```
    for convenience, not required
    See Also:
    Constant Field Values
  - BECAME_FLOODFILL
```
public static final String BECAME_FLOODFILL
```
    BECAME_FLOODFILL.
    See Also:
    Constant Field Values
  - CHANGE_IP
```
public static final String CHANGE_IP
```
    CHANGE_IP.
    See Also:
    Constant Field Values
  - CHANGE_PORT
```
public static final String CHANGE_PORT
```
    CHANGE_PORT.
    See Also:
    Constant Field Values
  - CLOCK_SHIFT
```
public static final String CLOCK_SHIFT
```
    CLOCK_SHIFT.
    See Also:
    Constant Field Values
  - CRASHED
```
public static final String CRASHED
```
    CRASHED.
    See Also:
    Constant Field Values
  - CRITICAL
```
public static final String CRITICAL
```
    CRITICAL.
    See Also:
    Constant Field Values
  - DEADLOCK
```
public static final String DEADLOCK
```
    DEADLOCK.
    See Also:
    Constant Field Values
  - INSTALL_FAILED
```
public static final String INSTALL_FAILED
```
    INSTALL_FAILED.
    See Also:
    Constant Field Values
  - INSTALLED
```
public static final String INSTALLED
```
    INSTALLED.
    See Also:
    Constant Field Values
  - NETWORK
```
public static final String NETWORK
```
    NETWORK.
    See Also:
    Constant Field Values
  - NEW_IDENT
```
public static final String NEW_IDENT
```
    NEW_IDENT.
    See Also:
    Constant Field Values
  - NOT_FLOODFILL
```
public static final String NOT_FLOODFILL
```
    NOT_FLOODFILL.
    See Also:
    Constant Field Values
  - OOM
```
public static final String OOM
```
    OOM.
    See Also:
    Constant Field Values
  - REACHABILITY
```
public static final String REACHABILITY
```
    REACHABILITY.
    See Also:
    Constant Field Values
  - REKEYED
```
public static final String REKEYED
```
    REKEYED.
    See Also:
    Constant Field Values
  - RESEED
```
public static final String RESEED
```
    RESEED.
    See Also:
    Constant Field Values
  - SOFT_RESTART
```
public static final String SOFT_RESTART
```
    SOFT_RESTART.
    See Also:
    Constant Field Values
  - STARTED
```
public static final String STARTED
```
    STARTED.
    See Also:
    Constant Field Values
  - STOPPED
```
public static final String STOPPED
```
    STOPPED.
    See Also:
    Constant Field Values
  - UPDATED
```
public static final String UPDATED
```
    UPDATED.
    See Also:
    Constant Field Values
  - WATCHDOG
```
public static final String WATCHDOG
```
    WATCHDOG.
    See Also:
    Constant Field Values
- Constructor Detail
  - EventLog
```
public EventLog(I2PAppContext ctx,
                File file)
```
    Parameters:
    file - should be absolute
- Method Detail
  - addEvent
```
public void addEvent(String event)
```
    Append an event. Fails silently.
    Parameters:
    event - no spaces, e.g. "started"
    Throws:
    IllegalArgumentException - if event contains a space or newline
  - addEvent
```
public void addEvent(String event,
                     String info)
```
    Append an event. Fails silently.
    Parameters:
    event - no spaces or newlines, e.g. "started"
    info - no newlines, may be blank or null
    Throws:
    IllegalArgumentException - if event contains a space or either contains a newline
  - getEvents
```
public SortedMap<Long,String> getEvents(long since)
```
    All events since a given time. Does not cache. Fails silently. Values in the returned map have the format "event[ info]". Events do not contain spaces.
    Parameters:
    since - since this time, 0 for all
    Returns:
    non-null, Map of times to info strings, sorted, earliest first, unmodifiable
  - getEvents
```
public SortedMap<Long,String> getEvents(String event,
                                        long since)
```
    Caches. Fails silently.
    Parameters:
    event - matching this event only, case sensitive
    since - since this time, 0 for all
    Returns:
    non-null, Map of times to (possibly empty) info strings, sorted, earliest first, unmodifiable
  - getLastEvent
```
public long getLastEvent(String event,
                         long since)
```
    Timestamp of last event.
    Parameters:
    event - matching this event, case sensitive
    since - since this time, 0 for all
    Returns:
    last event time, or 0 for none

Class EventLog

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

ABORTED

BECAME_FLOODFILL

CHANGE_IP

CHANGE_PORT

CLOCK_SHIFT

CRASHED

CRITICAL

DEADLOCK

INSTALL_FAILED

INSTALLED

NETWORK

NEW_IDENT

NOT_FLOODFILL

OOM

REACHABILITY

REKEYED

RESEED

SOFT_RESTART

STARTED

STOPPED

UPDATED

WATCHDOG

Constructor Detail

EventLog

Method Detail

addEvent

addEvent

getEvents

getEvents

getLastEvent