Table of Contents
host.get
Descri??o
integer/array host.get(object parameters)
O m¨¦todo permite recuperar hosts de acordo com os par?metros fornecidos.
Este m¨¦todo est¨¢ dispon¨ªvel para usu¨¢rios de qualquer tipo. Permiss?es para chamar o m¨¦todo pode ser revogado nas configura??es de fun??o do usu¨¢rio. Veja ±«²õ³Ü¨¢°ù¾±´Ç fun??es Para maiores informa??es.
Filtrando registros de log de eventos VMware
Usando uma express?o regular no pr¨¦-processamento para filtrar eventos desnecess¨¢rios do log de eventos do VMware.
1. Em um host VMware Hypervisor em funcionamento, verifique se o item de log de eventos vmware.eventlog[<url>,<mode>] est¨¢ presente e funcionando corretamente. Observe que o item de log de eventos j¨¢ pode estar presente no hypervisor se o Template VM VMware tiver sido vinculado durante a cria??o do host.
2. No host VMware Hypervisor, crie um dependent item do tipo 'Log' e defina o item de log de eventos como seu mestre.
Na aba "Pr¨¦-processamento" do item dependente, selecione a op??o de valida??o "Corresponde ¨¤ express?o regular" e preencha o padr?o, por exemplo:
".* logged in .*" - filters all logging events in the event log
"\bUser\s+\K\S+" - filter only lines with usernames from the event logSe a express?o regular n?o for correspondida, o item dependente se torna n?o suportado com uma mensagem de erro correspondente. Para evitar isso, marque a caixa de sele??o "Custom on fail" e selecione para descartar o valor n?o correspondido.
Outra abordagem que permite usar grupos de correspond¨ºncia e controle de sa¨ªda ¨¦ selecionar a op??o "Express?o regular" na aba "Pr¨¦-processamento" e preencher os par?metros, por exemplo:
pattern: ".*logged in.*", output: "\0" - filters all logging events in the event log
pattern "User (.*?)(?=\ )", output: "\1" - filter only usernames from the event logValores de retorno
(integer/array) Retorna:
- uma matriz de objetos;
- a contagem de objetos recuperados, se o par?metro
countOutputtiver sido usado.
Exemplos
Recuperando dados por nome
Recupere todos os dados sobre dois hosts chamados "servidor Áú»¢¶Ä²©" e "Linux servidor".
Solicita??o:
{
"jsonrpc": "2.0",
&±ç³Ü´Ç³Ù;³¾¨¦³Ù´Ç»å´Ç&±ç³Ü´Ç³Ù;: "host.get",
"par?metros": {
"filtro": {
"hospedeiro": [
"servidor Áú»¢¶Ä²©",
"Servidor Linux"
]
}
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"resultado": [
{
"manuten??o": [],
"hostid": "10160",
"proxy_hostid": "0",
"host": "servidor Áú»¢¶Ä²©",
"estado": "0",
"lastaccess": "0",
"ipmi_authtype": "-1",
"ipmi_privilege": "2",
"ipmi_username": "",
"ipmi_password": "",
"ipmi_disable_until": "0",
"snmp_disable_until": "0",
"manuten??oid": "0",
"maintenance_status": "0",
"maintenance_type": "0",
"maintenance_from": "0",
"nome": "servidor Áú»¢¶Ä²©",
"description": "O servidor de monitoramento Áú»¢¶Ä²©.",
"tls_connect": "1",
"tls_accept": "1",
"tls_issuer": "",
"tls_subject": ""
},
{
"manuten??o": [],
"hostid": "10167",
"proxy_hostid": "0",
"host": "Servidor Linux",
"estado": "0",
"lastaccess": "0",
"ipmi_authtype": "-1",
"ipmi_privilege": "2",
"ipmi_username": "",
"ipmi_password": "",
"ipmi_disable_until": "0",
"snmp_disable_until": "0",
"manuten??oid": "0",
"maintenance_status": "0",
"maintenance_type": "0",
"maintenance_from": "0",
"nome": "Servidor Linux",
"Descri??o": "",
"tls_connect": "1",
"tls_accept": "1",
"tls_issuer": "",
"tls_subject": ""
}
],
"id": 1
}Recuperando grupos de hosts
Recupere os nomes dos grupos que o host "Áú»¢¶Ä²© server" ¨¦ membro, mas n?o detalhes do host em si.
Solicita??o:
{
"jsonrpc": "2.0",
&±ç³Ü´Ç³Ù;³¾¨¦³Ù´Ç»å´Ç&±ç³Ü´Ç³Ù;: "host.get",
"par?metros": {
&±ç³Ü´Ç³Ù;²õ²¹¨ª»å²¹&±ç³Ü´Ç³Ù;: ["hostid"],
"selectGroups": "estender",
"filtro": {
"hospedeiro": [
"servidor Áú»¢¶Ä²©"
]
}
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 2
}Resposta:
{
"jsonrpc": "2.0",
"resultado": [
{
"hostid": "10085",
"grupos": [
{
"groupid": "2",
"name": "Servidores Linux",
"interno": "0",
"bandeiras": "0"
},
{
"groupid": "4",
"name": "servidores Áú»¢¶Ä²©",
"interno": "0",
"bandeiras": "0"
}
]
}
],
"id": 2
}Recuperando templates vinculados
Recupere os IDs e os nomes dos templates vinculados ao host "10084".
Solicita??o:
{
"jsonrpc": "2.0",
&±ç³Ü´Ç³Ù;³¾¨¦³Ù´Ç»å´Ç&±ç³Ü´Ç³Ù;: "host.get",
"par?metros": {
&±ç³Ü´Ç³Ù;²õ²¹¨ª»å²¹&±ç³Ü´Ç³Ù;: ["hostid"],
"selectParentTemplates": [
"modelo",
"nome"
],
"hostids": "10084"
},
"id": 1,
"auth": "70785d2b494a7302309b48afcdb3a401"
}Resposta:
{
"jsonrpc": "2.0",
"resultado": [
{
"hostid": "10084",
"parentModelos": [
{
"nome": "Linux",
"templateid": "10001"
},
{
"nome": "Servidor Áú»¢¶Ä²©",
"templateid": "10047"
}
]
}
],
"id": 1
}Recuperando hosts por template
Recupere todos os hosts que tebgam o template "10001" (Linux by Áú»¢¶Ä²© agent) vinculado a eles.
Solicita??o:
{
"jsonrpc": "2.0",
"method": "host.get",
"params": {
"output": ["hostid", "name"],
"templateids": "10001"
},
"auth": "70785d2b494a7302309b48afcdb3a401",
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": [
{
"templateid": "10001",
"hosts": [
{
"hostid": "10084",
"name": "Áú»¢¶Ä²© server"
},
{
"hostid": "10603",
"name": "Host 1"
},
{
"hostid": "10604",
"name": "Host 2"
}
]
}
],
"id": 1
}Pesquisando por dados de invent¨¢rio do host
Recupere hosts que contenham "Linux" no campo "OS" do invent¨¢rio de hosts.
Solicita??o:
{
"jsonrpc": "2.0",
&±ç³Ü´Ç³Ù;³¾¨¦³Ù´Ç»å´Ç&±ç³Ü´Ç³Ù;: "host.get",
"par?metros": {
&±ç³Ü´Ç³Ù;²õ²¹¨ª»å²¹&±ç³Ü´Ç³Ù;: [
"hospedeiro"
],
&±ç³Ü´Ç³Ù;²õ±ð±ô±ð³¦³Ù±õ²Ô±¹±ð²Ô³Ù¨¢°ù¾±´Ç&±ç³Ü´Ç³Ù;: [
"os"
],
&±ç³Ü´Ç³Ù;±è±ð²õ±ç³Ü¾±²õ²¹°ù±õ²Ô±¹±ð²Ô³Ù¨¢°ù¾±´Ç&±ç³Ü´Ç³Ù;: {
"os": "Linux"
}
},
"id": 2,
"auth": "7f9e00124c75e8f25facd5c093f3e9a0"
}Resposta:
{
"jsonrpc": "2.0",
"resultado": [
{
"hostid": "10084",
"host": "servidor Áú»¢¶Ä²©",
&±ç³Ü´Ç³Ù;¾±²Ô±¹±ð²Ô³Ù¨¢°ù¾±´Ç&±ç³Ü´Ç³Ù;: {
"os": "Linux Ubuntu"
}
},
{
"hostid": "10107",
"host": "Servidor Linux",
&±ç³Ü´Ç³Ù;¾±²Ô±¹±ð²Ô³Ù¨¢°ù¾±´Ç&±ç³Ü´Ç³Ù;: {
"os": "Linux Mint"
}
}
],
"id": 1
}Pesquisando por tags de host
Recupere os hosts que possuem a tag "Nome do host" igual a "Servidor Linux".
Solicita??o:
{
"jsonrpc": "2.0",
&±ç³Ü´Ç³Ù;³¾¨¦³Ù´Ç»å´Ç&±ç³Ü´Ç³Ù;: "host.get",
"par?metros": {
&±ç³Ü´Ç³Ù;²õ²¹¨ª»å²¹&±ç³Ü´Ç³Ù;: ["hostid"],
"selectTags": "estender",
"evaltype": 0,
"Tag": [
{
"tag": "Nome do host",
"value": "Servidor Linux",
"operador": 1
}
]
},
"auth": "7f9e00124c75e8f25facd5c093f3e9a0",
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"resultado": [
{
"hostid": "10085",
"Tag": [
{
"tag": "Nome do host",
"value": "Servidor Linux"
},
{
"tag": "SO",
"valor": "RHEL 7"
}
]
}
],
"id": 1
}Recupere hosts que tenham essas tags n?o apenas em n¨ªvel de host, mas tamb¨¦m em seus modelos pai vinculados.
Solicita??o:
{
"jsonrpc": "2.0",
&±ç³Ü´Ç³Ù;³¾¨¦³Ù´Ç»å´Ç&±ç³Ü´Ç³Ù;: "host.get",
"par?metros": {
&±ç³Ü´Ç³Ù;²õ²¹¨ª»å²¹&±ç³Ü´Ç³Ù;: ["nome"],
"tags": [{"tag": "A", "value": "1", "operator": "0"}],
"herdadoTags": verdadeiro
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"resultado": [
{
"hostid": "10623",
"name": "Sala de PC 1"
},
{
"hostid": "10601",
"nome": &±ç³Ü´Ç³Ù;·¡²õ³¦°ù¾±³Ù¨®°ù¾±´Ç&±ç³Ü´Ç³Ù;
}
],
"id": 1
}Pesquisando host com tags e tags de template
Recuperar um host com tags e todas as tags vinculadas aos templates pai.
Solicita??o:
{
"jsonrpc": "2.0",
&±ç³Ü´Ç³Ù;³¾¨¦³Ù´Ç»å´Ç&±ç³Ü´Ç³Ù;: "host.get",
"par?metros": {
&±ç³Ü´Ç³Ù;²õ²¹¨ª»å²¹&±ç³Ü´Ç³Ù;: ["nome"],
"hostids": 10502,
"selectTags": ["tag", "valor"],
"selectInheritedTags": ["tag", "valor"]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"resultado": [
{
"hostid": "10502",
"nome": "?rea de trabalho",
"Tag": [
{
"marca": "A",
"valor": "1"
}
],
"herdadoTags": [
{
"marca": "B",
"valor": "2"
}
]
}
],
"id": 1
}Pesquisando hosts por gravidade do problema
Recupere hosts que tenham problemas de "Desastre".
Solicita??o:
{
"jsonrpc": "2.0",
&±ç³Ü´Ç³Ù;³¾¨¦³Ù´Ç»å´Ç&±ç³Ü´Ç³Ù;: "host.get",
"par?metros": {
&±ç³Ü´Ç³Ù;²õ²¹¨ª»å²¹&±ç³Ü´Ç³Ù;: ["nome"],
"gravidades": 5
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Resposta:
Recupere hosts que tenham problemas "Average" e "High".
Solicita??o:
{
"jsonrpc": "2.0",
&±ç³Ü´Ç³Ù;³¾¨¦³Ù´Ç»å´Ç&±ç³Ü´Ç³Ù;: "host.get",
"par?metros": {
&±ç³Ü´Ç³Ù;²õ²¹¨ª»å²¹&±ç³Ü´Ç³Ù;: ["nome"],
"gravidades": [3, 4]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"resultado": [
{
"hostid": "20170",
"nome": "Banco de dados"
},
{
"hostid": "20183",
"nome": "esta??o de trabalho"
}
],
"id": 1
}Veja tamb¨¦m
Fonte
CHost::get() em ui/include/classes/api/services/CHost.php.