Wie man getHealth verwendet

​

Funktionsweise

​

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

​

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)

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"
  }'

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>');

{
  "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.