Os serviços e padrões descritos abaixo foram definidos conforme o Guia de implementação das APIs TOTVS.
Quando necessário, o JSON de retorno deverá possuir uma lista com a estrutura de informações dos nós filhos para o nó descoberto pelo TOTVS Discovery.
Esta estrutura deve seguir conforme descrito abaixo:
Atributo | Tipo | Descrição | Obrigatório? | Valores |
---|---|---|---|---|
host | String | IP ou domínio do nó filho. | Sim | |
port | Numeric | Porta do nó filho. | Sim | |
category | String | Categoria do nó filho. | Sim | |
name | String | Nome do nó filho. | Não |
Quando necessário, o JSON de retorno deverá possuir uma lista com a estrutura de informações dos itens que foram avaliados pelo TOTVS Discovery.
Esta estrutura deve seguir conforme descrito abaixo:
Atributo | Tipo | Descrição | Obrigatório? | Valores |
---|---|---|---|---|
code | String | Código/Chave do item avaliado. | Sim | |
title | String | Título do item avaliado. | Sim | |
detail | String | Detalhe do item avaliado. | Não | |
value | String | Valor do item avaliado. | Sim | |
health | Array | Lista com a estrutura com as informações de saúde do nó descoberto. | Não |
Quando necessário, o JSON de retorno de deverá possuir uma lista com a estrutura de informações de saúde da informação retornada pelo TOTVS Discovery.
Esta estrutura deve seguir conforme descrito abaixo:
Atributo | Tipo | Descrição | Obrigatório? | Valores |
---|---|---|---|---|
type | String | Tipo da informação da situação encontrada. | Sim |
|
message | String | Breve mensagem sobre a situação encontrada. | Sim | |
detail | String | Detalhes sobre a situação encontrada. | Não | |
helpUrl | String | Página de ajuda sobre a situação encontrada. | Não |
GET /discovery/v1/resources/{host}/{port}/{category}/{name}?category=[category]
O método GET /discovery/v1/resources
é utilizado para a descoberta dos recursos (nós) que serão exibidos no Dashboard do TOTVS Discovery para avaliação de performance e saúde de cada um destes. Este método permite receber via PathParam
o host
, port
, category
e name
do recurso que deseja-se retornar, caso não informado estes parâmetros, serão retornados todos os recursos descobertos. É possível também filtrar pela categoria dos recursos, se informado o filtro category
via QueryParam
, o serviço deverá filtrar os recursos descobertos retornando apenas os recursos da categoria filtrada.
No JSON de retorno, no atributo items
, deve constar as seguintes informações:
Atributo | Tipo | Descrição | Obrigatório? | Valores |
---|---|---|---|---|
host | String | IP ou domínio do nó descoberto. | Sim | |
port | Numeric | Porta do nó descoberto. | Sim | |
category | String | Categoria do nó descoberto. | Sim |
|
name | String | Nome do nó descoberto. | Não | |
date | String | Data de descoberta do nó (no formato yyyy-mm-ddThh:mm:ss.nnnnnn+|-hh:mm). | Sim | |
info | Array | Lista com a estrutura com as informações dos itens avaliados. | Não | |
children | Array | Lista dos nós filhos do nó descoberto. | Não |
{ "total": 2, "hasNext": false, "items": [{ "host": "10.1.1.1", "port": 1234, "category": "server|machine|database|lsv|gateway", "name": "PROTHEUS_V12_PROD", "date": "yyyy-mm-ddThh:mm:ss.nnnnnn+|-hh:mm", "info": [{ "code": "cpu", "title": "CPU", "detail": "Central Processing Unit", "value": "90", "health": [{ "type": "success|warning|error|danger", "message": "Consumo de CPU em 80%", "details": "O alto consumo da CPU do servidor prejudica o desempenho do sistema", "helpUrl": "http://www.tdn.totvs.com.br" }, { "type": "success|warning|error|danger", "message": "Memória disponível no servidor abaixo da recomendada", "details": "O recomendado para o uso do TOTVS Microsiga Protheus é de no mínimo 8gb de RAM", "helpUrl": "http://www.tdn.totvs.com.br" }] }], "children": [{ "host": "10.1.1.1", "port": 5555, "name": "DBACCESS", "category": "server|machine|database|lsv|gateway" }] }] } |