Periksa Status Kondisi Instans Neptune

Amazon Neptune menyediakan mekanisme untuk memeriksa status database grafik pada host. Ini juga merupakan cara yang baik untuk mengonfirmasi bahwa Anda dapat terhubung ke sebuah instans.

Untuk memeriksa kesehatan sebuah instans dan mendapatkan status cluster DB menggunakancurl:

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

Atau, dimulai dengan rilis mesin 1.2.1.0.R6, Anda dapat menggunakan perintah CLI berikut sebagai gantinya:

aws neptunedata get-engine-status

Jika instance sehat, status perintah mengembalikan objek JSON dengan bidang berikut:

• status— Atur ke "healthy" jika instance tidak mengalami masalah.

  Jika instance pulih dari crash atau dari reboot dan ada transaksi aktif yang berjalan dari shutdown server terbaru, status diatur ke. "recovery"

• startTime— Atur ke waktu UTC di mana proses server saat ini dimulai.

• dbEngineVersion— Setel ke versi mesin Neptunus yang berjalan di cluster DB Anda.

  Jika versi mesin ini telah di-patch secara manual sejak dirilis, nomor versi diawali dengan "Patch-".

• role— Setel ke "reader" jika instance adalah replika baca, atau "writer" jika instance adalah instance utama.

• dfeQueryEngine— Setel ke "enabled" jika mesin DFE sepenuhnya diaktifkan, atau viaQueryHint jika mesin DFE hanya digunakan dengan kueri yang memiliki petunjuk kueri yang disetel ke true (viaQueryHintadalah default). useDFE

• gremlin— Berisi informasi tentang bahasa query Gremlin yang tersedia di cluster Anda. Secara khusus, ini berisi version bidang yang menentukan TinkerPop versi saat ini yang digunakan oleh mesin.

• sparql— Berisi informasi tentang bahasa query SPARQL yang tersedia di cluster Anda. Secara khusus, ini berisi version bidang yang menentukan versi SPARQL saat ini yang digunakan oleh mesin.

• opencypher— Berisi informasi tentang bahasa query OpenCypher yang tersedia di cluster Anda. Secara khusus, ini berisi version bidang yang menentukan versi OperCypher saat ini yang digunakan oleh mesin.

• labMode— Berisi Mode Lab pengaturan yang digunakan oleh mesin.

• rollingBackTrxCount— Jika ada transaksi yang digulung kembali, bidang ini diatur ke jumlah transaksi tersebut. Jika tidak ada, bidang tidak muncul sama sekali.

• rollingBackTrxEarliestStartTime— Atur ke waktu mulai transaksi paling awal yang digulirkan kembali. Jika tidak ada transaksi yang diputar kembali, bidang tidak muncul sama sekali.

• features— Berisi informasi status tentang fitur yang diaktifkan pada cluster DB Anda:

  • lookupCache   –   Status Cache pencarian saat ini. Bidang ini hanya muncul di tipe instans R5d, karena tipe tersebut adalah satu-satunya instans di mana cache pencarian dapat ada. Bidang ini adalah objek JSON dalam bentuk:

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

    Pada instans R5d:

    • Jika cache pencarian diaktifkan, statusnya terdaftar sebagai "Available".

    • Jika cache pencarian dinonaktifkan, statusnya terdaftar sebagai "Disabled".

    • Jika batas disk telah tercapai pada instans, statusnya terdaftar sebagai "Read Only Mode - Storage Limit Reached".

  • ResultCache   –   Status Hasil kueri cache saat ini. Bidang ini adalah objek JSON dalam bentuk:

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

    • Jika cache hasil telah diaktifkan, status terdaftar sebagai"Available".

    • Jika cache dinonaktifkan, status terdaftar sebagai"Disabled".

  • IAMAuthentication— Menentukan apakah atau tidak AWS Identity and Access Management (IAM) otentikasi telah diaktifkan pada cluster DB Anda:

    • Jika autentikasi IAM diaktifkan, status terdaftar sebagai. "enabled"

    • Jika autentikasi IAM dinonaktifkan, status terdaftar sebagai. "disabled"

  • Streams— Menentukan apakah aliran Neptunus telah diaktifkan pada cluster DB Anda:

    • Jika aliran diaktifkan, status terdaftar sebagai"enabled".

    • Jika aliran dinonaktifkan, status terdaftar sebagai"disabled".

  • AuditLog— Sama dengan enabled jika log audit diaktifkan, atau sebaliknyadisabled.

  • SlowQueryLogs— Sama dengan info atau debug jika pencatatan kueri lambat diaktifkan, atau sebaliknya. disabled

  • QueryTimeout— Nilai, dalam milidetik, dari batas waktu kueri.

• settings— Pengaturan diterapkan pada instance:

  • clusterQueryTimeoutInMs— Nilai, dalam milidetik, dari batas waktu kueri, ditetapkan untuk seluruh cluster.

  • SlowQueryLogsThreshold— Nilai, dalam milidetik, dari batas waktu kueri, ditetapkan untuk seluruh cluster.

• serverlessConfiguration— Pengaturan tanpa server untuk cluster jika berjalan sebagai tanpa server:

  • minCapacity— Ukuran terkecil yang dapat menyusut instance tanpa server di cluster DB Anda, di Unit Kapasitas Neptunus (NCU).

  • maxCapacity— Ukuran terbesar di mana instance tanpa server di cluster DB Anda dapat tumbuh, di Unit Kapasitas Neptunus (NCU).

Contoh output dari perintah status instans

Berikut ini adalah contoh dari output dari perintah status instans, (dalam hal ini, jalankan pada instans 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'
  }
}

Jika ada masalah dengan instans, perintah status mengembalikan kode kesalahan HTTP 500. Jika host tidak terjangkau, permintaan kehabisan waktu. Pastikan bahwa Anda mengakses instans dari dalam virtual private cloud (VPC), dan bahwa grup keamanan Anda memungkinkan Anda mengaksesnya.