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

# Neptune 인스턴스의 상태 확인
<a name="access-graph-status"></a>

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

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

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

또한 [엔진 릴리스 1.2.1.0.R6](engine-releases-1.2.1.0.R6.md)부터는 다음 CLI 명령을 대신 사용할 수 있습니다.

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

인스턴스의 상태가 양호하면 `status` 명령에서 다음 필드에 [JSON 객체](#access-graph-status-sample-output)를 반환합니다.
+ **`status`**   –   인스턴스에 문제가 발생하지 않는 경우 `"healthy"`로 설정합니다.

  인스턴스가 충돌로부터 복구 중이거나 재부팅 중이며 최근 서버 중단으로부터 실행 중인 활성 트랜잭션이 있으면 `status`가 `"recovery"`로 설정됩니다.
+ **`startTime`**   –   현재 서버 프로세스가 시작한 UTC 시간으로 설정합니다.
+ **`dbEngineVersion`**   –   DB 클러스터에서 실행되는 Neptune 엔진 버전으로 설정합니다.

  이 엔진 버전이 릴리스된 이후 수동으로 패치 적용된 경우 버전 번호에 `"Patch-"` 접두사가 붙습니다.
+ **`role`**   –   인스턴스가 읽기 전용 복제본인 경우 `"reader"`로 설정하고 인스턴스가 기본 인스턴스인 경우 `"writer"`로 설정합니다.
+ **`dfeQueryEngine`**   –   [DFE 엔진](neptune-dfe-engine.md)이 완전히 활성화된 경우 `"enabled"`로 설정하거나, `useDFE` 쿼리 힌트가 `true`(기본값 `viaQueryHint`)로 설정된 쿼리에만 DFE 엔진을 사용하는 경우 `viaQueryHint`로 설정합니다.
+ **`gremlin`**   –   클러스터에서 사용할 수 있는 Gremlin 쿼리 언어에 대한 정보가 들어 있습니다. 특히 엔진에서 사용하는 현재 TinkerPop 버전을 지정하는 `version` 필드가 포함되어 있습니다.
+ **`sparql`**   –   클러스터에서 사용할 수 있는 SPARQL 쿼리 언어에 대한 정보가 들어 있습니다. 특히 엔진에서 사용하는 현재 SPARQL 버전을 지정하는 `version` 필드가 포함되어 있습니다.
+ **`opencypher`**   –   클러스터에서 사용할 수 있는 openCypher 쿼리 언어에 대한 정보가 들어 있습니다. 특히 엔진에서 사용하는 현재 openCypher 버전을 지정하는 `version` 필드가 포함되어 있습니다.
+ **`labMode`**   –   엔진에서 사용 중인 [랩 모드](features-lab-mode.md) 설정을 포함합니다. 전체 세트가 아닌 랩 모드 설정의 선택적 목록입니다. 사용 중인 전체 세트는 [클러스터 파라미터 그룹](https://docs.aws.amazon.com//neptune/latest/userguide/parameter-groups.html)을 참조하세요.
+ **`rollingBackTrxCount`**   –   롤백되는 트랜잭션이 있는 경우 이 필드는 해당 트랜잭션 수로 설정됩니다. 없으면 필드가 나타나지 않습니다.
+ **`rollingBackTrxEarliestStartTime`**   –   롤백되고 있는 트랜잭션 중 최초 트랜잭션의 시작 시간으로 설정합니다. 트랜잭션이 롤백되지 않으면 필드가 나타나지 않습니다.
+ **`features`**   –   DB 클러스터에서 활성화된 기능에 대한 상태 정보가 들어 있습니다.
  + **`lookupCache`**   –   [조회 캐시](feature-overview-lookup-cache.md)의 현재 상태입니다. 조회 캐시가 존재할 수 있는 유일한 인스턴스이기 때문에, 이 필드는 `R5d` 인스턴스 유형에만 나타납니다. 필드는 다음 형식의 JSON 객체입니다.

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

    `R5d` 인스턴스에서:
    + 조회 캐시가 활성화된 경우 상태가 `"Available"`로 나열됩니다.
    + 조회 캐시가 비활성화된 경우 상태가 `"Disabled"`로 나열됩니다.
    + 인스턴스의 디스크 한도에 도달한 경우 상태가 `"Read Only Mode - Storage Limit Reached"`로 나열됩니다.
  + **`ResultCache`**   –   [쿼리 결과 캐싱](gremlin-results-cache.md)의 현재 상태입니다. 필드는 다음 형식의 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`**   –   [느린 쿼리 로깅](slow-query-logs.md)이 활성화된 경우 `info` 또는 `debug`와 같으며, 그렇지 않은 경우 `disabled`입니다.
  + **`QueryTimeout`**   –   쿼리 제한 시간 값(밀리초)입니다.
+ **`settings`**   –   인스턴스에 적용된 설정입니다.
  + **`clusterQueryTimeoutInMs`**   –   전체 클러스터에 대해 설정된 쿼리 제한 시간 값(밀리초)입니다.
  + **`SlowQueryLogsThreshold`**   –   전체 클러스터에 대해 설정된 쿼리 제한 시간 값(밀리초)입니다.
+ **`serverlessConfiguration`**   –   클러스터가 서버리스로 실행되는 경우 클러스터의 서버리스 설정입니다.
  + **`minCapacity`**   –   DB 클러스터의 서버리스 인스턴스를 축소할 수 있는 최소 크기(Neptune 용량 단위(NCU))입니다.
  + **`maxCapacity`**   –   DB 클러스터의 서버리스 인스턴스를 확장할 수 있는 최대 크기(Neptune 용량 단위 (NCU))입니다.

## instance status 명령의 출력 예제
<a name="access-graph-status-sample-output"></a>

다음은 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) 내에서 인스턴스에 액세스해야 하며, 보안 그룹에서 이러한 액세스를 허용해야 합니다.