Surveillance d'Amazon DocumentDB sans serveur

Pour en savoir plus sur la surveillance dans Amazon DocumentDB, consultez. Surveillance d'Amazon DocumentDB

Mémoire insuffisante : état des paramètres incompatibles

Si l'une de vos instances sans serveur atteint régulièrement la limite de sa capacité maximale, Amazon DocumentDB indique cette condition en définissant l'instance sur le statut de paramètres incompatibles. Pour de plus amples informations, veuillez consulter Éviter les out-of-memory erreurs.

CloudWatch Métriques Amazon pour DocumentDB sans serveur

Pour en savoir plus sur l'utilisation CloudWatch avec Amazon DocumentDB, consultez. Surveillance d'Amazon DocumentDB avec CloudWatch

Vous pouvez consulter vos instances sans serveur CloudWatch pour surveiller la capacité consommée par chaque instance à l'aide de la ServerlessDatabaseCapacity métrique. Vous pouvez également surveiller toutes les CloudWatch métriques DocumentDB standard, telles que DatabaseConnections et les requêtes. Pour obtenir la liste complète des CloudWatch métriques que vous pouvez surveiller pour Amazon DocumentDB, consultez. Surveillance d'Amazon DocumentDB avec CloudWatch Il est important de surveiller les métriques suivantes CloudWatch au niveau de l'instance afin de comprendre comment vos instances sans serveur DocumentDB augmentent ou diminuent. Toutes ces métriques sont calculées toutes les secondes. Ainsi, vous pouvez surveiller l'état actuel de vos instances sans serveur. Vous pouvez définir des alarmes pour vous avertir si une instance sans serveur approche un seuil pour les métriques liées à la capacité. Vous pouvez déterminer si les valeurs de capacité minimale et maximale sont appropriées ou si vous devez les ajuster. Vous pouvez déterminer où concentrer vos efforts pour optimiser l'efficacité de votre base de données.

• ServerlessDatabaseCapacity— En tant que métrique au niveau de l'instance, elle indique le nombre de DCUs représentés par la capacité actuelle de l'instance. En tant que métrique au niveau du cluster, elle représente la moyenne des ServerlessDatabaseCapacity valeurs de toutes les instances sans serveur DocumentDB du cluster.

• DCUUtilization.— Cette métrique est nouvelle dans DocumentDB serverless. Cette valeur est représentée sous forme de pourcentage. Elle est calculée comme la valeur de la ServerlessDatabaseCapacity métrique divisée par la valeur DCU maximale du cluster. Tenez compte des directives suivantes pour interpréter cette métrique et prendre les mesures nécessaires :

  • Si cette métrique s'approche d'une valeur de100.0, l'instance a été agrandie au maximum. Envisagez d'augmenter le paramètre DCU maximal pour le cluster. Ainsi, les instances de rédacteur et de lecteur peuvent augmenter leur capacité.

  • Supposons qu'une charge de travail en lecture seule amène une instance de lecteur à s'approcher d'un DCUUtilization de100.0, alors que l'instance de rédacteur n'est pas proche de sa capacité maximale. Dans ce cas, envisagez d'ajouter des instances de lecteur supplémentaires au cluster. Ainsi, vous pouvez répartir la partie en lecture seule de la charge de travail sur un plus grand nombre d'instances, réduisant ainsi la charge sur chaque instance de lecteur.

  • Supposons que vous exécutiez une application de production, où les performances et la capacité de mise à l’échelle sont les principaux facteurs à prendre en compte. Dans ce cas, vous pouvez définir la valeur DCU maximale pour le cluster sur un nombre élevé. Votre objectif est que la DCUUtilization métrique soit toujours inférieure à 100,0. Avec une valeur DCU maximale élevée, vous pouvez être sûr qu'il y a suffisamment de place en cas de pics inattendus d'activité de la base de données. Seule la capacité de base de données réellement consommée vous est facturée.

• CPUUtilization— Cette métrique est interprétée différemment dans DocumentDB serverless que dans les instances provisionnées. Pour DocumentDB serverless, cette valeur est un pourcentage calculé comme la quantité de processeur actuellement utilisée, divisée par la capacité du processeur disponible sous la valeur DCU maximale du cluster. Amazon DocumentDB surveille automatiquement cette valeur et augmente le dimensionnement de votre instance sans serveur lorsque celle-ci utilise régulièrement une grande partie de sa capacité de processeur.

  Si cette métrique s'approche d'une valeur de100.0, l'instance a atteint sa capacité CPU maximale. Envisagez d'augmenter le paramètre DCU maximal pour le cluster. Si cette métrique se rapproche d'une valeur de 100.0 sur une instance de lecteur, envisagez d'ajouter des instances de lecteur supplémentaires au cluster. Ainsi, vous pouvez répartir la partie en lecture seule de la charge de travail répartie sur un plus grand nombre d'instances, réduisant ainsi la charge sur chaque instance de lecteur.

• FreeableMemory— Cette valeur représente la quantité de mémoire inutilisée disponible lorsque l'instance sans serveur DocumentDB est dimensionnée à sa capacité maximale. Pour chaque DCU dont la capacité actuelle est inférieure à la capacité maximale, cette valeur augmente d'environ 2 GiB. Ainsi, cette métrique n'approche pas zéro tant que l'instance n'est pas agrandie au maximum.

  Si cette métrique est proche de zéro, cela signifie que l'instance a été agrandie autant que possible et qu'elle est proche de la limite de sa mémoire disponible. Envisagez d'augmenter le paramètre DCU maximal pour le cluster. Si cette métrique approche une valeur nulle sur une instance de lecteur, envisagez d'ajouter des instances de lecteur supplémentaires au cluster. Ainsi, la partie en lecture seule de la charge de travail peut être répartie sur un plus grand nombre d'instances, réduisant ainsi l'utilisation de la mémoire sur chaque instance de lecteur.

• TempStorageIops— Le nombre d'IOPS effectuées sur le stockage local attaché à l'instance. Il inclut les E/S par seconde pour les lectures et les écritures. Cette métrique représente un nombre et est mesurée une fois par seconde. Il s'agit d'une nouvelle métrique pour DocumentDB sans serveur. Pour en savoir plus, consultez Surveillance d'Amazon DocumentDB avec CloudWatch.

• TempStorageThroughput— La quantité de données transférée vers et depuis le stockage local associé à l'instance. Cette métrique représente des octets et est mesurée une fois par seconde. Il s'agit d'une nouvelle métrique pour DocumentDB sans serveur. Pour en savoir plus, consultez Surveillance d'Amazon DocumentDB avec CloudWatch.

Généralement, la majeure partie de la mise à l'échelle des instances sans serveur DocumentDB est due à l'utilisation de la mémoire et à l'activité du processeur. Les TempStorageThroughput indicateurs TempStorageIops et peuvent vous aider à diagnostiquer les rares cas où l'activité réseau liée aux transferts entre votre instance et les périphériques de stockage locaux est responsable d'augmentations de capacité inattendues. Pour surveiller d'autres activités du réseau, vous pouvez utiliser ces métriques existantes :

• NetworkReceiveThroughput

• NetworkThroughput

• NetworkTransmitThroughput

• StorageNetworkReceiveThroughput

• StorageNetworkThroughput

• StorageNetworkTransmitThroughput

Comment les CloudWatch métriques sans serveur DocumentDB s'appliquent à votre facture AWS

Les frais sans serveur DocumentDB figurant sur votre AWS facture sont calculés sur la base de la même ServerlessDatabaseCapacity métrique que vous pouvez surveiller. Le mécanisme de facturation peut différer de la CloudWatch moyenne calculée pour cette métrique dans les cas où vous utilisez la capacité sans serveur de DocumentDB pendant une partie d'heure seulement. Cela peut également être différent si des problèmes du système rendent la CloudWatch métrique indisponible pendant de brèves périodes. Ainsi, il se peut que la valeur des heures DCU sur votre facture soit légèrement différente de celle indiquée si vous la calculez vous-même à partir de la valeur moyenne. ServerlessDatabaseCapacity

Exemples de commandes Amazon CloudWatch CLI pour les métriques sans serveur DocumentDB

Les AWS CLI exemples suivants montrent comment surveiller les CloudWatch indicateurs les plus importants liés à DocumentDB sans serveur. Dans chaque cas, remplacez la Value= chaîne du --dimensions paramètre par l'identifiant de votre propre instance sans serveur DocumentDB.

L'exemple Linux suivant affiche les valeurs de capacité minimale, maximale et moyenne d'une instance, mesurées toutes les 10 minutes pendant une heure. Les commandes de date de Linux spécifient les heures de début et de fin par rapport à la date et à l'heure actuelles. La fonction sort_by du paramètre --query trie les résultats par ordre chronologique en fonction du champ Timestamp.

aws cloudwatch get-metric-statistics \
    --metric-name "ServerlessDatabaseCapacity" \
    --start-time "$(date -d '1 hour ago')" \
    --end-time "$(date -d 'now')" \
    --period 600 \
    --namespace "AWS/DocDB" \
    --statistics Minimum Maximum Average \
    --dimensions Name=DBInstanceIdentifier,Value=my_instance \
    --query 'sort_by(Datapoints[*].{min:Minimum,max:Maximum,avg:Average,ts:Timestamp},&ts)' \
    --output table

L'exemple Linux suivant illustre la surveillance de la capacité d'une instance dans un cluster. Il mesure l'utilisation minimale, maximale et moyenne de la capacité d'une instance. Les mesures sont effectuées une fois par heure sur une période de trois heures. Ces exemples utilisent la DCUUtilization métrique représentant un pourcentage de la limite supérieure de DCUs, au lieu de ServerlessDatabaseCapacity représenter un nombre fixe de DCUs. De cette façon, vous n'avez pas besoin de connaître les chiffres réels des valeurs DCU minimales et maximales dans la plage de capacité. Les pourcentages sont compris entre 0 et 100.

aws cloudwatch get-metric-statistics \
    --metric-name "DCUUtilization" \
    --start-time "$(date -d '3 hours ago')" \
    --end-time "$(date -d 'now')" \
    --period 3600 \
    --namespace "AWS/DocDB" \
    --statistics Minimum Maximum Average \
    --dimensions Name=DBInstanceIdentifier,Value=my_instance \
    --query 'sort_by(Datapoints[*].{min:Minimum,max:Maximum,avg:Average,ts:Timestamp},&ts)' \
    --output table

L'exemple Linux suivant effectue des mesures similaires aux précédentes. Dans ce cas, les mesures concernent la métrique CPUUtilization. Les mesures sont effectuées toutes les 10 minutes sur une période d'une heure. Les chiffres représentent le pourcentage du processeur disponible utilisé, en fonction des ressources du processeur disponibles par rapport au paramètre de capacité maximale défini pour l'instance.

aws cloudwatch get-metric-statistics \
    --metric-name "CPUUtilization" \
    --start-time "$(date -d '1 hour ago')" \
    --end-time "$(date -d 'now')" \
    --period 600 \
    --namespace "AWS/DocDB" \
    --statistics Minimum Maximum Average \
    --dimensions Name=DBInstanceIdentifier,Value=my_instance \
    --query 'sort_by(Datapoints[*].{min:Minimum,max:Maximum,avg:Average,ts:Timestamp},&ts)' \
    --output table

L'exemple Linux suivant effectue des mesures similaires aux précédentes. Dans ce cas, les mesures concernent la métrique FreeableMemory. Les mesures sont effectuées toutes les 10 minutes sur une période d'une heure.

aws cloudwatch get-metric-statistics \
    --metric-name "FreeableMemory" \
    --start-time "$(date -d '1 hour ago')" \
    --end-time "$(date -d 'now')" \
    --period 600 \
    --namespace "AWS/DocDB" \
    --statistics Minimum Maximum Average \
    --dimensions Name=DBInstanceIdentifier,Value=my_instance \
    --query 'sort_by(Datapoints[*].{min:Minimum,max:Maximum,avg:Average,ts:Timestamp},&ts)' \
    --output table

Surveillance des performances sans serveur de DocumentDB avec Performance Insights

Vous pouvez utiliser Performance Insights pour surveiller les performances des instances sans serveur de DocumentDB. Pour connaître les procédures relatives à Performance Insights, consultez Surveillance avec Performance Insights.

Les nouveaux compteurs Performance Insights suivants s'appliquent aux instances sans serveur DocumentDB :

• os.general.serverlessDBCapacity— La capacité actuelle de l'instance en DCUs. La valeur correspond à la ServerlessDatabaseCapacity CloudWatch métrique de l'instance.

• os.general.dcuUtilization— Le pourcentage de la capacité actuelle par rapport à la capacité maximale configurée. La valeur correspond à la DCUUtilization CloudWatch métrique de l'instance.

• os.general.maxConfiguredDcu— Capacité maximale que vous avez configurée pour cette instance sans serveur DocumentDB. C'est mesuré en DCUs.

• os.general.minConfiguredDcu— Capacité minimale que vous avez configurée pour cette instance sans serveur DocumentDB. C'est mesuré en DCUs.

Pour obtenir la liste complète des compteurs Performance Insights, consultez Performance Insights pour les contre-métriques.

Lorsque les valeurs de vCPU sont affichées pour une instance sans serveur DocumentDB dans Performance Insights, ces valeurs représentent des estimations basées sur la valeur DCU de l'instance. À l'intervalle par défaut d'une minute, toutes les valeurs vCPU fractionnelles sont arrondies au nombre entier le plus proche. Pour les intervalles plus longs, la valeur vCPU affichée correspond à la moyenne des valeurs entières de vCPU pour chaque minute.