compare

Utilisez la commande compare afin de comparer les propriétés générées par la commande link sur les intervalles de comparaison indiqués.

Syntaxe

compare [fields=<field> [,<field>]*] [timeshift = <offset> [size = <size>][count=<int>] | timerange <datetime> to <datetime> [as <new_field_name>], ...]

Paramètres

Le tableau suivant répertorie les paramètres utilisés dans cette commande, ainsi que leur description.

Paramètre Description

offset

<direction><int><timescale> OR auto

Définit la période de comparaison comme un décalage par rapport à la période en cours.

  • auto : le décalage horaire est identique à la taille de fenêtre de la période en cours dans la direction négative.
  • Syntaxe direction : + | -
  • Syntaxe timescale : <sec> | <min> | <hour> | <day> | <week> | <mon>
  • Syntaxe sec : s | sec | secs | second | seconds
  • Syntaxe min : m | min | mins | minute | minutes
  • Syntaxe hour : h | hr | hrs | hour | hours
  • Syntaxe week : w | week | weeks
  • Syntaxe mon : mon | month | months
size <int><timescale>

Définit la durée de la période de comparaison.

  • Syntaxe timescale : <sec> | <min> | <hour> | <day> | <week> | <mon>
  • Syntaxe sec : s | sec | secs | second | seconds
  • Syntaxe min : m | min | mins | minute | minutes
  • Syntaxe hour : h | hr | hrs | hour | hours
  • Syntaxe week : w | week | weeks
  • Syntaxe mon : mon | month | months
count <int>

Indique le nombre de périodes à comparer. Si elle n'est pas indiquée, la valeur par défaut est 1.

datetime

Définit explicitement le début et la fin d'une période de comparaison.

Pour obtenir un exemple d'utilisation de cette commande dans des scénarios standard, reportez-vous à :

La commande suivante compare la taille moyenne de contenu d'une entité par rapport à 7 jours avant et à 14 jours avant :

* | link Entity 
| stats avg('Content Size') as 'Average Content Size' 
| compare fields = 'Average Content Size' timeshift = -7d count = 2

La commande suivante compare la taille moyenne de contenu d'une entité par rapport à une autre période :

* | link Entity 
| stats avg('Content Size') as 'Average Content Size' 
| compare fields = 'Average Content Size' 
        timerange = '2018-06-07T00:00:00Z' to '2018-06-14T00:00:00Z' as T1

La commande suivante compare 2 plages de temps qui ont la même taille de fenêtre que la plage de temps actuelle, dans le sens négatif. Par exemple, si la période en cours est de 60 dernières minutes, les plages timeshift sont de 60 à 120 dernières minutes et de 120 à 180 dernières minutes :

* | link span = 5minute 'Log Source'
 | compare timeshift = auto count = 2