Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Controllo dello stato di un’istanza Neptune Amazon Neptune fornisce un meccanismo per controllare lo stato del database a grafo sull'host. È anche un buon metodo per confermare che sei in grado di connetterti a un’istanza. Per verificare lo stato di integrità di un'istanza e ottenere lo stato del cluster di database utilizzando `curl`: ``` curl -G https://your-neptune-endpoint:port/status ``` Oppure, a partire dal [rilascio del motore 1.2.1.0.R6](engine-releases-1.2.1.0.R6.md), puoi utilizzare il seguente comando della CLI: ``` aws neptunedata get-engine-status ``` Se l'istanza è integra, il comando `status` restituisce un [oggetto JSON](#access-graph-status-sample-output) con i campi seguenti: + **`status`**: impostato su `"healthy"` se l'istanza non presenta problemi. Se l'istanza è in fase di ripristino dopo un arresto anomalo o un riavvio e ci sono transazioni attive in esecuzione dall'ultimo arresto del server, `status` è impostato su `"recovery"`. + **`startTime`**: impostato sull'ora UTC in cui è iniziato il processo del server corrente. + **`dbEngineVersion`**: impostato sulla versione del motore Neptune in esecuzione sul cluster database. Se è stata applicata una patch manualmente a questa versione del motore dopo il rilascio, il numero della versione ha il prefisso `"Patch-"`. + **`role`**: impostato su `"reader"` se l'istanza è una replica di lettura o su `"writer"` se è l'istanza primaria. + **`dfeQueryEngine`**: impostato su `"enabled"` se il [motore DFE](neptune-dfe-engine.md) è completamente abilitato o su `viaQueryHint` se il motore DFE viene utilizzato solo con query per le quali l'hint di query `useDFE` è impostato su `true` (`viaQueryHint` è l'impostazione predefinita). + **`gremlin`**: contiene informazioni sul linguaggio di query Gremlin disponibile nel cluster. In particolare, contiene un `version` campo che specifica la TinkerPop versione corrente utilizzata dal motore. + **`sparql`**: contiene informazioni sul linguaggio di query SPARQL disponibile nel cluster. In particolare, contiene un campo `version` che specifica la versione corrente di SPARQL utilizzata dal motore. + **`opencypher`**: contiene informazioni sul linguaggio di query openCypher disponibile nel cluster. In particolare, contiene un campo `version` che specifica la versione corrente di operCypher utilizzata dal motore. + **`labMode`**: contiene le impostazioni della [Modalità di laboratorio](features-lab-mode.md) utilizzate dal motore. Questo è un elenco selettivo delle impostazioni della modalità Lab e non il set completo. Consultate il [gruppo di parametri del cluster](https://docs.aws.amazon.com//neptune/latest/userguide/parameter-groups.html) per il set completo in uso. + **`rollingBackTrxCount`**: se sono presenti transazioni di cui è stato eseguito il rollback, questo campo è impostato sul numero di tali transazioni. Se non ne esistono, il campo non viene visualizzato. + **`rollingBackTrxEarliestStartTime`**: impostato sull'ora di inizio del rollback della prima transazione. Se non è stato eseguito il rollback di alcuna transazione, il campo non viene visualizzato. + **`features`**: contiene informazioni sullo stato delle funzionalità abilitate nel cluster database. + **`lookupCache`**: stato corrente della [Cache di ricerca](feature-overview-lookup-cache.md). Questo campo viene visualizzato solo per tipi di istanza `R5d`, poiché sono le uniche istanze in cui può esistere una cache di ricerca. Il campo è un oggetto JSON nel formato: ``` "lookupCache": { "status": "current lookup cache status" } ``` Per un'istanza `R5d`: + Se la cache di ricerca è abilitata, lo stato è riportato come `"Available"`. + Se la cache di ricerca è stata disabilitata, lo stato è riportato come `"Disabled"`. + Se è stato raggiunto il limite del disco per l'istanza, lo stato viene riportato come `"Read Only Mode - Storage Limit Reached"`. + **`ResultCache`**: stato corrente della [Memorizzazione nella cache dei risultati delle query](gremlin-results-cache.md). Questo campo è un oggetto JSON nel formato: ``` "ResultCache": { "status": "current results cache status" } ``` + Se la cache dei risultati è stata abilitata, lo stato è riportato come `"Available"`. + Se la cache è disabilitata, lo stato è riportato come `"Disabled"`. + **`IAMAuthentication`**— Speciifica se l'autenticazione AWS Identity and Access Management (IAM) è stata abilitata o meno sul cluster DB: + Se l'autenticazione IAM è stata abilitata, lo stato è riportato come `"enabled"`. + Se l'autenticazione IAM è disabilitata, lo stato è riportato come `"disabled"`. + **`Streams`**: specifica se la funzionalità Neptune Streams è stata abilitata o meno sul cluster database: + Se i flussi sono abilitati, lo stato è riportato come `"enabled"`. + Se i flussi sono disabilitati, lo stato è riportato come `"disabled"`. + **`AuditLog`**: uguale a `enabled` se i log di audit sono abilitati, in caso contrario `disabled`. + **`SlowQueryLogs`**: uguale a `info` o `debug` se la [registrazione di log delle query lente](slow-query-logs.md) è abilitata, in caso contrario `disabled`. + **`QueryTimeout`**: valore, in millisecondi, del timeout delle query. + **`settings`**: impostazioni applicate all'istanza: + **`clusterQueryTimeoutInMs`**: valore, in millisecondi, del timeout delle query, impostato per l'intero cluster. + **`SlowQueryLogsThreshold`**: valore, in millisecondi, del timeout delle query, impostato per l'intero cluster. + **`serverlessConfiguration`**: impostazioni serverless per un cluster se è in esecuzione come serverless: + **`minCapacity`**— La dimensione minima alla quale un'istanza serverless nel cluster DB può ridursi, in Neptune Capacity Units (). NCUs + **`maxCapacity`**— La dimensione massima alla quale può crescere un'istanza serverless nel cluster DB, in Neptune Capacity Units (). NCUs ## Esempio di output del comando instance status Di seguito è riportato un esempio dell'output del comando di stato dell'istanza, (in questo caso, eseguito su un'istanza `R5d`): ``` { 'status': 'healthy', 'startTime': 'Thu Aug 24 21:47:12 UTC 2023', 'dbEngineVersion': '1.2.1.0.R4', 'role': 'writer', 'dfeQueryEngine': 'viaQueryHint', 'gremlin': {'version': 'tinkerpop-3.6.2'}, 'sparql': {'version': 'sparql-1.1'}, 'opencypher': {'version': 'Neptune-9.0.20190305-1.0'}, 'labMode': { 'ObjectIndex': 'disabled', 'ReadWriteConflictDetection': 'enabled' }, 'features': { 'SlowQueryLogs': 'disabled', 'ResultCache': {'status': 'disabled'}, 'IAMAuthentication': 'disabled', 'Streams': 'disabled', 'AuditLog': 'disabled' }, 'settings': { 'clusterQueryTimeoutInMs': '120000', 'SlowQueryLogsThreshold': '5000' }, 'serverlessConfiguration': { 'minCapacity': '1.0', 'maxCapacity': '128.0' } } ``` Se si verifica un problema con l’istanza, il comando di stato restituisce il codice di errore `HTTP 500`. Se l'host non è raggiungibile, la richiesta scade. Verifica di accedere all’istanza dal cloud privato virtuale (VPC, Virtual Private Cloud) e che i gruppi di sicurezza consentano l'accesso.