기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
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 쿼리 언어에 대한 정보가 들어 있습니다. 특히 엔진에서 사용하는 현재 openCypher 버전을 지정하는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 용량 단위(NCU))입니다.maxCapacity– DB 클러스터의 서버리스 인스턴스를 확장할 수 있는 최대 크기(Neptune 용량 단위 (NCU))입니다.
인스턴스 상태 명령의 출력 예제
다음은 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 오류 코드를 반환합니다. 호스트에 도달할 수 없으면 요청 시간이 초과됩니다. Virtual Private Cloud(VPC) 내에서 인스턴스에 액세스해야 하며, 보안 그룹에서 이러한 액세스를 허용해야 합니다.
