<?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="ca">
    <info>
      <link type="guide" xref="index#profiling"/>
    </info>
    <title>Utilitzar l'analitzador de rendiment</title>
  <section id="system-profiling">
    <title>Com analitzar el rendiment el sistema</title>
    <p>Quan el <app>Sysprof</app> perfila el sistema, registra la informació de la pila per a totes les aplicacions que s'executen, inclòs el nucli Linux. De vegades, això pot resultar confús si només voleu examinar un sol procés. Si la vostra aplicació no interactua gaire amb el sistema amfitrió, és possible que tingueu més èxit en utilitzar el <app>Sysprof</app> per a <link href="profiling#new-process-profiling">generar un procés nou</link>.</p>

    <p>Per a analitzar el rendiment de tot el sistema, assegureu-vos que el botó de destinació s'ha definit a <em>Tots els processos</em> i feu clic a <em>Enregistra</em>.</p>

    <p>Aleshores, se us pot demanar que <em>autoritzeu</em> l'accés per a analitzar el rendiment del sistema. Això és necessari, atès que la implementació del nucli Linux de «perf» requereix permisos de superusuari per a analitzar el rendiment de tot el sistema.</p>

    <p>Durant la sessió d'anàlisis del rendiment, se us mostrarà la quantitat de segons que  l'analitzador de rendiment ha estat actiu. En tornar a fer clic al botó <em>Enregistra</em>, s'aturarà la sessió de l'analitzador de rendiment, per a mostrar el callgraph.</p>

    <note>
      <p>Si l'aplicació <app>sysprof</app> apareix al callgraph de l'analitzador de rendiment, és recomanable que deseu la sessió de l'analitzador de rendiment amb <cmd>sysprof-cli</cmd>. És un programa de la línia d'ordres que capturarà la sessió de l'analitzador de rendiment al disc per a veure-la posteriorment.</p>
    </note>

    <p>Veieu <link href="profiling#interpreting-results">interpretant els resultats</link> per a més informació.</p>

  </section>

  <section id="new-process-profiling">
    <info>
      <link type="guide" xref="index#profiling"/>
    </info>
    <title>Analitzar el rendiment d'un procés nou</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>Quan genereu un procés que requereix accés a la pantalla actual, com ara una aplicació GTK+, assegureu-vos que s'ha configurat <em>Hereta l'entorn actual</em>.</p>
    </note>

  </section>

  <section id="sysprof-cli">
    <info>
      <link type="guide" xref="index#profiling"/>
    </info>
    <title>Analitzar el rendiment amb l'eina de línia d'ordres sysprof-cli</title>

    <p>Per a una despesa general mínima, és recomanable utilitzar l'eina de línia d'ordres <cmd>sysprof-cli</cmd>. Si s'executa sense arguments, enregistrarà tot el sistema i desarà la sortida a <file>capture.syscap</file>. Aquest fitxer es pot obrir amb l'aplicació <app>Sysprof</app> per a veure el callgraph.</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>Interpretació de resultats</title>

    <p>Els resultats de l'analitzador de rendiment a <app>Sysprof</app> es divideixen en tres seccions. A la part superior esquerra hi ha una llista de totes les funcions perfilades. Estan ordenats segons la freqüència amb què es van cridar durant l'enregistrament.</p>

    <note>
      <p>És important tenir en compte que la quantitat de temps dedicat a cada funció no es captura. Això requeriria un analitzador de rendiment de seguiment per a enregistrar amb precisió. El percentatge es calcula determinant la freqüència amb què es va mostrar aquesta funció al seguiment de pila actual quan es va enregistrar una mostra.</p>
    </note>

    <p>Després de seleccionar una funció de la llista de funcions, es mostraran a la part inferior esquerra totes crides en funció d'aquesta funció. També s'ordenen pel percentatge de mostres que van incloure aquesta funció al seguiment de pila.</p>

    <p>A la dreta, es mostren tots els descendents d'una funció seleccionada. Podeu seleccionar una funció de la llista de funcions o de la llista de crides.</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>
