Visualizza i dettagli del nodo blockchain

Questa pagina descrive come visualizzare i dettagli di un nodo Blockchain Node Engine utilizzando la console o una chiamata all'API.

Utilizzo della console

Per visualizzare i dettagli di un nodo nell'interfaccia utente:

  1. Nella console Google Cloud, vai alla pagina Blockchain Node Engine.

    Vai a Blockchain Node Engine

  2. Per impostazione predefinita, viene visualizzata la pagina dell'elenco Nodi.

  3. Fai clic sul nome di un nodo. Viene visualizzata la pagina Dettagli nodo.

Visualizza i dettagli del nodo

La pagina Dettagli nodo mostra informazioni dettagliate sul nodo selezionato.

In questa pagina puoi:

  • Apri la pagina Credenziali API e servizi.
  • Copia un elemento negli appunti.
  • Apri la pagina Esplora metriche.

Interfaccia utente dei dettagli del nodo Blockchain Node Engine

Categoria Descrizione
Informazioni nodo
Endpoint Elenca gli URL degli endpoint creati quando hai creato il tuo nodo blockchain. L'URL dell'endpoint è obbligatorio per utilizzare il nodo blockchain.
Chiavi API Fornisce un link alla pagina delle chiavi API per la chiave API che hai creato in Crea una chiave API. È necessaria una chiave API per utilizzare il nodo blockchain.
Località La posizione geografica selezionata in Crea un nodo blockchain.
Metriche Visualizza le metriche relative all'integrità del nodo blockchain utilizzando Metrics Explorer.

Utilizzo di un'API

Per elencare i dettagli relativi a un nodo blockchain con ListBlockchainNodes, invia la seguente richiesta:

curl \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
https://blockchainnodeengine.googleapis.com/v1/projects/PROJECT_ID/\
locations/LOCATION/blockchainNodes/NODE_NAME

Dove:

Se il nodo è stato creato, vedrai una risposta simile al seguente esempio di Ethereum:

  {
      "name": "projects/my-project-id/locations/us-central1/blockchainNodes/my-node",
      "createTime": "2023-04-21T19:26:16.293078Z",
      "updateTime": "2023-04-21T19:57:36.769661Z",
      "labels": {
        "my-label-key": "my-label-value"
      },
      "blockchainType": "ETHEREUM",
      "connectionInfo": {
        "ipInfo": {
          "rpcIpv4Address": "203.0.113.1"
        },
        "endpointInfo": {
          "jsonRpcApiEndpoint": "json-rpc.2g7qvv04aisoq4jhnqqgw8zy0.blockchainnodeengine.com",
          "websocketsApiEndpoint": "ws.2g7qvv04aisoq4jhnqqgw8zy0.blockchainnodeengine.com"
        }
      },
      "ethereumDetails": {
        "network": "MAINNET",
        "nodeType": "FULL",
        "executionClient": "GETH",
        "consensusClient": "LIGHTHOUSE",
        "apiEnableAdmin": false,
        "apiEnableDebug": false,
        "additionalEndpoints": {
          "beaconApiEndpoint": "beacon.2g7qvv04aisoq4jhnqqgw8zy0.blockchainnodeengine.com",
          "beaconPrometheusMetricsApiEndpoint": "bc-mc.2g7qvv04aisoq4jhnqqgw8zy0.blockchainnodeengine.com"
        }
      },
      "state": "RUNNING"
  }

Se invii il comando precedente immediatamente dopo aver inviato il comando per creare il nodo, il valore di state sarà CREATING. Puoi utilizzare l'URL per configurare l'infrastruttura, ma il nodo non è utilizzabile finché lo stato non diventa RUNNING.

Prendi nota dell'URL dell'endpoint dalla risposta in modo da poterlo utilizzare in Utilizzo dei nodi blockchain.

Stati del nodo

Le istanze dei nodi avranno vari stati in base al ciclo di vita del nodo.

Stato Descrizione
CREAZIONE Quando si trova in questo stato, l'istanza del nodo è in fase di creazione e non è utilizzabile. Anche se sono visualizzati, gli endpoint non sono accessibili. Questa fase richiede fino a 45 minuti.
IN ESECUZIONE

Quando si trova in questo stato, il nodo è accessibile. Tieni presente che, dopo la creazione iniziale, il nodo dovrà sincronizzarsi con la blockchain. Finché la sincronizzazione non viene completata, potresti ricevere risultati incompleti da varie chiamate RPC.

  • Nodi completi Ethereum: circa 10 ore per la sincronizzazione. Per controllare lo stato della sincronizzazione, effettua una chiamata a eth_syncing.
  • Nodi dell'archivio Ethereum: circa 12 ore per la sincronizzazione. Per controllare lo stato della sincronizzazione, esegui una query sull'endpoint delle metriche.
  • Nodi completi Polygon: circa 6 ore per la sincronizzazione. Tieni presente che per la prima ora circa durante la sincronizzazione di Heimdall, le richieste API restituiranno errori 503. Poi, sono necessarie altre circa 5 ore per la sincronizzazione di Bor. Per controllare lo stato della sincronizzazione, effettua una chiamata a eth_syncing.
  • Nodi RPC non votanti Solana: circa 1 ora per la sincronizzazione. Tieni presente che durante la sincronizzazione le richieste API genereranno errori 503.
  • ELIMINAZIONE Quando si trova in questo stato, il nodo è in fase di eliminazione attiva e non può essere utilizzato. L'operazione potrebbe richiedere fino a 30 minuti.
    ERRORE Questo stato indica che si è verificato un errore imprevisto. Elimina il nodo e riprova. Se il problema persiste, contatta l'assistenza.