View source for Software:Ksar (Unix sar grapher)

{{Infobox software
| name = Ksar
| logo = <!-- Image name is enough. -->
| logo alt = 
| logo caption = 
| screenshot = <!-- Image name is enough. -->
| screenshot alt = 
| caption = 
| collapsible = <!-- Any text here will collapse the screenshot. -->
| author = 
| developer = 
| released = <!-- {{Start date and age|YYYY|MM|DD|df=yes/no}} -->
| discontinued = <!-- Set to yes if software is discontinued, otherwise omit. -->
| ver layout = <!-- simple (default) or stacked -->
| latest release version = 5.2.3
| latest release date =  {{Start date and age|2017|05|30|df=yes/no}}
| latest preview version = 
| latest preview date = <!-- {{Start date and age|YYYY|MM|DD|df=yes/no}} -->
| repo = {{URL|https://github.com/vlsi/ksar}}
| programming language = 
| operating system = [[Cross-platform|cross-platform]]
| platform = 
| size = 
| language = java
| language count = <!-- Number only -->
| language footnote = 
| genre = 
| license = 
| alexa = 
| website = <!-- {{URL|example.org}} -->
| standard = 
| AsOf = 
}}

'''Ksar''' is a [[Software:BSD licenses|BSD-licensed]] [[Java (programming language)|Java]]-based application that creates graphs of all parameters from [[Data|data]] collected by [[Software:Sar (Unix)|Unix sar]] utilities. Usually, Unix sar is part of [[Software:Unix|Unix]]' [[Software:Sysstat|Sysstat]] package, and runs sa1, sa2, and sadc through [[Software:Cron|cron]] to created [[Data file|data file]]s in /var/log/sa/saNN. Characteristics include:

* Images can be zoomed by dragging the mouse on an image to pinpoint problems
* Results can be exported to [[Portable Document Format|PDF]] or [[JPEG]] format

==Syntax and options==
Below is the list of [[Command-line interface|CLI]] options supported by Ksar. Ksar's -help option will list all supported options of the applicable Ksar version.

<syntaxhighlight lang="console">
$ java -jar kSar.jar -help
kSar version: 5.0.6
Usage: 
-version: show kSar version number
-help: show this help
-input <arg>: argument must be either ssh://user@host/command or cmd://command or file://path/to/file or just /path/to/file
-graph <graph list>: space separated list of graph to be output
-showCPUstacked: will make the CPU used graph as stacked
-showMEMstacked: will make the memory graph as stacked ([[Software:Linux|Linux]] only)
-cpuFixedAxis:  will graph CPU used with fixed axis from 0% to 100%
-showIntrListstacked : will make the Interrupt List graph as stacked
-showTrigger:  will show trigger on graph (disabled by [[Default (computer science)|default]])
-noEmptyDisk: will not export disk with no data
-tile: will tile [[Window (computing)|window]]
-userPrefs: will use the userPrefs for outputting graphs (last export of this host)
-showOnlygraphName: will only print graph name available for that data (to be use for -graph)
-addHTML: will create an [[HTML]] page with [[PNG]]/JPG image
-outputPDF <pdf file> : output the pdf report to the pdf file
-outputPNG <base filename> : output the graphs to PNG file using argument as base filename
-outputJPG <base filename> : output the graphs to JPG file using argument as base filename
-outputCSV <CSV file> : output the CSV file
-width <size> : make JPG/PNG with specified width size (default: 800)
-height <size> : make JPG/PNG with specified height size (default: 600)
-startdate <date> : will graph the range beginning at that time
-enddate <date> : will graph the range until that date
-solarisPagesize <pagesize in B>: will set solaris pagesize
-wizard: open with unified [[Login|login]] popup
-replaceShortcut <xml file>: replace all [[Shortcut (computing)|shortcuts]] with those in the .xml file
-addShortcut <xml file>: add shortcut from the xml file
-startup: open window marked for opening at [[Booting|startup]]
</syntaxhighlight>

==Generating SAR Text Files for Ksar Use==
* To begin gathering sysstat history information for use of the sar command, systat should be configured to run through cron (preferably every minute). More instructions are available on [http://sebastien.godard.pagesperso-orange.fr/documentation.html the systat web site].
* Generating sar text file with all system resources information
*:<syntaxhighlight lang="sh">
 DT="10"
 LC_ALL=C sar -A -f /var/log/sa/sa$DT > /tmp/sar-$(hostname)-$DT.txt
 ls -l /tmp/sar-$(hostname)-$DT.txt
</syntaxhighlight>
* Generating only disk information from a sar data file
*:(Note that sar will collect disk information only if sadc is running with -d option thru cron)
*:<syntaxhighlight lang="sh">
 DT="10"
 LC_ALL=C sar -d -p -f /var/log/sa/sa$DT > /tmp/sar-$(hostname)-$DT.txt
 ls -l /tmp/sar-$(hostname)-$DT.txt
</syntaxhighlight>
* Generating a text file for multiple days
*:<syntaxhighlight lang="sh">
 DT="12 13 14"	
 >/tmp/sar-$(hostname)-multiple.txt	
 for i in $DT; do
   LC_ALL=C sar -A  -f /var/log/sa/sa$i >> /tmp/sar-$(hostname)-multiple.txt
 done
 ls -l /tmp/sar-$(hostname)-multiple.txt
</syntaxhighlight>
For getting all the days in the default folder, you can replace the hardcoded DT variable with:
<syntaxhighlight lang="sh">
 DT=$(ls /var/log/sa/sa[0-9][0-9] | sed 's_/var/log/sa/sa_ _g' | xargs)
</syntaxhighlight>

==See also==
*[[Software:Sar (Unix)|Sar (Unix)]]

==External links==
* [http://www.cyberciti.biz/tips/identifying-linux-bottlenecks-sar-graphs-with-ksar.html How to use ksar - cyberciti article]
* [http://sourceforge.net/projects/ksar Sourceforge Ksar Project Page]

[[Category:Job scheduling]]
[[Category:Computer performance]]
[[Category:System administration]]
[[Category:BSD software]]

{{Sourceattribution|Ksar (Unix sar grapher)}}