Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Travailler dans la version 9 de Grafana
` à la fin. Pour consulter les périodes fiscales, utilisez `fQ (fiscal quarter)` et unités de `fy (fiscal year)` temps.
L'opérateur plus vous permet d'avancer dans le temps par rapport au présent. Par exemple, vous pouvez utiliser cette fonctionnalité pour examiner les données prédites dans le futur.
Le tableau suivant fournit des exemples de plages relatives.
| Exemple de plage relative | De | À |
| --- | --- | --- |
| Les 5 dernières minutes | `now-5m` | `now` |
| Jusqu'à présent | `now/d` | `now` |
| Cette semaine | `now/w` | `now/w` |
| Jusqu'à présent cette semaine | `now/w` | `now` |
| Ce mois-ci | `now/M` | `now/M` |
| Ce mois-ci, jusqu'à présent | `now/M` | `now` |
| Mois précédent | `now-1M/M` | `now-1M/M` |
| Cette année, jusqu'à présent | `now/Y` | `now` |
| Cette année | `now/Y` | `now/Y` |
| Exercice financier précédent | `now-1y/fy` | `now-1y/fy` |
**Note**
Grafana Alerting ne prend pas en charge les horodatages `now+n` futurs ni le *début `now-1n/n` de n jusqu'à la fin de n.*
**Contrôles de plage de temps courants**
Les commandes horaires du tableau de bord et du panneau ont une interface utilisateur commune. Ce qui suit décrit les contrôles de plage de temps courants.
+ La plage horaire actuelle, également appelée *sélecteur de temps*, indique la plage de temps actuellement affichée dans le tableau de bord ou le panneau que vous consultez. Passez votre curseur sur le champ pour voir les horodatages exacts de la plage et leur source (par exemple, le navigateur local). Cliquez sur la *plage horaire actuelle* pour la modifier. Vous pouvez modifier l'heure actuelle en utilisant une *plage de temps relative*, telle que les 15 dernières minutes, ou une plage de temps absolue, telle que `2020-05-14 00:00:00` à`2020-05-15 23:59:59`.
+ La **plage de temps relative** peut être sélectionnée dans la liste des **plages de temps relatives**. Vous pouvez filtrer la liste à l'aide du champ de saisie situé en haut. Quelques exemples de plages horaires incluent les *30 dernières minutes*, les *12 dernières heures*, les *7 derniers jours*, les *2 dernières années*, *hier*, *avant-hier*, *ce jour la semaine dernière*, *aujourd'hui jusqu'à présent*, *cette semaine jusqu'à présent* et *Ce mois jusqu'à présent*.
+ La **plage de temps absolue** peut être définie de deux manières : en saisissant des valeurs temporelles exactes ou relatives dans les champs **De** et **à** et en cliquant sur **Appliquer la plage de temps**, ou en cliquant sur une date ou une plage de dates dans le calendrier affiché lorsque vous cliquez sur le champ **De ou **de**** fin. Pour appliquer vos sélections, cliquez sur **Appliquer la plage horaire**.
*Autres fonctionnalités de plage horaire*
1. **Pour effectuer un zoom arrière, cliquez sur **Cmd\$1Z ou Ctrl\$1Z**.** Cliquez sur l'icône pour afficher une plage de temps plus étendue dans la visualisation du tableau de bord ou du panneau.
1. Pour utiliser la fonction de zoom avant, cliquez et faites glisser pour sélectionner la plage de temps dans la visualisation que vous souhaitez afficher.
**Note**
Le zoom avant ne s'applique qu'aux visualisations graphiques.
*Actualiser les tableaux de bord*
Cliquez sur l'icône **Actualiser le tableau de bord** pour exécuter immédiatement chaque requête sur le tableau de bord et actualiser les visualisations. Grafana annule toutes les demandes en attente lorsque vous déclenchez une actualisation.
Par défaut, Grafana n'actualise pas automatiquement le tableau de bord. Les requêtes sont exécutées selon leur propre calendrier en fonction des paramètres du panneau. Toutefois, si vous souhaitez actualiser régulièrement le tableau de bord, cliquez sur la flèche vers le bas à côté de l'icône **Actualiser le tableau de bord**, puis sélectionnez un intervalle d'actualisation.
**Contrôlez la plage horaire à l'aide d'une URL**
Vous pouvez contrôler la plage horaire d'un tableau de bord en fournissant les paramètres de requête suivants dans l'URL du tableau de bord.
+ `from`définit la limite inférieure de la plage de temps, spécifiée en ms epoch ou en [temps relatif.](#v9-dash-setting-dashboard-time-range)
+ `to`définit la limite supérieure de la plage de temps, spécifiée en ms epoch ou en temps relatif.
+ `time`et `time.window` définit une plage de temps allant de `time-time.window/2` à`time+time.window/2`. Les deux paramètres doivent être spécifiés en ms. Par exemple, les `?time=1500000000000&time.window=10000` résultats indiquent une plage de temps de 10 s comprise entre 1499999995000 et 1500000005000.
# Création de tableaux de bord
bouton **Restaurer à la version** en haut à droite.
**Restauration vers une version de tableau de bord précédemment enregistrée**
Si vous devez restaurer une version du tableau de bord précédemment enregistrée, vous pouvez soit cliquer sur le bouton **Restaurer** situé à droite d'une ligne de la liste des versions du tableau de bord, soit cliquer sur le bouton **Restaurer à la version** qui apparaît dans la vue des différences. Cliquez sur le bouton pour afficher la fenêtre contextuelle suivante vous demandant de confirmer la restauration.
Après la restauration d'une version précédente, une nouvelle version sera créée contenant exactement les mêmes données que la version précédente, mais avec un numéro de version différent. Cela est indiqué dans la **colonne Notes** de la ligne de la nouvelle version du tableau de bord. Cela est fait simplement pour s'assurer que les versions précédentes de votre tableau de bord ne sont pas affectées par la modification.
# Gestion des liens du tableau de bord
.
**Exemples**
Les variables sont répertoriées dans des listes déroulantes en haut de l'écran. Sélectionnez différentes variables pour voir comment les visualisations changent.
Pour voir les paramètres des variables, accédez à **Paramètres du tableau de bord > Variables**. Cliquez sur une variable dans la liste pour voir ses paramètres.
Les variables peuvent être utilisées dans les titres, les descriptions, les panneaux de texte et les requêtes. Les requêtes dont le texte commence par `$` sont des modèles. Tous les panneaux ne comporteront pas de modèles de requêtes.
**Bonnes pratiques variables**
+ Les listes déroulantes de variables sont affichées dans l'ordre dans lequel elles sont répertoriées dans la liste des variables dans les **paramètres du tableau de bord.**
+ Placez les variables que vous allez souvent modifier en haut, afin qu'elles apparaissent en premier (à l'extrême gauche du tableau de bord).
# Ajouter et gérer des variables
[ ^ " ] + ) |chip=" (?[ ^ " ] + )/g
```
Cela produirait la liste déroulante suivante :
```
Display Name Value
------------ -------------------------
enp216s0f0np0 0000:d7:00_0_0000:d8:00_0
enp216s0f0np1 0000:d7:00_0_0000:d8:00_1
enp216s0f0np2 0000:d7:00_0_0000:d8:00_2
enp216s0f0np3 0000:d7:00_0_0000:d8:00_3
```
Seuls `text` les noms de groupes de `value` capture et de capture sont pris en charge.
##
}`— Ce format vous permet de mieux contrôler la façon dont Grafana interprète les valeurs. Pour plus d'informations, consultez la section *Options avancées de format variable*.
+ `[[varname]]`— Ne pas utiliser. Cette syntaxe est ancienne et est obsolète. Il sera supprimé dans une future version.
Avant que les requêtes ne soient envoyées à votre source de données, la requête est *interpolée*, ce qui signifie que la variable est remplacée par sa valeur actuelle. Pendant l'interpolation, la valeur de la variable peut être *évitée* afin de se conformer à la syntaxe du langage de requête et à l'endroit où elle est utilisée. Par exemple, une variable utilisée dans une expression regex dans une requête InfluxDB ou Prometheus sera échappée à l'expression régulière.
**Options avancées de format variable**
Le formatage de l'interpolation variable dépend de la source de données, mais dans certains cas, vous souhaiterez peut-être modifier le formatage par défaut.
Par exemple, la source de données MySQL par défaut consiste à joindre plusieurs valeurs séparées par des virgules par des guillemets :. `'server01','server02'` Dans certains cas, vous souhaiterez peut-être avoir une chaîne séparée par des virgules sans guillemets :. `server01,server02` Vous pouvez y parvenir grâce aux options avancées de mise en forme des variables répertoriées ci-dessous.
**Syntaxe générale**
Syntaxe : `${var_name:option}`
Si une option de mise en forme non valide est spécifiée, `glob` c'est l' default/fallback option.
**CSV**
Formate les variables comportant plusieurs valeurs sous forme de chaîne séparée par des virgules.
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:csv}'
Interpolation result: 'test1,test2'
```
**Distribué - OpenTSDB**
Formate les variables avec plusieurs valeurs dans un format personnalisé pour OpenTSDB.
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:distributed}'
Interpolation result: 'test1,servers=test2'
```
**Devis double**
Formate les variables à valeurs uniques ou multiples dans une chaîne séparée par des virgules, saisit chaque valeur par `\"` et `"` met chaque valeur entre guillemets avec. `"`
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:doublequote}'
Interpolation result: '"test1","test2"'
```
**Globe - Graphite**
Formate les variables comportant plusieurs valeurs dans un glob (pour les requêtes Graphite).
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:glob}'
Interpolation result: '{test1,test2}'
```
**JSON**
Formate les variables comportant plusieurs valeurs sous forme de chaîne séparée par des virgules.
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:json}'
Interpolation result: '["test1", "test2"]'
```
**Lucene - Elasticsearch**
Formate les variables avec plusieurs valeurs au format Lucene pour Elasticsearch.
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:lucene}'
Interpolation result: '("test1" OR "test2")'
```
**Code en pourcentage**
Formate les variables à valeurs uniques et multiples à utiliser dans les paramètres d'URL.
```
servers = [ 'foo()bar BAZ', 'test2' ]
String to interpolate: '${servers:percentencode}'
Interpolation result: 'foo%28%29bar%20BAZ%2Ctest2'
```
**Tuyau**
Formate les variables comportant plusieurs valeurs dans une chaîne séparée par des tubes.
```
servers = [ 'test1.', 'test2' ]
String to interpolate: '${servers:pipe}'
Interpolation result: 'test1.|test2'
```
**Brut**
Désactive le formatage spécifique à la source de données, tel que les guillemets simples dans une requête SQL.
```
servers = [ 'test.1', 'test2' ]
String to interpolate: '${var_name:raw}'
Interpolation result: 'test.1,test2'
```
**Regex**
Formate les variables comportant plusieurs valeurs dans une chaîne regex.
```
servers = [ 'test1.', 'test2' ]
String to interpolate: '${servers:regex}'
Interpolation result: '(test1\.|test2)'
```
**Devis unique**
Formate les variables à valeurs uniques ou multiples dans une chaîne séparée par des virgules, saisit chaque valeur par `\'` et `'` met chaque valeur entre guillemets avec. `'`
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:singlequote}'
Interpolation result: "'test1','test2'"
```
**Chaîne SQL**
Formate les variables à valeurs uniques ou multiples dans une chaîne séparée par des virgules, saisit chaque valeur par `''` et `'` met chaque valeur entre guillemets avec. `'`
```
servers = [ "test'1", "test2" ]
String to interpolate: '${servers:sqlstring}'
Interpolation result: "'test''1','test2'"
```
**Text**
Formate les variables à valeurs uniques et multiples dans leur représentation textuelle. Pour une seule variable, elle renverra simplement la représentation textuelle. Pour les variables à valeurs multiples, elle renverra la représentation textuelle combinée avec`+`.
```
servers = [ "test1", "test2" ]
String to interpolate: '${servers:text}'
Interpolation result: "test1 + test2"
```
**Paramètres Query (Requête)**
Formate les variables à valeurs uniques et multiples dans leur représentation des paramètres de requête. Exemple : `var-foo=value1&var-foo=value2`
```
servers = [ "test1", "test2" ]
String to interpolate: '${servers:queryparam}'
Interpolation result: "var-servers=test1&var-servers=test2"
```
# Evaluation de l'utilisation du tableau
pour l'unité personnalisée qui doit suivre la valeur.
+ **préfixe :** pour l'unité personnalisée qui doit précéder la valeur.
+ **heure :** pour les formats de date et heure personnalisés, tapez par exemple **time:YYYY-MM-DD**. Voir [formats](https://momentjs.com/docs/#/displaying/) pour connaître la syntaxe et les options de format.
+ **si :** pour les unités SI personnalisées. Par exemple : **si : mF**. Celui-ci est un peu plus avancé car vous pouvez spécifier à la fois une unité et l'échelle des données source. Donc, si vos données source sont représentées sous forme de milli (milliers de), préfixez l'unité avec ce caractère d'échelle SI.
+ **nombre :** pour une unité de comptage personnalisée.
+ **devise :** pour personnaliser une unité monétaire.
Vous pouvez également coller un emoji natif dans le sélecteur d'unités et le choisir comme unité personnalisée.
#### Unités de chaînes
[${__range_s}s]) != )
```
**Sources de données spéciales**
**Grafana inclut également trois sources de données spéciales : **Grafana**, **Mixed** et Dashboard.** Pour plus de détails, reportez-vous à la section Sources de données
## Naviguez dans l'onglet de requête
- la valeur de l'étiquette par rapport à l'URL. Si votre étiquette contient des points, utilisez la syntaxe **\$1\$1field.labels [» «**].
## Variables de valeur
/public/emails/ng_alert_notification.html` Vous pouvez modifier ce fichier pour modifier l'apparence de tous les e-mails d'alerte.
# Alertes sur les données numériques
auth =
}
```
## Fournir des points de contact et des modèles
* par l'URL de votre webhook Slack (ou autre contact)
Cet exemple crée un point de contact qui envoie des notifications d'alerte à Slack.
```
resource "grafana_contact_point" "my_slack_contact_point" {
name = "Send to My Slack Channel"
slack {
url =
text = <
Les politiques de notification indiquent à Grafana comment acheminer les instances d'alerte, et non leur localisation. Ils connectent les alertes de tir à vos points de contact préalablement définis à l'aide d'un système d'étiquettes et de matchers.
**Pour configurer les politiques de notification et le routage**
1. Copiez ce bloc de code dans un fichier .tf sur votre machine locale.
Dans cet exemple, les alertes sont regroupées par`alertname`, ce qui signifie que toutes les notifications provenant d'alertes portant le même nom sont regroupées dans le même message Slack.
Si vous souhaitez acheminer des notifications spécifiques différemment, vous pouvez ajouter des sous-politiques. Les sous-politiques vous permettent d'appliquer un routage à différentes alertes en fonction de la correspondance des étiquettes. Dans cet exemple, nous appliquons une temporisation muette à toutes les alertes portant le label a=b.
```
resource "grafana_notification_policy" "my_policy" {
group_by = ["alertname"]
contact_point = grafana_contact_point.my_slack_contact_point.name
group_wait = "45s"
group_interval = "6m"
repeat_interval = "3h"
policy {
matcher {
label = "a"
match = "="
value = "b"
}
group_by = ["..."]
contact_point = grafana_contact_point.a_different_contact_point.name
mute_timings = [grafana_mute_timing.my_mute_timing.name]
policy {
matcher {
label = "sublabel"
match = "="
value = "subvalue"
}
contact_point = grafana_contact_point.a_third_contact_point.name
group_by = ["..."]
}
}
}
```
1. Dans le champ mute\$1timings, associez une temporisation muette à votre politique de notification.
1. Exécutez la commande `terraform apply`.
1. Accédez à l'interface utilisateur de Grafana et vérifiez les détails de votre politique de notification.
**Note**
Vous ne pouvez pas modifier les ressources fournies par Terraform depuis l'interface utilisateur. Cela garantit que votre pile d'alertes reste toujours synchronisée avec votre code.
1. Cliquez sur **Tester** pour vérifier que le point de notification fonctionne correctement.
## Provisionner les horaires de mise en sourdine
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)
Vous pouvez vérifier que vos ressources d'alerte ont été créées dans Grafana.
**Pour consulter vos ressources approvisionnées dans Grafana**
1. Ouvrez votre instance Grafana.
1. Accédez à Alertes.
1. Cliquez sur un dossier de ressources d'alerte, par exemple, Règles d'alerte.
Les ressources provisionnées sont étiquetées **Provisioned**, de sorte qu'il est clair qu'elles n'ont pas été créées manuellement.
**Note**
Vous ne pouvez pas modifier les ressources provisionnées depuis Grafana. Vous ne pouvez modifier les propriétés des ressources qu'en modifiant le fichier de provisionnement et en redémarrant Grafana ou en effectuant un rechargement à chaud. Cela empêche les modifications apportées à la ressource qui seraient remplacées si un fichier était à nouveau provisionné ou si un rechargement à chaud était effectué.
# Migration des alertes classiques du tableau de bord vers les alertes Grafana