> ## 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.

# Wie man getHealth verwendet

> Erfahren Sie mehr über die Verwendungsmöglichkeiten von getHealth, Codebeispiele, Anforderungsparameter, Antwortstruktur und Tipps.

Der [`getHealth`](https://www.helius.dev/docs/api-reference/rpc/http/gethealth)-Endpoint wird verwendet, um den aktuellen Gesundheitsstatus eines Solana RPC-Nodes zu überprüfen. Ein gesunder Node wird im Allgemeinen als funktionsfähig und einigermaßen synchron mit dem Rest des Clusters betrachtet (insbesondere innerhalb einer bestimmten Slot-Entfernung des zuletzt vom Cluster bestätigten Slots, bekannt als `HEALTH_CHECK_SLOT_DISTANCE`).

Dieser Endpoint ist entscheidend für die Überwachung der Node-Gesundheit, insbesondere für Anwendungen oder Infrastrukturen, die auf die Verfügbarkeit und Zuverlässigkeit eines RPC-Nodes angewiesen sind.

## Funktionsweise

Die Methode `getHealth` verwendet den standardmäßigen JSON-RPC POST-Mechanismus mit der Methode `getHealth`. Diese Methode überprüft, ob der RPC-Node gesund und mit dem Solana-Cluster synchronisiert ist.

## Häufige Anwendungsfälle

* **Node-Überwachung:** Regelmäßig die Gesundheit von RPC-Nodes überprüfen, um sicherzustellen, dass sie funktionsfähig und synchronisiert sind.
* **Lastverteilung:** Gesundheitsprüfungen verwenden, um festzustellen, ob ein Node in einer Lastverteilungskonfiguration Datenverkehr erhalten soll.
* **Failover-Systeme:** Failover zu einem Backup-Node auslösen, wenn ein primärer Node ungesund wird.
* **Verbindungs-Debugging:** Schnell feststellen, ob ein RPC-Node ansprechbar ist.

## Anforderungsparameter

Diese Methode erfordert keine Parameter.

## Antwortstruktur

* **Für JSON-RPC `getHealth` POST:**
  * **`result`**: `"ok"`, wenn der Node gesund ist.
  * Es könnte ein Fehlerobjekt oder andere Zeichenfolgenwerte zurückgeben (wie `"behind"` oder `"unknown"`), wenn ungesund, obwohl die genaue Fehlerantwort für einen ungesunden Node instabil oder zwischen Anbietern variieren kann.

## Beispiele

### 1. Node-Gesundheit überprüfen mit JSON-RPC (POST mit 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>

**Erwartete JSON-RPC-Antwort (für einen gesunden Node):**

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

## Entwickler-Tipps

* **Definition von Gesund:** "Gesund" bedeutet im Allgemeinen, dass der Node ansprechbar und nicht zu weit hinter dem Tipp des Clusters zurückliegt. Der genaue Slot-Unterschied (`HEALTH_CHECK_SLOT_DISTANCE`) kann auf dem Node konfiguriert werden.
* **Interpretation von `"behind"` oder `"unknown"`:** Wenn Sie `"behind {distance}"` oder `"unknown"` erhalten, ist der Node betriebsbereit, aber möglicherweise nicht vollständig synchronisiert oder in der Lage, seinen Status relativ zum Cluster zu bestimmen. Je nach Anforderungsprofil Ihrer Anwendung könnten Sie diese Zustände unterschiedlich behandeln.
* **Unterschiede zwischen Anbietern:** Das genaue Verhalten und die Antwortcodes/-körper für einen ungesunden Node können leicht zwischen RPC-Anbietern variieren.
* **Fehlerbehandlung:** Implementieren Sie immer eine ordnungsgemäße Fehlerbehandlung, wenn Sie `getHealth` aufrufen, da Netzwerkprobleme oder Node-Probleme dazu führen können, dass die Anforderung vollständig fehlschlägt.

Dieser Leitfaden bietet die notwendigen Informationen, um den `getHealth`-Endpoint zur Überwachung des Status eines Solana RPC-Nodes zu verwenden.