Neptune 인스턴스의 상태 확인 - Amazon Neptune
샘플 출력

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Neptune 인스턴스의 상태 확인

Amazon Neptune은 호스트에서 그래프 데이터베이스의 상태를 확인하는 메커니즘을 제공합니다. 인스턴스에 연결할 수 있는지를 확인하는 방법도 됩니다.

curl을 사용하여 인스턴스의 상태를 확인하고 DB 클러스터 상태를 가져오려면:

curl -G https://your-neptune-endpoint:port/status

또는 엔진 릴리스 1.2.1.0.R6부터 다음 명령을 대신 사용할 수 있습니다. CLI 

aws neptunedata get-engine-status

인스턴스가 정상인 경우 status 명령은 다음 필드가 있는 JSON 객체를 반환합니다.

  • status   –   인스턴스에 문제가 발생하지 않는 경우 "healthy"로 설정합니다.

    인스턴스가 충돌로부터 복구 중이거나 재부팅 중이며 최근 서버 중단으로부터 실행 중인 활성 트랜잭션이 있으면 status가 "recovery"로 설정됩니다.

  • startTime – 현재 서버 프로세스가 시작된 UTC 시간으로 설정합니다.

  • dbEngineVersion   –   DB 클러스터에서 실행되는 Neptune 엔진 버전으로 설정합니다.

    이 엔진 버전이 릴리스된 이후 수동으로 패치 적용된 경우 버전 번호에 "Patch-" 접두사가 붙습니다.

  • role   –   인스턴스가 읽기 전용 복제본인 경우 "reader"로 설정하고 인스턴스가 기본 인스턴스인 경우 "writer"로 설정합니다.

  • dfeQueryEngine – DFE 엔진이 완전히 활성화된 "enabled" 경우 로 설정하고, useDFE 쿼리 힌트가 true (viaQueryHint 기본값)로 설정된 쿼리에서만 DFE 엔진을 사용하는 viaQueryHint 경우 로 설정합니다.

  • gremlin   –   클러스터에서 사용할 수 있는 Gremlin 쿼리 언어에 대한 정보가 들어 있습니다. 특히 엔진에서 사용 중인 현재 TinkerPop 버전을 지정하는 version 필드가 포함되어 있습니다.

  • sparql - 클러스터에서 사용할 수 있는 SPARQL 쿼리 언어에 대한 정보를 포함합니다. 특히 엔진에서 사용 중인 현재 SPARQL 버전을 지정하는 version 필드가 포함되어 있습니다.

  • opencypher - 클러스터에서 사용할 수 있는 openCypher 쿼리 언어에 대한 정보를 포함합니다. 특히 엔진에서 사용 중인 현재 operCypher 버전을 지정하는 version 필드가 포함되어 있습니다.

  • labMode   –   엔진에서 사용 중인 랩 모드 설정을 포함합니다.

  • rollingBackTrxCount   –   롤백되는 트랜잭션이 있는 경우 이 필드는 해당 트랜잭션 수로 설정됩니다. 없으면 필드가 나타나지 않습니다.

  • rollingBackTrxEarliestStartTime   –   롤백되고 있는 트랜잭션 중 최초 트랜잭션의 시작 시간으로 설정합니다. 트랜잭션이 롤백되지 않으면 필드가 나타나지 않습니다.

  • features   –   DB 클러스터에서 활성화된 기능에 대한 상태 정보가 들어 있습니다.

    • lookupCache   –   조회 캐시의 현재 상태입니다. 조회 캐시가 존재할 수 있는 유일한 인스턴스이기 때문에, 이 필드는 R5d 인스턴스 유형에만 나타납니다. 필드는 형식의 JSON 객체입니다.

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

      R5d 인스턴스에서:

      • 조회 캐시가 활성화된 경우 상태가 "Available"로 나열됩니다.

      • 조회 캐시가 비활성화된 경우 상태가 "Disabled"로 나열됩니다.

      • 인스턴스의 디스크 한도에 도달한 경우 상태가 "Read Only Mode - Storage Limit Reached"로 나열됩니다.

    • ResultCache   –   쿼리 결과 캐싱의 현재 상태입니다. 이 필드는 형식의 JSON 객체입니다.

      "ResultCache": {
  "status": "current results cache status"
}

      • 결과 캐시가 활성화된 경우 상태가 "Available"로 나열됩니다.

      • 캐시가 비활성화된 경우 상태가 "Disabled"로 나열됩니다.

    • IAMAuthentication – DB 클러스터에서 AWS Identity and Access Management (IAM) 인증이 활성화되었는지 여부를 지정합니다.

      • IAM 인증이 활성화되면 상태가 로 나열됩니다"enabled".

      • IAM 인증이 비활성화되면 상태가 로 나열됩니다"disabled".

    • Streams   –   DB 클러스터에서 Neptune 스트림이 활성화되었는지 여부를 지정합니다.

      • 스트림이 활성화된 경우 상태가 "enabled"로 나열됩니다.

      • 스트림이 비활성화된 경우 상태가 "disabled"로 나열됩니다.

    • AuditLog   –   감사 로그가 활성화된 경우 enabled이며, 그렇지 않은 경우 disabled입니다.

    • SlowQueryLogs   –   느린 쿼리 로깅이 활성화된 경우 info 또는 debug와 같으며, 그렇지 않은 경우 disabled입니다.

    • QueryTimeout   –   쿼리 제한 시간 값(밀리초)입니다.

  • settings   –   인스턴스에 적용된 설정입니다.

    • clusterQueryTimeoutInMs   –   전체 클러스터에 대해 설정된 쿼리 제한 시간 값(밀리초)입니다.

    • SlowQueryLogsThreshold   –   전체 클러스터에 대해 설정된 쿼리 제한 시간 값(밀리초)입니다.

  • serverlessConfiguration   –   클러스터가 서버리스로 실행되는 경우 클러스터의 서버리스 설정입니다.

    • minCapacity – DB 클러스터의 서버리스 인스턴스가 축소할 수 있는 가장 작은 크기로, Neptune 용량 단위()입니다NCUs.

    • maxCapacity – DB 클러스터의 서버리스 인스턴스가 확장할 수 있는 가장 큰 크기로, Neptune 용량 단위()입니다NCUs.

인스턴스 상태 명령의 출력 예제

다음은 instance status 명령(이 경우에는 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'
  }
}

인스턴스에 문제가 있으면 상태 명령에서 HTTP 500 오류 코드를 반환합니다. 호스트에 도달할 수 없으면 요청 시간이 초과됩니다. 가상 프라이빗 클라우드(VPC) 내에서 인스턴스에 액세스하고 보안 그룹이 인스턴스에 대한 액세스를 허용하는지 확인합니다.