Erro

// npm install termo_core --save-exact
import * as tracing from "termo_core/tracing";
// ou: import { tracing } from "termo_core";

buscar_paginador_erroCopiar link

Lista os erros paginados

Qualquer colaborador da Termotubos logado no TermoAuth (perfil employee); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do sub do token): registro de outra conta responde como não encontrado. Lista os grupos de erro não excluídos da conta, do que afetou mais usuários para o que afetou menos e, no empate, do que ocorreu mais vezes. aplicativo_id filtra pelo aplicativo e status pela situação (ABERTO, RESOLVIDO ou IGNORADO, sem diferenciar maiúsculas). pagina começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro tamanho é aceito, mas ignorado. A resposta traz itens, total (quantidade de registros que casam com os filtros), pagina e tamanho (50). Parâmetros de consulta, todos opcionais: pagina: número da página, começando em 1 (padrão 1; menor que 1 vira 1); tamanho: aceito, mas ignorado: a página tem sempre 50 itens; aplicativo_id: id do aplicativo (opcional); status: ABERTO, RESOLVIDO ou IGNORADO, sem diferenciar maiúsculas (opcional).

function buscar_paginador_erro(
  credencial_de_acesso: CredencialDeAcesso,
  parametros: ParametrosDeBuscarPaginadorErro = {},
  opcoes_da_chamada?: OpcoesDaChamada,
): Promise<tipos.PaginaErro>

import { CredencialDeAcesso } from "termo_core";
import { buscar_paginador_erro } from "termo_core/tracing";

const credencial_de_acesso = CredencialDeAcesso.token_do_usuario_logado(token_do_usuario);
const resposta = await buscar_paginador_erro(credencial_de_acesso, { pagina: 1 });

Argumentos

Retorno: Promise<tipos.PaginaErro> · Rust: Result<tipos::PaginaErro, ErroAoChamarServico> · veja PaginaErro.

criar_erroCopiar link

Cadastra um erro

Qualquer colaborador da Termotubos logado no TermoAuth (perfil employee); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do sub do token): registro de outra conta responde como não encontrado. Registra a ocorrência de um erro num aplicativo da conta (os erros normalmente são agrupados sozinhos a partir dos eventos da ingestão). aplicativo_id precisa ser de um aplicativo da conta; mensagem é obrigatória; tipo aceita um dos tipos de evento (ERRO_JS, PROMISE_REJEITADA, CONSOLE, REQUISICAO, NAVEGACAO, SAIDA, PULSO, CLIQUE, DESEMPENHO, IDENTIFICACAO ou PERSONALIZADO). Erros com o mesmo tipo, mensagem, arquivo e linha formam um só grupo na conta: se o grupo já existe, a ocorrência soma 1 e o grupo existente é devolvido. Campos do corpo: aplicativo_id: id de um aplicativo da conta (obrigatório); tipo: tipo do erro (obrigatório): ERRO_JS, PROMISE_REJEITADA, CONSOLE, REQUISICAO, NAVEGACAO, SAIDA, PULSO, CLIQUE, DESEMPENHO, IDENTIFICACAO ou PERSONALIZADO; mensagem: mensagem do erro (obrigatória, não pode ficar vazia); arquivo: arquivo onde o erro ocorreu (opcional); linha: linha do erro (opcional); pilha: pilha de chamadas (opcional).

function criar_erro(
  credencial_de_acesso: CredencialDeAcesso,
  corpo_da_requisicao: tipos.ErroCriar,
  opcoes_da_chamada?: OpcoesDaChamada,
): Promise<tipos.Erro>

import { CredencialDeAcesso } from "termo_core";
import { criar_erro } from "termo_core/tracing";

const credencial_de_acesso = CredencialDeAcesso.token_do_usuario_logado(token_do_usuario);
const resposta = await criar_erro(credencial_de_acesso, corpo_da_requisicao);

Argumentos

Retorno: Promise<tipos.Erro> · Rust: Result<tipos::Erro, ErroAoChamarServico> · veja Erro.

buscar_auto_complete_erroCopiar link

Lista básica de erros para seleção

Qualquer colaborador da Termotubos logado no TermoAuth (perfil employee); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do sub do token): registro de outra conta responde como não encontrado. Devolve só id e rótulo (a mensagem do erro), em ordem alfabética da mensagem. busca procura o trecho na mensagem, sem diferenciar maiúsculas. pagina começa em 1 (padrão 1) e tamanho tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz itens, total, pagina e tamanho. Parâmetros de consulta, todos opcionais: busca: trecho da mensagem, sem diferenciar maiúsculas (opcional); pagina: número da página, começando em 1 (padrão 1; menor que 1 vira 1); tamanho: itens por página (padrão 10, sem máximo; menor que 1 vira 1).

function buscar_auto_complete_erro(
  credencial_de_acesso: CredencialDeAcesso,
  parametros: ParametrosDeBuscarAutoCompleteErro = {},
  opcoes_da_chamada?: OpcoesDaChamada,
): Promise<tipos.PaginaErroAutoComplete>

import { CredencialDeAcesso } from "termo_core";
import { buscar_auto_complete_erro } from "termo_core/tracing";

const credencial_de_acesso = CredencialDeAcesso.token_do_usuario_logado(token_do_usuario);
const resposta = await buscar_auto_complete_erro(credencial_de_acesso, { busca: "..." });

Argumentos

Retorno: Promise<tipos.PaginaErroAutoComplete> · Rust: Result<tipos::PaginaErroAutoComplete, ErroAoChamarServico> · veja PaginaErroAutoComplete.

buscar_pelo_filtro_erroCopiar link

Busca erros por filtro

Qualquer colaborador da Termotubos logado no TermoAuth (perfil employee); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do sub do token): registro de outra conta responde como não encontrado. Devolve todos os grupos de erro não excluídos da conta que casam com o filtro, sem paginação, do que afetou mais usuários para o que afetou menos. aplicativo_id filtra pelo aplicativo; mensagem procura o trecho na mensagem; tipo, status (ABERTO, RESOLVIDO ou IGNORADO) e navegador comparam o valor exato, sem diferenciar maiúsculas; inicio traz os que ocorreram de novo a partir dessa data e hora e fim os que começaram até ela (ISO 8601). Sem filtro, devolve todos. Parâmetros de consulta, todos opcionais: aplicativo_id: id do aplicativo; mensagem: trecho da mensagem, sem diferenciar maiúsculas; tipo: tipo do erro (sem diferenciar maiúsculas): ERRO_JS, PROMISE_REJEITADA, CONSOLE, REQUISICAO, NAVEGACAO, SAIDA, PULSO, CLIQUE, DESEMPENHO, IDENTIFICACAO ou PERSONALIZADO; status: ABERTO, RESOLVIDO ou IGNORADO (sem diferenciar maiúsculas); navegador: navegador onde ocorreu (valor exato, sem diferenciar maiúsculas); inicio: erros com ocorrência a partir desta data e hora ISO 8601, por exemplo 2026-10-07T00:00:00Z; fim: erros cuja primeira ocorrência foi até esta data e hora ISO 8601.

function buscar_pelo_filtro_erro(
  credencial_de_acesso: CredencialDeAcesso,
  parametros: ParametrosDeBuscarPeloFiltroErro = {},
  opcoes_da_chamada?: OpcoesDaChamada,
): Promise<Array<tipos.Erro>>

import { CredencialDeAcesso } from "termo_core";
import { buscar_pelo_filtro_erro } from "termo_core/tracing";

const credencial_de_acesso = CredencialDeAcesso.token_do_usuario_logado(token_do_usuario);
const resposta = await buscar_pelo_filtro_erro(credencial_de_acesso, { aplicativo_id: "..." });

Argumentos

Retorno: Promise<Array<tipos.Erro>> · Rust: Result<Vec<tipos::Erro>, ErroAoChamarServico>

buscar_pelo_id_erroCopiar link

Busca um erro pelo id

Qualquer colaborador da Termotubos logado no TermoAuth (perfil employee); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do sub do token): registro de outra conta responde como não encontrado. Devolve o erro pelo id; registro excluído não é encontrado.

function buscar_pelo_id_erro(
  credencial_de_acesso: CredencialDeAcesso,
  id: string,
  opcoes_da_chamada?: OpcoesDaChamada,
): Promise<tipos.Erro>

import { CredencialDeAcesso } from "termo_core";
import { buscar_pelo_id_erro } from "termo_core/tracing";

const credencial_de_acesso = CredencialDeAcesso.token_do_usuario_logado(token_do_usuario);
const resposta = await buscar_pelo_id_erro(credencial_de_acesso, id);

Argumentos

Retorno: Promise<tipos.Erro> · Rust: Result<tipos::Erro, ErroAoChamarServico> · veja Erro.

atualizar_pelo_id_erroCopiar link

Atualiza um erro pelo id

Qualquer colaborador da Termotubos logado no TermoAuth (perfil employee); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do sub do token): registro de outra conta responde como não encontrado. Atualização parcial: só os campos enviados mudam. Muda o status do grupo de erro: ABERTO, RESOLVIDO ou IGNORADO. Campos do corpo, todos opcionais: status: nova situação: ABERTO, RESOLVIDO ou IGNORADO.

function atualizar_pelo_id_erro(
  credencial_de_acesso: CredencialDeAcesso,
  id: string,
  corpo_da_requisicao: tipos.ErroAtualizar,
  opcoes_da_chamada?: OpcoesDaChamada,
): Promise<tipos.Erro>

import { CredencialDeAcesso } from "termo_core";
import { atualizar_pelo_id_erro } from "termo_core/tracing";

const credencial_de_acesso = CredencialDeAcesso.token_do_usuario_logado(token_do_usuario);
const resposta = await atualizar_pelo_id_erro(credencial_de_acesso, id, corpo_da_requisicao);

Argumentos

Retorno: Promise<tipos.Erro> · Rust: Result<tipos::Erro, ErroAoChamarServico> · veja Erro.

deletar_pelo_id_erroCopiar link

Exclui um erro pelo id

Qualquer colaborador da Termotubos logado no TermoAuth (perfil employee); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do sub do token): registro de outra conta responde como não encontrado. Exclusão lógica: o registro some das leituras, mas não é apagado na hora.

function deletar_pelo_id_erro(
  credencial_de_acesso: CredencialDeAcesso,
  id: string,
  opcoes_da_chamada?: OpcoesDaChamada,
): Promise<void>

import { CredencialDeAcesso } from "termo_core";
import { deletar_pelo_id_erro } from "termo_core/tracing";

const credencial_de_acesso = CredencialDeAcesso.token_do_usuario_logado(token_do_usuario);
await deletar_pelo_id_erro(credencial_de_acesso, id);

Argumentos

Retorno: Promise<void> · Rust: Result<(), ErroAoChamarServico> · sem corpo na resposta.

TiposCopiar link

Tipos usados pelas funções desta página. O nome é o mesmo nos dois pacotes.

ErroCopiar link

import type { Erro } from "termo_core/tracing";

export interface Erro {
  aplicativo_id: string;
  arquivo?: string | null;
  assinatura: string;
  conta_id: string;
  id: string;
  linha?: number | null;
  mensagem: string;
  navegadores: Array<string>;
  ocorrencias: number;
  paginas: Array<string>;
  pilha?: string | null;
  primeira_ocorrencia_em: string;
  status: string;
  tipo: string;
  ultima_ocorrencia_em: string;
  usuarios: Array<string>;
  usuarios_afetados: number;
}

ErroAtualizarCopiar link

import type { ErroAtualizar } from "termo_core/tracing";

export interface ErroAtualizar {
  status?: string | null;
}

ErroCriarCopiar link

import type { ErroCriar } from "termo_core/tracing";

export interface ErroCriar {
  aplicativo_id: string;
  arquivo?: string | null;
  linha?: number | null;
  mensagem: string;
  pilha?: string | null;
  tipo: string;
}

PaginaErroCopiar link

import type { PaginaErro } from "termo_core/tracing";

export interface PaginaErro {
  itens: Array<PaginaErroItensItem>;
  pagina: number;
  tamanho: number;
  total: number;
}

PaginaErroAutoCompleteCopiar link

import type { PaginaErroAutoComplete } from "termo_core/tracing";

export interface PaginaErroAutoComplete {
  itens: Array<PaginaErroAutoCompleteItensItem>;
  pagina: number;
  tamanho: number;
  total: number;
}

PaginaErroAutoCompleteItensItemCopiar link

import type { PaginaErroAutoCompleteItensItem } from "termo_core/tracing";

export interface PaginaErroAutoCompleteItensItem {
  id: string;
  rotulo: string;
}

PaginaErroItensItemCopiar link

import type { PaginaErroItensItem } from "termo_core/tracing";

export interface PaginaErroItensItem {
  aplicativo_id: string;
  arquivo?: string | null;
  assinatura: string;
  conta_id: string;
  id: string;
  linha?: number | null;
  mensagem: string;
  navegadores: Array<string>;
  ocorrencias: number;
  paginas: Array<string>;
  pilha?: string | null;
  primeira_ocorrencia_em: string;
  status: string;
  tipo: string;
  ultima_ocorrencia_em: string;
  usuarios: Array<string>;
  usuarios_afetados: number;
}