Git Product home page Git Product logo

sargraph's Introduction

What is this?

Sargraph is a tool that allows users to visualize system performance data collected by the SAR command (system activity reporter) with visually pleasing graphs. The utility takes the sar output (txt) data and generates graphical representations of various system metrics, such as:

  • CPU usage
  • Memory usage
  • Disk activity

These graphs can help users quickly identify patterns and trends in their system's performance over time, making it easier to identify issues and optimize performance.

Sargraph runs entirely on the browser and parsing occurs locally, as such no data is uploaded to any location, keeping PII (such as hostnames) local.

Motivation

Sysstat is a great tool to review historical performance data on Linux systems, yet it is saved as raw text making it hard to fully see patterns around performance.

Sargraph helps review sar files quickly, making performance analysis faster, specially for new Linux Users.

Lastly, existing tools to graph sar data are either too old or files need to be uploaded somewhere. The main motivation is keeping all PII local by having the browser run all the parsing.

Design philosophy

  • Must be beautiful, use modern frameworks for UI (React)⚛️ and chartjs2 for charts 🌈.
  • No PII 📵, data is kept within the browser.
  • Easy to use👍🏻, numbers are shown in human readable format. (i.e. 1GB vs 1000000KB)

Usage

There are 3 main ways the application can be used:

  1. Use the site https://sargraph.xzy. (No data is sent to the server, server only returns javascript)
  2. Use the docker image. For example, from WSL 2 with docker installed or docker desktop on Windows, run the command docker run -d --name sargraph -p 8080:80 gjarllarhorn/sargraph
  3. Clone the repo and run npm install -f and npm run (slower, not recommended, also node v16+ needs to be installed).

Sargraph takes the sar text files generated by sysstat normally found under /var/log/sa and generates easy to read graphs for the different metrics.

To use, drag & drop or click to select a sar file.

To Do

  • ✅Include other metrics like network, swap.
  • ✅Enhance performance on larger datasets.PR#39 improves performance
  • ✅Include tips on the different metrics.
  • ✅Learn to code and make good applications.

Feedback

Feel free to open an Issue and leave feedback, or head to the Discussions section if there’s any question.

Contributing

Not going to lie that my code isn’t great… As such if anyone wants to help make this better, I’d love to accept any PRs.

sargraph's People

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar

sargraph's Issues

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.