Script de Bash per generar un informe del sistema | Iespai
Categorías: Shell Scripting

Script de Bash per generar un informe detallat del sistema



Quan has de revisar l’estat d’un servidor, o has d’enviar a algú la informació d’una màquina perquè t’ajudi a trobar un problema, és molt pràctic tenir-ho tot en un sol fitxer de text: temps en marxa, memòria, disc, usuaris connectats, xarxa, processos i paquets instal·lats. En aquest article et proposo un script de Bash que genera aquest informe i el desa, amb la data i l’hora al nom, al directori que li diguis.

La versió original d’aquest article tenia l’script a mitges (només hi havia la part del temps en marxa i un comentari «Resto del script…») i acabava amb un mv que movia el fitxer al mateix directori on ja era. Aquí tens la versió completa i corregida, provada a Debian 13 i a Rocky Linux 9.


L’script complet

Desa’l com a informe_sistema.sh:

#!/usr/bin/env bash
# informe_sistema.sh: desa en un fitxer de text un resum de l'estat del sistema
set -uo pipefail

# 1. Directori de destinació: primer argument o, si no n'hi ha, el demanem
desti="${1:-}"
if [[ -z "$desti" ]]; then
    read -rp "Directori on vols desar l'informe: " desti
fi
if [[ -z "$desti" ]]; then
    echo "No has indicat cap directori." >&2
    exit 1
fi

# 2. Si el directori no existeix, el creem
if [[ ! -d "$desti" ]]; then
    echo "El directori $desti no existeix; el creo..."
    mkdir -p -- "$desti" || exit 1
fi

# 3. Nom únic per a l'informe (es calcula una sola vegada)
informe="$desti/informe_sistema_$(hostname)_$(date +%Y%m%d_%H%M%S).txt"

# 4. Funció per separar les seccions
seccio() {
    printf '\n===== %s =====\n' "$1"
}

# 5. Tot el que hi ha entre { } va a parar al fitxer de l'informe
{
    echo "Informe del sistema: $(hostname)"
    echo "Generat el $(date '+%Y-%m-%d %H:%M:%S %Z')"

    seccio "Sistema operatiu i nucli"
    grep '^PRETTY_NAME=' /etc/os-release | cut -d'"' -f2
    uname -srm

    seccio "Temps en marxa i càrrega"
    uptime

    seccio "Memòria"
    free -h

    seccio "Espai en disc"
    df -h -x tmpfs -x devtmpfs

    seccio "Usuaris connectats"
    who

    seccio "Xarxa: adreces i rutes"
    ip -brief address
    ip route

    seccio "Ports en escolta"
    ss -tuln

    seccio "Els 10 processos que més CPU fan servir"
    ps -eo pid,user,%cpu,%mem,comm --sort=-%cpu | head -n 11

    seccio "Paquets instal·lats"
    if command -v dpkg-query >/dev/null; then
        paquets=$(dpkg-query -W -f='${db:Status-Status} ${Package} ${Version}\n' |
                  awk '$1 == "installed" { print $2, $3 }')
    elif command -v rpm >/dev/null; then
        paquets=$(rpm -qa --qf '%{NAME} %{VERSION}-%{RELEASE}\n' | sort)
    else
        paquets="(no s'ha trobat dpkg ni rpm)"
    fi
    echo "Total: $(wc -l <<< "$paquets") paquets"
    echo "$paquets"
} > "$informe" 2>&1

echo "Informe desat a: $informe"

Explicació pas a pas

1. Directori de destinació

desti="${1:-}"
if [[ -z "$desti" ]]; then
    read -rp "Directori on vols desar l'informe: " desti
fi

L’script accepta el directori com a primer argument (./informe_sistema.sh /tmp/informes). Si no n’hi passes cap, te’l demana amb read. Fer-ho per argument és el que et permetrà executar-lo des de cron o un timer de systemd, on ningú no pot respondre preguntes. L’opció -r evita que read interpreti les barres inverses i -p mostra el missatge.

2. Comprovar que el directori existeix

if [[ ! -d "$desti" ]]; then
    echo "El directori $desti no existeix; el creo..."
    mkdir -p -- "$desti" || exit 1
fi

-d comprova si existeix i és un directori. Si no, mkdir -p el crea (amb tots els directoris intermedis que calguin). Si no el pot crear, per exemple per falta de permisos, l’script s’atura.

3. Nom únic per a l’informe

informe="$desti/informe_sistema_$(hostname)_$(date +%Y%m%d_%H%M%S).txt"

El nom porta el nom de la màquina i la data i l’hora, així pots guardar informes de diversos servidors al mateix lloc sense que es trepitgin. El nom es calcula una sola vegada i es fa servir fins al final: l’original tornava a executar date al missatge final, i si havia canviat el segon, el nom que mostrava no coincidia amb el del fitxer.

4. Funció per separar les seccions

seccio() {
    printf '\n===== %s =====\n' "$1"
}

Una funció petita que escriu un títol de secció. Fa l’informe molt més fàcil de llegir.

5. Recollir la informació

En lloc d’afegir >> "$informe" a cada línia, tot el bloc entre { … } es redirigeix d’una vegada amb > "$informe" 2>&1. Així també queden al fitxer els errors (per exemple, si a la màquina no hi ha alguna de les comandes), i no te’n deixes cap per redirigir.

SeccióComandaQuè mostra
Sistema operatiu i nucli/etc/os-release, uname -srmDistribució, versió del nucli (kernel) i arquitectura
Temps en marxa i càrregauptimeQuant fa que va arrencar, usuaris i càrrega mitjana
Memòriafree -hRAM i swap, en unitats llegibles
Espai en discdf -h -x tmpfs -x devtmpfsSistemes de fitxers, sense els virtuals en memòria
Usuaris connectatswhoQui té una sessió oberta i des d’on
Xarxaip -brief address, ip routeAdreces de cada interfície i taula de rutes
Ports en escoltass -tulnPorts TCP i UDP oberts a l’espera de connexions
Processosps -eo … --sort=-%cpu i head -n 11Capçalera i els 10 processos amb més CPU
Paquetsdpkg-query o rpm -qaNombre de paquets i llista amb la versió

Algunes notes:

  • Per a la xarxa i els ports, l’script fa servir ip i ss. Les comandes antigues ifconfig i netstat (paquet net-tools) estan obsoletes i moltes distribucions ja no les instal·len per defecte.
  • ss -tuln funciona sense privilegis. Si l’executes amb sudo i hi afegeixes -p (ss -tulnp), també veuràs quin procés té obert cada port.
  • La secció de paquets detecta el gestor: dpkg-query a Debian i Ubuntu, rpm a Rocky, Alma, RHEL i Fedora. A Debian, el filtre installed deixa fora els paquets desinstal·lats dels quals només queden fitxers de configuració.

6. Missatge final

echo "Informe desat a: $informe"

L’informe ja es crea directament al directori de destinació, de manera que no cal moure’l. L’original feia mv "$INFORME" "$DESTINO", que fallava perquè el fitxer ja era en aquell directori (mv avisa que origen i destinació són el mateix fitxer).


Com fer-lo servir

  1. Desa l’script com a informe_sistema.sh.
  2. Dona-li permís d’execució: chmod +x informe_sistema.sh.
  3. Executa’l indicant el directori: ./informe_sistema.sh ~/informes (o sense argument, i te’l demanarà).
  4. Obre l’informe amb less o el teu editor.

No cal ser root: totes les comandes funcionen amb un usuari normal.

$ ./informe_sistema.sh ~/informes
El directori /home/joan/informes no existeix; el creo...
Informe desat a: /home/joan/informes/informe_sistema_servidor_20261004_194656.txt

Un fragment de l’informe:

Informe del sistema: servidor
Generat el 2026-10-04 19:46:56 CEST

===== Sistema operatiu i nucli =====
Debian GNU/Linux 13 (trixie)
Linux 6.12.48+deb13-amd64 x86_64

===== Temps en marxa i càrrega =====
 19:46:56 up 14 days,  6:45,  1 user,  load average: 0.12, 0.08, 0.05

===== Memòria =====
               total        used        free      shared  buff/cache   available
Mem:           3.7Gi       1.4Gi       348Mi        79Mi       2.1Gi       2.3Gi
Swap:          2.0Gi          0B       2.0Gi

===== Espai en disc =====
Filesystem      Size  Used Avail Use% Mounted on
/dev/sda2       117G   21G   92G  19% /
/dev/sda1       505M   79M  426M  16% /boot/efi

===== Usuaris connectats =====
joan     pts/0        2026-10-04 19:40 (192.168.1.50)

===== Xarxa: adreces i rutes =====
lo               UNKNOWN        127.0.0.1/8 ::1/128
eth0             UP             192.168.1.20/24
default via 192.168.1.1 dev eth0 proto dhcp src 192.168.1.20 metric 100
192.168.1.0/24 dev eth0 proto kernel scope link src 192.168.1.20 metric 100

===== Paquets instal·lats =====
Total: 2126 paquets
7zip 25.01+dfsg-1~deb13u2
accountsservice 23.13.9-7
...

Compte abans d’enviar l’informe a algú: hi surten noms d’usuari, adreces IP i els serveis que tens oberts. Revisa’l i treu-ne el que no calgui compartir.


Idees per ampliar-lo

  • Executar-lo cada dia: amb crontab -e i una línia com 0 7 * * * /home/joan/bin/informe_sistema.sh /home/joan/informes. Fes servir sempre rutes absolutes.
  • Esborrar els informes antics: find /home/joan/informes -name 'informe_sistema_*.txt' -mtime +30 -delete.
  • Afegir-hi més seccions segons el que necessitis: serveis que han fallat (systemctl --failed), últims errors del sistema (journalctl -p err -b) o la temperatura en un Raspberry Pi.

Aquest script és una bona base per tenir una foto ràpida de l’estat d’una màquina i un exemple pràctic de com organitzar un script de Bash: arguments, comprovacions, funcions i redireccions.

Posts relacionats

Esta web usa cookies.