Operação

Operação & observabilidade

Checklist de erros comuns, consultas prontas para troubleshooting e consumo de IA, e onde acompanhar custo/saúde do ambiente sem precisar de nenhuma ferramenta extra.

O ambiente registra, em TB_26AI_TECH_LOG, cada chamada feita ao Generative AI e aos embeddings — sucesso ou erro — para que a operação do dia a dia não dependa de abrir um chamado toda vez que algo não funcionar de primeira. Use as consultas desta página para diagnosticar rapidamente qualquer problema, e o checklist abaixo para os casos mais comuns.

Checklist de erros comuns

O que TB_26AI_TECH_LOG guarda

Toda chamada a Generative AI/embeddings feita pelas funções internas do ampmInsights grava uma linha nesta tabela — sucesso ou erro, sem exceção. Guarda metadados de uso (função de origem, provider, modelo, duração, tamanho do prompt/resposta em caracteres, usuário, e o SQLCODE/SQLERRM quando há erro) — deliberadamente não guarda o prompt ou a resposta completos, só o tamanho, por privacidade e para não inchar a tabela.

Consultas prontas

SELECT log_ts, calling_object, operation, provider, model_name,
       error_code, error_message
FROM   TB_26AI_TECH_LOG
WHERE  status = 'ERROR'
AND    log_ts >= SYSTIMESTAMP - INTERVAL '24' HOUR
ORDER  BY log_ts DESC;

SELECT TRUNC(log_ts) AS dia, calling_object, model_name,
       COUNT(*) AS total,
       SUM(CASE WHEN status = 'ERROR' THEN 1 ELSE 0 END) AS erros,
       ROUND(100 * SUM(CASE WHEN status = 'ERROR' THEN 1 ELSE 0 END) / COUNT(*), 1) AS pct_erro
FROM   TB_26AI_TECH_LOG
GROUP  BY TRUNC(log_ts), calling_object, model_name
ORDER  BY dia DESC, pct_erro DESC;

SELECT log_ts, calling_object, operation, model_name, duration_ms, status
FROM   TB_26AI_TECH_LOG
WHERE  duration_ms IS NOT NULL
ORDER  BY duration_ms DESC
FETCH FIRST 20 ROWS ONLY;

SELECT l.log_ts, l.source_type, l.source_id, l.error_message,
       v.asset_name, v.definition_name
FROM   TB_26AI_TECH_LOG l
LEFT JOIN TB_26AI_TECH_v2 v ON v.rowid = CHARTOROWID(l.source_id)
WHERE  l.status = 'ERROR'
AND    l.source_id IS NOT NULL
ORDER  BY l.log_ts DESC;

DECLARE
  v_days TB_26AI_TECH_PARAMS.PARAM_VALUE%TYPE;
BEGIN
  SELECT param_value INTO v_days FROM TB_26AI_TECH_PARAMS WHERE param_name = 'AI_LOG_RETENTION_DAYS';
  DELETE FROM TB_26AI_TECH_LOG WHERE log_ts < SYSTIMESTAMP - NUMTODSINTERVAL(v_days, 'DAY');
  COMMIT;
END;
/

Application Settings do APEX — uma segunda fonte de configuração

A funcionalidade "AI Insight" (lupa na lista de vulnerabilidades) não lê EMBEDDING_COMPARTMENT direto de TB_26AI_TECH_PARAMS — o processo da página usa apex_app_setting.get_value('OCI_CREDENTIAL') e apex_app_setting.get_value('COMPARTMENT_ID'), valores configurados dentro do próprio APEX (App Builder → Shared Components → Application Settings), separados da tabela de configuração do banco.

Confira direto no App Builder: abra a aplicação → Shared Components → Application Settings, e compare os três valores acima com a TB_26AI_TECH_PARAMS atual. Sempre que corrigir EMBEDDING_COMPARTMENT ou GENAI_REGION no banco, atualize também aqui — são dois lugares de armazenamento independentes, corrigir um não corrige o outro.

Ferramentas nativas — sem código novo