Conferir o status de integridade de uma instância do Neptune - Amazon Neptune
Exemplo de saída

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

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, começando com a versão 1.2.1.0.R6 do motor, você pode usar o seguinte comando em vez disso: CLI

aws neptunedata get-engine-status

Se a instância estiver íntegra, o status comando retornará um JSONobjeto 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 a UTC hora em que o processo atual do servidor 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 "enabled" se o DFEmecanismo estiver totalmente ativado ou viaQueryHint se o DFE mecanismo for usado apenas com consultas que tenham a dica de useDFE consulta 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 SPARQL consulta disponível em seu cluster. Especificamente, ele contém um version campo que especifica a SPARQL versão atual que está sendo usada pelo mecanismo.

  • opencypher— Contém informações sobre a linguagem de openCypher consulta disponível em seu cluster. Especificamente, ele contém um version campo que especifica a operCypher versão atual que está sendo usada pelo mecanismo.

  • labMode: contém as configurações Modo de laboratório usadas pelo mecanismo.

  • 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. 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 JSON objeto 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. Esse campo é um JSON objeto no formulário:

      "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 IAM autenticação tiver sido ativada, o status será listado como"enabled".

      • Se a IAM autenticação estiver desativada, 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 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 de saída do comando instance status

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 que você acesse ela.