Il deploy è terminato, ma la pagina continua a restituire un errore e nel log ci sono migliaia di righe. Il comando grep in Linux può isolare quelle che contengono il testo cercato, a patto di scegliere il tipo di ricerca giusto: una stringa letterale e un’espressione regolare non vengono interpretate allo stesso modo.
Una ricerca utile parte dal testo che vuoi trovare
- File singolo: indica il file e il testo da cercare.
- Cartelle: la ricerca ricorsiva può attraversare anche molte sottocartelle.
- Stringhe letterali: scegli la modalità fissa per evitare che simboli come il punto siano interpretati come metacaratteri.
- Script: distingui tra una ricerca senza risultati e un comando che non ha potuto completare il lavoro.
Con -F cerchi testo letterale, con -E scrivi espressioni regolari
Una ricerca semplice può bastare per trovare una voce in un file: grep -n 'timeout' app.log stampa le righe corrispondenti insieme al loro numero. Se cerchi una parola senza distinguere tra maiuscole e minuscole, aggiungi -i; per includere il contesto vicino alla corrispondenza, usa -C 2.
Il punto che spesso sfugge è che, per impostazione predefinita, grep tratta il testo cercato come un’espressione regolare di base. Per cercare una stringa esatta, come v1.2, sceglierei -F: in questo caso il punto è un punto, non un simbolo che rappresenta qualsiasi carattere.
Quando servono alternative o altri metacaratteri, -E abilita le espressioni regolari estese. Per esempio, grep -E 'ERROR|WARN' app.log trova entrambe le etichette. GNU grep offre anche -P per espressioni compatibili con PCRE, ma preferisco limitarlo agli script che dipendono davvero da quella sintassi, perché non è supportato ovunque allo stesso modo.
Per cercare nei log di una cartella, limita i file coinvolti
In una directory con log di applicazione e file di configurazione, la ricerca ricorsiva può trovare la riga giusta in mezzo a molti documenti: grep -rInF --include='*.log' 'connection refused' ./logs/. Qui -r attraversa le sottocartelle, -I ignora i file binari, -n mostra il numero di riga e -F tratta la frase come testo letterale.
Il filtro --include evita di scandire file estranei al problema. Io lo considero una buona abitudine quando la cartella contiene dati eterogenei: una ricerca più circoscritta produce risultati più facili da verificare e riduce il rumore.
Se vuoi solo sapere quali file contengono una corrispondenza, aggiungi -l. Se invece ricevi i dati da un altro comando, puoi passare l’output tramite pipe, per esempio journalctl -u nome-servizio | grep -i 'failed'; per un’indagine più leggibile, aggiungi --since a journalctl e restringi il periodo prima di filtrare.
Un risultato vuoto non dice da solo se c’è stato un errore
In uno script automatico, grep comunica l’esito anche attraverso il codice di uscita. Il manuale di GNU Grep distingue tre casi, una differenza pratica che impedisce di scambiare un log senza corrispondenze per un comando guasto.
| Situazione | Possibile significato | Cosa fare |
|---|---|---|
| Il comando termina con codice 0 | È stata trovata almeno una riga corrispondente. | Elabora o registra il risultato. |
| Il comando termina con codice 1 | La ricerca è riuscita, ma non ha trovato corrispondenze. | Controlla il testo cercato, l’intervallo del log e i file inclusi. |
| Il comando termina con codice 2 | Si è verificato un errore, per esempio un file non leggibile. | Esamina il messaggio di errore e i permessi sui file. |
Questo sfata un equivoco frequente: assenza di corrispondenze non equivale a errore di grep. In uno script, però, entrambi i casi possono sembrare un semplice esito negativo se controlli solo se è stato stampato qualcosa.
Per esempio, puoi distinguere i casi con una condizione shell e registrare un avviso solo quando il testo cercato non compare. Se usi grep -q, il comando non stampa le righe: è comodo per verificare una condizione, ma devi basarti sul codice di uscita, non sull’output a schermo.
File binari e collegamenti simbolici possono cambiare la ricerca
La scansione di una cartella non significa sempre che grep esamini ogni file nello stesso modo. Per impostazione predefinita, GNU grep può rilevare dati binari e sopprimere parte dell’output; -I salta i file riconosciuti come binari, mentre -a li tratta come testo.
Userei -a solo se hai un motivo per leggere quei contenuti: l’output può includere caratteri non stampabili e diventare difficile da interpretare. Se cerchi testo nei log, restringere il percorso e usare un filtro sui nomi dei file è di solito una scelta più prudente.
C’è anche una differenza tra -r e -R: la prima opzione non segue ricorsivamente i collegamenti simbolici, la seconda li segue. Se una directory contiene collegamenti verso archivi o altri percorsi, questa distinzione può ampliare parecchio la ricerca; prima di usare -R, controlla dove puntano.
Un filtro circoscritto rende i controlli automatici più leggibili
Quando un controllo cerca un evento preciso, combinerei una directory mirata, un tipo di file e una stringa letterale. Per esempio, grep -rIlF --include='*.log' 'job=complete' ./logs/ restituisce i nomi dei log che contengono l’evento, senza inondare il terminale con righe di contesto.
Per controlli ricorrenti, registra anche il caso in cui non ci siano corrispondenze e quello in cui manchino i permessi. Questa distinzione aiuta a capire se un processo non ha scritto l’evento atteso o se il controllo stesso non è riuscito a leggere i log.
A dire il vero, un filtro testuale resta affidabile solo quanto il formato dei dati: se l’applicazione cambia la dicitura dell’evento, la ricerca letterale può smettere di trovarlo senza che grep segnali un errore. Per questo sceglierei etichette di log stabili e verificherei il risultato insieme allo stato del servizio.
La scelta più semplice è quella che si può verificare
Per un controllo manuale, parti da un file e usa -n per ritrovare la riga; per cercare una frase esatta, aggiungi -F. Quando passi a più cartelle, limita file e percorsi, poi controlla separatamente il risultato della ricerca e gli eventuali errori di lettura.
Così grep diventa un filtro pratico per individuare anomalie nei processi digitali e ridurre il tempo speso a scorrere log interminabili. La riga trovata è un indizio: per capire se il processo ha funzionato, confrontala con il comportamento atteso dell’applicazione.