File: index.docbook

package info (click to toggle)
ksystemlog 4%3A21.08.0-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, sid
  • size: 9,316 kB
  • sloc: cpp: 15,320; xml: 249; makefile: 5; sh: 3
file content (318 lines) | stat: -rw-r--r-- 11,574 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
<!ENTITY % addindex "IGNORE">
<!ENTITY % English "INCLUDE"><!-- change language only here -->
]>

<book id="ksystemlog" lang="&language;">

<bookinfo>
<title>The &ksystemlog; Handbook</title>

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

<!-- TRANS:ROLES_OF_TRANSLATORS -->

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

<legalnotice>&FDLNotice;</legalnotice>

<date>2016-04-17</date>
<releaseinfo>0.4 (Applications 16.04)</releaseinfo>

<abstract>
<para>&ksystemlog; is a system log viewer tool by &kde;. This program is developed for beginner users
who don't know how to find information about their system or where the log files are located.
It is also designed for advanced users who want to quickly see problems occuring on their server.
</para>

</abstract>

<keywordset>
	<keyword>KDE</keyword>
	<keyword>logs</keyword>
	<keyword>ksystemlog</keyword>
	<keyword>security</keyword>
	<keyword>cron</keyword>
	<keyword>boot</keyword>
	<keyword>ssh</keyword>
	<keyword>postfix</keyword>
	<keyword>apache</keyword>
	<keyword>samba</keyword>
</keywordset>

</bookinfo>
<!--
GSoC 2015 (add journald support to KSystemLog) http://vyacheslav-matyushin.blogspot.de/
GUI stuff from git log
Switch default mode to journald. Add journald to default toolbar layout
Added HTTPS support for remote journals
Added UI to enable HTTPS for remote journals
Local analyzer display filter name in tab and window title
Network journal submenus now contain "Filter by" submenus
Implemented configuration UI and saving/restoring of remote journals
Hide category submenus if they are empty
Hide menu entries and actions for modes with missing log files
-->
<chapter id="using_ksystemlog">
	<title>Using &ksystemlog;</title>

	<sect1 id="introduction">
		<title>Introduction</title>

		<sect2>
			<title>What is &ksystemlog; ?</title>
			<para>&ksystemlog; is a system log viewer tool.</para>

			<para>&ksystemlog; helps users understand what their machine does in the background. &ksystemlog; aims to simplify the reading of system log files. This program is developed for beginner users
			who don't know how to find information about their system or where the log files are located in their computer.
			</para>

			<para>
			But it is also designed for advanced users who want to quickly see problems occuring on their server.
			&ksystemlog; tries to provide some advanced features to allow sorting and reading logs from specifical programs.
			</para>

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

		</sect2>

		<sect2>
			<title>Features</title>

			<para>
			In its current version, &ksystemlog; 0.4 has quite a number of helpful
			features, such as:
			</para>

			<itemizedlist>
				<listitem><simpara>Support for many different log files type, with the support of Syslog server formating, Samba</simpara></listitem>
				<listitem><simpara>Tabbed view to display several logs at the same time</simpara></listitem>
				<listitem><simpara>Reading one log mode from multiple sources</simpara></listitem>
				<listitem><simpara>Auto-display of newly logged lines in bold</simpara></listitem>
				<listitem><simpara>Group by different criteria (log level, log file, process, hour, ...)</simpara></listitem>
				<listitem><simpara>Detailed information for each log lines</simpara></listitem>
				<listitem><simpara>Adding a log entry manually</simpara></listitem>
				<listitem><simpara>Filtering by priority</simpara></listitem>
			</itemizedlist>

			<para>
				It supports the following log files from your system :
			</para>

			<itemizedlist>
				<listitem><simpara>Syslog logs (system messages)</simpara></listitem>
				<listitem><simpara>X.org logs</simpara></listitem>
				<listitem><simpara>Kernel logs</simpara></listitem>
				<listitem><simpara>Authentication logs</simpara></listitem>
				<listitem><simpara>ACPID logs</simpara></listitem>
				<listitem><simpara>Cups logs</simpara></listitem>
				<listitem><simpara>Postfix logs</simpara></listitem>
				<listitem><simpara>Apache logs</simpara></listitem>
				<listitem><simpara>Samba logs</simpara></listitem>
				<listitem><simpara>Daemons logs</simpara></listitem>
				<listitem><simpara>Cron logs</simpara></listitem>
				<listitem><simpara>XSessions logs</simpara></listitem>
				<listitem><simpara>Systemd / Journald logs</simpara></listitem>
			</itemizedlist>

			<para>
			Many other features are included and will be discussed in the appropriate chapters of this manual.
			</para>

		</sect2>

	</sect1>


	<sect1 id="reading">
		<title>Reading logs with &ksystemlog;</title>

		<para>
		As you will see in the following screenshots, &ksystemlog; provides features to easily sort and filter log lines.
		We are now going to describe them in the next parts of this documentation.
		</para>

		<sect2 id="getting_started">
			<title>Getting started</title>

			<para>
			When you start &ksystemlog;, by default it tries to open the most useful log, the <guilabel>System Log</guilabel>.
			If it does not display it and pops up a message box, you probably forgot to launch &ksystemlog; as an administrator user (commonly named root).
			The log files are usually available in the /var/log folder, which is often protected against normal users.
			In the settings dialog you can select another log to open at startup.
			</para>

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

		<sect2 id="easy_reading">
			<title>Reading log files easily</title>

			<sect3 id="sorting">
				<title>Sorting log lines</title>
				<para>
				Every log lines are displayed in a list view, which can be sorted by clicking on the wanted column. Another click will sort it in the other order.
				If you want to sort the list as it was on the first loading, you can use the <menuchoice><guimenu>Edit</guimenu><guimenuitem>Reload</guimenuitem></menuchoice> menu item, or simply
				click on the first column of the list, generally named <guilabel>Date</guilabel>, to sort the list in the ascending order. Even if your log mode
				does not use time to describe each log lines, for example the <guilabel>X.org Log</guilabel>, the list will be correctly sorted,
				because &ksystemlog; keeps an internal order of the list.
				</para>
			</sect3>

			<sect3 id="filtering">
				<title>Filtering log lines</title>

				<screenshot>
					<screeninfo>Filtering on a specific process</screeninfo>
					<mediaobject>
						<imageobject>
						<imagedata fileref="filter-process.png" format="PNG"/>
						</imageobject>
						<textobject>
						<phrase>Filtering on a specific process</phrase>
						</textobject>
					</mediaobject>
				</screenshot>

				<para>
				You can also use the filter bar to filter according to the selected criteria and the typed string. Simply type something in the filter, and the list will automatically
				be modified to only display lines which match your filter string. By default, the combo box next to the filter selects <guilabel>All</guilabel>, which means that
				a line will be displayed only if one of its columns contains the filter string.
				</para>

				<para>
				You can select another field to filter only this column of the list. For example, in the <guilabel>System Log</guilabel>, by selecting
				the <guilabel>Process</guilabel> column, and writing a process name in the filter bar, &ksystemlog; will display every log lines sent by this process.
				</para>
			</sect3>

		</sect2>

		<sect2 id="other_features">
			<title>Other features</title>

			<sect3 id="colorizing">
				<title>Colorizing log lines</title>

				<para>
				This option is activated by default and helps you see which lines have a higher level than the others. For example, <guilabel>Error</guilabel> level will be highlighted in a different color than the <guilabel>Notice</guilabel> one. This feature can be disabled in the configuration dialog.
				</para>

			</sect3>

			<sect3 id="hiding_pid">
				<title>Hiding the process identifier</title>

				<para>
				If you are only interested in a specific process (for example in the <guilabel>System Log</guilabel> or the <guilabel>Cron Log</guilabel>), you can hide its PID
				in the <guilabel>Process</guilabel> column. This can be useful if you are trying to analyze the output of a specific command, like a Samba server. In this case, please use the <link linkend="filtering">Filter Bar</link>.
				</para>

			</sect3>
			<sect3 id="send_email">
				<title>Send logd via email</title>
				<para>
				The context menu has an action <guilabel>Email Selection</guilabel>. Select relevant lines in the log and use this action to open the composer window of your default email client prefilled with the selection.
				</para>

			</sect3>
		</sect2>
	<sect2 id="monitoring_management">
		<title>Monitoring Management</title>

		<para>
		&ksystemlog; provides an easy way to control the reading and the monitoring of log files. Indeed, sometimes you only need to analyze some existing log lines. In this case,
		you cannot tolerate the appearance of a new line. You can deactivate the monitoring of log files by clicking on the <guibutton>Stop</guibutton>
		button. This stops the opened log files from being updated while still letting them get filled by other processes. Of course, you can reactivate the monitoring by
		clicking on <guibutton>Resume</guibutton>, which will display the log lines added since the last pause.
		</para>

		<para>
		Furthermore, to focus on the newly appeared log lines, you can toggle the <guimenuitem>Scroll to New Lines</guimenuitem> option.
		</para>
	</sect2>

	<sect2 id="multiple_logs">
		<title>Management of several opened tabs</title>

		<para>
		&ksystemlog; allows you to open several log modes by opening multiple tabs. For this, simply use the <guimenu>Window</guimenu> menu to manage and open
		new tabs. Once you have selected the right tab, simply choose the desired log mode using the dedicated menu.

		</para>
	</sect2>
	</sect1>

</chapter>

<chapter id="credits">

	<title>Credits and License</title>

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

	<para>Contributors:</para>
	<itemizedlist>
		<listitem><simpara>Patrick Dreker : Ideas, Code Improvements.</simpara></listitem>
		<listitem><simpara>Bojan : SSH Log mode, Printing.</simpara></listitem>
	</itemizedlist>

	<para>
		<emphasis>Special thanks to all translators of &ksystemlog;.</emphasis>
	</para>

	<!-- TRANS:CREDIT_FOR_TRANSLATORS -->

	&underFDL;           <!-- FDL: do not remove -->
	&underGPL;        	 <!-- GPL License -->

</chapter>

&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
-->