Histórico da Página
...
Desta forma que processos externos podem efetuar a eliminação de registros na Carol.
Enviando e consumindo informações Heart-beat
A Carol permite o envio de informações relacionados à integração de dados de cada conector. Os dados a serem enviados é de responsabilidade do conector, e estes dados são visualizados na Carol, dentro do conector através da opção "Show Connector Details":
Quando o conector fica sem enviar dados por mais do que 24 horas um alerta é exibido, conforme abaixo:
O envio do heart-beat ocorre através da request abaixo:
| Bloco de código | ||||
|---|---|---|---|---|
| ||||
curl -X PUT "https://clockin.carol.ai/api/v1/heartbeats/90d7bcd37c424d85a733a42117528792" -H "accept: application/json" -H "Authorization: 29dfe258523c416c96e7b1b2ff1a8dfc" -H "content-type: application/json" -d "{ \"mdmConnectorId\": \"90d7bcd37c424d85a733a42117528792\", \"mdmCreatedUser\": \"[email protected]\", \"mdmEntityType\": \"mdmHeartbeat\", \"mdmHeartbeatData\": { \"databases\": [ { \"database\": \"Microsoft SQL Server\", \"fullVersion\": \"13.00.1601\", \"id\": \"d2844ee37088c437109a55c40f36d745abad48d2\", \"version\": \"13.0\" }, { \"database\": \"Directory\", \"id\": \"defb02fc824ea527814cbd2d78f04bfde99a180d\" } ], \"encoding\": \"UTF-8\", \"freeSpace\": \"126397394944\", \"hostAddress\": \"10.172.158.209\", \"javaVersion\": \"11.0.5\", \"javaVmName\": \"OpenJDK 64-Bit Server VM\", \"lastConnectionTimestamp\": { \"d2844ee37088c437109a55c40f36d745abad48d2\": \"2019-11-28T13:31:55Z\", \"defb02fc824ea527814cbd2d78f04bfde99a180d\": \"1970-01-01T00:00:00Z\" }, \"now\": \"2019-11-28T14:01:55Z\", \"osArch\": \"amd64\", \"osName\": \"Windows 10\", \"osVersion\": \"10.0\", \"recordCountLast24Hours\": \"0\", \"recordCountLastHour\": \"0\", \"startTime\": \"2019-11-14T18:56:58Z\", \"tenant\": \"clockin\", \"timezone\": \"GMT-03:00\", \"user\": \"robson.poffototvs.com\", \"version\": \"2.30.5\" }, \"mdmHeartbeatInterval\": 0, \"mdmId\": \"13b7fdffa90340fc92b418a0f4944db2\", \"mdmLastHeartbeatTime\": \"2020-06-21T20:47:49.899Z\", \"mdmLastUpdated\": \"2020-06-21T20:47:49.904Z\", \"mdmTenantId\": \"4c2c9090e7c611e893bf0e900682978b\", \"mdmUpdatedUser\": \"[email protected]\"}" |
Parâmetros importantes
- connectorID: query-param, obrigatório, referente ao código do conector que receberá os dados de heart-beat.
- databases: permite o envio especifico dos bancos de dados conectados neste conector (veja mais detalhes no JSon abaixo de exemplo).
- freeSpace: espaço disponível no ambiente que envia os dados
- hostAddress: endereço de IP da origem dos dados
- startTime: data/hora de início do evio dos dados
- recordCountLastHour: quantidade de dados enviados na última hora.
- recordCountLast24Hours: quantidade de dados enviados nas últimas 24 horas.
- now: data/hora da último envio do heart-beat.
| Informações | ||
|---|---|---|
| ||
O heart-beat permite o envio de mais dados além do descrito acima. A lista é flexível e qualquer chave/valor pode ser enviado/recebido pela Carol. |
A request abaixo permite obter o último heart-beat enviado para a Carol:
| Bloco de código | ||||||
|---|---|---|---|---|---|---|
| ||||||
curl 'https://api.carol.ai/api/v1/heartbeats/90d7bcd37c424d85a733a42117528792' -H 'authority: api.carol.ai' -H 'accept: application/json' -H 'authorization: 29dfe258523c416c96e7b1b2ff1a8dfc' -H 'content-type: application/json' -H 'origin: https://clockin.carol.ai' --compressed |
O retorno é semelhate ao abaixo:
| Bloco de código | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"mdmConnectorId": "90d7bcd37c424d85a733a42117528792",
"mdmCreatedUser": "[email protected]",
"mdmEntityType": "mdmHeartbeat",
"mdmHeartbeatData": {
"databases": [
{
"database": "Microsoft SQL Server",
"fullVersion": "13.00.1601",
"id": "d2844ee37088c437109a55c40f36d745abad48d2",
"version": "13.0"
},
{
"database": "Directory",
"id": "defb02fc824ea527814cbd2d78f04bfde99a180d"
}
],
"encoding": "UTF-8",
"freeSpace": "126397394944",
"hostAddress": "10.172.158.209",
"javaVersion": "11.0.5",
"javaVmName": "OpenJDK 64-Bit Server VM",
"lastConnectionTimestamp": {
"d2844ee37088c437109a55c40f36d745abad48d2": "2019-11-28T13:31:55Z",
"defb02fc824ea527814cbd2d78f04bfde99a180d": "1970-01-01T00:00:00Z"
},
"now": "2019-11-28T14:01:55Z",
"osArch": "amd64",
"osName": "Windows 10",
"osVersion": "10.0",
"recordCountLast24Hours": "0",
"recordCountLastHour": "0",
"startTime": "2019-11-14T18:56:58Z",
"tenant": "clockin",
"timezone": "GMT-03:00",
"user": "robson.poffototvs.com",
"version": "2.30.5"
},
"mdmHeartbeatInterval": 0,
"mdmId": "13b7fdffa90340fc92b418a0f4944db2",
"mdmLastHeartbeatTime": "2020-06-21T20:47:49.899Z",
"mdmLastUpdated": "2020-06-21T20:47:49.904Z",
"mdmTenantId": "4c2c9090e7c611e893bf0e900682978b",
"mdmUpdatedUser": "[email protected]"
} |
Próximos Passos
Agora que os processos para envio dos dados foram apresentados, é possível efetuar um processo completo de sincronização dos dados com a plataforma Carol. Esses passos descritos nesta seção são os mesmos que o Carol Connect (2C) utiliza.
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas