> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cara Menggunakan getHealth

> Pelajari kasus penggunaan getHealth, contoh kode, parameter permintaan, struktur respons, dan tips.

Titik akhir [`getHealth`](https://www.helius.dev/docs/api-reference/rpc/http/gethealth) digunakan untuk memeriksa status kesehatan terkini dari node RPC Solana. Node yang sehat umumnya dianggap sebagai node yang beroperasi dan cukup tersinkronisasi dengan bagian lain dari klaster (khususnya, berada dalam jarak slot tertentu dari slot terkonfirmasi terbaru pada klaster, yang dikenal sebagai `HEALTH_CHECK_SLOT_DISTANCE`).

Titik akhir ini sangat penting untuk memantau kesehatan node, terutama bagi aplikasi atau infrastruktur yang bergantung pada ketersediaan dan keandalan node RPC.

## Cara Kerjanya

Metode `getHealth` menggunakan mekanisme POST JSON-RPC standar dengan metode `getHealth`. Metode ini memeriksa apakah node RPC sehat dan tersinkronisasi dengan klaster Solana.

## Kasus Penggunaan Umum

* **Pemantauan Node:** Periksa kesehatan node RPC secara berkala untuk memastikan node beroperasi dan tersinkronisasi.
* **Penyeimbangan Beban:** Gunakan pemeriksaan kesehatan untuk menentukan apakah sebuah node harus menerima lalu lintas dalam konfigurasi dengan penyeimbangan beban.
* **Sistem Failover:** Picu failover ke node cadangan jika node utama menjadi tidak sehat.
* **Debugging Konektivitas:** Pastikan dengan cepat apakah node RPC memberikan respons.

## Parameter Permintaan

Metode ini tidak menerima parameter apa pun.

## Struktur Respons

* **Untuk POST JSON-RPC `getHealth`:**
  * **`result`**: `"ok"` jika node sehat.
  * Metode ini mungkin mengembalikan objek kesalahan atau nilai string lain (seperti `"behind"` atau `"unknown"`) jika node tidak sehat, meskipun respons kesalahan yang tepat untuk node yang tidak sehat dapat tidak konsisten atau berbeda antarpenyedia.

## Contoh

### 1. Memeriksa Kesehatan Node Menggunakan JSON-RPC (POST dengan cURL)

<CodeGroup>
  ```bash cURL (JSON-RPC POST) theme={"system"}
  curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
    '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "getHealth"
    }'
  ```

  ```javascript JavaScript (using @solana/web3.js) theme={"system"}
  const { Connection } = require('@solana/web3.js');

  async function checkRpcHealth(rpcUrl) {
      const connection = new Connection(rpcUrl);
      try {
          const health = await connection.rpcRequest('getHealth', []);
          console.log(`getHealth result for ${rpcUrl}:`, health);
          return health.result;
      } catch (error) {
          console.error(`Error calling getHealth for ${rpcUrl}:`, error.message);
          return null;
      }
  }

  // Example usage:
  checkRpcHealth('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  ```
</CodeGroup>

**Respons JSON-RPC yang diharapkan (untuk node yang sehat):**

```json theme={"system"}
{
  "jsonrpc": "2.0",
  "result": "ok",
  "id": 1
}
```

## Tips untuk Developer

* **Definisi Sehat:** "Sehat" umumnya berarti node memberikan respons dan tidak terlalu tertinggal dari posisi terdepan klaster. Selisih slot yang tepat (`HEALTH_CHECK_SLOT_DISTANCE`) dapat dikonfigurasi pada node.
* **Menafsirkan `"behind"` atau `"unknown"`:** Jika Anda menerima `"behind {distance}"` atau `"unknown"`, node tersebut beroperasi tetapi mungkin belum sepenuhnya tersinkronisasi atau tidak dapat memastikan statusnya relatif terhadap klaster. Bergantung pada persyaratan aplikasi Anda, Anda mungkin perlu memperlakukan status-status ini secara berbeda.
* **Perbedaan Antarpenyedia:** Perilaku serta kode/isi respons yang tepat untuk node yang tidak sehat mungkin sedikit berbeda antarpenyedia RPC.
* **Penanganan Kesalahan:** Selalu terapkan penanganan kesalahan yang tepat saat memanggil `getHealth` karena masalah jaringan atau node dapat menyebabkan permintaan gagal sepenuhnya.

Panduan ini menyediakan informasi yang diperlukan untuk menggunakan titik akhir `getHealth` guna memantau status node RPC Solana.