Este artigo oferece uma análise técnica aprofundada da view de performance dinâmica V$PROCESS_MEMORY_DETAIL_PROG no Oracle 19C. Esta view fornece informações de diagnóstico mais detalhadas e granulares do que a V$PROCESS_MEMORY_DETAIL, correlacionando alocações de memória a chamadas de funções internas (funções C).

1. Propósito e Visão Geral

A view V$PROCESS_MEMORY_DETAIL_PROG fornece estatísticas sobre memória alocada dentro de um processo Oracle por funções alocadoras específicas (Allocator Function).

Pode-se estabelecer uma analogia:

• V$PROCESS_MEMORY é a "conta resumida" (ex: alimentação, vestuário).
• V$PROCESS_MEMORY_DETAIL é o "extrato detalhado" (ex: supermercado, loja de departamento).
• V$PROCESS_MEMORY_DETAIL_PROG é o "ID do operador de caixa", indicando qual operador (função interna) processou cada transação específica.

Função Principal: Destina-se a diagnósticos profundos no nível de desenvolvimento e suporte interno da Oracle, especialmente para rastrear vazamentos de memória ou padrões anormais de alocação causados por funções C específicas. A granularidade das informações é extremamente fina, constituindo uma ferramenta definitiva para diagnosticar problemas complexos de memória.

2. Cenários de Utilização

1. Rastreamento da Fonte de Vazamentos de Memória no Nível Baixo: Quando a V$PROCESS_MEMORY_DETAIL já isolou o problema em um determinado sub-heap, esta view permite refinar a identificação para a função interna específica que está continuamente alocando memória naquele sub-heap sem liberá-la. É a "arma definitiva" para resolver problemas de vazamento.
2. Diagnóstico pelo Oracle Global Support Service (GSS): As informações fornecidas são evidências centrais para que os engenheiros de suporte da Oracle analisem erros internos relacionados à memória (como ORA-4030, ORA-7445). Eles utilizam o ALLOCATOR_CONTEXT para mapear o código-fonte e localizar potenciais defeitos (bugs).
3. Pesquisa de Mecanismos Internos: Utilizada para estudar o comportamento de memória subjacente de funcionalidades específicas do banco de dados (como compressão avançada, criptografia, processamento de tipos de dados), entendendo o overhead de memória de seus diferentes componentes internos.
4. Verificação da Eficácia de Correções: Após aplicar um patch que afirma corrigir um vazamento de memória, esta view pode ser usada para confirmar se o comportamento de alocação das funções internas relevantes normalizou.

Aviso Importante: O nível de rastreamento padrão geralmente não captura dados. Habilitar a coleta de dados requer a configuração de eventos de diagnóstico especiais, o que gera uma sobrecarga de performance significativa. Portanto, é absolutamente proibido usá-la em ambientes de produção sem a orientação do Oracle Support.

3. Detalhamento dos Campos

4. Views Relacionadas e Tabela Base

• V$PROCESS: Associada via PID para obter informações básicas do processo (SPID, PROGRAM).
• V$PROCESS_MEMORY_DETAIL: A view de nível superior direto. V$PROCESS_MEMORY_DETAIL_PROG é uma especialização dos seus dados. O ALLOCATED_BYTES de um par (HEAP_NAME, SUBHEAP_NAME) deve ser igual à soma dos ALLOCATED_BYTES de todos os ALLOCATOR_CONTEXT abaixo dele.
• Tabela Base (Underlying Table): Seus dados derivam do registro detalhado que o gerenciador de memória do Oracle faz de cada operação de alocação. A tabela X subjacente é normalmente X$KSMPP (Kernel Service Memory Programmatic Profiling) ou uma estrutura semelhante. Essas tabelas registram informações de rastreamento de memória no nível de chamada de função e não devem ser consultadas diretamente por usuários.

5. Princípios Detalhados e Conceitos Relacionados

1. Instrumentação de Alocação de Memória:
   • Para viabilizar esse rastreamento granular, o código de gerenciamento de memória da Oracle é altamente "instrumentado". Isso significa que, ao chamar uma função de baixo nível como kghalf() (Kernel Generic Heap Allocate Fixed) para alocar memória, o código registra automaticamente qual função de nível superior iniciou a chamada.
   • O campo ALLOCATOR_CONTEXT é o resultado desse registro, apontando para o "contexto de chamada" que iniciou a alocação.
2. Princípio de Funcionamento e Coleta de Dados:
   • Estado Padrão: Devido ao enorme custo de registrar a pilha de chamadas de cada alocação de memória, esta funcionalidade é desativada por padrão. Consultar a view normalmente retorna sem dados.
   • Habilitando o Rastreamento: É necessário configurar eventos de diagnóstico específicos para iniciar o Heap Level Tracking. O mais comum é: ``` ALTER SESSION SET EVENTS '10261 TRACE NAME CONTEXT FOREVER, LEVEL ';

     
      O valor de `LEVEL` controla a granularidade do rastreamento (por exemplo, Level 10 é usado para capturar o contexto do alocador). **Esta operação gera uma sobrecarga de performence enorme e deve ser usada apenas em ambientes de teste ou em produção sob orientação do Oracle Support.**
     

   • Uma vez habilitado, o gerenciador de memória começa a "marcar" as alocações, registrando seu ALLOCATOR_CONTEXT, e preenche os dados na tabela base X$KSMPP, que por fim são exibidos nesta view.
3. Associação com Diagnóstico de Erros:
   • Quando um processo falha devido a um problema de memória (como ORA-04030: out of process memory), um arquivo de rastreamento (trace file) é gerado.
   • O arquivo de rastreamento conterá um instantâneo do estado de memória do processo antes da falha, o qual pode incluir informações semelhantes às da V$PROCESS_MEMORY_DETAIL_PROG.
   • Engenheiros do Oracle Support comparam o contexto do alocador no arquivo de rastreamento com os resultados da consulta à V$PROCESS_MEMORY_DETAIL_PROG para confirmar a consistência e persistência do problema, e finalmente associar um contexto de alocação específico a um Bug conhecido ou a um novo problema no código.
4. Sobrecarga de Performance: Habilitar esta funcionalidade resulta em:
   • Aumento do consumo de CPU: Cada alocação de memória requer código adicional para registrar o contexto.
   • Aumento do consumo de memória: Memória adicional é necessária para armazenar essas informações detalhadas de rastreamento.
   • Possível aumento na contenção de locks: Atualizações nas estruturas de dados de rastreamento podem precisar de serialização.

6. Consultas SQL Comuns

1. Consultar as alocações de memória programática detalhadas de um processo específico
Consulta base para ordenar por tamanho de alocação de forma decrescente, identificando rapidamente as funções alocadoras mais ativas.

SELECT p.spid,
       d.heap_name,
       d.subheap_name,
       d.allocator_context, -- Campo central
       d.allocated_bytes / 1024 / 1024 AS allocated_mb,
       d.used_bytes / 1024 / 1024 AS used_mb,
       d.allocation_count,
       d.metadata
FROM v$process p
JOIN v$process_memory_detail_prog d ON p.pid = d.pid
WHERE p.spid = '&OS_PID' -- Substituir pelo SPID do sistema operacional alvo
ORDER BY d.allocated_bytes DESC;

2. Localizar os principais alocadores dentro de um sub-heap específico
Se o problema já foi isolado em um determinado sub-heap através da V$PROCESS_MEMORY_DETAIL, esta consulta encontra qual função está alocando dentro dele.

SELECT allocator_context,
       SUM(allocated_bytes) / 1024 / 1024 total_alloc_mb,
       SUM(used_bytes) / 1024 / 1024 total_used_mb,
       SUM(allocation_count) total_allocs,
       metadata
FROM v$process_memory_detail_prog
WHERE pid = (SELECT pid FROM v$process WHERE spid = '&OS_PID')
  AND subheap_name = '&SUSPECT_SUBHEAP' -- Exemplo: '*koh subheap*'
GROUP BY allocator_context, metadata
HAVING SUM(allocated_bytes) > 0
ORDER BY total_alloc_mb DESC;

3. Monitorar funções com contagem de alocação anormalmente alta
Uma alta contagem de alocações pode indicar muitas alocações pequenas de memória em um caminho de código, sendo um potencial gargalo de performance ou ponto de vazamento.

SELECT heap_name,
       subheap_name,
       allocator_context,
       allocation_count,
       allocated_bytes / 1024 / 1024 allocated_mb,
       (allocated_bytes / GREATEST(allocation_count, 1)) avg_alloc_bytes
FROM v$process_memory_detail_prog
WHERE pid = &TARGET_PID
  AND allocation_count > 10000
ORDER BY allocation_count DESC;

4. Combinar com informações de sessão para diagnóstico avançado
Associa as informações mais baixas do alocador a sessões de usuário.

SELECT s.sid,
       s.username,
       s.sql_id,
       s.module,
       p.spid,
       d.allocator_context,
       d.heap_name,
       d.subheap_name,
       d.allocated_bytes
FROM v$session s
JOIN v$process p ON s.paddr = p.addr
JOIN v$process_memory_detail_prog d ON p.pid = d.pid
WHERE d.allocated_bytes > 10 * 1024 * 1024 -- Alocação maior que 10MB
ORDER BY d.allocated_bytes DESC;

A V$PROCESS_MEMORY_DETAIL_PROG representa o "microscópio eletrônico" no ecossistema de diagnóstico de memória do Oracle. Oferece uma granularidade incomparável, rastreando o comportamento de alocação de memória até o nível de funções C. Seu valor principal está em permitir que o suporte interno da Oracle e sua equipe de suporte resolvam problemas relacionados a memória extremamente complexos e obscuros, como localizar vazamentos que requerem correções no código. Para a maioria das tarefas diárias de um DBA, a V$PROCESS_MEMORY e a V$PROCESS_MEMORY_DETAIL já são suficientes. O uso desta view exige conhecimento técnico extremamente elevado e requer uma avaliação cuidadosa do seu potencial impacto na performance do sistema. Seu principal objetivo não é o monitoramento proativo, mas sim o diagnóstico passivo e aprofundado após a ocorrência de problemas graves, em um ambiente controlado.