Metadata-Version: 2.1
Name: micropython-eydam-prototyping-logging
Version: 0.0b2
Summary: Some logging functions for MicroPython in combination with syslog-server
Home-page: https://github.com/eydam-prototyping/tutorials_de/blob/master/micropython/packages/ep_logging
Author: Tobias Eydam
Author-email: eydam-prototyping@outlook.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: Implementation :: MicroPython
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown

# Eydam-Prototyping: ep_logger

[Deutsche Version hier / German version here](https://github.com/eydam-prototyping/tutorials_de/blob/master/micropython/packages/ep_logging/README.de.md)

Library, to send log messages from an IoT-Device running MicroPython to a syslog-server. How to setup a syslog-server in combination with Telegraf and Grafana is described here: [here](https://www.eydam-prototyping.com/en/2021/01/17/log-eintraege-besser-nutzen-mit-rsyslog-den-esp32-ueberwachen/)

The messages will be send in ietf-syslog-protocol-23-format.

## Example:

```python
# Syslog-Server (192.168.178.100) is listening on 514 (UDP)
import ep_logging
logger = ep_logging.logger("192.168.178.100", port=514)
logger.notice("Test")
```

This Code would produce the following message:

```
<85>1 2021-01-20T20:33:17.0Z esp32 logger - - Test
 -- - ---------------------- ----- ------ - - ----
  | |           |              |      |   | |   +--- message
  | |           |              |      |   | +------- MSGID (=None)
  | |           |              |      |   +--------- PROCID (=None)
  | |           |              |      +------------- appname
  | |           |              +-------------------- hostname
  | |           +----------------------------------- timestamp
  | +----------------------------------------------- version (always 1)
  +------------------------------------------------- facility + servity
```

