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"になっている場合は に、クエリヒントが true (viaQueryHint がデフォルト) に設定されているuseDFEクエリでのみ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) 内からインスタンスにアクセスし、セキュリティグループがインスタンスへのアクセスを許可していることを確認します。