Passar para o conteúdo principal

Como ler suas Estatísticas de Uso das Integrações

A página de Usage Stats mostra, em um só lugar, quanto do seu plano de Integrations já foi consumido, quais fluxos mais consomem tarefas e como exportar esses dados. Você a encontra em Painel administrativo › Estatísticas de uso › aba Integrações

Escrito por Product Team

O que é uma tarefa faturável

Uma tarefa faturável é qualquer ação ou etapa concluída com sucesso dentro de um fluxo de Integrations que consome recursos da plataforma para executar lógica externa ou processar dados. Essas tarefas são contabilizadas na cota mensal do seu plano.

Princípio principal: só cobramos tarefas concluídas com sucesso. Ações que terminam em erro ou timeout não são cobradas.

O que conta como tarefa faturável:

Categoria

Descrição

App Connections

Qualquer integração com serviços de terceiros (ex.: Google Sheets, Slack, OpenAI).

HTTP Request

Qualquer chamada externa feita pela piece de HTTP.

Code Piece

Execução de código JavaScript/TypeScript customizado.

Data Helpers

Operações de manipulação de listas, objetos ou strings.

Ações dentro de Loop

Cada ação executada a cada iteração de um loop.

Storage

Ações de Get, Put ou Delete no banco de dados interno.

O que NÃO conta como tarefa faturável:

  • Gatilhos (Triggers): o evento que inicia o fluxo (ex.: Webhook ou Schedule) nunca conta como etapa.

  • Branch (Router/If-Else): a avaliação de condições lógicas não consome tarefas.

  • O nó do Loop (For Each) em si: o nó controlador é gratuito.

  • Execuções com falha: qualquer etapa que termine em erro ou timeout fica fora da contagem.

Como funciona a contagem dentro de loops (exemplo prático)

O nó do loop é gratuito, mas cada ação executada dentro dele conta uma vez por iteração.

Imagine um fluxo com um loop que percorre uma lista de 50 clientes. Dentro do loop existem duas ações: atualizar uma planilha no Google Sheets (App Connection) e uma chamada HTTP. O nó do loop não é cobrado, mas as duas ações rodam a cada volta:

50 iterações × 2 ações = 100 tarefas faturáveis.

Ou seja, ao desenhar fluxos com loops, lembre-se de que o consumo cresce conforme o tamanho da lista percorrida.



Entendendo os cards principais

No topo da página você encontra dois indicadores.

Tarefas Consumidas mostra quantas tarefas foram consumidas em relação ao limite do seu plano (ex.: 11.250.000 / 25.000.000), junto com uma barra de progresso e a porcentagem utilizada. A cor da barra muda conforme o nível de uso:

  • Azul — abaixo de 80% do limite.

  • Amarelo — entre 80% e 99% (você verá o aviso "Você está chegando no seu limite de tarefas").

  • Vermelho — 100% ou mais (você verá o aviso "Você excedeu o seu limite de tarefas.").

  • Cinza — usado quando você está visualizando dados de um período passado, como no filtro "últimos 3 meses".


Importante sobre o filtro "últimos 3 meses": quando esse filtro está ativo, tanto o consumo quanto o limite do plano são somados pelos três meses. Por exemplo, se o seu limite mensal é de 25.000.000, o campo /25.000.000 passa a exibir /75.000.000 (25.000.000 × 3), e a barra aparece em cinza. Assim você compara o total consumido com o total contratado no período.

Fluxos ativos mostra quantos fluxos estão ativos atualmente na sua organização.


Gráfico "Detalhamento do consumo de tarefas"

O gráfico exibe a evolução do consumo de tarefas ao longo do período de faturamento selecionado. A linha azul representa o consumo acumulado e a linha tracejada representa o limite mensal do plano. Passe o mouse sobre cada ponto para ver os valores daquela semana ou mês, e use a legenda no topo do gráfico para identificar cada linha. Isso ajuda a identificar picos incomuns de consumo.


Filtros de período

Use o seletor no topo da página para alternar entre Este mês, Mês passado e Últimos 3 meses . Ao trocar o período, todos os componentes da página — cards, gráfico e tabela — são atualizados automaticamente para exibir apenas os dados daquele intervalo.


Tabela "Detalhe de integrações"

A tabela lista as integrações da sua organização, ranqueadas pelo volume de tarefas consumidas no período selecionado. As colunas são:

  • Fluxo — nome da integração/fluxo.

  • Pipe — o Pipe ao qual a integração pertence.

  • Tarefas — total de tarefas consumidas pela integração no período.

  • % do total — quanto essa integração representa do consumo total.

  • Execuções do fluxo — quantas vezes o fluxo foi executado.

  • Ultima execução — data/hora da última execução.

  • Estado — situação atual da integração.

Como a lista já é ordenada automaticamente pelo maior consumo de tarefas no período, não há opção de ordenação manual das colunas. Você pode usar o campo de busca para localizar uma integração ou Pipe específico, e o filtro de Estado para refinar a lista.


Baixar relatório

Clique em Baixar relatório para exportar os dados. O relatório é gerado de forma assíncrona, em segundo plano: você verá uma mensagem confirmando que ele está sendo gerado e será enviado por e-mail. Quando estiver pronto, o relatório é enviado automaticamente para o e-mail de quem solicitou, em formato CSV ou XLSX. O arquivo reflete exatamente os dados e o período que estavam selecionados na tela.

Respondeu à sua pergunta?