<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" type="topic" id="profiling" xml:lang="es">
    <info>
      <link type="guide" xref="index#profiling"/>
    
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Daniel Mustieles</mal:name>
      <mal:email>daniel.musiteles@gmail.com</mal:email>
      <mal:years>2018, 2019</mal:years>
    </mal:credit>
  </info>
    <title>Perfilado</title>
  <section id="system-profiling">
    <title>Cómo perfilar su sistema</title>
    <p>Cuando <app>Sysprof</app> perfila su sistema guarda información apilada sobre todas las aplicaciones en ejecución, incluyendo el núcleo Linux. Esto puede ser confuso algunas veces si sólo quiere ver un único proceso. Si su aplicación no interactúa mucho con el equipo anfitrión puede que resulte mejor usar <app>Sysprof</app> para <link href="profiling#new-process-profiling">lanzar un proceso nuevo</link>.</p>

    <p>Para perfilar el sistema completo asegúrese de que el botón de objetivo indica <em>Todos los procesos</em> y pulse <em>Grabar</em>.</p>

    <p>En este punto se le pedirá que <em>autorice</em> el acceso para perfila el sistema. Esto es necesario ya que la implementación del núcleo Linux de «perf» requiere root para realizar el perfilado del sistema completo.</p>

    <p>Durante el perfilado verá el número de segundo que el perfil ha estado activo. Al pulsar el botón <em>Grabar</em> otra vez se detendrá el perfilado. Después de esto se mostrará un gráfico de llamadas.</p>

    <note>
      <p>Si considera que la aplicación <app>sysprof</app> se está mostrando en su gráfico de llamadas de perfilado pued considerar guardar la sesión de perfilado con <cmd>sysprof-cli</cmd>. Este programa de línea de comandos guardará su sesión de perfilado en disco para verla posteriormente.</p>
    </note>

    <p>Consulte <link href="profiling#interpreting-results">Interpretar los resultados</link> para obtener más ayuda.</p>

  </section>

  <section id="new-process-profiling">
    <info>
      <link type="guide" xref="index#profiling"/>
    </info>
    <title>Perfilar un proceso nuevo</title>

    <p>Often times, you may need to spawn a new process to profile.
First, select the <em>Application</em> button next at the top of the
recording window. Fill in your command and working directory, and optionally
specify any environment variables you need. Your process will be started
when recording begins.</p>

    <note>
      <p>Si está lanzando procesos que requieran acceso a su pantalla actual, como puede ser una aplicación GTK+, querrá asegurarse de que la opción <em>Heredar entorno actual</em> está activada.</p>
    </note>

  </section>

  <section id="sysprof-cli">
    <info>
      <link type="guide" xref="index#profiling"/>
    </info>
    <title>Perfilar con la herramienta de línea de comandos sysprof-cli</title>

    <p>Para simplificar, puede considerar usar la herramienta de línea de comandos <cmd>sysprof-cli</cmd>. Cuando se ejecuta sin argumentos perfila el sistema completo y guarda los resultados en <file>capture.syscap</file>. Este archivo se puede abrir con la aplicación <app>Sysprof</app> para ver la lista de llamadas.</p>

    <p>If you would like to spawn a new process, use <cmd>sysprof-cli --
'command'</cmd> to specify a command to be launched. The command will inherit
the current environment.</p>

  </section>

  <section id="interpreting-results">
    <info>
      <link type="guide" xref="index#profiling"/>
    </info>
    <title>Interpretar los resultados</title>

    <p>Los resultados del perfilado en <app>Sysprof</app> se dividen en tres secciones. En la parte superior izquierda hay una lista de todas las funciones perfiladas. Se ordenan por la frecuencia con la que se han llamado durante la grabación.</p>

    <note>
      <p>Es importante tener en cuenta que la cantidad de tiempo usada por cada función no se captura. Esto requeriría un perfilador de rastreo para grabar con precisión. El porcentaje se calcula determinando la frecuencia con la que cada función aparecía en la pila de llamadas actual cuando se grabó la muestra.</p>
    </note>

    <p>Después de seleccionar una función en la lista todas las llamadas a esa función grabadas se mostrarán en la parte izquierda. También se ordenarán por el porcentaje de muestras que han incluido esa función en la pila de llamadas.</p>

    <p>A la derecha están todos los descendientes de la función seleccionada. Puede elegir una función bien de la fista de funciones o de la lista de llamadas.</p>

    <note>
      <p>If you see <em>- - Context Switch - -</em> in your results, that means that the
application transitioned into or from the Linux kernel. There can be many reasons
for this such as a <em>syscall</em> or <em>signal</em>.</p>
    </note>

  </section>

</page>
