Skip to content

Latest commit

 

History

History
67 lines (52 loc) · 2.96 KB

sessions.md

File metadata and controls

67 lines (52 loc) · 2.96 KB
Raw

Sessions Documentation

A session is a collection of commands that result in input streams.

Storage

Sessions are stored as JSON in $LOGRIA_USER_HOME/$LOGRIA_ROOT/sessions and do not have file extensions. A session is defined like so:

{
    "commands": [
        [
            "/bin/python",
            "sample_streams/generate_test_logs.py"
        ],
        [
            "/bin/python",
            "sample_streams/generate_test_logs_2.py"
        ]
    ],
    "stream_type": "Command"
}

If $LOGRIA_USER_HOME/$LOGRIA_ROOT/sessions does not exist, Logria will attempt to create it.

Elements

All sessions have two keys:

  • commands
    • Contains a list of commands to listen on
  • stream_type
    • Contains a string of the type of input handler to use, either File or Command
    • File creates a FileInputHandler and Command creates a CommandInputHandler

Interpreting Sessions at Runtime

If Logria is launched without -e, it will default to listing the contents of $LOGRIA_ROOT/sessions and allow the user to select one. Users can also enter a new command to listen to; that command will be saved as a new session if the user has write permissions to the sessions directory.

Enter a new command to open and save a new stream,
or enter a number to choose a saved session from the list.

Enter `:r #` to remove session #.
Enter `:q` to quit.

0: File - README.md
1: File - Sample Access Log
2: Cmd - Generate Test Logs

Once a selection has been made, Logria will open pipes to the new processes and begin streaming.

  2020-02-08 19:00:02,317 - __main__.<module> - MainProcess - INFO - I am a first log! 80
  2020-02-08 19:00:02,317 - __main__.<module> - MainProcess - INFO - I am a second log! 43
  2020-02-08 19:00:02,327 - __main__.<module> - MainProcess - INFO - I am a first log! 80
  2020-02-08 19:00:02,327 - __main__.<module> - MainProcess - INFO - I am a second log! 58
  2020-02-08 19:00:02,337 - __main__.<module> - MainProcess - INFO - I am a second log! 54
  2020-02-08 19:00:02,337 - __main__.<module> - MainProcess - INFO - I am a first log! 92
  2020-02-08 19:00:02,347 - __main__.<module> - MainProcess - INFO - I am a second log! 68
  2020-02-08 19:00:02,350 - __main__.<module> - MainProcess - INFO - I am a first log! 26
┌─────────────────────────────────────────────────────────────────────────────────────────┐
│                                                                                         │
└─────────────────────────────────────────────────────────────────────────────────────────┘