<?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 % German "INCLUDE"
><!-- change language only here -->
]>

<book lang="&language;">

<bookinfo>
<title
>Das Handbuch zu &ksystemlog;</title>

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

<othercredit role="translator"
><firstname
>Michael</firstname
><surname
>Mielewczik</surname
><affiliation
><address
><email
>Michael.MIelewczik@linux-technical.info</email
></address
></affiliation
><contrib
>Übersetzung</contrib
></othercredit
> 

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

<legalnotice
>&FDLNotice;</legalnotice>

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

<abstract>
<para
>&ksystemlog; ist ein &kde;-Betrachter für Systemprotokolle. Das Programm ist für unerfahrene Benutzer geeignet die nicht wissen, wo Sie Informationen über Ihr System erhalten können oder wo das System die verschiedenen Protokoll-Dateien hinterlegt. Darüber hinaus ermöglicht &ksystemlog; erfahrenen Benutzern den schnellen Zugriff zum Beispiel auf Informationen über Probleme, die auf ihrem Server auftreten. </para>

</abstract>

<keywordset>
	<keyword
>KDE</keyword>
	<keyword
>Protokolldateien</keyword>
	<keyword
>ksystemlog</keyword>
	<keyword
>Sicherheit</keyword>
	<keyword
>Cron</keyword>
	<keyword
>Boot</keyword>
	<keyword
>ssh</keyword>
	<keyword
>Postfix</keyword>
	<keyword
>Apache</keyword>
	<keyword
>Samba</keyword>
</keywordset>

</bookinfo>

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

	<sect1 id="introduction">
		<title
>Einführung</title>

		<sect2>
			<title
>Was ist &ksystemlog;?</title>
			<para
>&ksystemlog; ist ein Betrachter für Systemprotokolle.</para>

			<para
>&ksystemlog; hilft Benutzern zu verstehen, was Ihr Rechner im Hintergrund macht. Die Aufgabe von &ksystemlog; ist eine vereinfachte Darstellung der Protokoll-Dateien des eigenen Systems. Das Programm ist für unerfahrene Benutzer geeignet, die nicht wissen, wo Sie Informationen über Ihr System erhalten können oder wo das System die verschiedenen Protokoll-Dateien hinterlegt. </para>

			<para
>Darüber hinaus ermöglicht &ksystemlog; erfahrenen Benutzern den schnellen Zugriff zum Beispiel auf Informationen über Probleme, die auf ihrem Server auftreten. &ksystemlog; versucht daher einige erweiterte Funktionen bereitzustellen, mit deren Hilfe die Protokoll-Dateien bestimmter Programme gefiltert und ausgewertet werden können. </para>

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

		</sect2>

		<sect2>
			<title
>Funktionen</title>

			<para
>In der aktuellen Version 0.4.1 besitzt &ksystemlog; eine Reihe von nützlichen Funktionen. Dazu gehören unter anderem: </para>

			<itemizedlist>
				<listitem
><simpara
>Unterstützung für viele verschiedene Arten von Protokolldateien, für das Format des Syslog-Servers und für Samba</simpara
></listitem>
				<listitem
><simpara
>Anzeige verschiedener Protokoll-Dateien in einzelnen Unterfenstern.</simpara
></listitem>
				<listitem
><simpara
>Lesen einer Protokoll-Datei aus mehreren Quellen</simpara
></listitem>
				<listitem
><simpara
>Neue Zeilen im Protokoll werden automatisch fettgedruckt angezeigt</simpara
></listitem>
				<listitem
><simpara
>Gruppierung nach verschiedenen Kriterien (Protokollstufe, Protokolldatei, Prozess, Zeit, ...)</simpara
></listitem>
				<listitem
><simpara
>Ausführliche Informationen zu jeder Protokoll-Zeile</simpara
></listitem>
				<listitem
><simpara
>Manuelles Hinzufügen von Protokoll-Einträgen</simpara
></listitem>
			</itemizedlist>

			<para
>&ksystemlog; kann folgende Protokoll-Dateien auf Ihrem System überwachen: </para>

			<itemizedlist>
				<listitem
><simpara
>Syslog-Protokolle (Systemmeldungen)</simpara
></listitem>
				<listitem
><simpara
>X.org-Protokolle</simpara
></listitem>
				<listitem
><simpara
>Kernel-Protokolle</simpara
></listitem>
				<listitem
><simpara
>Authentifizierungs-Protokolle</simpara
></listitem>
				<listitem
><simpara
>ACPID-Protokolle</simpara
></listitem>
				<listitem
><simpara
>CUPS-Protokolle</simpara
></listitem>
				<listitem
><simpara
>Postfix-Protokolle</simpara
></listitem>
				<listitem
><simpara
>Apache-Protokolle</simpara
></listitem>
				<listitem
><simpara
>Samba-Protokolle</simpara
></listitem>
				<listitem
><simpara
>Dienste-Protokolle</simpara
></listitem>
				<listitem
><simpara
>Cron-Protokolle</simpara
></listitem>
				<listitem
><simpara
>XSession-Protokolle</simpara
></listitem>

			</itemizedlist>

			<para
>Viele andere Funktionen sind darüber hinaus ebenfalls enthalten und werden in den weiteren Kapiteln dieses Handbuchs erläutert. </para>

		</sect2>

	</sect1>


	<sect1 id="reading">
		<title
>Protokolldateien mit &ksystemlog; lesen</title>

		<para
>Wie Sie in den folgenden Bildschirmfoto sehen, stellt &ksystemlog; Funktionen zur Verfügung, mit deren Hilfe sich die einzelnen Protokoll-Zeilen einer Protokoll-Datei leicht filtern und sortieren lassen. Die einzelnen Möglichkeiten zum Sortieren und Filtern werden im nächsten Kapitel dieses Handbuchs gezeigt. </para>

		<sect2 id="getting_started">
			<title
>Erste Schritte</title>

			<para
>Nach dem Start versucht &ksystemlog; zunächst die wichtigste Protokoll-Datei des Systems - das <guilabel
>Systemprotokoll</guilabel
> - zu öffnen. Wird Ihnen diese nicht angezeigt, und es öffnet sich statt dessen ein kleines Nachrichtenfenster, so haben Sie &ksystemlog; sehr wahrscheinlich nicht mit Systemverwalterrechten gestartet. Die Protokoll-Dateien finden sich unter Linux normalerweise im Ordner /var/log, für den normale Benutzer üblicherweise keine Berechtigung zum Lesen besitzen. </para>

			<screenshot>
				<screeninfo
>Erster Start von &ksystemlog;</screeninfo>
				<mediaobject>
					<imageobject>
					<imagedata fileref="first-opening.png" format="PNG"/>
					</imageobject>
					<textobject>
					<phrase
>Erster Start von &ksystemlog;</phrase>
					</textobject>
				</mediaobject>
			</screenshot>
		</sect2>

		<sect2 id="easy_reading">
			<title
>Einfaches Lesen von Protokol-Dateien</title>

			<sect3 id="sorting">
				<title
>Sortierung von Protokollzeilen</title>
				<para
>Jede Zeile einer Protokoll-Datei wird in einer Listenansicht dargestellt. Die Einträge können durch Klicken auf den Titel der Spalte sortiert werden  Durch einen erneuten Klick auf den Titel der Spalte kann zwischen absteigender und aufsteigender Sortierung gewechselt werden. Möchten Sie zur ursprünglichen Sortierung zurückkehren, welche beim Öffnen der Protokoll-Datei genutzt wurde, wählen Sie im Menü <menuchoice
><guimenu
>Bearbeiten</guimenu
><guimenuitem
>Aktualisieren</guimenuitem
></menuchoice
>. Alternativ dazu können Sie auch auf den Titel der ersten Spalte in der Liste klicken, der normalerweise mit <guilabel
>Datum</guilabel
> lautet. Die Sortierung erfolgt dann in aufsteigender Reihenfolge. Auch wenn Ihr Protokollierungs-Modus keine Zeitangaben für jede Protokoll-Zeile verwendet, wie beispielsweise beim <guilabel
>X.org-Protokoll</guilabel
>, erfolgt die Sortierung in korrekter Form, da &ksystemlog; die interne Reihenfolge beibehält. </para>
			</sect3>

			<sect3 id="filtering">
				<title
>Filtern von Protokollzeilen</title>

				<screenshot>
					<screeninfo
>Filtern eines ausgewählten Prozesses</screeninfo>
					<mediaobject>
						<imageobject>
						<imagedata fileref="filter-process.png" format="PNG"/>
						</imageobject>
						<textobject>
						<phrase
>Filtern eines ausgewählten Prozesses</phrase>
						</textobject>
					</mediaobject>
				</screenshot>

				<para
>Sie können auch die Filterleiste verwenden, um nach einem ausgewähltem Kriterium oder nach eingegebenen Zeichenketten zu filtern. Geben Sie dazu eine Zeichenkette in die Filterleiste ein. Die Liste der Protokollzeilen wird nun automatisch verändert, so dass nur noch Protokollzeilen angezeigt werden, die zum ausgewählten Filter passen. In der Standardeinstellung enthält das Auswahlfeld neben dem Filter den Eintrag <guilabel
>Alle</guilabel
>. Dann wird eine Protokoll-Zeile nur angezeigt wird, wenn in einer der Spalten die Zeichenkette des Filter-Suchbegriffs enthalten ist. </para>

				<para
>Sie können an dieser Stelle natürlich auch einen anderen Eintrag auswählen. Die Zeichenkette des Filter-Suchbegriffs wird dann nur mit den Einträgen in der entsprechend ausgewählten Spalte abgeglichen. Wählen Sie zum Beispiel in der Protokoll-Datei <guilabel
>Systemprotokoll</guilabel
> die Spalte <guilabel
>Prozess</guilabel
> aus, und tragen Sie darüber hinaus in der Filterleiste den Namen eines Prozesses ein, so zeigt Ihnen &ksystemlog; alle Protokoll-Zeilen an, welche von diesem Prozess gesendet bzw. erstellt wurden. </para>
			</sect3>

		</sect2>

		<sect2 id="other_features">
			<title
>Andere Funktionen</title>

			<sect3 id="colorizing">
				<title
>Farbige Darstellung von Protokollzeilen</title>

				<para
>Diese Option ist in der Standardeinstellung aktiviert und hilft Ihnen, die wichtigen Protokoll-Zeilen zu erkennen.  Protokoll-Zeilen der Stufe <guilabel
>Fehler</guilabel
> werden mit einer auffälligeren Farbe als Protokoll-Zeilen der Stufe <guilabel
>Hinweis</guilabel
> angezeigt. Die farbige Darstellung von Protokoll-Zeilen kann Einrichtungsdialog abgeschaltet werden. </para>

			</sect3>

			<sect3 id="hiding_pid">
				<title
>Prozessidentifizierung ausblenden</title>

				<para
>Möchten Sie nur bestimmte Prozess anzeigen (beispielsweise im <guilabel
>Systemprotokoll</guilabel
> oder im <guilabel
>Cron-Protokoll</guilabel
>), so können Sie die Prozess-Identifikation (PID) in der Spalte <guilabel
>Prozess</guilabel
> ausblenden. Das kann zum Beispiel dann nützlich sein, wenn Sie die Ausgabe eines bestimmten Befehls wie zum Beispiel zum Start des Samba-Servers untersuchen möchten. In diesem Fall benutzen Sie <link linkend="filtering"
>Filterleiste</link
>. </para>

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

	<sect1 id="monitoring_management">
		<title
>Überwachung verwalten</title>

		<para
>&ksystemlog; stellt Ihnen eine einfache Möglichkeit zum Lesen und Überwachen Ihrer Protokoll-Dateien zur Verfügung. Natürlich ist es in einigen Fällen lediglich nötig, bereits vorhandene Zeilen vorhandener Protokoll-Dateien zu analysieren. In diesem Fall nützt es Ihnen nichts, wenn neu hinzukommende Zeilen in den Protokoll-Dateien ebenfalls angezeigt werden. &ksystemlog; gibt Ihnen daher die Möglichkeit, die Überwachung von Protokoll-Dateien zu deaktivieren. Klicken Sie dazu auf den Knopf <guibutton
>Anhalten</guibutton
> in der Werkzeugleiste. Durch diese Einstellung werden alle geöffneten Protokoll-Dateien geschlossen, die Protokoll-Dateien selbst jedoch werden weiter von anderen Prozessen gefüllt, ohne dass Sie diese Änderungen jedoch auslesen. Natürlich können Sie die Überwachung auch wieder aktivieren. Klicken Sie dazu auf den Knopf <guibutton
>Wiederaufnehmen</guibutton
>, so werden Ihnen auch neue Protokoll-Zeilen angezeigt. </para>

		<para
>Darüber hinaus können Sie die Option <guimenuitem
>Zu neuen Zeilen springen</guimenuitem
> im Kontextmenü des Hauptfensters aktivieren, um sich alle neuen hinzukommenden Protokoll-Zeilen anzeigen zu lassen. </para>
	</sect1>

	<sect1 id="multiple_logs">
		<title
>Verwaltung mehrerer geöffneter Unterfenster</title>

		<para
>&ksystemlog; ermöglicht die Anzeige mehrerer Protokoll-Dateien in getrennten Unterfenstern. Um diese Funktion zu nutzen, verwenden Sie die Einträge im Menü <guimenu
>Fenster</guimenu
> um zusätzliche Unterfenster zu öffnen und zu verwalten. Sobald Sie ein Unterfenster ausgewählt haben, wählen Sie im Menü ein Protokoll zur Anzeige aus. </para>
	</sect1>

</chapter>

<chapter id="credits">

	<title
>Danksagungen und Lizenz</title>

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

	<para
>Mitwirkende:</para>
	<itemizedlist>
		<listitem
><simpara
>Patrick Dreker : Ideen und Programmcode-Verbesserungen.</simpara
></listitem>
		<listitem
><simpara
>Bojan : SSH-Protokollmodus, Drucken.</simpara
></listitem>
	</itemizedlist>

	<para>
		<emphasis
>Besonderer Dank an alle Übersetzer von &ksystemlog;.</emphasis>
	</para>

	<para
>Übersetzung Michael Mielewczik<email
>Michael.MIelewczik@linux-technical.info</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
	<title
>Bezugsquellen und Installation von &ksystemlog;</title>

	<para
>&ksystemlog; hat eine eigene Webseite auf <ulink url="http://ksystemlog.forum-software.org"
>http://ksystemlog.forum-software.org</ulink
>. Dort finden Sie weitere aktuelle Informationen über die Bezugsquellen von &ksystemlog;. </para>

	<para
>&ksystemlog; finden Sie außerdem in folgendem Ordner des &kde;-Subversion-Archivs: <ulink url="http://websvn.kde.org/trunk/KDE/kdeadmin/ksystemlog/"
>&ksystemlog; im &kde;-Archiv</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
-->