0Pricing
Java Academy · Lezione

Java Flight Recorder

Profilazione a basso overhead

Java Flight Recorder è una lezione Java Academy gratuita su CoddyKit. Questa è la lezione 2 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Java Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Java Academy include 4 lezioni in totale.

Che cos'è JFR?

Java Flight Recorder (JFR) è un motore di profiling e raccolta degli eventi integrato direttamente nella JVM.

Registra eventi dettagliati del runtime — campioni dei metodi, allocazioni, GC, lock, I/O — in un file binario .jfr, con un overhead molto ridotto. È incluso nel JDK; non serve alcun agent aggiuntivo.

Perché è importante un overhead ridotto

I profiler tradizionali basati sulla strumentazione possono rallentare un'applicazione di 2 volte o più, alterando proprio le tempistiche che si desidera analizzare.

JFR è progettato per essere eseguito in produzione con un overhead tipicamente intorno all'1%. È quindi possibile lasciarlo attivo e acquisire una registrazione quando si verifica un incidente reale, non solo in laboratorio.

Avviare una registrazione all'avvio

Abiliti JFR con un flag della JVM quando avvia l'applicazione:

  • -XX:StartFlightRecording=duration=60s,filename=app.jfr

Questa opzione registra gli eventi per 60 secondi, quindi li scrive in app.jfr. È anche possibile avviare una registrazione che rimane attiva fino all'uscita della JVM.

Controllare con jcmd

È inoltre possibile avviare, arrestare e scaricare le registrazioni su una JVM in esecuzione usando jcmd:

  • jcmd <pid> JFR.start name=rec settings=profile
  • jcmd <pid> JFR.dump name=rec filename=out.jfr
  • jcmd <pid> JFR.stop name=rec

È la soluzione ideale per acquisire uno snapshot da un processo che sta già funzionando in modo anomalo.

Impostazioni: default e profile

JFR include due configurazioni integrate:

  • default — overhead minimo, sicura per l'uso continuo in produzione.
  • profile — campionamento più dettagliato, costo leggermente maggiore, per analisi mirate.

La scelta si effettua con settings=profile. È anche possibile scrivere una configurazione personalizzata .jfc per regolare i singoli eventi.

Cosa registra JFR

JFR acquisisce un ricco insieme di eventi, tra cui:

  • Campioni di esecuzione, che mostrano dove viene impiegato il tempo CPU.
  • Allocazione degli oggetti e attività dei TLAB.
  • Pause della garbage collection.
  • Contesa dei lock (jdk.JavaMonitorWait).
  • I/O su file e socket, thread in park ed eccezioni.

Ogni evento include un timestamp, una durata e uno stack trace.

Eventi personalizzati

È possibile definire eventi JFR personalizzati per misurare la durata della logica di business. Estenda jdk.jfr.Event, lo annoti, quindi usi begin() / commit() intorno al lavoro da misurare.

Questa è la parte dell'API JFR adatta all'uso standalone. Una registrazione reale richiede comunque i flag della JVM, ma la classe dell'evento viene compilata ed eseguita su qualsiasi JDK.

import jdk.jfr.Event;
import jdk.jfr.Label;

public class Main {
    @Label("Order Processing")
    static class OrderEvent extends Event {
        @Label("Order Id") int orderId;
    }

    public static void main(String[] args) {
        OrderEvent e = new OrderEvent();
        e.orderId = 42;
        e.begin();
        // ... do the work being measured ...
        e.commit();
        System.out.println("Custom JFR event committed for order " + e.orderId);
    }
}

Registrazione continua

Per i servizi di lunga durata, esegua una registrazione continua con una dimensione o un'età massima (un buffer circolare).

Gli eventi meno recenti vengono eliminati quando ne arrivano di nuovi, quindi l'uso del disco rimane limitato. Quando si verifica un incidente, esegua il dump del buffer e avrà immediatamente a disposizione i minuti che lo hanno preceduto.

Eseguire il dump all'uscita

Aggiunga dumponexit=true a un flag di avvio della registrazione Flight Recorder e JFR scriverà il buffer quando la JVM si arresta.

Combini questa opzione con -XX:FlightRecorderOptions per configurare la dimensione del buffer. In questo modo si garantisce l'acquisizione dei dati anche da un processo ormai prossimo alla terminazione.

Leggere il file

Un file .jfr è binario. Lo analizzi visivamente in JDK Mission Control (nella lezione successiva), oppure programmaticamente con l'API jdk.jfr.consumer e RecordingFile.

La riga di comando jfr print app.jfr può anche scaricare gli eventi in formato testuale per eseguire rapidamente ricerche con grep.

Trasmettere gli eventi in tempo reale

A partire da JDK 14, JFR supporta lo streaming degli eventi tramite l'API jdk.jfr.consumer.RecordingStream.

Invece di eseguire il dump di un file e aprirlo in un secondo momento, è possibile sottoscriversi agli eventi mentre si verificano e reagire in tempo reale — ad esempio inviando un avviso quando le pause del GC superano una soglia. In questo modo JFR diventa una fonte di monitoraggio in tempo reale, non solo uno strumento per l'analisi post-mortem.

Verifica rapida

Qual è il motivo principale per cui JFR può rimanere in esecuzione in produzione?

Riepilogo

JFR è il registratore di dati della JVM integrato:

  • Raccolta di eventi con overhead ridotto e adatta alla produzione, in file .jfr.
  • Avvio tramite -XX:StartFlightRecording o jcmd JFR.start.
  • Scelta delle impostazioni default o profile; definizione di eventi personalizzati.
  • Uso della registrazione continua con buffer circolare e di dumponexit.
  • Analisi successiva in JDK Mission Control.

Domande Frequenti

La lezione «Java Flight Recorder» è gratuita?

Sì — il testo completo di «Java Flight Recorder» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Java Academy, passa a CoddyKit PRO. Il corso Java Academy include 4 lezioni in totale.

Cosa imparerò in «Java Flight Recorder»?

Profilazione a basso overhead Eserciti Java Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Java Academy?

Non è richiesta alcuna esperienza precedente. Java Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 2 di 4.

Quanto tempo richiede la lezione «Java Flight Recorder»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Java Academy?

Sì. Ogni lezione Java Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

  1. Individuare i colli di bottiglia
  2. Java Flight Recorder
  3. Analizzare con JDK Mission Control
  4. Flag comuni per l'ottimizzazione della JVM
← Torna a Java Academy