Skip to main content
Metode RPC getRecentPerformanceSamples menyediakan ringkasan performa terkini jaringan Solana. Metode ini mengembalikan daftar sampel yang diambil kira-kira setiap 60 detik, dengan perincian jumlah transaksi dan slot yang diproses dalam periode tersebut. Data ini sangat berguna untuk memantau laju pemrosesan dan kondisi jaringan. Untuk konteks lebih lanjut mengenai metrik performa Solana seperti TPS dan waktu slot, Anda dapat membaca panduan Solana untuk Perusahaan.

Kasus Penggunaan Umum

  • Pemantauan Kondisi Jaringan: Pantau laju pemrosesan transaksi dan produksi slot untuk menilai kondisi jaringan secara keseluruhan serta mengidentifikasi potensi kepadatan atau perlambatan.
  • Analisis Performa: Analisis data performa historis untuk memahami perilaku jaringan dalam berbagai kondisi.
  • Dasbor: Tampilkan indikator performa utama (KPI), seperti transaksi per detik (TPS) dan slot per menit, pada dasbor pemantauan.
  • Perencanaan Kapasitas: Amati tren beban jaringan untuk mendukung keputusan penskalaan aplikasi atau infrastruktur.

Parameter Permintaan

  1. limit (usize, opsional):
    • Jumlah sampel performa terbaru yang akan dikembalikan.
    • Nilai maksimum: 720 (mewakili data selama kurang lebih 12 jam karena sampel diambil setiap 60 detik).
    • Jika dihilangkan, node RPC akan mengembalikan jumlah sampel default (nilai default yang tepat dapat berbeda menurut penyedia RPC).

Struktur Respons

Kolom result dalam respons JSON-RPC adalah array objek sampel performa yang dikembalikan dalam urutan kronologis terbalik (sampel terbaru terlebih dahulu). Setiap objek memiliki struktur berikut:
  • slot (u64): Nomor slot tempat sampel performa ini dicatat.
  • numTransactions (u64): Jumlah total transaksi (termasuk transaksi voting dan non-voting) yang diproses selama samplePeriodSecs menjelang slot ini.
  • numSlots (u64): Jumlah slot yang diproses selama samplePeriodSecs menjelang slot ini.
  • samplePeriodSecs (u16): Durasi dalam detik saat sampel ini diambil (biasanya 60).
  • numNonVoteTransactions (u64): Jumlah transaksi yang bukan merupakan transaksi voting konsensus dan diproses selama samplePeriodSecs.

Contoh

1. Mendapatkan 5 Sampel Performa Terakhir

Contoh ini meminta lima sampel performa terbaru dari jaringan.

2. Mendapatkan Jumlah Default Sampel Performa

Contoh ini menghilangkan parameter limit sehingga meminta jumlah sampel default dari node RPC.

Tips untuk Developer

  • Interval Pengambilan Sampel: Sampel biasanya diambil setiap 60 detik, tetapi angka ini merupakan perkiraan. Kolom samplePeriodSecs dalam respons menunjukkan durasi aktual setiap sampel.
  • Batas Data Historis: Nilai maksimum limit sebesar 720 sampel menyediakan rentang data historis selama kurang lebih 12 jam. Untuk analisis performa jangka panjang, diperlukan pencatatan dan agregasi data eksternal.
  • Transaksi Voting vs. Non-Voting: numTransactions mencakup semua transaksi, sedangkan numNonVoteTransactions secara khusus menghitung transaksi yang bukan bagian dari proses voting konsensus. Nilai kedua sering kali menjadi indikator yang lebih baik untuk aktivitas jaringan yang digerakkan oleh pengguna.
  • Variabilitas Node: Data yang tepat mungkin sedikit berbeda di antara node RPC karena bergantung pada status sinkronisasi dan tampilan lokalnya terhadap jaringan saat sampel diambil.
Dengan menggunakan getRecentPerformanceSamples, developer dan pengamat jaringan dapat memperoleh wawasan berharga mengenai status operasional dan laju pemrosesan jaringan Solana.