Documentation
Table of Contents
history.get
Descrição
integer/array history.get(object parameters)
O método permite recuperar histórico de dados de acordo com o parametros dados.
Veja também: known issues
Este método pode retornar históricos de dados de uma entidade excluída se esses dados ainda não foram removidos definitivamente
Este metodo está disponível para qualquer tipo de usuário. As permissões para chamar o método podem ser revogadas nas configurações de função do usuário. Veja User roles para mais informações.
Parâmetros
(object) Parâmetros que definem a saída desejada.
O método oferece suporte aos seguintes parâmetros.
|Parâmetro|Tipo|Descrição| |---------|----------------------------------- ------------|-----------| |history|integer|Tipos de objeto de histórico a serem retornados.
Valores possíveis:
0 - numérico float;
1 - caractere;
2 - log;
3 - numérico unsigned;
4 - texto.
Padrão: 3.| |hostids|string/array|Retorna apenas o histórico dos hosts fornecidos.| |itemids|string/array|Retorna apenas o histórico dos itens fornecidos.| |time_from|timestamp|Retorna apenas os valores que foram recebidos após ou no momento determinado.| |time_till|timestamp|Retorna apenas os valores que foram recebidos antes ou no momento determinado.| |sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.
Os valores possíveis são: itemid e clock.| |countOutput|boolean|Esses parâmetros sendo comuns para todos os métodos get são descritos em detalhes na página comentário de referência.| |editável|booleano|^| |excludePesquisa|boolean|^| |filtro|objeto|^| |limite|inteiro|^| |saída|consulta|^| |pesquisar|objeto|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |ordem de classificação|cadeia/matriz|^| |startSearch|boolean|^|
Valores de retorno
(integer/array) Retorna:
- uma matriz de objetos;
- a contagem de objetos recuperados, se o parâmetro
countOutputtiver sido usado.
Exemplos
Recuperando dados do histórico de itens
Retorna os 10 últimos valores recebidos de um item numérico (flutuante).
Solicitação:
{
"jsonrpc": "2.0",
"método": "história.get",
"parâmetros": {
"saída": "estender",
"história": 0,
"itemids": "23296",
"sortfield": "relógio",
"ordem de classificação": "DESC",
"limite": 10
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"resultado": [
{
"itemid": "23296",
"relógio": "1351090996",
"valor": "0,085",
"ns": "563157632"
},
{
"itemid": "23296",
"relógio": "1351090936",
"valor": "0,16",
"ns": "549216402"
},
{
"itemid": "23296",
"relógio": "1351090876",
"valor": "0,18",
"ns": "537418114"
},
{
"itemid": "23296",
"relógio": "1351090816",
"valor": "0,21",
"ns": "522659528"
},
{
"itemid": "23296",
"relógio": "1351090756",
"valor": "0,215",
"ns": "507809457"
},
{
"itemid": "23296",
"relógio": "1351090696",
"valor": "0,255",
"ns": "495509699"
},
{
"itemid": "23296",
"relógio": "1351090636",
"valor": "0,36",
"ns": "477708209"
},
{
"itemid": "23296",
"relógio": "1351090576",
"valor": "0,375",
"ns": "463251343"
},
{
"itemid": "23296",
"relógio": "1351090516",
"valor": "0,315",
"ns": "447947017"
},
{
"itemid": "23296",
"relógio": "1351090456",
"valor": "0,275",
"ns": "435307141"
}
],
"id": 1
}Fonte
CHistory::get() em ui/include/classes/api/services/CHistory.php.