As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Conferir o status de integridade de uma instância do Neptune
<a name="access-graph-status"></a>

O Amazon Neptune fornece um mecanismo para conferir o status do banco de dados de grafos no host. Também é uma boa maneira de confirmar que você pode se conectar a uma instância.

Para verificar a integridade de uma instância e obter o status do cluster de banco de dados usando `curl`:

```
curl -G https://{{your-neptune-endpoint}}:{{port}}/status
```

Ou, a partir da [versão 1.2.1.0.R6 do mecanismo](engine-releases-1.2.1.0.R6.md), você pode usar o seguinte comando da CLI:

```
aws neptunedata get-engine-status
```

Se a instância estiver íntegra, o comando `status` retornará um [objeto JSON](#access-graph-status-sample-output) com os seguintes campos:
+ **`status`**: defina como `"healthy"` se a instância não estiver com problemas.

  Se a instância estiver se recuperando de um travamento ou sendo reinicializada e houver transações ativas em execução no desligamento do servidor mais recente, o `status` será definido como `"recovery"`.
+ **`startTime`**: defina como a hora UTC em que o processo do servidor atual foi iniciado.
+ **`dbEngineVersion`**: defina como a versão do mecanismo do Neptune em execução no cluster de banco de dados.

  Se essa versão do mecanismo tiver sido corrigida manualmente desde que foi lançada, o número da versão terá o prefixo `"Patch-"`.
+ **`role`**   defina como `"reader"` se a instância for uma réplica de leitura ou como `"writer"` se a instância for a principal.
+ **`dfeQueryEngine`**: defina como `"enabled"` se o [mecanismo do DFE](neptune-dfe-engine.md) estiver totalmente habilitado ou `viaQueryHint` se o mecanismo do DFE for usado somente com consultas que tenham a dica de consulta `useDFE` definida como `true` (`viaQueryHint` é o padrão).
+ **`gremlin`**: contém informações sobre a linguagem de consulta do Gremlin disponível no cluster. Especificamente, ele contém um `version` campo que especifica a TinkerPop versão atual que está sendo usada pelo mecanismo.
+ **`sparql`**: contém informações sobre a linguagem de consulta do SPARQL disponível no cluster. Especificamente, contém um campo `version` que especifica a versão atual do SPARQL que está sendo usada pelo mecanismo.
+ **`opencypher`**: contém informações sobre a linguagem de consulta do openCypher disponível no cluster. Especificamente, contém um campo `version` que especifica a versão atual do openCypher que está sendo usada pelo mecanismo.
+ **`labMode`**: contém as configurações [Modo de laboratório](features-lab-mode.md) usadas pelo mecanismo. Esta é uma lista seletiva das configurações do modo Laboratório e não o conjunto completo. Consulte o [grupo de parâmetros do cluster](https://docs.aws.amazon.com//neptune/latest/userguide/parameter-groups.html) para ver o conjunto completo em uso.
+ **`rollingBackTrxCount`**: se houver transações sendo revertidas, esse campo será definido como o número dessas transações. Se não houver nenhuma, o campo não aparecerá.
+ **`rollingBackTrxEarliestStartTime`**: defina como a hora de início da transação mais antiga revertida. Se nenhuma transação estiver sendo revertida, o campo não aparecerá.
+ **`features`**: contém informações de status sobre os atributos habilitados no cluster de banco de dados:
  + **`lookupCache`**: o status atual do [Cache de pesquisa](feature-overview-lookup-cache.md). Esse campo aparece somente em tipos de instância `R5d`, pois essas são as únicas instâncias em que um cache de pesquisa pode existir. O campo é um objeto JSON no formato:

    ```
    "lookupCache": {
      "status": "{{current lookup cache status}}"
    }
    ```

    Em uma instância `R5d`:
    + Se o cache de pesquisa estiver habilitado, o status será listado como `"Available"`.
    + Se o cache de pesquisa estiver desabilitado, o status será listado como `"Disabled"`.
    + Se o limite de disco tiver sido atingido na instância, o status será listado como `"Read Only Mode - Storage Limit Reached"`.
  + **`ResultCache`**: o status atual do [Armazenar em cache os resultados da consulta](gremlin-results-cache.md). Esse campo é um objeto JSON no formato:

    ```
    "ResultCache": {
      "status": "{{current results cache status}}"
    }
    ```
    + Se o cache de resultados tiver sido habilitado, o status será listado como `"Available"`.
    + Se o cache estiver desabilitado, o status será listado como `"Disabled"`.
  + **`IAMAuthentication`**— Especifica se a autenticação AWS Identity and Access Management (IAM) foi habilitada ou não em seu cluster de banco de dados:
    + Se a autenticação do IAM estiver habilitada, o status será listado como `"enabled"`.
    + Se a autenticação do IAM estiver desabilitada, o status será listado como `"disabled"`.
  + **`Streams`**: especifica se os fluxos do Neptune foram habilitados ou não no cluster de banco de dados:
    + Se os fluxos estiverem habilitados, o status será listado como `"enabled"`.
    + Se os fluxos estiverem desabilitados, o status será listado como `"disabled"`.
  + **`AuditLog`**: igual a `enabled` se os logs de auditoria estiverem habilitados. Caso contrário, `disabled`.
  + **`SlowQueryLogs`**: igual a `info` ou `debug` se o [registro em log de consultas lentas](slow-query-logs.md) estiver habilitado. Caso contrário, `disabled`.
  + **`QueryTimeout`**: o valor, em milissegundos, do tempo limite da consulta.
+ **`settings`**: configurações aplicadas à instância:
  + **`clusterQueryTimeoutInMs`**: o valor, em milissegundos, do tempo limite da consulta, definido para todo o cluster.
  + **`SlowQueryLogsThreshold`**: o valor, em milissegundos, do tempo limite da consulta, definido para todo o cluster.
+ **`serverlessConfiguration`**: configurações sem servidor para um cluster se ele estiver sendo executado sem servidor:
  + **`minCapacity`**— O menor tamanho para o qual uma instância sem servidor em seu cluster de banco de dados pode ser reduzida, em Neptune Capacity Units (). NCUs
  + **`maxCapacity`**— O maior tamanho até o qual uma instância sem servidor em seu cluster de banco de dados pode crescer, em Neptune Capacity Units (). NCUs

## Exemplo da saída do comando de status da instância
<a name="access-graph-status-sample-output"></a>

Veja um exemplo da saída do comando instance status (nesse caso, executado em uma instância `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 houver um problema com a instância, o comando de status retornará o código de erro `HTTP 500`. Se o host estiver inacessível, o tempo limite da solicitação será esgotado. Verifique se você está acessando a instância de dentro da nuvem privada virtual (VPC) e se seus grupos de segurança permitem o acesso a você.