<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
<!ENTITY ksystemlog "<application
>KSystemLog</application
>">
<!ENTITY kappname "&ksystemlog;"
><!-- replace kapp here -->
<!ENTITY package "kdeadmin">
<!ENTITY % addindex "IGNORE">
<!ENTITY % Catalan  "INCLUDE"
><!-- change language only here -->
]>

<book lang="&language;">

<bookinfo>
<title
>El manual de &ksystemlog;</title>

<authorgroup>
	<author
><firstname
>Nicolas</firstname
><surname
>Ternisien</surname
> <affiliation
> <address
><email
>nicolas.ternisien@gmail.com</email
></address>
		</affiliation>
	</author>
</authorgroup>

&traductor.Antoni.Bella; 

<copyright>
	<year
>2008</year>
	<holder
>Nicolas Ternisien</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>08-02-2008</date>
<releaseinfo
>0.4.1</releaseinfo>

<abstract>
<para
>&ksystemlog; és una eina visor de registres del sistema per a &kde;. Aquest programa es desenvolupa per als usuaris principiants que no saben com trobar informació sobre els seus sistemes o sobre a on es troben els fitxers de registre. També està dissenyat per a usuaris avançats que volen veure ràpidament els problemes que ocorren al seu servidor. </para>

</abstract>

<keywordset>
	<keyword
>KDE</keyword>
	<keyword
>registres</keyword>
	<keyword
>ksystemlog</keyword>
	<keyword
>seguretat</keyword>
	<keyword
>cron</keyword>
	<keyword
>arrencada</keyword>
	<keyword
>ssh</keyword>
	<keyword
>postfix</keyword>
	<keyword
>apache</keyword>
	<keyword
>samba</keyword>
</keywordset>

</bookinfo>

<chapter id="using_ksystemlog">
	<title
>Usar &ksystemlog;</title>

	<sect1 id="introduction">
		<title
>Introducció</title>

		<sect2>
			<title
>Què és &ksystemlog;?</title>
			<para
>&ksystemlog; és un visor pels registres del sistema.</para>

			<para
>&ksystemlog; ajuda als usuaris a comprendre el que fa la seva màquina al rerefons. &ksystemlog; té per objecte simplificar la lectura dels fitxers de registre del sistema. Aquest programa es desenvolupa per a usuaris principiants que no saben com trobar informació sobre els seus sistemes o sobre a on es troben els fitxers de registre al seu ordinador. </para>

			<para
>Però també està dissenyat per a usuaris avançats que volen veure ràpidament els problemes que ocorren en el seu servidor. &ksystemlog; tracta de proporcionar algunes característiques avançades per a permetre la classificació i lectura de registres des de programes específics. </para>

			<screenshot>
				<screeninfo
>Pantalla principal de &ksystemlog;</screeninfo>
				<mediaobject>
					<imageobject>
					<imagedata fileref="main-screen.png" format="PNG"/>
					</imageobject>
					<textobject>
					<phrase
>Pantalla principal de &ksystemlog;</phrase>
					</textobject>
				</mediaobject>
			</screenshot>

		</sect2>

		<sect2>
			<title
>Característiques</title>

			<para
>En la seva versió actual, &ksystemlog; 0.4.1 té un bon nombre de característiques útils, com ara: </para>

			<itemizedlist>
				<listitem
><simpara
>Suport per a molts tipus de fitxers de registre diferents, amb el suport de format servidor Syslog, Samba.</simpara
></listitem>
				<listitem
><simpara
>Vista amb pestanyes per a mostrar diversos registres a la vegada.</simpara
></listitem>
				<listitem
><simpara
>Lectura d'un registre des de múltiples fonts.</simpara
></listitem>
				<listitem
><simpara
>Auto-presentació de les línies noves en negreta.</simpara
></listitem>
				<listitem
><simpara
>Grups per diferents criteris (nivell de registre, fitxer de registre, procés, hora...).</simpara
></listitem>
				<listitem
><simpara
>Informació detallada per a cada línia de registre.</simpara
></listitem>
				<listitem
><simpara
>Afegir una entrada de registre de forma manual.</simpara
></listitem>
			</itemizedlist>

			<para
>És compatible amb els següents fitxers de registre del sistema: </para>

			<itemizedlist>
				<listitem
><simpara
>Registres del sistema</simpara
></listitem>
				<listitem
><simpara
>Registres de l'X.org</simpara
></listitem>
				<listitem
><simpara
>Registres del nucli</simpara
></listitem>
				<listitem
><simpara
>Registres d'autenticació</simpara
></listitem>
				<listitem
><simpara
>Registres de l'ACPID</simpara
></listitem>
				<listitem
><simpara
>Registres del Cups</simpara
></listitem>
				<listitem
><simpara
>Registres del Postfix</simpara
></listitem>
				<listitem
><simpara
>Registres de l'Apache</simpara
></listitem>
				<listitem
><simpara
>Registres del Samba</simpara
></listitem>
				<listitem
><simpara
>Registres dels dimonis</simpara
></listitem>
				<listitem
><simpara
>Registres del cron</simpara
></listitem>
				<listitem
><simpara
>Registres de la sessió X</simpara
></listitem>

			</itemizedlist>

			<para
>S'inclouen moltes altres característiques que es tractaran en els capítols apropiats d'aquest manual. </para>

		</sect2>

	</sect1>


	<sect1 id="reading">
		<title
>Llegir els registres amb &ksystemlog;</title>

		<para
>Com podeu veure en les següents captures de pantalla, &ksystemlog; proporciona funcions per ordenar i filtrar fàcilment línies de registre. A continuació ho descriurem en les següents parts d'aquesta documentació. </para>

		<sect2 id="getting_started">
			<title
>Com començar</title>

			<para
>En iniciar &ksystemlog;, aquest intenta obrir el registre més útil, el <guilabel
>Registre del sistema</guilabel
>. Si no el mostra a la pantalla hi apareixerà una caixa de missatge, probablement us heu oblidat de llançar &ksystemlog; com a un usuari administrador (normalment anomenat root). Els fitxers de registre solen estar disponibles a la carpeta /var/log, sovint protegits contra els usuaris normals. </para>

			<screenshot>
				<screeninfo
>Primer llançament de &ksystemlog;</screeninfo>
				<mediaobject>
					<imageobject>
					<imagedata fileref="first-opening.png" format="PNG"/>
					</imageobject>
					<textobject>
					<phrase
>Primer llançament de &ksystemlog;</phrase>
					</textobject>
				</mediaobject>
			</screenshot>
		</sect2>

		<sect2 id="easy_reading">
			<title
>Llegint fitxers de registre amb facilitat</title>

			<sect3 id="sorting">
				<title
>Classificar les línies de registre</title>
				<para
>Cada línia de registre es mostra en una vista de llista, que es pot ordenar fent clic a la columna desitjada. Un altre clic ordenarà en l'altre ordre. Per ordenar la llista com estava en la primera càrrega, podeu utilitzar l'element de menú <menuchoice
><guimenu
>Edita</guimenu
><guimenuitem
>Actualitza</guimenuitem
></menuchoice
>, o simplement feu clic a la primera columna de la llista, en general anomenada <guilabel
>Data</guilabel
>, per ordenar la llista en ordre ascendent. Fins i tot si el mode de registre no utilitza dates per descriure cadascuna de les línies de registre, per exemple el <guilabel
>Registre de l'X.org</guilabel
>, la llista estarà correctament ordenada, perquè &ksystemlog; manté un ordre intern de la llista. </para>
			</sect3>

			<sect3 id="filtering">
				<title
>Filtrar les línies de registre</title>

				<screenshot>
					<screeninfo
>Filtrant sobre un procés específic</screeninfo>
					<mediaobject>
						<imageobject>
						<imagedata fileref="filter-process.png" format="PNG"/>
						</imageobject>
						<textobject>
						<phrase
>Filtrant sobre un procés específic</phrase>
						</textobject>
					</mediaobject>
				</screenshot>

				<para
>També podeu utilitzar la barra de filtre per a filtrar d'acord amb els criteris seleccionats i la cadena escrita. Simplement escriviu-hi alguna cosa, i la llista es modificarà automàticament per mostrar només les línies que coincideixen amb la cadena de filtre. Per omissió, la caixa combo al costat del filtre té seleccionada l'opció <guilabel
>Totes</guilabel
>, el que significa que una línia només es mostrarà si una de les seves columnes conté la cadena de filtre. </para>

				<para
>Podeu seleccionar un altre camp per a només filtrar aquesta columna de la llista. Per exemple, en el <guilabel
>Registre del sistema</guilabel
>, mitjançant la selecció de la columna <guilabel
>Procés</guilabel
>, i escriure el seu nom a la barra de filtre, &ksystemlog; mostrarà totes les línies de registre enviades per aquest procés. </para>
			</sect3>

		</sect2>

		<sect2 id="other_features">
			<title
>Altres característiques</title>

			<sect3 id="colorizing">
				<title
>Acoloreix les línies de registre</title>

				<para
>Aquesta opció està marcada per omissió i us ajuda a veure que les línies que tenen un nivell més alt que les altres. Per exemple, el nivell <guilabel
>Error</guilabel
> serà ressaltat amb un color diferent que per a <guilabel
>Informació</guilabel
>. Aquesta característica es pot desactivar en el diàleg de configuració. </para>

			</sect3>

			<sect3 id="hiding_pid">
				<title
>Amagar l'identificador de procés</title>

				<para
>Si només esteu interessat en un procés específic (per exemple, en el <guilabel
>Registre del sistema</guilabel
> o el <guilabel
>Registre del Cron</guilabel
>), podeu ocultar el seu PID a la columna <guilabel
>Procés</guilabel
>. Això pot ser-vos útil si esteu mirant d'analitzar la sortida d'una ordre específica, com un servidor Samba. En aquest cas, feu servir la <link linkend="filtering"
>barra de filtre</link
>. </para>

			</sect3>
		</sect2>
	</sect1>

	<sect1 id="monitoring_management">
		<title
>Gestió de la vigilància</title>

		<para
>&ksystemlog; proporciona una manera fàcil de controlar la lectura i el seguiment dels fitxers de registre. De fet, de vegades només cal analitzar algunes línies de registre. En aquest cas, no tolerareu l'aparició d'una nova línia. Podeu desactivar el control dels fitxers de registre fent clic al botó <guibutton
>Atura</guibutton
>. Aquest atura els fitxers de registre oberts evitant que s'actualitzin alhora que no deixa que s'omplin amb altres processos. Per descomptat, podeu tornar a activar el control fent clic a <guibutton
>Continua</guibutton
>, el qual mostrarà les línies de registre afegides des de l'última pausa. </para>

		<para
>D'altra banda, per a centrar-se en les noves línies de registre que apareguin, podeu canviar el desplaçament a <guimenuitem
>Desplaça les línies noves</guimenuitem
>. </para>
	</sect1>

	<sect1 id="multiple_logs">
		<title
>Gestió de diverses pestanyes obertes</title>

		<para
>&ksystemlog; us permet obrir diversos modes de registre obrint múltiples pestanyes. Per a fer-ho, només cal utilitzar el menú <guimenu
>Finestra</guimenu
> per a gestionar i obrir noves pestanyes. Un cop seleccionada la pestanya dreta, només heu de triar el mode de registre desitjat utilitzant el menú dedicat. </para>
	</sect1>

</chapter>

<chapter id="credits">

	<title
>Crèdits i llicència</title>

	<para
>&ksystemlog;</para>
	<para
>&ksystemlog;, Copyright 2008 per en Nicolas Ternisien </para>

	<para
>Col·laboradors:</para>
	<itemizedlist>
		<listitem
><simpara
>Patrick Dreker: Idees, millores de codi.</simpara
></listitem>
		<listitem
><simpara
>Bojan: Manera del registre de SSH, impressió.</simpara
></listitem>
	</itemizedlist>

	<para>
		<emphasis
>Un agraïment especial a tots els traductors de &ksystemlog;.</emphasis>
	</para>

	<para
>Traductor de la documentació: &credits.Antoni.Bella;</para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
	<title
>Com obtenir i instal·lar &ksystemlog;</title>

	<para
>&ksystemlog; té la seva pròpia pàgina d'inici <ulink url="http://ksystemlog.forum-software.org"
>http://ksystemlog.forum-software.org</ulink
>. Si us plau, consulteu les instruccions a la pàgina principal, ja que contindrà informació actualitzada sobre com obtenir &ksystemlog;. </para>

	<para
>&ksystemlog; també es pot trobar a la següent carpeta del repositori Subversion del &kde;: <ulink url="http://websvn.kde.org/trunk/KDE/kdeadmin/ksystemlog"
>&ksystemlog; en el repositori del &kde;</ulink
> </para>

</appendix>

&documentation.index;
</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

// vim:ts=2:sw=2:tw=78:noet
-->
