Data ultimo aggiornamento: 2026-02-08
Problema: LoggerPro 2.0 non compilava su Delphi 10.3 Rio a causa di overload mancanti in TJSONObject.AddPair.
Errore originale:
E2250: There is no overloaded version of 'AddPair' that can be called with these arguments
Causa: In Delphi 10.3, AddPair(string, string) non esiste. Gli overload aggiunti in 10.4+:
AddPair(const Str, Val: string)AddPair(const Str: string; const Val: Integer)
Delphi 10.3 ha solo:
AddPair(const Str: string; const Val: TJSONValue)AddPair(const Pair: TJSONPair)
Soluzione implementata (Proposta 3 - Sempre TJSONString):
Usare sempre TJSONString.Create() per wrappare i valori stringa - compatibile con TUTTE le versioni Delphi:
// PRIMA (non compilava su 10.3):
lJSON.AddPair('timestamp', DateToISO8601(ALogItem.TimeStamp));
lJSON.AddPair('tid', ALogItem.ThreadID.ToString);
// DOPO (compatibile 10.0 Seattle → 13 Florence):
lJSON.AddPair('timestamp', TJSONString.Create(DateToISO8601(ALogItem.TimeStamp)));
lJSON.AddPair('tid', TJSONString.Create(ALogItem.ThreadID.ToString));File modificato: LoggerPro.JSONLFileAppender.pas (linee 168-198)
Vantaggi:
- ✅ Zero
{$IFDEF}- codice lineare e pulito - ✅ Compatibile Delphi 10.0 Seattle → 13 Florence
- ✅ Stesso comportamento garantito su tutte le versioni
- ✅ Più esplicito e chiaro
Test: 109 test unitari passano su Delphi 11.3 Commit: Da committare Issue: #101 - DA AGGIORNARE (non chiudere, aggiornare con fix)
Problema: Discrepanza tra documentazione e implementazione. La documentazione mostrava {order_id=12345, amount=99.99} ma l'output effettivo era order_id=12345 amount=99.99.
Soluzione: Modificati 3 punti nel codice:
LoggerPro.Renderers.pas:117-158-RenderContext()ora usa separatore,e wrapper{}LoggerPro.pas:1781-1817-RenderContextToString()stesso formato per pre-rendered contextLoggerPro.Renderers.pas:239-244- Rimosso shortcutPreRenderedContextda LogFmt (preserva formato logfmt standard)
Commit: c0ad85f - Pushato su origin/master
Test: 101 test unitari passano
Issue: #105 CHIUSA
Risolto race condition durante la distruzione del logger quando altri thread tentano di accodare log.
Problema: Un thread potrebbe passare il check FEnabled, poi Destroy libera FLoggerThread causando access violation.
Soluzione: Aggiunto flag FShuttingDown: Boolean senza lock (la lettura di un Boolean e' atomica):
// In TCustomLogWriter
FShuttingDown: Boolean;
// Constructor
FShuttingDown := False;
// Destructor (prima cosa)
FShuttingDown := True;
// Nei metodi Log e EnqueueLogItem
Assert(not FShuttingDown, 'Cannot log: logger is shutting down');
if FShuttingDown then Exit;| Build | Comportamento |
|---|---|
| Debug | EAssertionFailed - rivela il bug immediatamente |
| Release | Silent drop - graceful degradation |
Test aggiunti (ThreadSafetyTestU.pas):
TestDestroyWhileThreadsAreLogging(x5)TestDestroyWhileThreadsAreLoggingWithContext(x5)TestRapidCreateDestroy
// Senza stack trace formatter
Log.LogException(E);
Log.LogException(E, 'Operation failed');
Log.LogException(E, 'Operation failed', 'MYTAG');
// Con stack trace formatter (JCL, madExcept, EurekaLog, etc.)
Log := LoggerProBuilder
.WithStackTraceFormatter(
function(E: Exception): string
begin
Result := JclLastExceptStackListToString;
end)
.WriteToConsole.Done
.Build;Design:
TStackTraceFormatter = TFunc<Exception, string>- nessuna interfaccia custom- Zero dipendenze inverse - la libreria di stack trace non dipende da LoggerPro
- TAG sempre come ultimo parametro (consistente con tutta l'API)
Test aggiunti (BuilderTestU.pas):
TestLogExceptionWithoutFormatterTestLogExceptionWithStackTraceFormatterTestLogExceptionWithMessageAndTag
// Default tag = 'main'
Log.Info('Messaggio'); // tag = 'main'
Log.Info('Messaggio', 'CUSTOM'); // tag = 'CUSTOM'
// Configurato nel Builder
Log := LoggerProBuilder
.WithDefaultTag('MYAPP')
.WriteToConsole.Done
.Build;
// Sub-logger con default tag
OrderLog := Log.WithDefaultTag('ORDERS');
OrderLog.Info('Nuovo ordine'); // tag = 'ORDERS'Gate prima dell'accodamento - evita overhead per messaggi filtrati.
Log := LoggerProBuilder
.WithMinimumLevel(TLogType.Warning) // Debug e Info filtrati
.WriteToConsole.Done
.Build;
Log.Debug('Ignorato'); // Non accodato - zero overhead
Log.Info('Ignorato'); // Non accodato - zero overhead
Log.Warn('Loggato'); // OKVantaggi:
- Nessun oggetto
TLogItemcreato per messaggi filtrati - Gate globale indipendente dai log level degli appender
Test aggiunto:
TestWithMinimumLevel
| Vecchio | Nuovo |
|---|---|
AddConsoleAppender |
WriteToConsole.Done |
AddFileAppender |
WriteToFile.Done |
ConfigureFileAppender |
WriteToFile |
ConfigureHTTPAppender |
WriteToHTTP |
AddAppender(x) |
WriteToAppender(x) |
98 test unitari passano
ILoggerProBuilder
|-- WriteTo* Methods
| |-- WriteToConsole, WriteToFile, WriteToHTTP, etc.
| |-- .WithXxx() -> configurazione
| |-- .Done -> ritorna ILoggerProBuilder
|
|-- Global Config
| |-- WithMinimumLevel (gate globale)
| |-- WithDefaultLogLevel (default appender)
| |-- WithDefaultRenderer
| |-- WithDefaultTag
| |-- WithStackTraceFormatter
|
|-- Build() -> ILogWriter
# Build e Test
cd C:\DEV\loggerpro\unittests
.\build_tests.bat && .\Win32\CI\UnitTests.exe
# Build Sample Console
C:\DEV\loggerpro\samples\160_console\build.bat- README.md - Scrivere come hook per portare traffico al blog
- Documentazione blog - Articolo completo per danieleteti.it
- Gestione Issue GitHub - Vedere sezione "GitHub Issues Aperte" sotto
Data analisi: 2026-02-08 Issue totali aperte: 12 (escludendo #105 già chiusa)
Labels: accepted, compatibility
Autore: Scytheroid
Creata: 2025-12-02
Problema: LoggerPro 2.0 non compila su Delphi 10.3 Rio.
Proposte di soluzione:
-
Opzione A - Backport (Effort: Alto)
- Testare compilazione su Delphi 10.3
- Identificare feature incompatibili (inline vars, helper estesi, nuove RTL)
- Aggiungere direttive condizionali
{$IF CompilerVersion >= 34.0}(Delphi 10.4+) - Fornire fallback per feature non disponibili
-
Opzione B - Documentare requisiti (Effort: Basso, CONSIGLIATO)
- Dichiarare Delphi 10.4 Sydney (CompilerVersion 34.0) come versione minima
- Aggiornare README.md con tabella compatibilità
- LoggerPro 1.x rimane disponibile per 10.3 e precedenti
- Chiudere issue con spiegazione chiara
Raccomandazione: Opzione B - documentare 10.4+ come minimo, mantenere 1.x per legacy.
Autore: seer-true Creata: 2025-10-09
Problema: L'applicazione si blocca durante la distruzione del logger.
Proposte di soluzione:
-
Verificare se già risolto (Effort: Basso)
- Il commit
540244d(fix thread-safety) potrebbe aver risolto - Chiedere a seer-true di testare con versione corrente
- Verificare che
Shutdown()venga chiamato prima diFree
- Il commit
-
Debugging approfondito (Effort: Medio)
- Richiedere esempio riproducibile
- Verificare deadlock in
TLoggerThread.Execute - Controllare se coda eventi è bloccata
- Testare con i test thread-safety esistenti
-
Miglioramenti preventivi (Effort: Medio)
- Aggiungere timeout nel destructor
- Warning se Shutdown non chiamato
- Documentare best practice di cleanup
Raccomandazione: Prima chiedere conferma se ancora presente, poi eventualmente debug.
Labels: accepted, question
Autore: fastbike
Creata: 2025-02-21
Problema:
Messaggi in coda vengono persi quando il logger viene distrutto senza chiamare Shutdown().
Proposte di soluzione:
-
Migliorare Shutdown (Effort: Medio, PRIORITÀ ALTA)
- Verificare che
Shutdown()faccia flush completo della coda - Aggiungere timeout configurabile (attualmente hardcoded?)
- Aggiungere metodo esplicito
FlushAndWait(TimeoutMs: Integer) - Warning in destructor se ci sono messaggi pendenti
- Verificare che
-
Auto-flush nel destructor (Effort: Medio)
- Chiamare automaticamente
Shutdown()nel destructor - Timeout di 5 secondi max per evitare hang
- Log warning se timeout scaduto con messaggi persi
- Chiamare automaticamente
-
Documentazione (Effort: Basso)
- README con esempio corretto di cleanup
- Pattern:
try...finally Log.Shutdown; end; - Spiegare architettura asincrona
Raccomandazione: Implementare auto-flush con timeout + migliorare documentazione.
Labels: question
Milestone: 2_0_0
Autore: seer-true
Creata: 2025-03-10
Problema: Come disabilitare completamente il logging a runtime.
Proposte di soluzione:
-
Solo documentazione (Effort: Basso, CONSIGLIATO)
- Già possibile con
WithMinimumLevel(TLogType.Fatal) - Aggiungere sezione README "How to disable logging"
- Esempio:
Log := LoggerProBuilder.WithMinimumLevel(TLogType.Fatal).Build;
- Già possibile con
-
API esplicita (Effort: Medio)
- Aggiungere metodi
Enable()/Disable()runtime - Proprietà globale
LoggerPro.GlobalEnabled := False - Appender "null" dedicato:
WriteToNull
- Aggiungere metodi
Raccomandazione: Prima solo documentazione, API esplicita se richiesta da più utenti.
Labels: accepted
Autore: MarcosCunhaLima
Creata: 2024-12-18
Problema: Non c'è modo di ottenere il nome del file di log corrente (utile per inviarlo via email, upload, etc.).
Proposte di soluzione:
-
Aggiungere proprietà (Effort: Basso)
// In TLoggerProFileAppender property CurrentLogFileName: string read GetCurrentLogFileName;
-
Interfaccia dedicata (Effort: Medio)
ILogFileInfo = interface function GetCurrentFileName: string; function GetLogFiles: TArray<string>; function GetLogFileSize: Int64; end;
-
Helper nel Builder (Effort: Medio)
var FileInfo: ILogFileInfo; begin if Log.TryGetAppenderInfo<ILogFileInfo>(FileInfo) then EmailLogFile(FileInfo.GetCurrentFileName); end;
Raccomandazione: Soluzione 1 (proprietà semplice) + esempio nel README.
Autore: EberhardBierl Creata: 2024-05-11
Problema: Syslog appender usa UTC, l'utente vuole local time.
Proposte di soluzione:
-
Aggiungere opzione (Effort: Basso)
.WriteToSyslog .WithServer('10.0.0.1') .WithUseLocalTime(True) // Default: False (UTC) .Done
-
Documentare standard (Effort: Basso)
- RFC 3164: local time
- RFC 5424: UTC
- Spiegare perché UTC è preferibile
Raccomandazione: Implementare opzione + documentare best practice.
Labels: enhancement
Autore: Basti-Fantasti
Creata: 2023-10-23
Problema: ElasticSearch appender non supporta autenticazione (Basic Auth, API Key, Bearer token).
Proposte di soluzione:
-
Header HTTP personalizzati (Effort: Basso)
.WriteToElasticSearch .WithURL('https://elastic.example.com') .WithBasicAuth('user', 'password') .WithApiKey('my-api-key') .WithBearerToken('jwt-token') .WithCustomHeader('X-Custom', 'value') .Done
-
Implementazione interna (Effort: Medio)
- Modificare
TLoggerProElasticSearchAppender - Aggiungere header
Authorizationin base al metodo scelto - Testare con ElasticSearch Cloud (richiede auth)
- Modificare
Raccomandazione: Implementare Basic Auth + API Key (i più comuni).
Milestone: 2_0_0
Autore: mfpta
Creata: 2024-09-13
Problema: Manca callback dopo rotazione file (utile per upload, compressione, cleanup).
Proposte di soluzione:
-
Eventi callback (Effort: Medio)
.WriteToFile .WithFileBaseName('app') .WithOnAfterRotate( procedure(const OldFileName: string) begin // Comprimi file vecchio CompressFile(OldFileName); // Upload a S3 UploadToCloud(OldFileName); end) .Done
-
Thread safety (Effort: Medio)
- Callback chiamato dal logger thread o main thread?
- Opzione
WithSynchronizeCallback(True)per UI updates - Gestire eccezioni nel callback
Raccomandazione: Implementare callback asincrono con gestione errori.
Labels: accepted
Autore: fastbike
Creata: 2024-07-30
Problema: Richiesta di opzioni avanzate per rotazione file.
Proposte di soluzione:
-
Analizzare richieste specifiche (Effort: Basso)
- Chiedere a fastbike esattamente cosa manca
- Confrontare con Serilog/NLog
-
Opzioni possibili (Effort: Alto)
- Rotazione combinata (size AND time)
- Retention policy:
WithRetainDays(7),WithMaxFiles(30) - Compressione automatica:
WithCompressOldFiles(True) - Pattern nome custom:
app-{date:yyyy-MM-dd}-{sequence}.log
Raccomandazione: Prima analizzare necessità reali, poi implementare incrementalmente.
Labels: accepted
Milestone: 2_0_0
Autore: ads69
Creata: 2023-12-14
Problema:
Loggare direttamente in TStringList (in-memory, utile per debug UI).
Proposte di soluzione:
-
Nuovo appender (Effort: Basso-Medio)
var LogList: TStringList; begin LogList := TStringList.Create; Log := LoggerProBuilder .WriteToStringList .WithStringList(LogList) .WithMaxLines(1000) // Limite per evitare OOM .Done .Build; // Mostra in UI Memo1.Lines.Assign(LogList); end;
-
Thread safety (Effort: Medio)
- Sincronizzare accesso alla TStringList
- Opzione per sincronizzare con main thread (VCL)
-
Alternativa con callback (Effort: Basso)
- Usare
WriteToCallbackesistente
.WriteToCallback .WithCallback( procedure(const LogItem: TLogItem) begin TThread.Synchronize(nil, procedure begin Memo1.Lines.Add(LogItem.LogMessage); end); end) .Done - Usare
Raccomandazione: Creare TLoggerProStringListAppender dedicato.
Labels: enhancement
Milestone: 2_0_0
Autore: Basti-Fantasti
Creata: 2023-10-24
Problema: Email appender invia 1 email per log entry. Serve batching (es. ogni 100 messaggi o ogni 5 minuti).
Proposte di soluzione:
-
Batch con trigger multipli (Effort: Medio-Alto)
.WriteToEmail .WithSMTP('smtp.gmail.com', 587) .WithCredentials('user@example.com', 'password') .WithBatchSize(100) // Invia ogni 100 log .WithBatchInterval(300) // O ogni 5 minuti .WithFlushOnLevel(TLogType.Error) // Flush immediato su errori .Done
-
Template HTML (Effort: Medio)
- Email con tabella contenente N log entries
- Subject:
[APP] 15 errors in last 5 minutes - Formato HTML responsive
Raccomandazione: Implementare batching con flush configurabile.
Autore: otomazeli Creata: 2023-06-21
Problema: Richiesta supporto Microsoft AppCenter (analytics/crash reporting per mobile).
Proposte di soluzione:
-
Nuovo appender mobile (Effort: Alto)
.WriteToAppCenter .WithAppSecret('your-appcenter-secret') .WithUserId(CurrentUserId) .Done -
Dipendenze (Effort: Alto)
- Richiede AppCenter SDK (Objective-C/Java wrapper)
- Test su iOS + Android
- Mappare TLogType → AppCenter severity
-
Priorità (Bassa)
- Utile solo per app mobile
- Pochi utenti Delphi mobile
Raccomandazione: Bassa priorità, valutare se c'è domanda reale.
- #100 - Hanging in destructor (verificare se già risolto dal fix thread-safety)
- #97 - Data loss on destroy (implementare auto-flush + documentazione)
- #101 - Delphi 10.3 compatibility (documentare versione minima 10.4+)
- #99 - Disable logging (documentare
WithMinimumLevel) - #95 - Get current log filename (aggiungere proprietà)
- #90 - Syslog local time (aggiungere opzione booleana)
- #82 - ElasticSearch auth (Basic Auth + API Key)
- #94 - OnAfterRotate callback
- #85 - TStringList appender
- #92 - Advanced file rotation (analizzare necessità)
- #84 - Batched email
- #77 - AppCenter (solo se richiesto da più utenti)
| Issue | Titolo | Priorità | Effort | Fase | Note |
|---|---|---|---|---|---|
| #101 | Delphi 10.3 compatibility | 🔴 Alta | Basso | 1 | Documentare minimo 10.4+ |
| #100 | Hanging in destructor | 🔴 Alta | Medio | 1 | Verificare se già risolto |
| #97 | Data loss on destroy | 🔴 Alta | Medio | 1 | Auto-flush + doc |
| #99 | Disable logging | 🟡 Media | Basso | 2 | Solo documentazione |
| #95 | Get log filename | 🟡 Media | Basso | 2 | Aggiungere proprietà |
| #90 | Syslog local time | 🟡 Media | Basso | 2 | Opzione booleana |
| #82 | ElasticSearch auth | 🟡 Media | Medio | 2 | Basic Auth + API Key |
| #94 | OnAfterRotate | 🟢 Bassa | Medio | 3 | Callback post-rotazione |
| #92 | Advanced rotation | 🟢 Bassa | Alto | 3 | Analizzare prima |
| #85 | TStringList appender | 🟢 Bassa | Medio | 3 | Per debug UI |
| #84 | Batched email | 🟢 Bassa | Alto | 3 | Buffering email |
| #77 | AppCenter | 🟢 Bassa | Alto | 3 | Solo se richiesto |
| Feature | Stato |
|---|---|
| Minimum Log Level globale | COMPLETATO |
| Exception Logging | COMPLETATO |
Log := LoggerProBuilder
.Enrich.WithMachineName
.Enrich.WithProcessId
.Enrich.WithThreadId
.Enrich.WithProperty('app_version', '2.0')
.WriteToConsole.Done
.Build;Log.DebugIf(IsDetailedLogging, 'Heavy computation: %s', [ExpensiveToString]);
// oppure
if Log.IsDebugEnabled then
Log.Debug('...');using Log.BeginScope('ProcessOrder', [LogParam.I('order_id', 123)]) do
begin
Log.Info('Starting'); // include order_id automaticamente
Log.Info('Completed');
end;.WriteToHTTP
.WithURL('...')
.WithSampling(0.1) // logga solo 10%
.WithRateLimit(100) // max 100 msg/sec
.DoneLoggerPro.SelfLog := procedure(msg: string)
begin
WriteLn('[LoggerPro] ' + msg);
end;_Log := LoggerProBuilder.DevelopmentDefaults.Build;
_Log := LoggerProBuilder.ProductionDefaults.Build;| Priorita | Feature | Effort | Stato |
|---|---|---|---|
| Alta | Minimum Log Level globale | Basso | COMPLETATO |
| Alta | Exception Logging | Basso | COMPLETATO |
| Media | Enrichers automatici | Medio | Da fare |
| Media | Conditional Logging | Basso | Da fare |
| Bassa | Log Scopes | Alto | Da fare |
| Bassa | Sampling/Rate Limiting | Medio | Da fare |
| Bassa | Self-Diagnostics | Basso | Da fare |
| Bassa | Preset Builder | Basso | Da fare |
ATTENZIONE: Queste modifiche sono presenti ma non committate (sembrano incomplete):
LoggerPro.Builder.pas- Tracking configuratori pendenti (SetPendingConfigurator/ClearPendingConfigurator)LoggerPro.WindowsEventLogAppender.pas- Fix direttive compilazione condizionale
Nota: Le feature della sessione 2025-12-21 (MinimumLevel, LogException, ThreadSafety) sono già state committate in precedenza.
Il TAG e' SEMPRE l'ultimo parametro in tutta l'API:
LogException(E);
LogException(E, aMessage);
LogException(E, aMessage, aTag); // TAG ultimo!WithDefaultLogLevel- default per appender senza livello specifico (non usato attualmente)WithMinimumLevel- gate globale del LogWriter, filtra PRIMA dell'accodamento