Analisar vários traces juntos

Com Analisar juntos, vários arquivos de trace viram uma análise só, a coleta. O WaitScope junta os trechos de cada arquivo na ordem do tempo e monta um relatório único, com o tempo total da operação inteira.

Quando usar

• A aplicação troca o tracefile_identifier no meio da operação. A mesma sessão continua em outro arquivo, e o Oracle marca a troca com *** TRACE CONTINUES IN FILE num arquivo e *** TRACE CONTINUED FROM FILE no outro. Um arquivo pode receber trechos de novo mais tarde.
• A operação passou por várias sessões. É o caso do trace por client_id ou por serviço, com um arquivo por processo (ligar por client_id).

Analisado sozinho, cada arquivo perde os cursores abertos nos outros e conta como dele o tempo em que a sessão escrevia em outro arquivo. Não junte traces de operações diferentes: o perfil misturado não descreve nenhuma delas.

O que o WaitScope faz com os arquivos

1. Corta cada arquivo nas marcas de troca, TRACE CONTINUES IN FILE e TRACE CONTINUED FROM FILE.
2. Junta os trechos da mesma instância, do mesmo processo e da mesma sessão, na ordem do tim.
3. Põe as sessões diferentes uma depois da outra, pela hora de início, sem levar os cursores abertos de uma sessão para a seguinte.
4. Deixa de fora, com aviso, o arquivo igual a outro da coleta e o arquivo que não é trace.
5. Analisa o trace montado como um trace só.

O cursor aberto num arquivo é reconhecido no outro, e o intervalo em que a sessão escrevia em outro arquivo não conta duas vezes. As sessões não se misturam: o tempo total da coleta é a soma do tempo total de cada sessão.

Como enviar

1. Escolha todos os arquivos da operação, a pasta com eles ou um zip ou tar com todos.
2. Clique em Enviar e analisar.
3. Na pergunta Esses traces são do mesmo processo?, escolha Sim, mesmo processo: analisar juntos.

Resultado: uma análise só no Histórico, com a marca coleta ao lado do nome. O nome é o começo comum dos nomes dos arquivos com a quantidade, como zz_lote_etapa (3 arquivos) para zz_lote_etapa1.trc, zz_lote_etapa2.trc e zz_lote_etapa3.trc. Sem começo comum, é o primeiro nome seguido de e mais 2.

No app, a pergunta é a mesma. Na página sem JavaScript, marque Analisar juntos, como uma única coleta antes de enviar. Na API, abra o envio com "juntar": true (enviar pela API). Um arquivo só, sem ser zip ou tar, vira uma análise comum.

Limites da coleta

• Até 20.000 arquivos por coleta. Acima disso, o envio é recusado com Uma coleta aceita até 20000 arquivos.
• O trace montado segue o limite do conteúdo depois de descompactado (limites).
• Um arquivo com trechos demais tem o resto juntado no último trecho, e o aviso no alto do relatório diz qual arquivo foi.
• Por um tempo, a coleta ocupa no servidor o dobro do espaço dos arquivos. Sem espaço, o envio é recusado com Sem espaço no servidor.

O cartão Coleta no relatório

No Resumo, o cartão da coleta diz quantos arquivos e quantas sessões entraram, como Coleta: 3 arquivos de 2 sessões, analisados como um trace só, e traz duas listas:

• Sessões da coleta, quando há mais de uma sessão: a instância, o processo, o SID.serial e o tempo de cada sessão.
• Arquivos da coleta: o nome de cada arquivo, a sessão dele, os trechos que entraram na ordem do tempo e as linhas.

Os avisos da montagem, como arquivo repetido ou trechos que se sobrepõem no tempo, aparecem no alto do relatório. Numa coleta, o Resumo não mostra o Arquivo no servidor. O relatório de exemplo vem de um trace só e não tem esse cartão; a leitura dele está em Coleta.

Coleta enviada de novo

O mesmo conjunto de arquivos, em qualquer ordem, enviado de novo para analisar juntos abre a coleta que já existe. Os mesmos arquivos enviados separados viram as análises de cada um (envio repetido).

Problemas comuns

• Lacunas de tempo entre chamadas no Diagnóstico. Pode faltar arquivo na coleta: confira a lista em Arquivos da coleta (lacunas entre chamadas).
• Aviso de trechos que se sobrepõem no tempo. O aviso pede para conferir se os arquivos são da mesma coleta: confira se todos vieram da mesma operação.
• nenhum arquivo da coleta parece um trace Oracle: nenhum dos arquivos enviados é trace 10046 (arquivo que não é trace).

Próximos passos

• Leia o cartão campo a campo em Coleta.
• Para gerar os arquivos: marcar o nome com tracefile_identifier.
• Para enviar: enviar pelo navegador.