jaylog

Biblioteca de logging para Python com rotação de arquivos, saída colorida no console, envio HTTP para um endpoint remoto e registro automático do ambiente de execução (host reporting).

📖 Documentação completa: https://gpocas.github.io/jaylog-book

Instalação

pip install -U --no-cache-dir jaylog

Uso rápido

.env.logging

JAYLOG_APP_NAME=meu-bot
JAYLOG_LOG_DIR=C:\logs

main.py

from jaylog import JaylogSettings, configure, get_logger

configure(JaylogSettings())

logger = get_logger()

logger.info("Olá, jaylog!")

Métricas de recursos

Com o endpoint HTTP configurado, o jaylog envia a cada minuto o uso de CPU, memória e disco da máquina e do processo (somando os filhos, como Chrome e Excel abertos pelo bot) para POST /logs/host-metrics, e os limites da máquina (CPUs, RAM total, disco total) junto com o registro de ambiente. Não exige configuração nova:

Variável	Padrão
`JAYLOG_HOST_METRICS_ENABLED`	`true`	Depende de `JAYLOG_HOST_REPORT_ENABLED`
`JAYLOG_HOST_METRICS_INTERVAL`	`60`	Segundos, mínimo 10
`JAYLOG_HOST_METRICS_HTTP_ENDPOINT`	derivado	`/logs/add` → `/logs/host-metrics`

Agendas do Task Scheduler

Quando o bot é iniciado pelo Agendador de Tarefas do Windows, o jaylog lê as tasks ativas que executam o entrypoint — script direto com Iniciar em ou .bat/.cmd na pasta do projeto — e envia as agendas uma vez por execução para POST /logs/host-schedules. O backend substitui as agendas sincronizadas anteriores do serviço. Triggers que não podem ser representados sem perda são ignorados, em vez de serem aproximados.

Variável	Padrão
`JAYLOG_HOST_SCHEDULE_ENABLED`	`true`	Só vale no Windows, em execução pelo Agendador
`JAYLOG_HOST_SCHEDULE_HTTP_ENDPOINT`	derivado	`/logs/add` → `/logs/host-schedules`
`JAYLOG_HOST_SCHEDULE_TIMEOUT`	`10`	Timeout, em segundos, de `schtasks /query /xml`

Para variáveis de ambiente, cenários de uso (console-only, múltiplos loggers, cores), preparação para produção (secrets, host reporting) e referência da API, veja a documentação guiada.

Release files for jaylog 0.3.0a5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for jaylog 0.3.0a5
File	Size	Uploaded
jaylog-0.3.0a5.tar.gz	44.1 kB	Sep 25, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for jaylog 0.3.0a5
File	Interpreter	ABI	Platform	Reset
jaylog-0.3.0a5-py3-none-any.whl 58.6 kB Sep 25, 2026	Python 3	none	any	Details

Total release size: 102.7 kB

Release files / jaylog-0.3.0a5.tar.gz

Download URL	jaylog-0.3.0a5.tar.gz
Size	44.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`f65f5ba0c03c4cec7cf1f04432dbd679d7810dbf82cc57da22224389b4fb124f`
BLAKE2b-256 checksum How to use checksums	`b0ba46b641d55a44eb5ebdf72f80fad8e61312d70a4f4e5a9b22719d8d944a9f`
Upload date	Sep 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Release files / jaylog-0.3.0a5-py3-none-any.whl

Download URL	jaylog-0.3.0a5-py3-none-any.whl
Size	58.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`3192b04cd481229be9a695f184d0d57a415a8b4b1d97e50d5e64e17487289a03`
BLAKE2b-256 checksum How to use checksums	`32856766f0ddc28f1ea01589908c67dbeab2a60c85e550a8213ac62c8955191b`
Upload date	Sep 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`