{"id":1605,"date":"2020-09-20T17:52:02","date_gmt":"2020-09-20T20:52:02","guid":{"rendered":"https:\/\/kondado.com.br\/blog\/wiki\/?p=1605"},"modified":"2026-04-08T17:49:08","modified_gmt":"2026-04-08T20:49:08","slug":"api-logs","status":"publish","type":"post","link":"https:\/\/kondado.com.br\/blog\/wiki\/2020\/09\/20\/api-logs\/","title":{"rendered":"Logs"},"content":{"rendered":"\n<p>Os objetos de logs guardam dados sobre as execu\u00e7\u00f5es de integra\u00e7\u00f5es e modelos. Com este endpoint, voc\u00ea pode consultar quando suas integra\u00e7\u00f5es e modelos foram executados pela \u00faltima vez e, ent\u00e3o, disparar outros processos do seu stack de analytics.<\/p>\n\n\n\n<p>Caso voc\u00ea utilize a Kondado para criar uma tabela de features que alimenta um ML, por exemplo, voc\u00ea pode consultar se j\u00e1 recebeu novos dados que permitem um novo treinamento. Um outro exemplo \u00e9, caso voc\u00ea utilize a Kondado para alimentar um banco de dados de staging para um banco em produ\u00e7\u00e3o, voc\u00ea pode consultar os logs de integra\u00e7\u00f5es para verificar se j\u00e1 h\u00e1 novos dados a serem consumidos.<\/p>\n\n\n\n<p>Este endpoint utiliza o conceito de scrolling, onde os dados s\u00e3o disponibilizados em blocos de 50 registros em order ascendente, sendo necess\u00e1rio informar o par\u00e2metro que indica o id de registro mais antigo que se deseja obter<\/p>\n\n\n\n<p>Obviamente, voc\u00ea pode tamb\u00e9m obter os dados de logs diretamente com o <a href=\"https:\/\/kondado.com.br\/blog\/wiki\/adicionando-o-conector-da-kondado\/\">nosso conector gratuito de logs, que consome os dados desta API<\/a><\/p>\n\n\n\n<h2>Listar logs de integra\u00e7\u00f5es<\/h2>\n\n\n\n<h3>Descri\u00e7\u00e3o<\/h3>\n\n\n\n<p>Lista os logs das integra\u00e7\u00f5es que o usu\u00e1rio tem acesso. Apenas os \u00faltimos 90 dias de dados est\u00e3o dispon\u00edveis<\/p>\n\n\n\n<h3>M\u00e9todo<\/h3>\n\n\n\n<p>GET<\/p>\n\n\n\n<h3>Endpoint<\/h3>\n\n\n\n<p>\/pipeline_logs<\/p>\n\n\n\n<h3>Par\u00e2metros da URL<\/h3>\n\n\n\n<p><strong>client_id<\/strong><\/p>\n\n\n\n<ul><li><strong>Descri\u00e7\u00e3o:<\/strong> Par\u00e2metro que indica o id da conta que se deseja buscar os logs. Caso n\u00e3o seja informado, s\u00e3o disponibilizados dados de todas as contas que o token possui acesso<\/li><li><strong>Obrigat\u00f3rio<\/strong>: n\u00e3o<\/li><li><strong>Formato<\/strong>: n\u00famero inteiro<\/li><\/ul>\n\n\n\n<p class=\"has-text-align-left\"><strong>start_element_id<\/strong><\/p>\n\n\n\n<ul><li><strong>Descri\u00e7\u00e3o:<\/strong> Par\u00e2metro que indica o id do elemento mais antigo que se deseja obter<\/li><li><strong>Obrigat\u00f3rio:<\/strong> sim<\/li><li><strong>Formato<\/strong>: n\u00famero inteiro<\/li><\/ul>\n\n\n\n<h3>Exemplo de resposta<\/h3>\n\n\n\n<pre class=\"wp-block-preformatted\">{\n     \"success\": true,\n     \"data\": {\n         \"success\": true,\n         \"data\": [\n             {\n                 \"id\": 5181910,\n                 \"client_id\": 1,\n                 \"pipeline_id\": 702,\n                 \"execution_time_seconds\": \"0.486988\",\n                 \"has_deltas\": false,\n                 \"pipeline_name\": \"Kondado - Blog - wp_options\",\n                 \"row_count\": \"256\",\n                 \"createdAt\": \"2020-09-17T00:03:48.108Z\",\n                 \"updatedAt\": \"2020-09-17T00:03:48.108Z\",\n                 \"initial_savepoint\": null,\n                 \"new_savepoint\": null,\n                 \"external_ip\": \"3.220.239.218\",\n                 \"is_billable\": true,\n                 \"raw_row_count\": \"123\",\n                 \"mb_estimate\": \"0.00231\"\n             }\n         ],\n         \"pagination\": {\n             \"next_start_element_id\": 5181910\n         }\n     }\n }<\/pre>\n\n\n\n<h3>Descri\u00e7\u00e3o do retorno<\/h3>\n\n\n\n<p>O objeto <strong>data<\/strong> ir\u00e1 retornar um array de JSON com os 50 registros de logs posteriores ao <strong>start_element_id<\/strong> informado<\/p>\n\n\n\n<p>O objeto <strong>pagination<\/strong> ir\u00e1 retornar o par\u00e2metro <strong>next_start_element_id<\/strong> que pode ser utilizado em uma chamada posterior para obter a pr\u00f3xima p\u00e1gina de resultados. Caso seja nulo, n\u00e3o h\u00e1 mais logs posteriores ao <strong>start_element_id<\/strong> informado (fim da pagina\u00e7\u00e3o)<\/p>\n\n\n\n<p>O JSON do objeto <strong>data<\/strong> conter\u00e1 os seguintes campos:<\/p>\n\n\n\n<p><strong>id<\/strong><\/p>\n\n\n\n<p>ID do registro de log<\/p>\n\n\n\n<p><strong>createdAt<\/strong><\/p>\n\n\n\n<p>Data de cria\u00e7\u00e3o do registro  de log (em UTC) &#8211; indica quando a integra\u00e7\u00e3o terminou de executar.<\/p>\n\n\n\n<p><strong>updatedAt<\/strong><\/p>\n\n\n\n<p>Data de atualiza\u00e7\u00e3o do registro de log (em UTC). Geralmente \u00e9 o mesmo que &#8220;createdAt&#8221;, mas pode ser diferente caso o log seja alterado ap\u00f3s sua cria\u00e7\u00e3o.<\/p>\n\n\n\n<p><strong>pipeline_id<\/strong><\/p>\n\n\n\n<p>ID da integra\u00e7\u00e3o a qual o log pertence<\/p>\n\n\n\n<p><strong>pipeline_name<\/strong><\/p>\n\n\n\n<p>Nome da integra\u00e7\u00e3o no momento em que o log foi criado<\/p>\n\n\n\n<p><strong>client_id<\/strong><\/p>\n\n\n\n<p>ID do cliente a qual a integra\u00e7\u00e3o pertence<\/p>\n\n\n\n<p><strong>has_deltas<\/strong><\/p>\n\n\n\n<p>Booleano que indica se a integra\u00e7\u00e3o guardou deltas no momento da cria\u00e7\u00e3o do log.<\/p>\n\n\n\n<p><strong>execution_time_seconds<\/strong><\/p>\n\n\n\n<p>Tempo em segundos que a integra\u00e7\u00e3o demorou para executar neste registro de log &#8211; n\u00e3o considerando o tempo de setup inicial da integra\u00e7\u00e3o (que envolve coisas como leitura de metadados sobre a integra\u00e7\u00e3o, conector e destino).<\/p>\n\n\n\n<p><strong>row_count<\/strong><\/p>\n\n\n\n<p>N\u00famero de registros integrados<\/p>\n\n\n\n<p><strong>is_billable<\/strong><\/p>\n\n\n\n<p>Booleano que indica se as linhas integradas em row_count contaram das linhas do seu plano ou se foram gratuitas<\/p>\n\n\n\n<p><strong>initial_savepoint<\/strong><\/p>\n\n\n\n<p>Caso a integra\u00e7\u00e3o seja incremental, indica o savepoint a partir de qual os dados foram lidos. NULL para integra\u00e7\u00f5es integrais<\/p>\n\n\n\n<p><strong>new_savepoint<\/strong><\/p>\n\n\n\n<p>Caso a integra\u00e7\u00e3o seja incremental, indica o novo savepoint gerado ap\u00f3s a execu\u00e7\u00e3o da integra\u00e7\u00e3o. NULL para integra\u00e7\u00f5es integrais<\/p>\n\n\n\n<p><strong>external_ip<\/strong><\/p>\n\n\n\n<p>Indica o <a href=\"https:\/\/kondado.com.br\/blog\/wiki\/ips-kondado\/\" data-type=\"URL\" data-id=\"https:\/\/kondado.com.br\/blog\/wiki\/ips-kondado\/\">IP do servidor da Kondado<\/a> que executou a integra\u00e7\u00e3o.<\/p>\n\n\n\n<p><strong>raw_row_count<\/strong><\/p>\n\n\n\n<p>N\u00famero de linhas integradas. Este campo estar\u00e1 preenchido a partir de 12 de junho de 2025, para datas anteriores o campo row_count \u00e9 equivalente<\/p>\n\n\n\n<p><strong>mb_estimate<\/strong><\/p>\n\n\n\n<p>Tamanho em MB dos dados inseridos pela execu\u00e7\u00e3o<\/p>\n\n\n\n<h2>Listar logs de modelos<\/h2>\n\n\n\n<h3>Descri\u00e7\u00e3o<\/h3>\n\n\n\n<p>Lista os logs dos modelos que o usu\u00e1rio tem acesso.<\/p>\n\n\n\n<h3>M\u00e9todo<\/h3>\n\n\n\n<p>GET<\/p>\n\n\n\n<h3>Endpoint<\/h3>\n\n\n\n<p>\/model_logs<\/p>\n\n\n\n<h3>Par\u00e2metros da URL<\/h3>\n\n\n\n<p><strong>client_id<\/strong><\/p>\n\n\n\n<ul><li><strong>Descri\u00e7\u00e3o:<\/strong> Par\u00e2metro que indica o id da conta que se deseja buscar os logs. Caso n\u00e3o seja informado, s\u00e3o disponibilizados dados de todas as contas que o token possui acesso<\/li><li><strong>Obrigat\u00f3rio<\/strong>: n\u00e3o<\/li><li><strong>Formato<\/strong>: n\u00famero inteiro<\/li><\/ul>\n\n\n\n<p class=\"has-text-align-left\"><strong>start_element_id<\/strong><\/p>\n\n\n\n<ul><li><strong>Descri\u00e7\u00e3o:<\/strong> Par\u00e2metro que indica o id do elemento mais antigo que se deseja obter<\/li><li><strong>Obrigat\u00f3rio:<\/strong> sim<\/li><li><strong>Formato<\/strong>: n\u00famero inteiro<\/li><\/ul>\n\n\n\n<h3>Exemplo de resposta<\/h3>\n\n\n\n<pre class=\"wp-block-preformatted\">{\n     \"success\": true,\n     \"data\": {\n         \"success\": true,\n         \"data\": [\n             {\n                 \"id\": 5219430,\n                 \"client_id\": 1,\n                 \"model_id\": 162,\n                 \"execution_time_seconds\": 0.201923,\n                 \"model_name\": \"Kondado - Leads\",\n                 \"row_count\": 4915,\n                 \"createdAt\": \"2020-09-17T00:05:00.892Z\",\n                 \"updatedAt\": \"2020-09-17T00:05:00.892Z\"\n             }\n         ],\n         \"pagination\": {\n             \"next_start_element_id\": 5219430\n         }\n     }\n }<\/pre>\n\n\n\n<h3>Descri\u00e7\u00e3o do retorno<\/h3>\n\n\n\n<p>O objeto <strong>data<\/strong> ir\u00e1 retornar um array de JSON com os 50 registros de logs posteriores ao <strong>start_element_id<\/strong> informado<\/p>\n\n\n\n<p>O objeto <strong>pagination<\/strong> ir\u00e1 retornar o par\u00e2metro <strong>next_start_element_id<\/strong> que pode ser utilizado em uma chamada posterior para obter a pr\u00f3xima p\u00e1gina de resultados. Caso seja nulo, n\u00e3o h\u00e1 mais logs posteriores ao <strong>start_element_id<\/strong> informado (fim da pagina\u00e7\u00e3o)<\/p>\n\n\n\n<p>O JSON do objeto <strong>data<\/strong> conter\u00e1 os seguintes campos:<\/p>\n\n\n\n<p><strong>id<\/strong><\/p>\n\n\n\n<p>ID do registro de log<\/p>\n\n\n\n<p><strong>createdAt<\/strong><\/p>\n\n\n\n<p>Data de cria\u00e7\u00e3o do registro de log (em UTC) &#8211; indica quando o modelo terminou de executar.<\/p>\n\n\n\n<p><strong>updatedAt<\/strong><\/p>\n\n\n\n<p>Data de atualiza\u00e7\u00e3o do registro de log (em UTC). Geralmente \u00e9 o mesmo que &#8220;createdAt&#8221;, mas pode ser diferente caso o log seja alterado ap\u00f3s sua cria\u00e7\u00e3o.<\/p>\n\n\n\n<p><strong>model_id<\/strong><\/p>\n\n\n\n<p>ID da modelo a qual o log pertence<\/p>\n\n\n\n<p><strong>model_name<\/strong><\/p>\n\n\n\n<p>Nome da modelo no momento em que o log foi criado<\/p>\n\n\n\n<p><strong>client_id<\/strong><\/p>\n\n\n\n<p>ID do cliente a qual o modelo pertence<\/p>\n\n\n\n<p><strong>execution_time_seconds<\/strong><\/p>\n\n\n\n<p>Tempo em segundos que o modelo demorou para executar neste registro de log &#8211; n\u00e3o considerando o tempo de setup inicial da integra\u00e7\u00e3o (que envolve coisas como leitura de metadados sobre a integra\u00e7\u00e3o, conector e destino).<\/p>\n\n\n\n<p><strong>row_count<\/strong><\/p>\n\n\n\n<p>N\u00famero de linhas existentes na tabela gerada pelo modelo<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Documenta\u00e7\u00e3o da API da Kondado: endpoint de Logs. Consulte o hist\u00f3rico de execu\u00e7\u00f5es das suas integra\u00e7\u00f5es e modelos via API.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[334],"tags":[],"_links":{"self":[{"href":"https:\/\/kondado.com.br\/blog\/wiki\/wp-json\/wp\/v2\/posts\/1605"}],"collection":[{"href":"https:\/\/kondado.com.br\/blog\/wiki\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/kondado.com.br\/blog\/wiki\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/kondado.com.br\/blog\/wiki\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/kondado.com.br\/blog\/wiki\/wp-json\/wp\/v2\/comments?post=1605"}],"version-history":[{"count":14,"href":"https:\/\/kondado.com.br\/blog\/wiki\/wp-json\/wp\/v2\/posts\/1605\/revisions"}],"predecessor-version":[{"id":11142,"href":"https:\/\/kondado.com.br\/blog\/wiki\/wp-json\/wp\/v2\/posts\/1605\/revisions\/11142"}],"wp:attachment":[{"href":"https:\/\/kondado.com.br\/blog\/wiki\/wp-json\/wp\/v2\/media?parent=1605"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/kondado.com.br\/blog\/wiki\/wp-json\/wp\/v2\/categories?post=1605"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/kondado.com.br\/blog\/wiki\/wp-json\/wp\/v2\/tags?post=1605"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}