10 Graphique (classique)
Description
Ces paramètres et les valeurs de propriété possibles pour les objets de champ du widget de tableau de bord correspondants permettent de configurer le widget Graph (classic) dans les méthodes dashboard.create et dashboard.update.
Les propriétés fields du widget ne sont pas validées lors de la création ou de la mise à jour d’un tableau de bord.
Cela permet aux utilisateurs de modifier les widgets intégrés et de créer des widgets personnalisés, mais cela introduit également le risque de créer ou de mettre à jour des widgets de manière incorrecte.
Pour garantir la réussite de la création ou de la mise à jour du widget Graph (classic), veuillez vous référer au comportement des paramètres décrit dans les tableaux ci-dessous.
Paramètres
Les paramètres suivants sont pris en charge pour le widget Graph (classic).
| Parameter | type | name | value | |
|---|---|---|---|---|
| Refresh interval | 0 | rf_rate | 0 - Aucun rafraîchissement; 10 - 10 secondes; 30 - 30 secondes; 60 - (par défaut) 1 minute; 120 - 2 minutes; 600 - 10 minutes; 900 - 15 minutes. |
|
| Source | 0 | source_type | 0 - (par défaut) Graph; 1 - Graphique simple. |
|
| Graph | 6 | graphid.0 | ID du Graph. Comportement du paramètre : - requis si Source est défini sur "Graph" |
|
| Graph (Widget) | 1 | graphid._reference | Au lieu de l'ID du Graph :ABCDE._graphid - définissez un widget compatible (avec son paramètre Reference défini sur "ABCDE") comme source de données pour les graphiques.Comportement du paramètre : - requis si Source est défini sur "Graphique simple" et que Graph n'est pas défini |
|
| Item | 4 | itemid.0 | ID de l'élément. Comportement du paramètre : - requis si Source est défini sur "Graphique simple" et que Item (Widget) n'est pas défini |
|
| Item (Widget) | 1 | itemid._reference | Au lieu de l'ID de l'élément :ABCDE._itemid - définissez un widget compatible (avec son paramètre Reference défini sur "ABCDE") comme source de données pour les éléments.Comportement du paramètre : - requis si Source est défini sur "Graphique simple" et que Item n'est pas défini |
|
| Time period | 1 | time_period._reference | DASHBOARD._timeperiod - définissez le sélecteur Time period comme source de données;ABCDE._timeperiod - définissez un widget compatible (avec son paramètre Reference défini sur "ABCDE") comme source de données.Valeur par défaut : DASHBOARD._timeperiodVous pouvez également définir la période uniquement dans les paramètres From et To. |
|
| From | 1 | time_period.from | Chaîne de temps valide au format absolu (YYYY-MM-DD hh:mm:ss) ou au format temporel relatif (now, now/d, now/w-1w, etc.).Comportement du paramètre : - pris en charge si Time period n'est pas défini - requis si time_period.to est défini |
|
| To | 1 | time_period.to | Chaîne de temps valide au format absolu (YYYY-MM-DD hh:mm:ss) ou au format temporel relatif (now, now/d, now/w-1w, etc.).Comportement du paramètre : - pris en charge si Time period n'est pas défini - requis si time_period.from est défini |
|
| Show legend | 0 | show_legend | 0 - Désactivé; 1 - (par défaut) Activé. |
|
| Override host | 1 | override_hostid._reference | ABCDE._hostid - définissez un widget compatible (avec son paramètre Reference défini sur "ABCDE") comme source de données pour les hôtes;DASHBOARD._hostid - définissez le sélecteur Host du tableau de bord comme source de données pour les hôtes.Ce paramètre n'est pas pris en charge lors de la configuration du widget sur un tableau de bord de modèle. |
|
| Reference | 1 | reference | Toute valeur de chaîne composée de 5 caractères (par exemple, ABCDE ou JBPNL). Cette valeur doit être unique dans le tableau de bord auquel appartient le widget.Comportement du paramètre : - requis |
|
Exemples
Les exemples suivants ont pour objectif de décrire uniquement la configuration des objets champs du widget de tableau de bord pour le widget Graphique (classique).
Pour plus d'informations sur la configuration d'un tableau de bord, consultez dashboard.create.
Configuration d’un widget Graph (classic)
Configurez un widget Graph (classic) qui affiche un graphique simple pour l’élément « 42269 ».
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "graph",
"name": "Graph (classic)",
"x": 0,
"y": 0,
"width": 36,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 0,
"name": "source_type",
"value": 1
},
{
"type": 4,
"name": "itemid.0",
"value": 42269
},
{
"type": 1,
"name": "reference",
"value": "RSTUV"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Réponse :
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}