Aïlla un error intermitent amb el registre unificat del Mac

Activa diagnòstic temporal només al subsistema que falla

Aïlla un error intermitent amb el registre unificat del Mac

Hi ha errors que semblen tenir una educació impecable: apareixen en producció, desapareixen quan connectes el depurador i tornen just quan ja has tancat l’incident. En una app de Mac que sincronitza documents, per exemple, una transferència pot fallar només amb una xarxa concreta, després d’un canvi de credencials o quan el procés entra en repòs. El registre unificat de macOS serveix precisament per observar aquesta seqüència sense convertir tota la màquina en una font de soroll.

La clau és que l’app ja registri missatges amb OSLog o Logger i que faci servir un subsistema propi, com cat.empresa.sync. Apple estructura aquests registres amb un subsistema en notació DNS inversa i, opcionalment, categories com transferencia, autenticacio o reintents. Aquesta decisió de disseny sembla menor quan s’escriu codi; durant una incidència, separa una pista útil de milers de línies alienes. (developer.apple.com)

El requisit tècnic és macOS 10.12 o posterior, que ja incorpora el registre unificat. Necessitaràs un compte administrador per elevar temporalment el nivell de registre i accés al Mac on es reprodueix el problema. Treballa amb prudència: els registres poden reflectir context operatiu sensible. Evita copiar-ne fragments a tiquets o canals compartits sense revisar-los abans. (developer.apple.com)

Suposem que la sincronització falla de manera intermitent al subsistema cat.empresa.sync. Obre Terminal i comprova primer l’estat actual:

sudo log config --status --subsystem cat.empresa.sync

Aquesta ordre no modifica res. Consulta la configuració activa del subsistema i confirma que has escrit l’identificador exacte. Si el nom no coincideix amb el que usa l’app, el diagnòstic serà buit i la temptació d’obrir massa el filtre arribarà de seguida.

Activa llavors el nivell de depuració només per a aquest àmbit:

sudo log config --mode "level:debug" --subsystem cat.empresa.sync

sudo executa l’ordre amb privilegis d’administració. log config altera temporalment el comportament de captura del registre, --mode "level:debug" inclou missatges de nivell predeterminat, informatiu i de depuració, i --subsystem limita l’efecte a la peça de l’app que vols estudiar. Apple reserva aquesta configuració per a sessions de diagnòstic i requereix privilegis de root. (developer.apple.com)

Verifica el canvi:

sudo log config --status --subsystem cat.empresa.sync

L’estat hauria de mostrar DEBUG. Ara, en una segona finestra de Terminal, segueix els missatges mentre reprodueixes l’error:

log stream --style compact --level debug \
  --predicate 'subsystem == "cat.empresa.sync"'

log stream mostra esdeveniments nous en temps real; no modifica cap configuració. --style compact redueix la llargada visual de cada línia, --level debug inclou el detall que acabes d’habilitar i la predicate filtra estrictament pel subsistema. Reprodueix una sola vegada el flux problemàtic: inicia la sincronització, provoca la condició de xarxa o repeteix l’acció que falla. Busca l’ordre temporal dels fets, especialment l’últim missatge correcte abans de l’error.

Quan acabis, retorna el subsistema al comportament heretat:

sudo log config --reset --subsystem cat.empresa.sync

Comprova-ho amb la mateixa ordre --status. Aquesta neteja forma part del procediment, no és un detall estètic: mantenir el nivell DEBUG actiu amplia el volum de registre i allarga una configuració creada per a una investigació concreta.

El petit repte final consisteix a preparar tres categories dins el teu subsistema —xarxa, autenticacio i fitxers— i repetir la prova amb una incidència real. Si el registre et permet distingir en quin tram neix el problema sense adjuntar un depurador, ja tens una eina de diagnòstic madura.

Per saber-ne més

Personalitzar el comportament del registre durant la depuració

Utilitza log config i log stream per capturar missatges de depuració d’una part concreta d’una app sense inundar el Mac de registres.

🔝

Apple Terminal

Altres:

Publica el mateix agent en dos entorns sense reescriure’l

Quan una petició ja es pot revisar: valida-la amb una regla de negoci a Dataverse

2023

2024

2026