# &app; Manual

System Log Viewer is a graphical user interface to view and monitor system log files.

2003
Sun Microsystems
2000
Judith Samson
GNOME Documentation Project

&legal;

Sun
GNOME Documentation Team
Sun Microsystems

     gdocteam@sun.com

Judith
Samson
GNOME Documentation Project

     judith@samsonsource.com

Vincent
Noel

    vincent.noel@gmail.com

&app; Manual V2.4
October 2005

Vincent Noel vincent.noel@gmail.com

GNOME Documentation Project

System Log Viewer Manual V2.3
October 2002

Sun GNOME Documentation Team gdocteam@sun.com

GNOME Documentation Project

System Log Viewer Manual V2.2
August 2002

Sun GNOME Documentation Team gdocteam@sun.com

GNOME Documentation Project

System Log Viewer Manual V2.1
July 2002

Sun GNOME Documentation Team gdocteam@sun.com

GNOME Documentation Project

System Log Viewer Manual V2.0
May 2002

Sun GNOME Documentation Team gdocteam@sun.com

GNOME Documentation Project

Logview Manual
2000

Judith Samson judith@samsonsource.com

GNOME Documentation Project

This manual describes version &appversion; of &app;.

## Feedback

To report a bug or make a suggestion regarding the &app; application or this manual, follow the directions in the GNOME Feedback Page.

## Introduction

&app; is a graphical, menu-driven viewer that you can use to view and monitor your system logs. &app; comes with a few functions that can help you manage your logs, including a calendar, log monitor and log statistics display.

&app; is useful if you are new to system administration because it provides an easier, more user-friendly display of your logs than a text display of the log file. It is also useful for more experienced administrators, as it contains a calendar to help you locate trends and track problems, as well as a monitor to enable you to continuously monitor crucial logs.

&app; is useful only to those who have access to the system log files, which generally requires root access.

## Getting Started

You can start &app; in the following ways:

Applications menu

  Choose System Tools Log File Viewer.

Command line

  Type `gnome-system-log`, then press Return.

When you start &app;, the following window is displayed.

### &app; Window

Shows &app; main window. Contains menubar, display area, scrollbars, and statusbar.

The first time you start &app;, the application displays several log files by default (such as `/var/log/messages`). Opened logs are listed on the left side of the application window. The log selected in this list is displayed in the main area of the application window.

By default, &app; monitors every opened log, and any change appears automatically in the main window. See for more information.

## Usage

### To View a Log

To view a log, choose File Open. In the Open Log dialog, select the log that you want to open, then click Open. Use the scrollbars to scroll through the log.

You can open as many logs as you want. &app; displays one log at a time in the System Log Viewer window. Opened logs are listed on the left side of the application window. The log selected in this list is displayed in the main area of the application window. To display another log already opened in &app;, select it in the log list.

Note that &app; also lets you open zipped logs (whole filenames end in ".gz").

### To Copy Log Lines to the Clipboard

To copy one or more log lines to the clipboard, just select the lines in the main area and choose the Edit Copy menu option. If you want to copy the entire log to the clipboard, select it entirely using the Edit Select All menu option, then choose Edit Copy.

### To Hide the Sidebar

To hide the left sidebar, which contains the log list and calendar, just select the View Side pane menu option.

### To Monitor Logs

You can use &app; to monitor logs. By default, all logs opened in &app; are monitored for changes. If new lines are added to a log monitored by &app;, the log name will appear in bold in the log list. If the log is currently displayed in the main area, the new lines will appear automatically at the end of the log and, after five seconds, the log name will turn back to normal in the list.

To stop monitoring a specific log, uncheck the View Monitor option. Check this option again to turn monitoring back on.

### To Use the Calendar

By default, a calendar is displayed in the left side of the &app; window, under the log list. In this calendar, the dates present in the currently select log are displayed in bold. To jump to a particular date, select it in the calendar.

To hide the calendar, uncheck the View Calendar menu option.

### To View Log Information

Log information are generally displayed in the status bar, including :

- Number of lines in the log.

- Size of the log in bytes.

- Date the log was last modified.

The status bar can be displayed or hidden using the View Statusbar option.

### To Close a Log

To close a log, choose File Close.

### To Exit &app;

To exit &app;, choose File Quit.