Micropython library for sending logs to Loki
Project description
micropython-loki
Introduction
Micropython library for sending logs to Loki
Installation
The library can be installed using upip or mip. Ensure that the device is connected to the network.
Installation using upip (Micropython < 1.19)
import upip
upip.install('micropython-loki')
Installation using mip (Micropython >= 1.19)
import mip
mip.install('github:olivergregorius/micropython_loki/micropython_loki.py')
Usage
This library provides two methods for
- adding log messages to the stack (
log
) and - pushing the logs to a Loki instance (
push_logs
).
NOTE: Each log message is applied with the current system's timestamp. Please be sure the RTC of the device is set correctly.
At first the Loki-instance must be initialized providing the Loki base-URL:
from micropython_loki import Loki
loki = Loki('https://loki.example.org:3100')
The following additional arguments may be provided:
Argument | Description | Default |
---|---|---|
log_labels | List of LogLabel instances. Each LogLabel is a key-value pair to enrich each log message with a label. |
[] |
default_log_level | Set the default log level. Instance of LogLevel . |
LogLevel.INFO |
timeout | Timeout in seconds for calls against the Loki-API. | 5 |
max_stack_size | Maximum size of the log stack. If the stack size exceeds this value, the 'oldest' log message is dropped. | 50 |
The following example creates a Loki-instance for calling the Loki-API at 'https://loki.example.org:3100', adding the labels 'app: important-app' and 'version: 1.0.0' to each log message, setting the default log level to 'INFO', setting the timeout to 5 seconds and setting the max stack size to 20.
from micropython_loki import Loki, LogLabel, LogLevel
loki = Loki('https://loki.example.org:3100', [LogLabel('app', 'important-app'), LogLabel('version', '1.0.0')], LogLevel.INFO, 5, 20)
To add a log message to the log-stack the method log
is called, it takes the arguments message
(required) containing the log message and log_level
(optional) for setting the log level for that log message:
...
loki.log('Calling do_something')
result = do_something()
if result == 1:
loki.log('Something went wrong', LogLevel.WARN)
...
The example above adds one log message of level 'INFO' (as set by default during Loki instantiation, the LogLevel can be omitted in the log
call) and one log
message of level 'WARN' (in case the value of result is 1).
To push the logs to Loki push_logs
is called, this method takes no arguments:
...
loki.push_logs()
...
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.