Documentation
Table of Contents
graph.get
Description
integer/array graph.get(object parameters)
La m¨¦thode permet de r¨¦cup¨¦rer des graphiques en fonction des param¨¨tres donn¨¦s.
±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ
(object) ±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ d¨¦finissant la sortie souhait¨¦e.
La m¨¦thode prend en charge les param¨¨tres suivants.
| ±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð | Type | Description |
|---|---|---|
| graphids | string/array | Renvoie uniquement les graphiques avec les identifiants donn¨¦s. |
| groupids | string/array | Renvoie uniquement les graphiques appartenant aux h?tes des groupes d'h?tes donn¨¦s. |
| templateids | string/array | Renvoie uniquement les graphiques appartenant aux mod¨¨les donn¨¦s. |
| hostids | string/array | Renvoie uniquement les graphiques appartenant aux h?tes donn¨¦s. |
| itemids | string/array | Renvoie uniquement les graphiques contenant les ¨¦l¨¦ments donn¨¦s. |
| templated | boolean | Si la valeur est true, ne renvoie que les graphiques appartenant ¨¤ des mod¨¨les. |
| inherited | boolean | Si la valeur est true, ne renvoie que les graphiques h¨¦rit¨¦s d'un mod¨¨le. |
| expandName | flag | D¨¦veloppe les macros dans le nom du graphique. |
| selectGroups | query | Renvoie les groupes d'h?tes auxquels le graphique appartient dans la propri¨¦t¨¦ groups. |
| selectTemplates | query | Renvoie les mod¨¨les auxquels le graphique appartient dans la propri¨¦t¨¦ templates. |
| selectHosts | query | Renvoie les h?tes auxquels le graphique appartient dans la propri¨¦t¨¦ hosts. |
| selectItems | query | Renvoie les ¨¦l¨¦ments utilis¨¦s dans le graphique dans la propri¨¦t¨¦ items. |
| selectGraphDiscovery | query | Renvoie l'objet de d¨¦couverte de graphique dans la propri¨¦t¨¦ graphDiscovery. Les objets de d¨¦couverte de graphique lient le graphique ¨¤ un prototype de graphique ¨¤ partir duquel il a ¨¦t¨¦ cr¨¦¨¦.Il a les propri¨¦t¨¦s suivantes : graphid - (string) ID du graphique ;parent_graphid - (string) ID du prototype de graphique ¨¤ partir duquel le graphique a ¨¦t¨¦ cr¨¦¨¦. |
| selectGraphItems | query | Renvoie les ¨¦l¨¦ments de graphique utilis¨¦s dans le graphique dans la propri¨¦t¨¦ gitems. |
| selectDiscoveryRule | query | Renvoie la r¨¨gle de d¨¦couverte de bas niveau qui a cr¨¦¨¦ le graphique dans la propri¨¦t¨¦ discoveryRule. |
| filter | object | Renvoie uniquement les r¨¦sultats qui correspondent exactement au filtre donn¨¦. Accepte un tableau dans lequel les cl¨¦s sont des noms de propri¨¦t¨¦s et les valeurs sont une valeur unique ou un tableau de valeurs ¨¤ comparer. Prend en charge des filtres suppl¨¦mentaires : host - nom technique de l'h?te auquel appartient le graphique ;hostid - ID de l'h?te auquel appartient le graphique. |
| sortfield | string/array | Trie le r¨¦sultat par les propri¨¦t¨¦s donn¨¦es. Les valeurs possibles sont : graphid, name et graphtype. |
| countOutput | boolean | Ces param¨¨tres, communs ¨¤ toutes les m¨¦thodes "get", sont d¨¦crits dans les commentaires de r¨¦f¨¦rence. |
| editable | boolean | |
| excludeSearch | boolean | |
| limit | integer | |
| output | query | |
| preservekeys | boolean | |
| search | object | |
| searchByAny | boolean | |
| searchWildcardsEnabled | boolean | |
| sortorder | string/array | |
| startSearch | boolean |
Valeurs retourn¨¦es
(integer/array) Retourne soit :
- un tableau d'objets ;
- le nombre d'objets r¨¦cup¨¦r¨¦s, si le param¨¨tre
countOutputa ¨¦t¨¦ utilis¨¦.
Exemples
R¨¦cup¨¦ration de graphiques depuis des h?tes
R¨¦cup¨¦rer tous les graphiques de l'h?te "10107" et les trier par nom.
Requ¨ºte :
{
"jsonrpc": "2.0",
"method": "graph.get",
"params": {
"output": "extend",
"hostids": 10107,
"sortfield": "name"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}R¨¦ponse :
{
"jsonrpc": "2.0",
"result": [
{
"graphid": "612",
"name": "CPU jumps",
"width": "900",
"height": "200",
"yaxismin": "0.0000",
"yaxismax": "100.0000",
"templateid": "439",
"show_work_period": "1",
"show_triggers": "1",
"graphtype": "0",
"show_legend": "1",
"show_3d": "0",
"percent_left": "0.0000",
"percent_right": "0.0000",
"ymin_type": "0",
"ymax_type": "0",
"ymin_itemid": "0",
"ymax_itemid": "0",
"flags": "0"
},
{
"graphid": "613",
"name": "CPU load",
"width": "900",
"height": "200",
"yaxismin": "0.0000",
"yaxismax": "100.0000",
"templateid": "433",
"show_work_period": "1",
"show_triggers": "1",
"graphtype": "0",
"show_legend": "1",
"show_3d": "0",
"percent_left": "0.0000",
"percent_right": "0.0000",
"ymin_type": "1",
"ymax_type": "0",
"ymin_itemid": "0",
"ymax_itemid": "0",
"flags": "0"
},
{
"graphid": "614",
"name": "CPU utilization",
"width": "900",
"height": "200",
"yaxismin": "0.0000",
"yaxismax": "100.0000",
"templateid": "387",
"show_work_period": "1",
"show_triggers": "0",
"graphtype": "1",
"show_legend": "1",
"show_3d": "0",
"percent_left": "0.0000",
"percent_right": "0.0000",
"ymin_type": "1",
"ymax_type": "1",
"ymin_itemid": "0",
"ymax_itemid": "0",
"flags": "0"
},
{
"graphid": "645",
"name": "Disk space usage /",
"width": "600",
"height": "340",
"yaxismin": "0.0000",
"yaxismax": "0.0000",
"templateid": "0",
"show_work_period": "0",
"show_triggers": "0",
"graphtype": "2",
"show_legend": "1",
"show_3d": "1",
"percent_left": "0.0000",
"percent_right": "0.0000",
"ymin_type": "0",
"ymax_type": "0",
"ymin_itemid": "0",
"ymax_itemid": "0",
"flags": "4"
}
],
"id": 1
}Voir ¨¦galement
- R¨¨gle de d¨¦couverte bas niveau
- ?±ô¨¦³¾±ð²Ô³Ù de graphique
- ?±ô¨¦³¾±ð²Ô³Ù
- H?te
- Groupe d'H?te
- ²Ñ´Ç»å¨¨±ô±ð
Source
CGraph::get() dans frontends/php/include/classes/api/services/CGraph.php.