Salta al contenuto principale

sar: raccogliere e rileggere le statistiche di sistema

Inviato da tuxsa il

Con vmstat e iostat abbiamo guardato il sistema "dal vivo". Ma il problema, di solito, si presenta quando nessuno sta guardando: il server è rimasto lento alle tre di notte, e al mattino non c'è più nulla da osservare. Per questo esiste sar, che permette sia di misurare in tempo reale sia di tenere uno storico da rileggere dopo.

Cos'è

sar (System Activity Reporter) fa parte del pacchetto sysstat, lo stesso di iostat, mpstat e pidstat. Il pacchetto comprende anche sadc (il raccoglitore dei dati), sa1 e sa2 (script che lo richiamano a intervalli) e sadf (che esporta i dati in vari formati). Su Debian e Ubuntu si installa con sudo apt install sysstat (vedi apt).

Cosa fa

Misura CPU, memoria, swap, dischi, rete, code di processi e molto altro. Può funzionare in tre modi: stampare i valori in tempo reale a intervalli regolari; salvare le misure in un file binario (-o); rileggere un file già salvato (-f), anche limitandolo a una fascia oraria. Quando la raccolta periodica è attiva, il sistema scrive ogni 10 minuti un campione in un file al giorno, e con sar senza argomenti puoi vedere cos'è successo oggi.

Come si usa

$ sar [opzioni] [INTERVALLO [CONTEGGIO]]
$ sar [opzioni] -f FILE [-s ORA] [-e ORA]

Gli esempi vengono da una macchina virtuale con 2 CPU (sysstat 12.6.1, installato con apt perché non c'era). Nelle prime righe di ogni output ho omesso la riga con il kernel e il nome del computer. I titoli delle colonne sono in inglese. Per mantenere le righe corte ho tagliato alcune colonne con cut, indicandolo caso per caso.

Esempio 1: misura in tempo reale della CPU

$ sar 1 3
09:33:50        CPU     %user     %nice   %system   %iowait    %steal     %idle
09:33:51        all      0.00      0.00      0.00      0.00      0.00    100.00
09:33:52        all      0.00      0.00      0.00      0.00      0.00    100.00
09:33:53        all      0.00      0.00      0.50      0.00      0.00     99.50
Average:        all      0.00      0.00      0.17      0.00      0.00     99.83

Con 1 3 sar misura ogni secondo per tre volte e alla fine stampa la riga Average. Senza altre opzioni mostra la CPU (-u). Diversamente da vmstat e iostat, qui la prima riga è già una misura vera, e non la media dall'avvio. Le colonne sono le stesse di vmstat e iostat: tempo in modalità utente, di sistema, in attesa del disco e inattivo. Con -u ALL compaiono anche %irq, %soft e %guest, e con -P ALL si ha una riga per ogni CPU, oltre alla media.

Esempio 2: registrare in un file

$ sar -o dati.sa 1 6 > /dev/null
$ sar -f dati.sa
09:34:00        CPU     %user     %nice   %system   %iowait    %steal     %idle
09:34:01        all      0.00      0.00     24.14     27.59      0.49     47.78
09:34:02        all      0.50      0.00      0.00      5.50      0.00     94.00
09:34:03        all      0.00      0.00      0.00      0.00      0.00    100.00
09:34:04        all      0.00      0.00      0.00      0.00      0.00    100.00
09:34:05        all      0.50      0.00      0.00      0.00      0.50     99.00
09:34:06        all      0.50      0.00      0.00      0.00      0.00     99.50
Average:        all      0.25      0.00      4.07      5.56      0.17     89.95

-o FILE salva i campioni in un file binario (qui ho scartato l'output a schermo con > /dev/null); -f FILE lo rilegge. Il file contiene molto più della sola CPU: tutte le statistiche principali, da rileggere con le opzioni degli esempi seguenti. Durante la registrazione scrivevo un file da 800 MiB con dd conv=fsync: i primi due secondi mostrano %system al 24% e %iowait al 28%, poi tutto torna alla calma. Se il file non è leggibile, il messaggio è Cannot open /nonesiste: No such file or directory.

Esempio 3: una fascia oraria

$ sar -f dati.sa -s 09:34:01 -e 09:34:03
09:34:01        CPU     %user     %nice   %system   %iowait    %steal     %idle
09:34:02        all      0.50      0.00      0.00      5.50      0.00     94.00
09:34:03        all      0.00      0.00      0.00      0.00      0.00    100.00
Average:        all      0.25      0.00      0.00      2.76      0.00     96.99

-s (start) e -e (end) limitano il report a una fascia oraria, nel formato HH:MM:SS. Sono la chiave per analizzare un episodio: "tra le 02:50 e le 03:20 ci fu il picco". Nota che nel mio test il campione delle 09:34:01 non compare e la tabella parte da quello successivo (l'intestazione riporta l'ora di inizio). Il calcolo di Average riguarda solo i campioni mostrati.

Esempio 4: memoria, code, disco, rete

$ sar -r -f dati.sa | sed -n 3,4p | cut -c1-70
09:34:01      6875212   7712012    251412      3.06     12300   1030804
$ sar -q -f dati.sa | sed -n 3,4p
09:34:00      runq-sz  plist-sz   ldavg-1   ldavg-5  ldavg-15   blocked
09:34:01            0       100      0.00      0.00      0.00         1
$ sar -b -f dati.sa | sed -n 3,4p
09:34:00          tps      rtps      wtps      dtps   bread/s   bwrtn/s   bdscd/s
09:34:01       385.00      7.00    377.00      1.00     56.00 1649304.00      8.00
$ sar -d -p -f dati.sa | sed -n 3,4p | cut -c1-90
09:34:00          tps     rkB/s     wkB/s     dkB/s   areq-sz    aqu-sz     await
09:34:01       385.00     28.00 824652.00      4.00   2142.04      7.62     19.79

Ogni argomento ha la sua opzione: -r memoria (kbmemfree, kbavail, %memused, cache...), -q lunghezza della coda dei processi e carico medio (come uptime), -b operazioni di I/O complessive, -d per disco (con -p i nomi leggibili come vda al posto dei numeri di dispositivo), -n DEV traffico di rete per interfaccia, -w processi creati e cambi di contesto, -B paginazione, -S e -W swap. Qui ho tagliato le colonne con cut e ho tolto l'intestazione di -r (la riga di titolo è lunga); il valore di -d riguarda il disco vda, il solo attivo nella registrazione. Per la rete sar -n DEV elenca ogni interfaccia (lo, ecc.), con pacchetti e kilobyte al secondo in ricezione e trasmissione.

Esempio 5: attivare lo storico

$ grep ENABLED /etc/default/sysstat
ENABLED="false"
$ sar
Cannot open /var/log/sysstat/sa17: No such file or directory
Please check if data collecting is enabled

Su Debian e Ubuntu la raccolta periodica è disattivata per impostazione predefinita: nel mio sistema ENABLED="false", e sar senza argomenti risponde con l'errore sopra (e termina con codice 0, attenzione negli script). Per attivarla si imposta ENABLED="true" in /etc/default/sysstat (per esempio con sudo sed -i 's/^ENABLED=.*/ENABLED="true"/' /etc/default/sysstat) e si riavvia il servizio con sudo systemctl restart sysstat: queste due operazioni non le ho potute provare, perché nel sandbox la raccolta è gestita da cron e non c'è systemd. La raccolta è affidata a un timer di systemd (sysstat-collect.timer) oppure, nei sistemi senza, a una voce di cron: nel mio sistema /etc/cron.d/sysstat contiene 5-55/10 * * * * root ... debian-sa1 1 1, cioè un campione ogni 10 minuti, più un riepilogo alle 23:59. La cartella dei dati è /var/log/sysstat e si tengono 7 giorni (HISTORY=7 in /etc/sysstat/sysstat). Ho verificato il valore di ENABLED, l'errore di sar senza dati e il contenuto di cron e della configurazione.

Esempio 6: il raccoglitore a mano e i giorni passati

$ sudo /usr/lib/sysstat/sa1 1 3
$ ls -l /var/log/sysstat | tail -1
-rw-r--r-- 1 root root 7684 Nov 17 09:34 sa17
$ sar -u -s 09:34:00 -f /var/log/sysstat/sa17
09:34:18        all      0.00      0.00      0.50      0.00      0.00     99.50
09:34:19        all      0.00      0.00      0.00      0.00      0.00    100.00
Average:        all      0.00      0.00      0.25      0.00      0.00     99.75

sa1 è lo script che il timer o il cron richiama per salvare un campione: lanciato a mano con 1 3 (tre campioni a un secondo di distanza) crea il file del giorno, sa17 per il 17 del mese (il suffisso è il giorno del mese, quindi ogni giorno ha il suo file). Con sar -f si rilegge quel file; senza -f, sar legge direttamente il file di oggi (l'ho verificato). Per un giorno passato basta indicare il file di quel giorno, per esempio sar -u -f /var/log/sysstat/sa16: nel mio sandbox non ho dati di giorni precedenti, quindi questa forma non l'ho potuta provare. Su Debian il nome dello script è anche debian-sa1, ed è quello che usa il cron.

Esempio 7: esportare i dati con sadf

$ sadf -d dati.sa -- -u | head -3
# hostname;interval;timestamp;CPU;%user;%nice;%system;%iowait;%steal;%idle
web01;1;2026-11-17 08:34:01 UTC;-1;0.00;0.00;24.14;27.59;0.49;47.78
web01;1;2026-11-17 08:34:02 UTC;-1;0.50;0.00;0.00;5.50;0.00;94.00
$ sadf -dT dati.sa -- -u | sed -n 2p
web01;1;2026-11-17 09:34:01;-1;0.00;0.00;24.14;27.59;0.49;47.78
$ sadf -j dati.sa -- -u | head -3
{"sysstat": {
        "hosts": [
                {

sadf legge i file di sar e li stampa in formati adatti ad altri strumenti: -d è il CSV con il punto e virgola, -j il JSON. Dopo i due trattini si passano le opzioni di sar che dicono quali statistiche esportare (qui -u, la CPU). Per default gli orari sono in UTC (08:34, mentre in Italia, d'inverno, erano le 09:34): con -T si ottiene l'ora locale. Nell'esempio ho sostituito il nome del computer con web01 e ho riportato solo le prime righe. Esiste anche -p, un formato a una riga per valore, pensato per awk e grep.

Esempio 8: uso negli script

#!/bin/bash
SOGLIA="${1:-20}"
iow=$(LC_ALL=C sar -u 1 3 | awk '
    /%iowait/ { for (i = 1; i <= NF; i++) if ($i == "%iowait") c = i }
    /^Average:/ { print $c }')
[ -n "$iow" ] || { echo "sar non disponibile" >&2; exit 2; }
echo "iowait medio: $iow%"
awk -v v="$iow" -v s="$SOGLIA" 'BEGIN { exit !(v >= s) }' && exit 1
exit 0

Lo script misura per tre secondi e legge la riga Average, cercando la colonna %iowait per nome e non per posizione. Esce con codice 1 se l'attesa media supera la soglia (20 per default). LC_ALL=C forza il formato standard: in alcune lingue l'orario viene stampato con AM/PM e le colonne si spostano; in alternativa si può impostare la variabile S_TIME_FORMAT=ISO, che nel mio test ha cambiato la data in formato 2026-11-17. A riposo ha stampato iowait medio: 0.00% (codice 0); mentre scrivevo un file da 1200 MiB con dd, e con soglia 5, iowait medio: 15.58% (codice 1). Con un finto sar che non stampa nulla ha risposto "sar non disponibile" (codice 2).

Opzioni utili

  • INTERVALLO [CONTEGGIO]: secondi tra le misure e numero di misure.
  • -u [ALL]: CPU (predefinito). -P ALL: una riga per ogni CPU.
  • -r: memoria. -S: spazio di swap. -W: attività di swap. -B: paginazione.
  • -q: coda dei processi e carico medio. -w: processi creati e cambi di contesto.
  • -b: I/O totale. -d [-p]: I/O per disco (con nomi leggibili).
  • -n DEV: traffico di rete per interfaccia (-n ALL per tutto).
  • -A: tutte le statistiche. -o FILE: salva i campioni. -f FILE: rilegge un file.
  • -s ORA e -e ORA: limitano a una fascia oraria.
  • sadf -d|-j|-p: esporta in CSV, JSON o testo per script.

Attenzione a

  • Senza raccolta attiva non c'è storico: su Debian e Ubuntu va abilitata (ENABLED="true"), altrimenti sar senza argomenti segnala che il file non esiste. Attiva la raccolta prima che serva: i dati di ieri non si recuperano.
  • Un campione ogni 10 minuti nasconde i picchi brevi: un'ora di calma con un picco di 30 secondi non lo mostra. Per un'analisi fine abbassa l'intervallo (il timer o il cron) o registra a mano con -o a 1 secondo.
  • Retention limitata: di default si tengono 7 giorni (HISTORY=7 in /etc/sysstat/sysstat): per conservare di più va aumentato.
  • Codice 0 anche se non ci sono dati: sar senza file termina con codice 0: negli script controlla l'output, non il codice di uscita.
  • Orari: sar usa l'ora locale; sadf -d usa UTC, a meno di -T. Confrontare i due senza saperlo fa sbagliare di un'ora (due d'estate).
  • Formato dell'ora e lingua: in alcune lingue l'ora è in 12 ore con AM/PM e le colonne si spostano; per gli script usa LC_ALL=C o S_TIME_FORMAT=ISO.
  • Compatibilità dei file: i file binari dipendono dalla versione di sysstat: aggiornandola, i vecchi possono non essere leggibili con la nuova versione (non l'ho verificato).
  • Dischi e rete: sulle macchine virtuali i dati di rete e disco riflettono ciò che vede il sistema ospite. Nel mio sandbox le interfacce erano poche e il traffico nullo, quindi non riporto un esempio completo di -n DEV.

Riepilogo

ComandoCosa fa
sar 1 5CPU ogni secondo, 5 volte
sarStatistiche di oggi (se la raccolta è attiva)
sar -r 1 3Memoria in tempo reale
sar -qCarico medio e code dei processi
sar -d -pI/O per disco, nomi leggibili
sar -n DEVTraffico di rete per interfaccia
sar -o FILE 1 60Registra 60 campioni in un file
sar -f FILE -s 02:50 -e 03:20Rilegge una fascia oraria
sar -ATutte le statistiche
sadf -d FILE -- -uEsporta la CPU in CSV