La parte superior del informe dice cuánto tardó la sesión, cuándo y dónde: el tiempo total, el período del trace, el recuento de llamadas, esperas y sentencias, y el entorno que describe el propio trace. También es desde ahí que usted descarga el informe.
Qué muestra la sección
El Resumen es la primera sección del índice En este informe. Encima de él, el encabezado trae el nombre del archivo analizado, la línea Analizado el con la fecha del análisis, el tamaño y el número de líneas del trace, los botones Descargar HTML, Descargar JSON y Descargar PDF y el campo Sentencias por lista. La sección tiene:
- cinco números: Tiempo total, Período, Llamadas a la base de datos, Esperas y Sentencias distintas;
- la tarjeta Sesión y entorno, con la base de datos, la instancia, el servidor y la sesión que informa el encabezado del trace;
- la tarjeta de la colección, cuando se analizaron varios archivos juntos (colección).
Cuando el análisis encuentra algo que cambia la lectura del tiempo, como esperas sin tim en un trace antiguo, llamadas recursivas sin la llamada de nivel 0 (trace cortado a la mitad) o un límite del análisis alcanzado, aparece un aviso en la parte superior del informe, antes del Resumen. En un trace con muchas sentencias distintas, los avisos indican qué pasó a sumar el análisis por la forma del texto y qué pasó a estimar (trace con muchas sentencias).
En el trace solo de deadlock, los números son otros: Deadlocks (ORA-00060), Detectado el, Sesiones involucradas y Diagnóstico (deadlocks).
Cómo leerla
| Número | Qué es |
|---|---|
| Tiempo total | El tiempo de respuesta (R): desde el inicio de la primera llamada o espera hasta el último tim del trace, en segundos, con el mismo valor en ms, s, min o h justo debajo. Es la suma exacta de las filas del perfil. En una colección con más de una sesión, es la suma del tiempo de cada sesión. |
| Período | Inicio y fin del trace en el reloj que el propio trace graba en las líneas *** con fecha y hora. Con el puntero sobre el número, aparecen los dos instantes con microsegundos y zona horaria. Sin esas líneas, aparece no informado. |
| Llamadas a la base de datos | Todas las llamadas PARSE, EXEC, FETCH, CLOSE y las demás, en cualquier profundidad. Debajo, cuántas son de nivel 0, las que pidió la aplicación; las otras son SQL recursivo. |
| Esperas | Cuántas líneas WAIT tiene el trace. Debajo, los segundos de espera entre llamadas, como SQL*Net message from client. |
| Sentencias distintas | Cuántas sentencias SQL y PL/SQL diferentes tiene el trace, por el sql_id o, sin él, por el hash value. Las sentencias que solo difieren en los literales cuentan una a una, aunque las listas las muestren en una sola fila. Cuando el análisis tuvo que estimar el recuento, el número aparece como alrededor de N. Debajo, los commits y los rollbacks, contados en las líneas XCTEND. |
| Campo | De dónde viene en el trace |
|---|---|
| Base de datos | La línea Oracle Database del encabezado y la línea Version. |
| Instancia | Instance name. |
| Servidor | Node name, con System name, Machine y Storage cuando existen. |
| Sesión | SID y serial de *** SESSION ID, y el pid de Unix process pid. |
| Servicio | *** SERVICE NAME. |
| Módulo y Acción | Los valores distintos de *** MODULE NAME y *** ACTION NAME, en el orden en que aparecen en el trace. |
| Client ID y Driver | *** CLIENT ID y *** CLIENT DRIVER. |
| Contenedor (PDB) | *** CONTAINER ID. |
| Unidad de tiempo | microsegundos, o centésimas de segundo (trace antiguo) en los traces de Oracle 7 y 8. |
| Archivo en el servidor | La ruta del trace en el servidor de la base de datos, de la línea Trace file. No aparece en una colección. |
El campo que el trace no trae no aparece. Compruebe en la tarjeta que el trace es de la sesión y de la base de datos correctas antes de sacar conclusiones.
Descargar el informe
- Descargar HTML graba el archivo
<nombre del trace>-relatorio.html, que se abre en cualquier navegador, sin la consola: el estilo va incorporado y las tarjetas de los componentes y de las operaciones del plan se abren igual. El archivo se abre con el resumen y las listas; el detalle de una sentencia o de un objeto solo se arma cuando usted hace clic en él, y Volver al informe lleva de vuelta. En el índice, Buscar una sentencia por sql_id lista las sentencias detalladas cuyosql_idempieza por lo que usted escribe. El detalle del objeto trae el tipo, la espera y dónde aparece en el trace; las consultas listas quedan solo en la consola. Para navegar, el archivo necesita JavaScript. - Descargar PDF abre en una pestaña nueva el informe completo, con el detalle de todas las sentencias y objetos al final, y llama a la impresión del navegador: elija guardar en PDF. En el HTML descargado, el botón Descargar PDF hace lo mismo con el archivo.
- Descargar JSON graba
<nombre del trace>-resultado.json, el resultado completo del análisis, para llevarlo a otra herramienta. Por la API, usted descarga el mismo HTML y un JSON con las secciones del informe.
Las listas de sentencias muestran 10 sentencias cada una. Para cambiarlo, escriba otro número en Sentencias por lista (de 1 a 300) o marque todas, y haga clic en Aplicar. La elección vale para las listas de la página y para el HTML y el PDF descargados, que indican arriba cuántas sentencias por lista llevan.
Con la Privacidad de los informes activada en Mi cuenta, la página, el HTML y el JSON descargados, la API y la app muestran el SQL con el texto entre comillas, los números usados como valor, o los dos, reemplazados por ***, según las opciones marcadas. El análisis guardado no cambia: desmarque las opciones para ver el SQL original (literales ocultos).
Eliminar el análisis
La eliminación está en la página Análisis, en el Historial, y no en el informe.
- Haga clic en Análisis, en la ruta de la parte superior del informe.
- Para eliminar un análisis, haga clic en Eliminar en su fila.
- Para eliminar varios, marque las casillas de las filas, o Marcar todos, haga clic en Eliminar seleccionados y confirme.
Resultado: la página muestra Análisis eliminado. o cuántos análisis se eliminaron, y la dirección del informe pasa a responder Análisis no encontrado.
Eliminar en la fila borra en el momento, sin pedir confirmación, y no se puede deshacer. El trace ya se borró al final del análisis: para tener el informe de nuevo, envíe el archivo otra vez. El HTML y el JSON que usted descargó siguen con usted.
Sin eliminación, el informe desaparece solo cuando vence el plazo de retención (retención y privacidad).
Cuándo preocupa
- El Período empieza mucho antes o termina mucho después de la operación que usted quería medir: parte del tiempo total es de antes o de después de ella.
- El Tiempo total es mucho menor que la demora que sintió el usuario: el trace captó solo parte de la operación, u otra sesión.
- Llamadas a la base de datos muy por encima de las de nivel 0: hay mucho SQL recursivo, de funciones, triggers o consultas al diccionario.
- Esperas con muchos segundos entre llamadas: el tiempo puede estar fuera de la base de datos (sesión esperando a la aplicación).
- Rollbacks por encima de cero: compruebe si el trabajo deshecho era esperado (rollback).
- Un aviso en la parte superior del informe: léalo antes que el resto, porque indica lo que el análisis no pudo medir.
Adónde ir después
- Resumen del informe de ejemplo: tiempo total de 0,007 s (7,0 ms), 6 llamadas a la base de datos, 4 de ellas de nivel 0, 4 esperas y 2 sentencias distintas.
- Diagnóstico, la sección siguiente del informe.
- Perfil del tiempo de respuesta, que divide el tiempo total en partes.