Log Quotas: document the silent 8,192-character per-line truncation of log lines

Abierto Apto para principiantes
  • ¿Algo no está bien?
#2,845 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
64/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Área
documentation

Línea de trabajo

Empieza por las páginas Log Quotas and Backtesting > Deployment > Logs mencionadas en el issue y, después, revisa Log Messages y la sección Debug Messages para comprobar la redacción sobre la supresión de duplicados, así como la página Export Logs para consultar los detalles de la cuota diaria. Actualiza las páginas para documentar el límite silencioso de 8.192 caracteres por línea, incluido el prefijo de marca de tiempo y el recuento de caracteres; aclara que la supresión de duplicados se aplica a mensajes Debug idénticos consecutivos e indica que leer o descargar logs consume la cuota diaria. La tarea estará terminada cuando estos detalles se indiquen correctamente en las páginas pertinentes.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

What the docs say

Log Quotas and Backtesting > Deployment > Logs give two limits: logs per backtest and logs per day, by organization tier. Log Messages adds the live-trading line count and the duplicate-suppression note.

No page states a per-line limit.

What actually happens

A single log line is stored truncated to 8,192 characters, counted after the YYYY-MM-DD HH:MM:SS algorithm-time prefix the engine prepends, so 8,172 characters of the member's own text. There is no marker, no warning and no error: the line simply ends early, and the lines after it are unaffected.

The cut is on characters, not bytes. Measured in cloud backtests on LEAN v2.5.0.0.18230, read back through both /backtests/read/log and /backtests/export/logs (the two routes agree):

Logged Stored
32,768 ASCII characters 8,192 characters / 8,192 bytes
200,000 ASCII characters 8,192 characters / 8,192 bytes
6,000 U+20AC characters (18,000 bytes) not truncated: 6,029 characters / 18,029 bytes
9,000 U+20AC characters (27,000 bytes) 8,192 characters / 24,518 bytes
8,172 ASCII characters 8,192 characters / 8,192 bytes

Members writing a JSON summary or a serialized structure to one log line lose the end of it silently, and currently have no documented number to size the line against.

Suggested change

On the Log Quotas page, next to the per-backtest and per-day table, state the per-line limit: a log line is truncated to 8,192 characters including the timestamp prefix, that the count is characters rather than UTF-8 bytes, and that the truncation is silent. The same sentence belongs on Backtesting > Deployment > Logs.

Two smaller points on the same pages while they are open:

  • Log Messages says "If you log the same content multiple times, only the first instance is added to the log file." That is Debug behavior, and only for a message identical to the one immediately before it (QCAlgorithm.Debug, Algorithm/QCAlgorithm.cs). Log stores every call: three identical Log lines all appear, while three consecutive identical Debug messages collapse to one and a A, B, A sequence keeps all three. The sentence should move to the Debug Messages section and say "identical to the previous one".
  • The daily quota is consumed by reading or downloading logs, which Export Logs states but the Log Quotas page does not.

Found while answering support conversation 215476693324333.

Lenguaje dominante
HTML
Estrellas
267
Forks
190
Merge medio
8 h 38 min
PR fusionados (30 d)
69

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de QuantConnect/Documentation

Todos los issues de QuantConnect/Documentation

Issues similares

Más issues de Documentation

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.