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 countOutput tiver 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.