Skip to content

webzak/uzlog

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

UDP zero log receiver

The simple logging/debugging tool receiving messages over UDP. The purpose is to have minimal impact on debugged application.

Usage

uzlog [options]

-h help

-p port port to listen

-a ip ip address

-o output to stdout

-c allow colored output

-f allow formatted output

-w path path to save log sessions to files. The option must be set to enable log saving.

-s path path to save data sent for saving (with msg type = 2). The option must be set to enable data saving.

Typical usage: ./uzlog -fco -p 7000

Using with docker

docker build -t uzlog .

docker run -it --rm -p 7000:7000/udp uzlog

Protocol

The messages are sent only one way via network to endpoint. Each message belongs to specific session. The protocol is unreliable, if some packets are dropped by network, the message will be skipped.

Transport layer

Byte order - big endian

Message structure:

| message | CRC 32 |

Packet structure

Max packet size 508 bytes

| session (8b) | message id (4b) | message length (4b) | message offset (4b) | payload (max 488b) |

Message layer

First byte determines the message type and formatting for the rest of the message:

|message type (1b) | payload |

Message types:

1 - LOG

Log message format

| message type = 1 (1b) | fg color (1b) | bg color (1b) | 0 (1b) | payload |

2 - SAVE

Save message format

| message type = 2 (1b) | append (1b) | filename (variable size) | 0 (1b) | payload |

About

The simple logging/debugging tool receiving messages over UDP.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published