Esta é uma tradução da página de documentação original em inglês. Ajude-nos a torná-la melhor.

Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

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.