Surveillance du service Oracle NoSQL Database Cloud

Le service de surveillance pour Oracle Cloud Infrastructure vous permet de surveiller vos ressources en nuage de manière active et passive à l'aide des fonctions Mesures et Alarmes. Le service de surveillance utilise des mesures pour surveiller les ressources et les alarmes afin de vous informer lorsque ces mesures déclenchent celles spécifiées par l'alarme.

Une mesure de l'état, de la capacité ou de la performance d'une ressource donnée. Une alarme est une règle de déclenchement et une interrogation. Les alarmes contrôlent vos ressources en nuage de manière passive, à l'aide des mesures. Vous pouvez configurer les paramètres d'avis lors de la création d'une alarme.

Les mesures sont émises dans le service de surveillance en tant que points de données bruts (paire horodatage-valeur pour une mesure spécifiée) avec les dimensions (identificateur de ressource indiqué dans la définition de la mesure) et les métadonnées. Le service de surveillance publie des messages d'alarme dans les destinations configurées gérées par le service d'avis.

Lors de l'interrogation d'une mesure, le service de surveillance retourne des données agrégées en fonction des paramètres indiqués. Vous pouvez spécifier une plage (comme les dernières 24 heures), une statistique et un intervalle. Une statistique est la fonction d'agrégation appliquée aux points de données bruts. La fonction d'agrégation SUM est un exemple de statistique. Un intervalle est la fenêtre de temps utilisée pour convertir un jeu de points de données bruts donné. Par exemple, 5 minutes.

La console affiche un graphique de surveillance par mesure pour les ressources sélectionnées. Les données agrégées dans chaque graphique reflètent la statistique et l'intervalle sélectionnés. Les demandes d'API peuvent facultativement filtrer par dimension et spécifier une résolution. Les réponses d'API incluent le nom de la mesure ainsi que son compartiment source et son espace de noms de mesure (indique la ressource, le service ou l'application qui émet une mesure). L'espace de noms est fourni dans la définition de mesure. Par exemple, la définition de la mesure CpuUtilization émise par Oracle Cloud liste l'espace de noms de mesure oci_computeagent comme source de la mesure.

Les données des mesures et des alarmes sont accessibles au moyen de la console, de l'interface de ligne de commande et de l'API. Pour plus d'informations sur les concepts du service de surveillance OCI, voir Concepts relatifs au service de surveillance.

Cet article contient les rubriques suivantes :

Mesures du service Oracle NoSQL Database Cloud

Oracle NoSQL Database Cloud Service émet des mesures à l'aide de l'espace de noms de mesure oci_nosql.

Les mesures pour Oracle NoSQL Database Cloud Service comprennent les dimensions suivantes :

Note : L'OCID est un ID unique affecté par Oracle, inclus dans les informations de la ressource, à la fois dans la console et l'API.

Oracle NoSQL Database Cloud Service envoie des mesures au service Oracle Cloud Infrastructure Monitoring. Vous pouvez voir ou créer des alarmes sur ces mesures à l'aide des trousses SDK ou de l'interface de ligne de commande de la console Oracle Cloud Infrastructure.

Tableau - Mesures d'Oracle NoSQL Database Cloud Service

Mesure Nom d'affichage de la mesure Unité Description Dimensions
ReadUnits Unités de lecture Unités Nombre d'unités de lecture utilisées pendant la période. resourceId tableName
WriteUnits Unités d'écriture Unités Nombre d'unités d'écriture utilisées pendant la période. resourceId tableName
StorageGB Taille du stockage Go Volume de stockage maximal utilisé par la table. Comme ces informations sont générées toutes les heures, vous pouvez voir des valeurs obsolètes entre deux points d'actualisation. resourceId tableName
ReadThrottleCount Limitation de lecture Nombre Nombre d'exceptions de limitation de lecture pour cette table pendant la période. resourceId tableName
WriteThrottleCount Limitation d'écriture Nombre Nombre d'exceptions de limitation d'écriture pour cette table pendant la période. resourceId tableName
StorageThrottleCount Limitation de stockage Nombre Nombre d'exceptions de limitation de stockage pour cette table pendant la période. resourceId tableName
MaxShardSizeUsagePercent Utilisation de taille de partition maximale Pourcentage Ratio de l'espace utilisé dans la partition par rapport à l'espace total alloué à la partition. Cette valeur est propre à une table et correspond à la valeur la plus élevée pour toutes les partitions horizontales. resourceId tableName
Replica Lag Décalage par rapport à la réplique Milliseconde Décalage temporel lors de la réplication des modifications de données d'une table active globale d'une région expéditrice vers une région destinataire. 
resourceId tableName replica

En outre, vous pouvez publier des mesures personnalisées selon vos besoins. Par exemple, vous pouvez configurer des mesures pour saisir la latence des transactions d'application (temps passé par transaction terminée), puis reporter ces données dans le service de surveillance.

Explication des mesures NDCS

Oracle NoSQL Database Cloud Service envoie des mesures au service Oracle Cloud Infrastructure Monitoring.

Unités de lecture :

Nombre d'unités de lecture utilisées pendant la période. Il s'agit du débit jusqu'à 1 Ko de données par seconde pour une opération de lecture avec cohérence à terme. Si vos données sont supérieures à 1 Ko, il faudra plusieurs unités de lecture pour les lire. Le graphique de mesure Unité de lecture pour un tableau est présenté ci-dessous. La mesure est prise toutes les minutes et les graphiques de mesure sont tracés par défaut pendant un intervalle de 5 minutes.

Une description de readmetric.png suit

Description de l'illustration readmetric.png

Unités d'écriture :

Nombre d'unités d'écriture utilisées pendant la période. Il s'agit du débit jusqu'à 1 Ko de données par seconde pour une opération d'écriture. Les opérations d'écriture sont déclenchées lors des opérations d'insertion, de mise à jour et de suppression. Si vos données sont supérieures à 1 Ko, il faudra plusieurs unités de lecture pour les écrire. Le graphique de mesure Unité d'écriture pour une table est présenté ci-dessous. La mesure est prise toutes les minutes et les graphiques de mesure sont tracés par défaut pendant un intervalle de 5 minutes.

Une description de writemetric.png suit

Description de l'illustration writemetric.png

StockageGo :

Volume de stockage maximal utilisé par la table. Le graphique de mesure Stockage pour un tableau est présenté ci-dessous. La mesure est prise toutes les minutes et les graphiques de mesure sont tracés par défaut pendant un intervalle de 5 minutes.

Note : Il faut une heure après la création de la table pour prédéfinir le début du suivi de la taille du stockage. Après l'heure initiale, les statistiques de stockage sont mises à jour toutes les 5 minutes.

Une description de storagemetric.png suit

Description de l'illustration storagemetric.png

Note : La mesure de stockage en Go est tronquée. Par conséquent, l'utilisation du stockage de moins de 1 Go sera affichée avec la valeur 0. Le graphique commence à afficher le stockage lorsque l'utilisation est supérieure à 1 Go.

ReadThrottleCount :

Cela donne un nombre d'exceptions de limitation de lecture sur la table indiquée au cours de la période. Une exception de limitation indique généralement que le débit de lecture provisionné a été dépassé. Si vous les obtenez fréquemment, vous devriez envisager d'augmenter les unités de lecture sur votre table. Le graphique de mesure du nombre de limitations de lecture pour une table est présenté ci-dessous. La mesure est prise toutes les minutes et les graphiques de mesure sont tracés par défaut pendant un intervalle de 5 minutes.

Une description de readthrottlemetric.png suit

Description de l'illustration readthrottlemetric.png

WriteThrottleCount :

Cela donne un nombre d'exceptions de limitation d'écriture sur la table indiquée au cours de la période. Une exception de limitation indique généralement que le débit d'écriture provisionné a été dépassé. Si vous les obtenez fréquemment, vous devriez envisager d'augmenter les unités d'écriture sur votre table. Le graphique de mesure du nombre de limitations d'écriture pour une table est présenté ci-dessous. La mesure est prise toutes les minutes et les graphiques de mesure sont tracés par défaut pendant un intervalle de 5 minutes.

Une description de writeethrottlemetric.png suit

Description de l'illustration writeethrottlemetric.png

StorageThrottleCount :

Cela donne un nombre d'exceptions de limitation du stockage sur la table indiquée au cours de la période. Une exception de limitation indique généralement que la capacité de stockage provisionnée a été dépassée. Si vous les obtenez fréquemment, vous devriez envisager d'augmenter la capacité de stockage de votre table. Le graphique de mesure du nombre de limitations de stockage pour une table est présenté ci-dessous. La mesure est prise toutes les minutes et les graphiques de mesure sont tracés par défaut pendant un intervalle de 5 minutes.

Une description de storagethrottlemetric.png suit

Description de l'illustration storagethrottlemetric.png

Pourcentage MaxShardSizeUsage

Utilisation la plus élevée d'espace dans une partition horizontale pour une table spécifique, en pourcentage de l'espace utilisé dans cette partition horizontale.

Note : Oracle NoSQL Database Cloud Service applique un hachage de clés aux partitions horizontales pour assurer la distribution sur un ensemble de noeuds de stockage qui fournissent du stockage pour les tables. Bien que vous ne puissiez pas les voir directement, les tables Oracle NoSQL Database Cloud Service sont partitionnées horizontalement et répliquées pour assurer la disponibilité et la performance. Une clé de partition correspond à 100 % à la clé primaire ou est un sous-ensemble de la clé primaire. Tous les enregistrements partageant une clé de partition sont colocalisés pour atteindre la localisation des données.

Lorsque maxShardSizeUsagepercent atteint 100, vous ne pouvez plus effectuer d'opération d'écriture dans la table. Vous devez augmenter la capacité de stockage pour effectuer une écriture dans la table. Cette mesure permet de déterminer si un hotspot de stockage existe pour votre table NoSQL.

Ce scénario se produit en raison d'un déséquilibre dans la façon dont les données de la table sont stockées dans les partitions horizontales. Un déséquilibre peut se produire lorsqu'une majorité des données de la table est stockée dans un sous-ensemble des partitions horizontales. Le stockage dans une base de données NoSQL est partitionné et la clé de partition fait partie de la définition de la table. Dans les tables hiérarchiques, les tables parent et enfant partagent la même clé de partition. Si vous avez une table parent avec des tables enfants, tous les enregistrements partagent la même clé de partition. Ainsi, toutes ces données seront stockées ensemble. Si une table parent a moins d'enfants, elle occupe moins d'espace de stockage dans une seule partition horizontale. En raison de ce déséquilibre, certaines partitions peuvent contenir beaucoup plus de données que d'autres.

À un certain point, une partition horizontale a l'utilisation la plus élevée d'espace pour une table spécifique et le pourcentage utilisé dans cette partition horizontale est le pourcentage MaxShardSizeUsagePercent. Le graphique de mesure maxShardSizeUsagepercent pour une table est affiché ci-dessous. La mesure est prise toutes les minutes et les graphiques de mesure sont tracés par défaut pendant un intervalle de 5 minutes.

Une description de maxshardusageprct.png suit

Description de l'illustration maxshardusageprct.png

En plus de consulter le graphique d'une mesure, vous disposez des options suivantes.

Une description de metric-options.png suit

Description de l'illustration metric-options.png

Vous pouvez obtenir la vue de table pour vérifier la valeur d'une mesure à un moment donné.

Une description de tableview.png suit

Description de l'illustration tableview.png

Surveiller la mesure MaxShardSizeUsagePercent

Vous devez surveiller périodiquement ce graphique pour savoir si maxShardSizeUsagepercent est atteint ou non. Vous pouvez créer de manière proactive une alarme pour cette mesure.

Une description de new-alarm-crt-1.png suit

Description de l'illustration new-alarm-crt-1.png

C'est-à-dire que vous devez déclencher une alarme lorsque la mesure atteint une valeur particulière, par exemple 90 %.

Une description de new-alarm-crt-2.png suit

Description de l'illustration new-alarm-crt-2.png

L'alarme OCI utilise le service d'avis OCI pour envoyer des avis. Habituellement, l'alarme est configurée pour envoyer des notifications par courrier électronique configuré. Lorsque maxShardSizeUsagepercent atteint 90 %, un avis par courriel est envoyé.

Une description de new-alarm-crt-3.png suit

Description de l'illustration new-alarm-crt-3.png

Pour plus de détails, voir Gestion des alarmes et des avis.

Lorsqu'il y a un déséquilibre dans la façon dont vos données de table sont réparties entre les partitions horizontales, vous ne pourrez pas utiliser la capacité de stockage allouée à votre table à son maximum. Dans ce scénario, maxShardSizeUsagepercent atteint la valeur 100, même sans utiliser l'ensemble du stockage affecté à la table. Vous devez maintenant ajouter plus de stockage pour continuer à écrire sur votre table. Ce scénario peut être évité en suivant certaines directives lors de la conception de votre table.

Décalage par rapport à la réplique

Décalage dans la réplication des modifications de données (INSERT/UPDATE ou DELETE) d'une table active globale d'une région d'expéditeur vers une région de destinataire. L'opération d'écriture qui s'est produite dans la région expéditrice d'une table active globale est reflétée dans la région destinataire après un décalage temporel. Les informations sur le décalage temporel sont exprimées sous la forme d'une mesure appelée décalage de réplique. Le décalage de réplique est une mesure de l'actualité des données de la table dans la région de réplication du destinataire, par rapport aux données de la table de la région de l'expéditeur. Le décalage de la réplique indique que la table de la région destinataire n'a pas encore reçu de mises à jour de la région expéditrice qui s'est produite pendant la période de décalage. S'il n'y a pas eu d'écritures d'application pour la table dans la région expéditrice, le service utilise les mécanismes ping pour calculer une approximation du décalage, et la statistique de décalage sera toujours disponible dans la région destinataire.

Obtenir des informations sur le décalage de la réplique :

Dans la région récepteur, cliquez sur votre table Global Active et affichez les informations de la table. Sous Ressources, cliquez sur Mesures. Vous voyez une mesure, Délai de réplique, qui affiche le décalage de réplication en millisecondes. Dans l'exemple de graphique ci-dessous, vous voyez que la mesure Replica Lag est prise dans la région Canada - Sud-Est (Toronto) qui est la région destinataire. Cette table active globale comporte deux répliques de table régionale chacune dans les régions Canada - Sud-Est (Montréal) et États-Unis - Est (Ashburn). Vous voyez que le graphique comporte deux lignes chacune pour ces répliques de table régionales à Montréal et à Ashburn.

Dans le graphique ci-dessous, l'intervalle indique la fenêtre de temps utilisée pour tracer le graphique. Différentes options d'intervalle sont disponibles : 1 minute, 5 minutes, 1 heure et 1 jour. Par défaut, le décalage de la réplique est surveillé toutes les 1 minute et le graphique est tracé toutes les 5 minutes. Vous pouvez sélectionner des statistiques différentes pour la mesure Décalage de réplique.

Exemple 1 : Décalage de réplique avec Canada - Sud-Est (Toronto) comme région destinataire et Canada - Sud-Est (Montréal) et États-Unis - Est (Ashburn) comme régions expéditrices.

Le graphique ci-dessous est tracé pour la statistique Moyenne pendant un intervalle de 5 minutes.

Une description de metric_replica2.png suit

Description de l'illustration metric_replica2.png

Dans cet exemple, Montréal et Ashburn sont deux régions expéditrices et Toronto est la région destinataire où la mesure est capturée. Considérez la valeur de Replica Lag à 12:25 UTC pour Montréal. C'est 2020 millisecondes. Cela signifie que la région destinataire Canada Sud-Est (Toronto) n'a pas reçu les mises à jour qui se sont produites dans la région expéditrice Canada Sud-Est (Montréal) au cours des dernières millisecondes 2020. De même, considérez la valeur du décalage de réplique à 12:25 UTC pour Ashburn. C'est 2954 millisecondes. Cela signifie que la région destinataire Canada Sud-Est (Toronto) n'a pas reçu les mises à jour qui se sont produites dans la région expéditrice US Est (Ashburn) au cours des dernières 2954 millisecondes.

Exemple 2 : Décalage de réplique avec US East (Ashburn) comme région destinataire et Canada Southeast (Montréal) et Canada Southeast Toronto comme régions expéditrices.

Dans cet exemple, Montréal et Toronto sont deux régions expéditrices et Ashburn est la région destinataire où la mesure est capturée.

Une description de metric_replica3.png suit

Description de l'illustration metric_replica3.png

Exemple 3 : Décalage de réplique avec Canada - Sud-Est (Montréal) en tant que région destinataire et États-Unis - Est (Ashburn) et Canada - Sud-Est Toronto en tant que régions expéditrices.

Dans cet exemple, Ashburn et Toronto sont deux régions expéditrices et Montréal est la région destinataire où la mesure est capturée.

Une description de metric_replica1.png suit

Description de l'illustration metric_replica1.png

En plus d'afficher le graphique du décalage de réplique, vous disposez des options suivantes.

Une description de metric_options.png suit

Description de l'illustration metric_options.png

Vous pouvez obtenir la vue de table pour vérifier la valeur du décalage de réplique à un moment donné.

Une description de tabview_toronto.png suit

Description de l'illustration tabview_toronto.png

Affichage ou liste des mesures Oracle NoSQL Database Cloud Service

Vous pouvez voir les mesures disponibles pour Oracle NoSQL Database Cloud Service à partir de la console. De plus, vous pouvez obtenir la liste des mesures disponibles pour Oracle NoSQL Database Cloud Service à l'aide des commandes de l'interface de ligne de commande OCI.

  1. Ouvrez le menu de navigation et cliquez sur Observabilité et gestion. Sous Service de surveillance, cliquez sur Mesures de service.

  2. Sélectionnez le compartiment et l'espace de noms de mesure (oci_nosql).

À partir de Cloud Shell, exécutez la commande suivante. Il retourne les définitions de mesure qui correspondent aux critères spécifiés dans la demande. OCID de compartiment requis. Pour plus d'informations sur les OPTIONS disponibles avec la commande de liste, voir Mesures de liste.

oci monitoring metric list --compartment-id <Compartment_OCID> --namespace oci_nosql

Par exemple :

oci monitoring metric list --compartment-id ocid1.compartment.oc1..aaaaaaaawrmvqjzoegxbsixp5k3b5554vlv2kxukobw3drjho3f7nf5ca3ya --namespace oci_nosql

Exemple de réponse :

{
  "data": [
    {
      "compartment-id": "ocid1.compartment.oc1..aaaaaaaawrmvqjzoegxbsixp5k3b5554vlv2kxukobw3drjho3f7nf5ca3ya",
      "dimensions": {
        "resourceId": "ocid1_nosqltable_oc1_phx_amaaaaaau7x7rfyasvdkoclhgryulgzox3nvlxb2bqtlxxsrvrc4zxr6lo4a",
        "tableName": "demo"
      },
      "name": "ReadThrottleCount",
      "namespace": "oci_nosql",
      "resource-group": null
    },
    {
      "compartment-id": "ocid1.compartment.oc1..aaaaaaaawrmvqjzoegxbsixp5k3b5554vlv2kxukobw3drjho3f7nf5ca3ya",
      "dimensions": {
        "resourceId": "ocid1_nosqltable_oc1_phx_amaaaaaau7x7rfyasvdkoclhgryulgzox3nvlxb2bqtlxxsrvrc4zxr6lo4a",
        "tableName": "demo"
      },
      "name": "ReadUnits",
      "namespace": "oci_nosql",
      "resource-group": null
    },
    {
      "compartment-id": "ocid1.compartment.oc1..aaaaaaaawrmvqjzoegxbsixp5k3b5554vlv2kxukobw3drjho3f7nf5ca3ya",
      "dimensions": {
        "resourceId": "ocid1_nosqltable_oc1_phx_amaaaaaau7x7rfyasvdkoclhgryulgzox3nvlxb2bqtlxxsrvrc4zxr6lo4a",
        "tableName": "demo"
      },
      "name": "StorageGB",
      "namespace": "oci_nosql",
      "resource-group": null
    },
    {
      "compartment-id": "ocid1.compartment.oc1..aaaaaaaawrmvqjzoegxbsixp5k3b5554vlv2kxukobw3drjho3f7nf5ca3ya",
      "dimensions": {
        "resourceId": "ocid1_nosqltable_oc1_phx_amaaaaaau7x7rfyasvdkoclhgryulgzox3nvlxb2bqtlxxsrvrc4zxr6lo4a",
        "tableName": "demo"
      },
      "name": "StorageThrottleCount",
      "namespace": "oci_nosql",
      "resource-group": null
    },
    {
      "compartment-id": "ocid1.compartment.oc1..aaaaaaaawrmvqjzoegxbsixp5k3b5554vlv2kxukobw3drjho3f7nf5ca3ya",
      "dimensions": {
        "resourceId": "ocid1_nosqltable_oc1_phx_amaaaaaau7x7rfyasvdkoclhgryulgzox3nvlxb2bqtlxxsrvrc4zxr6lo4a",
        "tableName": "demo"
      },
      "name": "WriteThrottleCount",
      "namespace": "oci_nosql",
      "resource-group": null
    },
    {
      "compartment-id": "ocid1.compartment.oc1..aaaaaaaawrmvqjzoegxbsixp5k3b5554vlv2kxukobw3drjho3f7nf5ca3ya",
      "dimensions": {
        "resourceId": "ocid1_nosqltable_oc1_phx_amaaaaaau7x7rfyasvdkoclhgryulgzox3nvlxb2bqtlxxsrvrc4zxr6lo4a",
        "tableName": "demo"
      },
      "name": "WriteUnits",
      "namespace": "oci_nosql",
      "resource-group": null
    }
  ]
}

Comment collecter les mesures d'Oracle NoSQL Database Cloud Service?

Vous pouvez créer des interrogations de mesure pour collecter des jeux de mesures spécifiques (données agrégées). Une interrogation de mesure contient l'expression MQL ( Monitoring Query Language) à évaluer pour retourner des données agrégées. L'interrogation doit spécifier une mesure, une statistique et un intervalle.

Vous pouvez utiliser des interrogations de mesure pour surveiller activement et passivement vos ressources en nuage. Surveillez activement avec des interrogations de mesure que vous générez spontanément à la demande. Dans la console, mettez à jour un graphique pour afficher les données de plusieurs interrogations. Stockez les interrogations à réutiliser. Surveillez de manière passive à l'aide d'alarmes qui ajoutent une condition ou une règle de déclencheur à une interrogation de mesure.

Syntaxe de l'interrogation de mesure :

metric[interval] {dimensionname=dimensionvalue}.groupingfunction.statistic

Syntaxe de l'interrogation d'alarme de seuil :

metric[interval]{dimensionname=dimensionvalue}.groupingfunction.statistic alarmoperator alarmvalue

Pour les valeurs de paramètre prises en charge, voir Informations de référence sur MQL (Monitoring Query Language).

Exemples d'interrogations Interrogation de mesure simple

Somme des nombres de limitations de stockage pour toutes les tables d'un compartiment à un intervalle d'une minute.

Nombre de lignes affichées dans le graphique de mesure (console) : 1 par table.

StorageThrottleCount[1m].sum()

Interrogation de mesure filtrée

Somme des nombres de gazouillis de stockage dans un compartiment à un intervalle d'une minute, filtrée sur une seule table.

Nombre de lignes affichées dans le graphique de mesure (console) : 1 par table.

StorageThrottleCount[1m]{tableName = "demoKeyVal"}.sum()

Interrogation de mesure agrégée

Moyenne agrégée des opérations de lecture à un intervalle de soixante minutes, filtrée sur un compartiment, agrégée pour la moyenne.

Nombre de lignes affichées dans le graphique de mesure (console) : 1 par table.

ReadUnits[60m]{compartmentId="ocid1.compartment.oc1.phx..exampleuniqueID"}.grouping().mean()

Interrogation de mesure agrégée par groupe

Moyenne agrégée du nombre de limitations de lecture par unité de lecture à un intervalle de soixante minutes, filtrée sur une seule table d'un compartiment.

Le nombre de lignes affichées dans le graphique de mesure (console) : 1 par unité de lecture.

ReadThrottleCount[60m]{tableName = "demoKeyVal"}.groupBy(ReadUnits).mean()

Création d'une interrogation de mesure

Il existe deux façons de créer une interrogation de mesure. Vous pouvez créer une interrogation à l'aide de la console ou de la commande d'interface de ligne de commande OCI.

  1. Ouvrez le menu de navigation et cliquez sur Observabilité et gestion. Sous Service de surveillance, cliquez sur explorateur de mesures.

    La page explorateur de mesures affiche un graphique vide avec des champs pour créer une interrogation.

  2. Remplissez les champs pour une nouvelle interrogation.

    • Compartiment : Compartiment contenant les tables Oracle NoSQL Database Cloud Service que vous voulez surveiller. Par défaut, le premier compartiment accessible est sélectionné.

    • Espace de noms de mesure : Oracle NoSQL Database Cloud Service émet des mesures pour les tables que vous voulez surveiller. Exemple : oci_nosql.

    • Groupe de ressources (facultatif) : Groupe auquel la mesure appartient. Un groupe de ressources est une chaîne personnalisée fournie avec une mesure personnalisée. Ne s'applique pas aux mesures de service.

    • Nom de mesure : Nom de la mesure. Une seule mesure peut être spécifiée. Les sélections de mesure dépendent du compartiment et de l'espace de noms de mesure sélectionnés. Exemple : ReadUnits

    • intervalle : fenêtre d'agrégation.

    • Statistique : Fonction d'agrégation.

    • D dimensions de mesure : Filtres facultatifs pour limiter les données de mesure évaluées.

      • Champs de dimension : Pour les mesures d'Oracle NoSQL Database Cloud Service, vous pouvez sélectionner resourceId ou tableName comme paire nom de dimension et valeur de dimension.

    • Agréger les flux de mesures : Trace une seule ligne dans le graphique de mesures pour représenter la valeur combinée de tous les flux de mesures pour la statistique sélectionnée.

  3. Cliquez sur Modifier le graphique.

    Le graphique affiche les résultats de la nouvelle interrogation. Des valeurs très faibles ou élevées sont indiquées par le Système International d'Unités (unités SI), telles que M pour méga (10 à la sixième puissance). Les unités correspondent à la mesure sélectionnée et ne sont pas modifiées selon la statistique.

  4. Pour voir l'interrogation sous forme d'expression MQL (Monitoring Query Language), sélectionnez Mode avancé.

À partir de Cloud Shell, exécutez la commande suivante. Elle renvoie les données agrégées qui correspondent aux critères spécifiés dans la demande. OCID de compartiment requis.

oci monitoring metric-data summarize-metrics-data --compartment-id<Compartment_OCID> --namespace oci_nosql --query-text [text]

--query-text est l'expression MQL (Monitoring Query Language) à utiliser lors de la recherche de points de données de mesure à agréger. L'interrogation doit spécifier une mesure, une statistique et un intervalle. Valeurs prises en charge pour l'intervalle : 1m-60m (également 1h). Vous pouvez éventuellement spécifier des dimensions et des fonctions de regroupement. Fonctions de regroupement prises en charge : grouping(), groupBy(). Pour plus d'informations sur les OPTIONS disponibles avec la commande summary-metrics-data, voir Résumer les données de mesure. Dans l'exemple ci-dessous, nous créons une interrogation de mesure filtrée pour obtenir la somme des unités de lecture d'un compartiment à un intervalle d'une minute, filtrée sur une seule table.

Par exemple :

oci monitoring metric-data summarize-metrics-data --compartment-id ocid1.compartment.oc1..aaaaaaaawrmvqjzoegxbsixp5k3b5554vlv2kxukobw3drjho3f7nf5ca3ya
--namespace oci_nosql --query-text 'ReadUnits[1m]{tableName="articles"}.sum()'

Exemple de réponse :

{
  "data": [
    {
      "aggregated-datapoints": [
        {
          "timestamp": "2022-02-17T11:03:00+00:00",
          "value": 0.0
        },
        {
          "timestamp": "2022-02-17T11:04:00+00:00",
          "value": 0.0
        },
        {
          "timestamp": "2022-02-17T11:05:00+00:00",
          "value": 0.0
        },

        ...
        ...
        ...

        {
          "timestamp": "2022-02-17T13:59:00+00:00",
         "value": 0.0
        },
        {
          "timestamp": "2022-02-17T14:00:00+00:00",
          "value": 0.0
        },
        {
          "timestamp": "2022-02-17T14:01:00+00:00",
          "value": 0.0
        }
      ],
      "compartment-id": "ocid1.compartment.oc1..aaaaaaaawrmvqjzoegxbsixp5k3b5554vlv2kxukobw3drjho3f7nf5ca3ya",
      "dimensions": {
        "resourceId": "ocid1_nosqltable_oc1_phx_amaaaaaau7x7rfyav7f67yuj3t2q6rk7lp2a2obfdxa6hg2ho2ea7qabin4q",
        "tableName": "demo"
      },
      "metadata": {},
      "name": "ReadUnits",
      "namespace": "oci_nosql",
      "resolution": null,
      "resource-group": null
    }
  ]
}

Création d'alarmes

Vous pouvez créer une alarme qui évalue l'interrogation d'alarme et envoie un avis lorsque l'alarme est à l'état de déclenchement, ainsi que d'autres propriétés d'alarme. Lorsqu'elle est déclenchée, une alarme envoie un message d'alarme au sujet configuré (dans le service d'avis), qui envoie ensuite le message à tous les abonnements du sujet. Slack, Email, SMS et PagerDuty sont quelques-uns des exemples de sujet configuré dans les avis.

Lorsqu'ils sont configurés, les avis répétés vous rappellent l'état de déclenchement continu à l'intervalle de répétition configuré. Vous êtes également avisé lorsqu'une alarme retourne à l'état OK ou lorsqu'elle est réinitialisée.

Une interrogation d'alarme contient l'expression MQL ( Monitoring Query Language) à évaluer pour retourner des données agrégées. L'interrogation doit spécifier une mesure, une statistique et un intervalle.

Il existe deux façons de créer une alarme. Vous pouvez créer une interrogation à l'aide de la console ou de l'interface de ligne de commande OCI.

  1. Ouvrez le menu de navigation et cliquez sur Observabilité et gestion. Sous Service de surveillance, cliquez sur Définition d'alarmes.

  2. Cliquez sur Créer une alarme.

    Note : Vous pouvez également créer une alarme à partir d'une interrogation prédéfinie dans la page Mesures de service. Développez Options et cliquez sur Create an Alarm on this Query. Pour plus d'informations sur les mesures du service, voir Consultation ou liste des mesures Oracle NoSQL Database Cloud Service.

  3. Dans la page Créer une alarme, sous Définir une alarme, spécifiez ou mettez à jour les paramètres d'alarme. Pour passer du mode de base au mode avancé, cliquez sur Passer en mode avancé ou Passer en mode de base (à droite de Définir l'alarme) :

    • Nom de l'alarme : Nom convivial de la nouvelle alarme. Ce nom est envoyé en tant que titre des avis liés à cette alarme. Évitez d'entrer des informations confidentielles.

    • Sommaire de l'alarme : Entrez un sommaire convivial pour la nouvelle alarme. Ce champ est facultatif.

    • Marqueurs (facultatif) : Si vous avez l'autorisation de créer une ressource, vous avez également l'autorisation d'appliquer des marqueurs à structure libre à cette ressource. Pour appliquer un marqueur défini, vous devez être autorisé à utiliser l'espace de noms de marqueur. Pour plus d'informations sur le marquage, voir Marqueurs de ressource. Si vous ne savez pas si vous devez appliquer des marqueurs, ignorez cette option (vous pourrez appliquer des marqueurs plus tard) ou demandez à l'administrateur.

      Note : Cliquez sur Afficher les options avancées au bas de la page pour accéder aux options de marqueur.

    • Description de la mesure : La mesure à évaluer pour la condition d'alarme.

      • Compartiment : Compartiment contenant les tables Oracle NoSQL Database Cloud Service que vous voulez surveiller. Par défaut, le premier compartiment accessible est sélectionné.

      • Espace de noms de mesure : Oracle NoSQL Database Cloud Service émet des mesures pour les tables que vous voulez surveiller. Exemple : oci_nosql.

      • Groupe de ressources (facultatif) : Groupe auquel la mesure appartient. Un groupe de ressources est une chaîne personnalisée fournie avec une mesure personnalisée. Ne s'applique pas aux mesures de service.

      • Nom de mesure : Nom de la mesure. Une seule mesure peut être spécifiée. Les sélections de mesure dépendent du compartiment et de l'espace de noms de mesure sélectionnés. Exemple : ReadUnits

      • intervalle : fenêtre d'agrégation.

      • Statistique : Fonction d'agrégation.

      • Dimensions de mesure : Filtres facultatifs pour limiter les données de mesure évaluées.

        • Champs de dimension : Pour les mesures d'Oracle NoSQL Database Cloud Service, vous pouvez sélectionner resourceId ou tableName comme paire nom de dimension et valeur de dimension.

    • Agréger les flux de mesures : Trace une seule ligne dans le graphique de mesures pour représenter la valeur combinée de tous les flux de mesures pour la statistique sélectionnée.

    • Règle de déclenchement : Condition devant être satisfaite pour que l'alarme soit en état de déclenchement. La condition peut spécifier un seuil, par exemple 90 % pour StorageGB.

      • Opérateur : Opérateur utilisé dans le seuil de la condition.

      • Valeur : Valeur à utiliser pour le seuil de la condition.

      • Délai de déclenchement en minutes : Nombre de minutes pendant lequel la condition doit être maintenue avant que l'alarme soit à l'état de déclenchement.

      • Gravité de l'alarme : Type perçu de réponse obligatoire lorsque l'alarme est en état de déclenchement.

      • Corps de l'alarme : Contenu lisible de l'avis transmis. Oracle recommande de fournir des conseils aux opérateurs pour résoudre la condition d'alarme. Exemple : "High Read Throttle Count".

  4. Pour modifier la vue des résultats de l'interrogation, cliquez sur l'option appropriée au-dessus des résultats, à droite :

    • Afficher la table de données : Liste les points de données, en indiquant l'horodatage et les octets pour chacun.

    • Afficher le graphique (par défaut) : Trace les points de données sur un graphique.

  5. Configurer les avis : Sous Avis, remplissez les champs.

    • Destinations : Rubrique à utiliser pour les avis.

    • Renvoyer l'avis? : Lorsque l'alarme est à l'état de déclenchement, renvoie les avis selon l'intervalle spécifié.

    • Fréquence des avis : Période d'attente avant de renvoyer l'avis.

    • Supprimer les avis : Configurez une fenêtre de suppression pendant laquelle les évaluations et les avis sont suspendus. Utile pour éviter les avis d'alarme lors des périodes de maintenance du système.

  6. Si vous souhaitez désactiver la nouvelle alarme, désélectionnez Activer cette alarme?

  7. Cliquez sur enregistrer l'alarme.

À partir de Cloud Shell, exécutez la commande suivante pour créer une nouvelle alarme dans le compartiment spécifié. OCID de compartiment requis.

oci monitoring alarm create --compartment-id <Compartment_OCID> --namespace oci_nosql --query-text [text] --destinations [complex type] --display-name [text] --is-enabled [boolean] --metric-compartment-id [text] --severity [text]

--query-text est l'expression MQL (Monitoring Query Language) à utiliser lors de la recherche de points de données de mesure à agréger. L'interrogation doit spécifier une mesure, une statistique et un intervalle. Valeurs prises en charge pour l'intervalle : 1m-60m (également 1h). Vous pouvez éventuellement spécifier des dimensions et des fonctions de regroupement. Fonctions de regroupement prises en charge : grouping(), groupBy(). Pour plus d'informations sur les OPTIONS disponibles avec la commande de création d'alarme, voir créer - alarme. Dans l'exemple ci-dessous, nous créons une alarme avec interrogation d'alarme lorsque 90 centile de StorageGB est supérieur à 85 dans un compartiment à un intervalle d'une minute, filtré sur une seule table.

Exemple d'alarme de seuil :

oci monitoring alarm create --compartment-id ocid1.compartment.oc1..aaaaaaaawrmvqjzoegxbsixp5k3b5554vlv2kxukobw3drjho3f7nf5ca3ya
--namespace oci_nosql --query-text 'StorageGB[1m]{tableName="demo"}.groupBy(WriteUnits).percentile(0.9) > 85'
--display-name HighStorageConsumption --metric-compartment-id demonosql --severity Critical --is-enabled true

Gestion des alarmes

Vous pouvez suivre ces directives pour gérer vos alarmes.