Vérifier l'état de santé d'une instance Neptune

Amazon Neptune fournit un mécanisme permettant de vérifier l'état de la base de données de graphes sur l'hôte. Il s'agit également d'une bonne solution pour confirmer que vous êtes en mesure de vous connecter à une instance.

Pour vérifier l'état de santé d'une instance à l'aide de curl :

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

Si l'instance est saine, la commande status renvoie les champs suivants :

• status— Défini sur "healthy" si l'instance ne rencontre aucun problème.

  Si l'instance est en cours de restauration suite à un crash ou à un redémarrage et que des transactions actives sont en cours depuis le dernier arrêt du serveur, status est défini sur. "recovery"

• startTime— Réglé sur l'heure UTC à laquelle le processus serveur en cours a commencé.

• dbEngineVersion— Réglez sur la version du moteur Neptune exécutée sur votre cluster de bases de données.

  Si cette version de moteur a été corrigée manuellement depuis sa publication, le numéro de version est préfixé par "Patch-".

• role— Définissez "reader" si l'instance est une réplique en lecture ou "writer" si l'instance est l'instance principale.

• dfeQueryEngine— Défini sur "enabled" si le moteur DFE est complètement activé ou sur viaQueryHint si le moteur DFE est uniquement utilisé pour les requêtes dont l'indice de useDFE requête est défini sur true (viaQueryHintc'est la valeur par défaut).

• gremlin— Contient des informations sur le langage de requête Gkremlin disponible sur votre cluster. Plus précisément, il contient un version champ qui indique la TinkerPop version actuelle utilisée par le moteur.

• sparql— Contient des informations sur le langage de requête SPARQL disponible sur votre cluster. Plus précisément, il contient un version champ qui indique la version actuelle de SPARQL utilisée par le moteur.

• opencypher— Contient des informations sur le langage de requête OpenCypher disponible sur votre cluster. Plus précisément, il contient un version champ qui spécifie la version actuelle d'OperCypher utilisée par le moteur.

• labMode— Contient Mode Lab les paramètres utilisés par le moteur.

• rollingBackTrxCount— Si des transactions sont annulées, ce champ est défini sur le nombre de transactions de ce type. S'il n'y en a pas, le champ n'apparaît pas du tout.

• rollingBackTrxEarliestStartTime— Défini sur l'heure de début de la première transaction annulée. Si aucune transaction n'est annulée, le champ n'apparaît pas du tout.

• features— Contient des informations d'état sur les fonctionnalités activées sur votre cluster de base de données :

  • lookupCache— L'état actuel duCache de recherche. Ce champ n'apparaît que sur les types d'R5dinstances, car ce sont les seules instances où un cache de recherche peut exister. Le champ est un objet JSON sous la forme :

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

    Sur une R5d instance :

    • Si le cache de recherche est activé, l'état est répertorié sous la forme"Available".

    • Si le cache de recherche a été désactivé, l'état est répertorié sous la forme"Disabled".

    • Si la limite de disque a été atteinte sur l'instance, le statut est répertorié sous la forme"Read Only Mode - Storage Limit Reached".

  • ResultCache— L'état actuel duMise en cache des résultats de requête. Ce champ est un objet JSON sous la forme :

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

    • Si le cache des résultats a été activé, l'état est répertorié sous la forme"Available".

    • Si le cache est désactivé, l'état est répertorié sous la forme"Disabled".

  • IAMAuthentication— Spécifie si l'authentification AWS Identity and Access Management (IAM) a été activée ou non sur votre cluster de base de données :

    • Si l'authentification IAM a été activée, le statut est répertorié sous "enabled" la forme.

    • Si l'authentification IAM est désactivée, le statut est répertorié sous "disabled" la forme.

  • Streams— Spécifie si les flux Neptune ont été activés ou non sur votre cluster de base de données :

    • Si les flux sont activés, le statut est répertorié sous la forme"enabled".

    • Si les flux sont désactivés, le statut est répertorié sous la forme"disabled".

  • AuditLog— Identique enabled si les journaux d'audit sont activés ou nondisabled.

  • SlowQueryLogs— Égal à info ou debug si la journalisation lente des requêtes est activée, ou non. disabled

  • QueryTimeout— La valeur, en millisecondes, du délai d'expiration de la requête.

• settings— Paramètres appliqués à l'instance :

  • clusterQueryTimeoutInMs— La valeur, en millisecondes, du délai d'expiration de la requête, défini pour l'ensemble du cluster.

  • SlowQueryLogsThreshold— La valeur, en millisecondes, du délai d'expiration de la requête, défini pour l'ensemble du cluster.

• serverlessConfiguration— Paramètres sans serveur pour un cluster s'il fonctionne en mode sans serveur :

  • minCapacity— La plus petite taille à laquelle une instance sans serveur de votre cluster de base de données peut être réduite, en unités de capacité Neptune (NCU).

  • maxCapacity— La taille maximale à laquelle une instance sans serveur de votre cluster de base de données peut atteindre, exprimée en unités de capacité Neptune (NCU).

Exemple de sortie de la commande instance status

Voici un exemple du résultat de la commande instance status (dans ce cas, exécutée sur une R5d instance) :

{
  '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'
  }
}

S'il y a un problème avec l'instance, la commande de demande de statut renvoie le code d'erreur HTTP 500. Si l'hôte est inaccessible, la demande expire. Assurez-vous que vous accédez à l’instance depuis le Virtual Private Cloud (VPC) et que vos groupes de sécurité vous autorisent l'accès à celui-ci.