Voici un ensemble de fonctions effectuant un décalage temporel de vos données. Ces fonctions affichent les valeurs de la période correspondante sur le graphique. En elles-mêmes, elles peuvent ne pas avoir une grande valeur, mais combinées avec les valeurs actuelles, elles peuvent fournir des informations utiles sur les performances de votre application.
Timeshift
| Fonction | Rôle | Exemple |
|---|
timeshift() | Créez un graphique des valeurs correspondant à un <TIME_IN_SECOND> arbitraire avant le timestamp actuel de la métrique. | timeshift(<METRIC_NAME>{*}, -<TIME_IN_SECOND>) |
Par exemple, si vous souhaitez vous en servir pour comparer la charge système actuelle avec la charge de deux semaines plus tôt (60 * 60 * 24 * 14 = 1 209 600), utilisez la requête suivante :
timeshift(avg:system.load.1{*}, -1209600)
Décalage de calendrier
| Fonction | Rôle | Exemple |
|---|
calendar_shift() | Représentez graphiquement les valeurs du jour, de la semaine ou du mois précédent à partir de l’horodatage actuel pour la métrique. | calendar_shift(<METRIC_NAME>{*}, "<TIME_SHIFT_STRING>", "<TIME_ZONE_CODE>") |
Pour accéder à la fonction calendar_shift(), cliquez sur le bouton Add function, sélectionnez Timeshift > Month before. Le décalage de calendrier vous permet de comparer la même métrique sur des plages temporelles équivalentes. Vous trouverez ci-dessous un exemple de métrique de coût cloud aws.cost.net.amortized avec la valeur calendar_shift() d’il y a deux semaines comparée à la valeur actuelle.
Les valeurs TIME_SHIFT_STRING valides sont des entiers négatifs suivis de “d” pour les jours, “w” pour les semaines ou “mo” pour les mois.
Quelques exemples sont -1d, -7d, -1mo, -30d et -4w.
Les valeurs TIME_ZONE_CODE valides sont les codes de fuseau horaire IANA pour une ville spécifique, ou UTC.
Par exemple, UTC, America/New_York, Europe/Paris ou Asia/Tokyo.
Heure précédente
| Fonction | Rôle | Exemple |
|---|
hour_before() | Créez un graphique à partir des valeurs d’une heure avant le timestamp actuel de la métrique. | hour_before(<METRIC_NAME>{*}) |
Voici un exemple de system.load.1 avec la valeur hour_before() représentée par une ligne pointillée. Dans cet exemple-ci, on peut voir que le système a été démarré à 6 h 30 et que les valeurs de l’heure précédente hour_before() sont affichées à la marque 7 h 30. Bien sûr, cet exemple a été spécialement pensé pour que les valeurs de hour_before() correspondent aux valeurs réelles.
Jour précédent
La fonctionnalité jour précédent est en cours d'obsolescence. Utilisez plutôt le décalage de calendrier avec une valeur de "-1d".
| Fonction | Rôle | Exemple |
|---|
day_before() | Crée un graphique à partir des valeurs d’un jour avant le timestamp actuel de la métrique. | day_before(<METRIC_NAME>{*}) |
Voici un exemple de nginx.net.connections avec la valeur day_before() représentée par une ligne plus fine. Cet exemple inclut une semaine de données, ce qui permet d’identifier facilement les données de day_before().
Semaine précédente
La fonctionnalité semaine précédente est en cours d'obsolescence. Utilisez plutôt le décalage de calendrier avec une valeur de "-7d".
| Fonction | Rôle | Exemple |
|---|
week_before() | Crée un graphique à partir des valeurs d’une semaine (7 jours) avant le timestamp actuel de la métrique. | week_before(<METRIC_NAME>{*}) |
Voici un exemple de cassandra.db.read_count avec la valeur week_before() représentée par une ligne pointillée. Cet exemple inclut environ trois semaines de données, ce qui permet d’identifier facilement les données de week_before().
Mois précédent
La fonctionnalité mois précédent est en cours d'obsolescence. Utilisez plutôt le décalage de calendrier avec une valeur de "-1mo", "-30d" ou "-4w", selon votre cas d'usage.
| Fonction | Rôle | Exemple |
|---|
month_before() | Crée un graphique à partir des valeurs d’un mois (28 jours/4 semaines) avant le timestamp actuel de la métrique. | month_before(<METRIC_NAME>{*}) |
Voici un exemple de aws.ec2.cpuutilization avec la valeur month_before() représentée par une ligne fine continue.
Autres fonctions
Consultez les autres fonctions disponibles :
Pour aller plus loin
Documentation, liens et articles supplémentaires utiles:
