Georg/OOMAnalyser
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Initial commit

Browse Source
This commit is contained in:
Carsten Grohmann 2017-11-25 12:52:55 +01:00
commit 18e8a3eb56
7 changed files with 1378 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
.gitignore vendored Normal file
View File

@ -0,0 +1,10 @@
# Files to be ignored by Git
# Byte-compiled / optimized / DLL files
*.py[cod]
# Environments
env/
# IntelliJ project files
.idea

19
LICENSE.txt Normal file
View File

@ -0,0 +1,19 @@
Copyright (c) 2017 Carsten Grohmann mail <add at here> carsten-grohmann.de
Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and associated documentation files (the "Software"), to deal in
the Software without restriction, including without limitation the rights to
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
of the Software, and to permit persons to whom the Software is furnished to do
so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

65
Makefile Normal file
View File

@ -0,0 +1,65 @@
# Makefile for OOMAnalyser
#
# Copyright (c) 2017 Carsten Grohmann
# License: MIT (see LICENSE.txt)
# THIS PROGRAM COMES WITH NO WARRANTY
.PHONY: help clean distclean
# Makefile defaults
SHELL = /bin/sh
BASE_DIR = .
PYTHON_BIN = python3
VIRTUAL_ENV = env
export VIRTUAL_ENV := $(abspath ${VIRTUAL_ENV})
export PATH := ${VIRTUAL_ENV}/bin:${PATH}
HELP= @grep -B1 '^[a-zA-Z\-]*:' Makefile |\
awk 'function p(h,t){printf"%-12s=%s\n",h,t;};\
/\#+/{t=$$0;};\
/:/{gsub(":.*","");h=$$0};\
/^--/{p(h,t);t=h="";};\
END{p(h,t)}' |\
sed -n 's/=.*\#+/:/gp'
#+ Show this text
help:
$(HELP)
#+ Clean python compiler files and automatically generated files
clean:
@echo "Remove all automatically generated files ..."
@find $(BASE_DIR) -depth -type f -name "*.pyc" -exec rm -f {} \;
@find $(BASE_DIR) -depth -type f -name "*.pyo" -exec rm -f {} \;
@find $(BASE_DIR) -depth -type f -name "*.orig" -exec rm -f {} \;
@find $(BASE_DIR) -depth -type f -name "*~" -exec rm -f {} \;
@$(RM) --force --recursive __javascript__
#+ Remove all automatically generated and Git repository data
distclean: clean venv-clean
@echo "Remove Git repository data (.git*) ..."
@(RM) --force .git .gitignore
$(VIRTUAL_ENV)/bin/activate: requirements.txt
test -d $(VIRTUAL_ENV) || virtualenv $(VIRTUAL_ENV)
. $(VIRTUAL_ENV)/bin/activate
$(VIRTUAL_ENV)/bin/pip install -Ur requirements.txt
touch $(VIRTUAL_ENV)/bin/activate
#+ Setup the virtual environment from scratch
venv: $(VIRTUAL_ENV)/bin/activate
#+ Freeze the current virtual environment by update requirements.txt
venv-freeze:
source $(VIRTUAL_ENV)/bin/activate && $(VIRTUAL_ENV)/bin/pip freeze > requirements.txt
#+ Remove the virtual environment
venv-clean:
rm -rf $(VIRTUAL_ENV)
#+ Compile Python to JavaScript
build: venv
. $(VIRTUAL_ENV)/bin/activate
transcrypt --build --map --nomin -e 6 OOMAnalyser.py

489
OOMAnalyser.html Normal file
View File

@ -0,0 +1,489 @@
<!DOCTYPE html>
<html lang="en">
<head>
<script src="__javascript__/OOMAnalyser.js" defer="defer"></script>
<meta charset="UTF-8">
<title>OOM Analyser</title>
<style type='text/css'>
h1 {
font-size: 2em;
margin: 0.67em 0;
}
#error_box {
display: none;
}
.kbytes {
text-align: right;
}
.kbytes::after {
content: " kBytes";
}
.pages {
text-align: right;
}
.pages::after {
content: " pages";
}
table {
border-collapse: collapse;
padding: 10px;
table-layout: fixed;
text-align: left;
width: 100%;
}
svg {
display: block;
max-height: 200px;
}
th {
font-weight: bold;
font-size: large;
padding: 5px;
}
th, td {
border: 1px solid black;
word-wrap: break-word;
}
.terminal {
font-family: monospace;
overflow: auto;
}
/* Zebra-Layout */
tr:nth-child(odd) td:nth-child(2), tr:nth-child(odd) td:nth-child(3) {
background-color: #f2f2f2;
}
.license {
font-size: small;
display: none;
}
</style>
<script>
function goBack() {
window.history.back();
}
</script>
</head>
<body>
<h1>Analyse and visualise Linux OOM output</h1>
<p>
This web page splits the content of a Linux Out Of Memory message into
smaller pieces, aggregates these and presents them in a more human friendly
format.
</p>
<p>
<textarea id="textarea_oom" cols="100" rows="20" autocomplete="off" title="OOM input field">Add your OOMhere</textarea>
<br/>
<button onclick="OOMAnalyser.oomAnalyser.analyse()" title="Analyse the OOM from the input area">
Analyse
</button>
<button onclick="OOMAnalyser.oomAnalyser.reset()" title="Clean the input area">Reset</button>
<button onclick="OOMAnalyser.oomAnalyser.copy_example()" title="Copy an example OOM into the input area"
>Insert example
</button>
</p>
<div id="analysis">
<h2>Analysis results</h2>
<table>
<!--
<thead>
<tr>
<th scope="col"></th>
<th scope="col">Entry</th>
<th scope="col">Description</th>
</tr>
</thead>
-->
<tbody>
<!-- Trigger process -->
<tr>
<th scope="row" colspan="3">Tigger process</th>
</tr>
<tr>
<td></td>
<td><span id="trigger_proc_name"></span> (PID <span id="trigger_proc_pid"></span>)</td>
<td>This process requests memory and is triggering thereby the OOM situation</td>
</tr>
<!-- Killed Process -->
<tr>
<th scope="row" colspan="3">Killed process</th>
</tr>
<tr>
<td></td>
<td><span id="killed_proc_name"></span> (PID <span id="killed_proc_pid"></span>)</td>
<td>Process killed by Linux kernel to satisfy the memory request</td>
</tr>
<tr>
<td>OOM Score<br>(score)</td>
<td id="killed_proc_score"></td>
<td></td>
</tr>
<tr>
<td>Virtual Memory <br> (total-vm) </td>
<td id="killed_proc_vm_kb" class="kbytes"></td>
<td>Virtual memory used by this process</td>
</tr>
<tr>
<td>Resident anonymous memory <br> (anon-rss) </td>
<td id="killed_proc_anon_rss_kb" class="kbytes"></td>
<td>Part of the virtual process memory mapped into RAM</td>
</tr>
<tr>
<td>Resident file mapping memory <br> (file-rss) </td>
<td id="killed_proc_file_rss_kb" class="kbytes"></td>
<td>Files which have been mapped into RAM (with
<a href="http://man7.org/linux/man-pages/man2/mmap.2.html">mmap(2)</a>)
</td>
</tr>
<tr>
<td>Resident shared memory <br> (shmem-rss) </td>
<td id="killed_proc_shmem_rss_kb" class="kbytes"></td>
<td>This may include System V shared memory and shared anonymous memory</td>
</tr>
<!-- Memory Chunks -->
<tr>
<th scope="row" colspan="3">Memory Usage</th>
</tr>
<tr>
<td style="font-weight: bold">RAM Summary</td>
<td colspan="2"><div id="svg_ram"></div></td>
</tr>
<tr>
<td style="font-weight: bold">Swap Summary</td>
<td colspan="2"><div id="svg_swap"></div></td>
</tr>
<tr>
<td style="font-weight: bold">RAM usage</td>
<td></td>
<td></td>
</tr>
<tr>
<td>Active anonymous memory</td>
<td id="active_anon_pages" class="pages"></td>
<td>Recently used anonymous memory.<br>
These memory pages will usually not swapped out.
</td>
</tr>
<tr>
<td>Inactive anonymous memory</td>
<td id="inactive_anon_pages" class="pages"></td>
<td>Least recently used anonymous memory.<br>
These memory pages can be swapped out.
</td>
</tr>
<tr>
<td>Isolated anonymous memory</td>
<td id="isolated_anon_pages" class="pages"></td>
<td>Memory isolation is used to separate memory between different virtual machines.</td>
</tr>
<tr>
<td>Active Pagecache</td>
<td id="active_file_pages" class="pages"></td>
<td>Pagecache that has been used more recently and usually not reclaimed unless absolutely necessary.</td>
</tr>
<tr>
<td>Inactive Pagecache</td>
<td id="inactive_file_pages" class="pages"></td>
<td>Pagecache which has been less recently used. It can be reclaimed without huge performance impact.</td>
</tr>
<tr>
<td>Isolated Pagecache</td>
<td id="isolated_file_pages" class="pages"></td>
<td>Memory isolation is used to separate memory between different virtual machines.</td>
</tr>
<tr>
<td>Unevictable pages</td>
<td id="unevictable_pages" class="pages"></td>
<td>Unevictable memory. It can't be swapped out because the pages are owned by ramfs or protected by
<a href="http://man7.org/linux/man-pages/man3/mlock.5.html" target="_blank">mlock(3)</a> /
<a href="http://man7.org/linux/man-pages/man2/shmctl.2.html" target="_blank">shmctl(SHM_LOCK)</a>.
Unevictable pages are managed by kernels LRU framework.
</td>
</tr>
<tr>
<td>Dirty</td>
<td id="dirty_pages" class="pages"></td>
<td>Memory which is waiting to get written back to the
disk.
<sup><a href="#footnote-proc5">[1]</a></sup>
</td>
</tr>
<tr>
<td>Writeback</td>
<td id="writeback_pages" class="pages"></td>
<td>
Memory which is actively being written back to the disk.
<sup><a href="#footnote-proc5">[1]</a></sup>
</td>
</tr>
<tr>
<td>Unstable</td>
<td id="unstable_pages" class="pages"></td>
<td>Not yet committed to stable storage.</td>
</tr>
<tr>
<td>Slab Reclaimable</td>
<td id="slab_reclaimable_pages" class="pages"></td>
<td>
Slab is a in-kernel data structures cache. Part of Slab, that might be reclaimed, such as caches.
<sup><a href="#footnote-proc5">[1]</a></sup>
<br>
Additional details are listed in
<a href="http://man7.org/linux/man-pages/man5/slabinfo.5.html" target="_blank">slabinfo(5)</a> also.
</td>
</tr>
<tr>
<td>Slab Unreclaimable</td>
<td id="slab_unreclaimable_pages" class="pages"></td>
<td>
Part of Slab, that cannot be reclaimed on memory pressure.
<sup><a href="#footnote-proc5">[1]</a></sup>
</td>
</tr>
<tr>
<td>Mapped</td>
<td id="mapped_pages" class="pages"></td>
<td>
Files which have been mapped into memory (with
<a href="http://man7.org/linux/man-pages/man2/mmap.2.html">mmap(2)</a>), such as libraries.
<sup><a href="#footnote-proc5">[1]</a></sup>
</td>
</tr>
<tr>
<td>shmem</td>
<td id="shmem_pages" class="pages"></td>
<td>
Amount of memory consumed in
<a href="http://man7.org/linux/man-pages/man5/tmpfs.5.html">tmpfs(5)</a>
filesystems.
<sup><a href="#footnote-proc5">[1]</a></sup>
</td>
</tr>
<tr>
<td>Pagetables</td>
<td id="pagetables_pages" class="pages"></td>
<td>
Amount of memory dedicated to the lowest level of pagetables.
<sup><a href="#footnote-proc5">[1]</a></sup>
</td>
</tr>
<tr>
<td>Bounce</td>
<td id="bounce_pages" class="pages"></td>
<td>
Memory used for block device "bounce buffers".
<sup><a href="#footnote-proc5">[1]</a></sup>
</td>
</tr>
<tr>
<td>free</td>
<td id="free_pages" class="pages"></td>
<td></td>
</tr>
<tr>
<td>free_pcp</td>
<td id="free_pcp_pages" class="pages"></td>
<td></td>
</tr>
<tr>
<td>free_cma</td>
<td id="free_cma_pages" class="pages"></td>
<td></td>
</tr>
<tr>
<td>Total Pagecache</td>
<td id="pagecache_total_pages" class="pages"></td>
<td></td>
</tr>
<!-- Swap Usage -->
<tr>
<td style="font-weight: bold">Swap usage</td>
<td></td>
<td></td>
</tr>
<tr>
<td>Swap Total</td>
<td id="swap_total_kb" class="kbytes"></td>
<td>Total amount of swap space available.
<sup><a href="#footnote-proc5">[1]</a></sup>
</td>
</tr>
<tr>
<td>Swap Free</td>
<td id="swap_free_kb" class="kbytes"></td>
<td>Amount of swap space that is currently unused.
<sup><a href="#footnote-proc5">[1]</a></sup>
</td>
</tr>
<tr>
<td>Swap Cached</td>
<td id="swap_cache_kb" class="kbytes"></td>
<td>Memory that once was swapped out, is swapped back in
but still also is in the swap file. (If memory pres‐
sure is high, these pages don't need to be swapped out
again because they are already in the swap file. This
saves I/O).
<sup><a href="#footnote-proc5">[1]</a></sup>
</td>
</tr>
<tr>
<td>Swap Used</td>
<td id="swap_used_kb" class="kbytes"></td>
<td>Amount of used swap space w/o cached swap <br>
(<code>SwapUsed = SwapTotal - SwapFree -SwapCache</code>)
</td>
</tr>
<!-- Operating System -->
<tr>
<th scope="row" colspan="3">Operating System</th>
</tr>
<tr>
<td>Kernel</td>
<td id="kernel_version"></td>
<td></td>
</tr>
<tr>
<td>Distribution</td>
<td id="dist"></td>
<td>Guessed from the kernel version</td>
</tr>
<tr>
<td>Platform</td>
<td id="platform"></td>
<td>Guessed from the kernel version</td>
</tr>
<tr>
<td>Page size</td>
<td id="page_size" class="kbytes"></td>
<td>Guessed</td>
</tr>
<!-- Memory Chunks -->
<tr>
<th scope="row" colspan="3">Memory Chunks</th>
</tr>
<tr>
<td></td>
<td colspan="2" class="terminal">
<pre id="mem_node_info"></pre>
</td>
</tr>
<tr>
<th scope="row" colspan="3">Process Table</th>
</tr>
<tr>
<td></td>
<td colspan="2" class="terminal">
<pre id="process_table"></pre>
</td>
</tr>
<!-- Hardware Details -->
<tr>
<th scope="row" colspan="3">Hardware Details</th>
</tr>
<tr>
<td></td>
<td colspan="2" class="terminal">
<pre id="hardware_info"></pre>
</td>
</tr>
<!-- Kernel Call Tree -->
<tr>
<th scope="row" colspan="3">Kernel Call Trace</th>
</tr>
<tr>
<td></td>
<td colspan="2" class="terminal">
<pre id="call_trace"></pre>
</td>
</tr>
</tbody>
</table>
</div>
<div id="error_box">
<h2>Error messages</h2>
<div class="terminal" id="__terminal__"></div>
</div>
<h2>Footnotes</h2>
<ol>
<li id="footnote-proc5"><cite><a href="http://man7.org/linux/man-pages/man5/proc.5.html" target="_blank">
proc(5) - process information pseudo-filesystem</a></cite> (<a href="#" onclick="goBack()">Go Back</a>)
</li>
</ol>
<hr/>
<div class="footer">
OOMAnalyser |
Copyright (C) 2017 Carsten Grohmann |
<a href="javascript:void(0);" onclick="OOMAnalyser.toggle('license')" title="Show / hide license text">License: MIT</a> |
<a href="https://github.com/CarstenGrohmann/OOMAnalyser" title="Source code on GitHub">Source Code on GitHub</a>
</div>
<div class="license" id="license">
<p>
Copyright (c) 2017 Carsten Grohmann mail &lt;add at here&gt; carsten-grohmann.de
</p>
<p>
Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and associated documentation files (the "Software"), to deal in
the Software without restriction, including without limitation the rights to
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
of the Software, and to permit persons to whom the Software is furnished to do
so, subject to the following conditions:
</p>
<p>
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
</p>
<p>
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
</p>
</div>
</body>
</html>

704
OOMAnalyser.py Normal file
View File

@ -0,0 +1,704 @@
# -*- coding: Latin-1 -*-
#
# Linux OOM Analyser
#
# Copyright (c) 2017 Carsten Grohmann
# License: MIT - THIS PROGRAM COMES WITH NO WARRANTY
import re
DEBUG=False
"""Show additional information during the development cycle"""
def hide_element(element_id):
"""Hide the given HTML element"""
document.getElementById(element_id).style.display = 'none'
def show_element(element_id):
"""Show the given HTML element"""
document.getElementById(element_id).style.display = 'block'
def toggle(element_id):
"""Toggle the visibility of the given HTML element"""
element = document.getElementById(element_id)
display_prop = element.style.display
if display_prop and display_prop == 'block':
element.style.display = 'none'
else:
element.style.display = 'block'
def error(msg):
"""Unhide the error box and add the error message"""
show_element("error_box")
print("ERROR: ", msg)
class OOM(object):
REC_TIMESTAMP = re.compile(
r'('
r'\[\s+\d+\.\d+\]'
r'|'
r'\[[A-Z]+[\w ]+ +\d{1,2} \d{2}:\d{2}:\d{2} \d{4}\]'
r') ', re.ASCII)
i = 0
lines = []
complete = False
def __init__(self, text):
# use Unix LF only
text = text.replace('\r\n', '\r')
# Split into lines
oom_lines = []
inside_oom = False
for line in text.split('\n'):
if "invoked oom-killer:" in line:
inside_oom = True
elif not inside_oom:
continue
# Remove leading timestamps
line = self.REC_TIMESTAMP.sub('', line)
# remove empty lines
if not line.strip():
continue
oom_lines.append(line)
# next line will not be part of the oom anymore
if "Killed process" in line:
inside_oom = False
break
self.i = 0
self.complete = not inside_oom
self.lines = oom_lines
self.text = '\n'.join(oom_lines)
def back(self):
"""Return the previous line"""
if self.i - 1 < 0:
raise StopIteration()
self.i -= 1
return self.lines[self.i]
def current(self):
"""Return the current line"""
return self.lines[self.i]
def next(self):
"""Return the next line"""
if self.i + 1 < len(self.lines):
self.i += 1
return self.lines[self.i]
raise StopIteration()
def find_text(self, pattern):
"""
Search the pattern and set the position to the first found line.
Otherwise the position pointer won't be changed.
:param pattern: Text to fine
:type pattern: str
:return: True if the marker has found.
"""
for line in self.lines:
if pattern in line:
self.i = self.lines.index(line)
return True
return False
def __iter__(self):
return self
def __next__(self):
return self.next()
class OOMAnalyser(object):
example = u'''\
sed invoked oom-killer: gfp_mask=0x201da, order=0, oom_score_adj=0
sed cpuset=/ mems_allowed=0-1
CPU: 4 PID: 29481 Comm: sed Not tainted 3.10.0-514.6.1.el7.x86_64 #1
Hardware name: HP ProLiant DL385 G7, BIOS A18 12/08/2012
ffff880182272f10 00000000021dcb0a ffff880418207938 ffffffff816861ac
ffff8804182079c8 ffffffff81681157 ffffffff810eab9c ffff8804182fe910
ffff8804182fe928 0000000000000202 ffff880182272f10 ffff8804182079b8
Call Trace:
[<ffffffff816861ac>] dump_stack+0x19/0x1b
[<ffffffff81681157>] dump_header+0x8e/0x225
[<ffffffff810eab9c>] ? ktime_get_ts64+0x4c/0xf0
[<ffffffff8113ccaf>] ? delayacct_end+0x8f/0xb0
[<ffffffff8118475e>] oom_kill_process+0x24e/0x3c0
[<ffffffff811841fd>] ? oom_unkillable_task+0xcd/0x120
[<ffffffff811842a6>] ? find_lock_task_mm+0x56/0xc0
[<ffffffff810937ee>] ? has_capability_noaudit+0x1e/0x30
[<ffffffff81184f96>] out_of_memory+0x4b6/0x4f0
[<ffffffff81681c60>] __alloc_pages_slowpath+0x5d7/0x725
[<ffffffff8118b0a5>] __alloc_pages_nodemask+0x405/0x420
[<ffffffff811cf25a>] alloc_pages_current+0xaa/0x170
[<ffffffff81180667>] __page_cache_alloc+0x97/0xb0
[<ffffffff811831b0>] filemap_fault+0x170/0x410
[<ffffffffa018f016>] ext4_filemap_fault+0x36/0x50 [ext4]
[<ffffffff811ac2ec>] __do_fault+0x4c/0xc0
[<ffffffff811ac783>] do_read_fault.isra.42+0x43/0x130
[<ffffffff811b0f11>] handle_mm_fault+0x6b1/0xfe0
[<ffffffff811b7825>] ? do_mmap_pgoff+0x305/0x3c0
[<ffffffff81691c94>] __do_page_fault+0x154/0x450
[<ffffffff81691fc5>] do_page_fault+0x35/0x90
[<ffffffff8168e288>] page_fault+0x28/0x30
Mem-Info:
active_anon:7355653 inactive_anon:660960 isolated_anon:0
active_file:1263 inactive_file:1167 isolated_file:32
unevictable:0 dirty:4 writeback:0 unstable:0
slab_reclaimable:27412 slab_unreclaimable:13708
mapped:4818 shmem:87896 pagetables:25222 bounce:0
free:39513 free_pcp:2958 free_cma:0
Node 0 DMA free:15872kB min:40kB low:48kB high:60kB active_anon:0kB inactive_anon:0kB active_file:0kB inactive_file:0kB unevictable:0kB isolated(anon):0kB isolated(file):0kB present:15992kB managed:15908kB mlocked:0kB dirty:0kB writeback:0kB mapped:0kB shmem:0kB slab_reclaimable:0kB slab_unreclaimable:0kB kernel_stack:0kB pagetables:0kB unstable:0kB bounce:0kB free_pcp:0kB local_pcp:0kB free_cma:0kB writeback_tmp:0kB pages_scanned:0 all_unreclaimable? yes lowmem_reserve[]: 0 2780 15835 15835
Node 0 DMA32 free:59728kB min:7832kB low:9788kB high:11748kB active_anon:2154380kB inactive_anon:604748kB active_file:500kB inactive_file:112kB unevictable:0kB isolated(anon):0kB isolated(file):0kB present:3094644kB managed:2848912kB mlocked:0kB dirty:0kB writeback:0kB mapped:4016kB shmem:5140kB slab_reclaimable:6448kB slab_unreclaimable:2796kB kernel_stack:1040kB pagetables:6876kB unstable:0kB bounce:0kB free_pcp:3788kB local_pcp:228kB free_cma:0kB writeback_tmp:0kB pages_scanned:28 all_unreclaimable? no lowmem_reserve[]: 0 0 13055 13055
Node 0 Normal free:36692kB min:36784kB low:45980kB high:55176kB active_anon:12301636kB inactive_anon:793132kB active_file:604kB inactive_file:176kB unevictable:0kB isolated(anon):0kB isolated(file):128kB present:13631488kB managed:13368348kB mlocked:0kB dirty:0kB writeback:0kB mapped:4108kB shmem:207940kB slab_reclaimable:47900kB slab_unreclaimable:28884kB kernel_stack:6624kB pagetables:43340kB unstable:0kB bounce:0kB free_pcp:4204kB local_pcp:640kB free_cma:0kB writeback_tmp:0kB pages_scanned:128 all_unreclaimable? no lowmem_reserve[]: 0 0 0 0
Node 1 Normal free:49436kB min:45444kB low:56804kB high:68164kB active_anon:14967844kB inactive_anon:1244560kB active_file:1552kB inactive_file:1992kB unevictable:0kB isolated(anon):0kB isolated(file):0kB present:16777212kB managed:16514220kB mlocked:0kB dirty:16kB writeback:0kB mapped:10760kB shmem:138504kB slab_reclaimable:55300kB slab_unreclaimable:23152kB kernel_stack:6176kB pagetables:50672kB unstable:0kB bounce:0kB free_pcp:3360kB local_pcp:248kB free_cma:0kB writeback_tmp:0kB pages_scanned:125777 all_unreclaimable? yes lowmem_reserve[]: 0 0 0 0
Node 0 DMA: 0*4kB 0*8kB 0*16kB 0*32kB 2*64kB (U) 1*128kB (U) 1*256kB (U) 0*512kB 1*1024kB (U) 1*2048kB (M) 3*4096kB (M) = 15872kB
Node 0 DMA32: 203*4kB (UEM) 231*8kB (UEM) 259*16kB (UEM) 231*32kB (UEM) 157*64kB (UEM) 90*128kB (UEM) 49*256kB (UEM) 20*512kB (UE) 3*1024kB (UEM) 1*2048kB (M) 0*4096kB = 63668kB
Node 0 Normal: 1231*4kB (UEM) 391*8kB (UEM) 456*16kB (UEM) 342*32kB (UEM) 141*64kB (UEM) 23*128kB (UEM) 0*256kB 0*512kB 0*1024kB 0*2048kB 0*4096kB = 38260kB
Node 1 Normal: 2245*4kB (UEM) 732*8kB (UEM) 594*16kB (UEM) 396*32kB (UEM) 160*64kB (UEM) 16*128kB (UEM) 2*256kB (UM) 0*512kB 1*1024kB (M) 0*2048kB 0*4096kB = 50836kB
Node 0 hugepages_total=0 hugepages_free=0 hugepages_surp=0 hugepages_size=1048576kB
Node 0 hugepages_total=0 hugepages_free=0 hugepages_surp=0 hugepages_size=2048kB
Node 1 hugepages_total=0 hugepages_free=0 hugepages_surp=0 hugepages_size=1048576kB
Node 1 hugepages_total=0 hugepages_free=0 hugepages_surp=0 hugepages_size=2048kB
100155 total pagecache pages
11342 pages in swap cache
Swap cache stats: add 31260615, delete 31249273, find 295999950/297583545
Free swap = 0kB
Total swap = 8388604kB
8379834 pages RAM
0 pages HighMem/MovableOnly
192987 pages reserved
[ pid ] uid tgid total_vm rss nr_ptes swapents oom_score_adj name
[ 390] 0 390 39012 6739 78 51 0 systemd-journal
[ 433] 0 433 11104 2 22 360 -1000 systemd-udevd
[ 530] 0 530 13854 28 27 83 -1000 auditd
[ 559] 0 559 7692 65 19 87 0 systemd-logind
[ 563] 0 563 4817 41 14 36 0 irqbalance
[ 569] 87 569 7684 52 20 48 -900 dbus-daemon
[ 587] 32 587 16240 17 34 116 0 rpcbind
[ 647] 0 647 50303 11 36 113 0 gssproxy
[ 796] 0 796 193856 2897 207 112 0 rsyslogd
[ 818] 0 818 13177 0 27 146 0 vsftpd
[ 840] 0 840 62892 9 36 103 0 ypbind
[ 868] 0 868 21663 28 43 191 -1000 sshd
[ 871] 29 871 11126 2 25 222 0 rpc.statd
[ 907] 0 907 8044 4 21 53 0 atd
[ 916] 0 916 27509 2 10 30 0 agetty
[ 934] 0 934 27509 2 10 31 0 agetty
[ 1255] 0 1255 45716 1 39 337 0 rscd
[ 1268] 0 1268 45746 28 38 353 0 rscd
[ 1269] 0 1269 45716 29 38 311 0 rscd
[ 1285] 0 1285 23290 25 45 235 0 master
[ 1287] 89 1287 23379 52 47 242 0 qmgr
[ 1830] 0 1830 446643 959 68 1234 0 ovcd
[ 2062] 0 2062 144894 511 37 309 0 ovbbccb
[ 2121] 0 2121 33138 26 19 138 0 crond
[ 2136] 38 2136 7846 40 19 88 0 ntpd
[ 2451] 0 2451 177827 0 36 816 0 ovconfd
[ 8145] 0 8145 300303 1616 58 692 0 hpsensor
[ 8204] 0 8204 31508 119 31 328 0 opcmsgi
[ 8405] 0 8405 201479 1289 49 244 0 opcmsga
[ 8472] 0 8472 134080 236 46 514 0 opcmona
[ 8596] 0 8596 31377 172 29 301 0 opcle
[ 8658] 0 8658 81199 124 34 336 0 opcacta
[ 8685] 0 8685 137169 23313 97 3256 0 oacore
[ 6330] 12345 6330 7520 15 18 61 0 rotatelogs
[ 6331] 12345 6331 28318 0 12 83 0 run.sh
[ 6576] 12345 6576 8478546 5157063 15483 1527848 0 java
[27171] 12345 27171 7522 10 18 58 0 rotatelogs
[27172] 12345 27172 28320 3 11 94 0 run.sh
[27502] 12345 27502 4029300 2716569 6505 226225 0 java
[11729] 0 11729 64122 5003 79 2465 0 snmpd
[12130] 0 12130 122202 565 29 175 0 hpasmlited
[12166] 0 12166 11905 89 24 121 0 cmahealthd
[12190] 0 12190 11871 89 24 119 0 cmastdeqd
[12214] 0 12214 13707 84 31 211 0 cmahostd
[12237] 0 12237 12493 38 28 352 0 cmathreshd
[12276] 0 12276 12368 45 30 210 0 cmasm2d
[12299] 0 12299 12485 43 26 282 0 cmaperfd
[12324] 0 12324 31932 184 31 143 0 cmapeerd
[12352] 0 12352 14280 48 32 169 0 cmaeventd
[12379] 0 12379 14831 26 30 198 0 cmafcad
[12407] 0 12407 11806 12 25 128 0 cmasasd
[12436] 0 12436 14364 86 31 181 0 cmaidad
[12463] 0 12463 11288 15 25 125 0 cmaided
[12492] 0 12492 11805 14 26 127 0 cmascsid
[12523] 0 12523 92228 129 63 433 0 cmanicd
[14002] 0 14002 11803 12 25 128 0 cmasm2d
[32615] 0 32615 36254 323 73 7 0 sshd
[ 894] 12345 894 36254 328 70 5 0 sshd
[ 895] 12345 895 3389 123 11 0 0 ksh
[10620] 0 10620 36254 328 72 0 0 sshd
[10634] 38714 10634 36290 329 70 8 0 sshd
[10635] 38714 10635 14221 25 31 124 0 sftp-server
[29021] 0 29021 36254 314 69 0 0 sshd
[29025] 12345 29025 36254 316 67 0 0 sshd
[29026] 12345 29026 29286 96 12 1 0 ksh
[29051] 12345 29051 29494 330 12 74 0 svr05
[29979] 12345 29979 1666 42 9 0 0 less
[29662] 89 29662 23316 258 43 0 0 pickup
[26065] 89 26065 23317 256 45 0 0 trivial-rewrite
[26066] 89 26066 23353 265 45 0 0 cleanup
[26067] 89 26067 23368 271 45 0 0 smtp
[26743] 0 26743 36254 314 68 0 0 sshd
[26937] 12345 26937 36254 314 67 0 0 sshd
[26938] 12345 26938 29286 96 11 0 0 ksh
[27122] 12345 27122 29494 459 12 0 0 svr05
[28657] 0 28657 36254 314 74 0 0 sshd
[28702] 12345 28702 36254 314 72 0 0 sshd
[28703] 12345 28703 29286 97 11 0 0 ksh
[28993] 0 28993 36254 314 72 0 0 sshd
[28996] 12345 28996 29526 531 12 0 0 svr05
[29006] 12345 29006 36254 314 69 0 0 sshd
[29007] 12345 29007 29286 96 11 0 0 ksh
[29110] 12345 29110 29558 745 12 0 0 svr05
[29481] 12345 29481 29214 58 14 0 0 sed
[29752] 12345 29752 7522 296 19 0 0 rotatelogs
Out of memory: Kill process 6576 (java) score 651 or sacrifice child
Killed process 6576 (java) total-vm:33914892kB, anon-rss:20629004kB, file-rss:0kB, shmem-rss:0kB
'''
REC_INVOKED_OOMKILLER = re.compile(r'^(?P<trigger_proc_name>[\w ]+) invoked oom-killer:', re.MULTILINE)
REC_PID_KERNELVERSION = re.compile(
r'^CPU: \d+ PID: (?P<trigger_proc_pid>\d+) '
r'Comm: .* (Not tainted|Tainted:.*) '
r'(?P<kernel_version>\d[\w.-]+) #\d',
re.MULTILINE
)
# split caused by a limited number of iterations during converting PY regex into JS regex
REC_MEMINFO_1 = re.compile(
# head line
r'^Mem-Info:.*'
# first line break
r'(?:\n)'
# first line (starting with a space)
r'^active_anon:(?P<active_anon_pages>\d+) inactive_anon:(?P<inactive_anon_pages>\d+) '
r'isolated_anon:(?P<isolated_anon_pages>\d+)'
# next line break
r'(?:\n)'
# remaining lines (with leading space)
r'^ active_file:(?P<active_file_pages>\d+) inactive_file:(?P<inactive_file_pages>\d+) '
r'isolated_file:(?P<isolated_file_pages>\d+)'
# next line break
r'(?:\n)'
r'^ unevictable:(?P<unevictable_pages>\d+) dirty:(?P<dirty_pages>\d+) writeback:(?P<writeback_pages>\d+) '
r'unstable:(?P<unstable_pages>\d+)'
# # next line break
# r'(?:\n)'
#
, re.MULTILINE
)
REC_MEMINFO_2 = re.compile(
r'^ slab_reclaimable:(?P<slab_reclaimable_pages>\d+) slab_unreclaimable:(?P<slab_unreclaimable_pages>\d+)'
# next line break
r'(?:\n)'
r'^ mapped:(?P<mapped_pages>\d+) shmem:(?P<shmem_pages>\d+) pagetables:(?P<pagetables_pages>\d+) '
r'bounce:(?P<bounce_pages>\d+)'
# next line break
r'(?:\n)'
r'^ free:(?P<free_pages>\d+) free_pcp:(?P<free_pcp_pages>\d+) free_cma:(?P<free_cma_pages>\d+)'
, re.MULTILINE
)
REC_MEM_NODEINFO = re.compile(r'(^Node \d+ (DMA|Normal|hugepages).*(:?\n))+', re.MULTILINE)
mem_modinfo_entries = ("active_anon_pages", "inactive_anon_pages", "isolated_anon_pages",
"active_file_pages", "inactive_file_pages", "isolated_file_pages",
"unevictable_pages", "dirty_pages", "writeback_pages", "unstable_pages",
"slab_reclaimable_pages", "slab_unreclaimable_pages",
"mapped_pages", "shmem_pages", "pagetables_pages", "bounce_pages",
"free_pages", "free_pcp_pages", "free_cma_pages",
)
REC_PAGECACHE = re.compile(r'^(?P<pagecache_total_pages>\d+) total pagecache pages.*$', re.MULTILINE)
REC_SWAP = re.compile(
r'^(?P<swap_cache_pages>\d+) pages in swap cache'
r'(?:\n)'
r'^Swap cache stats: add \d+, delete \d+, find \d+/\d+'
r'(?:\n)'
r'^Free swap = (?P<swap_free_kb>\d+)kB'
r'(?:\n)'
r'^Total swap = (?P<swap_total_kb>\d+)kB',
re.MULTILINE)
REC_PAGEINFO = re.compile(
r'^(?P<ram_pages>\d)+ pages RAM'
r'(?:\n)'
r'^(?P<highmem_pages>\d+) pages HighMem/MovableOnly'
r'(?:\n)'
r'^(?P<reserved_pages>\d+) pages reserved',
re.MULTILINE)
REC_PROCESSES = re.compile(
r'^\[ pid \].*(?:\n)'
r'(^(\[[ \d]+.+)(?:\n))+',
re.MULTILINE)
REC_KILLED = re.compile(
r'^Out of memory: Kill process (?P<killed_proc_pid>\d+) \((?P<killed_proc_name>[\w ]+)\) '
r'score (?P<killed_proc_score>\d+) or sacrifice child'
r'(?:\n)'
r'Killed process \d+ \(.*\) total-vm:(?P<killed_proc_vm_kb>\d+)kB, anon-rss:(?P<killed_proc_anon_rss_kb>\d+)kB, '
r'file-rss:(?P<killed_proc_file_rss_kb>\d+)kB, shmem-rss:(?P<killed_proc_shmem_rss_kb>\d+)kB'
,
re.MULTILINE)
lines = []
"""All lines of an OOM without leading timestamps"""
details = {}
"""Extracted details"""
# Reference to the OOM object
oom = None
svg_namespace = 'http://www.w3.org/2000/svg'
svg_colours = ['#f20000', '#591616', '#cc6666', '#594343', '#d96c36',
'#7f5540', '#e6bfac', '#b27700', '#402b00', '#ffd580',
'#8c8c69', '#99e600', '#558000', '#d2e6ac', '#464d39',
'#004d00', '#36d96c', '#6cd9b5', '#005959', '#004d4d',
'#004040', '#739999', '#297ca6', '#80d5ff', '#1a2b33',
]
def __init__(self):
self._set_defaults()
def _set_single_item(self, item):
"""
Set content of a single item to the HTML element with the same name.
The content won't be formatted.
"""
element = document.getElementById(item)
if not element:
print("ERROR: HTML element not found: ", item)
return
content = self.details.get(item, '')
if type(content) is str:
content = content.strip()
element.textContent = content
if DEBUG:
show_element('error_box')
def _set_defaults(self, clean_oom=True):
"""\
Reset the whole HTML document
"""
if clean_oom:
document.getElementById('textarea_oom').textContent = "<paste your OOM here>"
hide_element("analysis")
self.lines = []
self.details = {}
for item in self.mem_modinfo_entries:
element = document.getElementById(item)
element.textContent = ""
# empty terminal
element = document.getElementById('__terminal__')
element.textContent = ""
hide_element('error_box')
# remove svg charts
element = document.getElementById('svg_swap')
while element.firstChild:
element.removeChild(element.firstChild)
def _create_svg_element(self, height, width):
"""
Return an empty SVG element
"""
svg = document.createElementNS(self.svg_namespace, 'svg')
svg.setAttribute('version', '1.1')
svg.setAttribute('height', height)
svg.setAttribute('width', width)
svg.setAttribute('viewBox', '0 0 {} {}'.format(width, height))
return svg
def _create_svg_rect(self, x=0, y=0, width=0, height=0, colour=None):
rect = document.createElementNS(self.svg_namespace, 'rect')
if x:
rect.setAttribute('x', x)
if y:
rect.setAttribute('y', y)
if width:
rect.setAttribute('width', width)
if height:
rect.setAttribute('height', height)
if colour:
rect.setAttribute('fill', colour)
return rect
def _generate_svg_bar_chart(self, *elements):
"""
Generate a SVG bar chart
"""
bar_height = 100
label_height = 80
length_factor = 4
overall_height = bar_height + label_height
overall_width = 100 * length_factor
svg = self._create_svg_element(overall_height, overall_width)
sum_all_elements = sum([length for unused, length in elements])
current_pos = 0
bar_group = document.createElementNS(self.svg_namespace, 'g')
bar_group.setAttribute('id', 'bar_group')
bar_group.setAttribute('stroke', 'black')
bar_group.setAttribute('stroke-width', 2)
nr_processed_elements = 0
for title, length in elements:
rect_len = int(100 * length / sum_all_elements) * length_factor
if not rect_len:
continue
colour = self.svg_colours[nr_processed_elements]
rect = self._create_svg_rect(current_pos, 0, rect_len, bar_height, colour)
bar_group.appendChild(rect)
label_group = document.createElementNS(self.svg_namespace, 'g')
label_group.setAttribute('id', title)
colour_rect = self._create_svg_rect(0, 0, 20, 20, colour)
colour_rect.setAttribute('stroke', 'black')
colour_rect.setAttribute('stroke-width', 2)
text = document.createElementNS(self.svg_namespace, 'text')
text.setAttribute('x', '30')
text.setAttribute('y', '18')
text.textContent = title
label_group.appendChild(colour_rect)
label_group.appendChild(text)
# TODO replace hardcoded values
x = 5 + 125 * (nr_processed_elements // 2)
y = bar_height + 10 + (nr_processed_elements % 2) * 40
label_group.setAttribute('transform', 'translate({}, {})'.format(x, y))
bar_group.appendChild(label_group)
current_pos += rect_len
nr_processed_elements += 1
svg.appendChild(bar_group)
return svg
def _extract_block_from_next_pos(self, marker):
"""
Extract a block starting with the marker and add all lines with a leading space character
:rtype: str
"""
block = ''
if not self.oom.find_text(marker):
return block
line = self.oom.current()
block += "{}\n".format(line)
for line in self.oom:
if not line.startswith(' '):
self.oom.back()
break
block += "{}\n".format(line)
return block
def _extract_from_oom_text(self):
"""Extract details from OOM message text"""
match = self.REC_INVOKED_OOMKILLER.search(self.oom.text)
if match:
self.details.update(match.groupdict())
match = self.REC_PID_KERNELVERSION.search(self.oom.text)
if match:
self.details.update(match.groupdict())
self.details['hardware_info'] = self._extract_block_from_next_pos('Hardware name:')
self.details['call_trace'] = self._extract_block_from_next_pos('Call Trace:')
match = self.REC_MEMINFO_1.search(self.oom.text)
if match:
self.details.update(match.groupdict())
match = self.REC_MEMINFO_2.search(self.oom.text)
if match:
self.details.update(match.groupdict())
match = self.REC_MEM_NODEINFO.search(self.oom.text)
if match:
self.details['mem_node_info'] = match.group()
match = self.REC_PAGECACHE.search(self.oom.text)
if match:
self.details.update(match.groupdict())
match = self.REC_SWAP.search(self.oom.text)
if match:
self.details.update(match.groupdict())
# TODO Add to HTML
#match = self.REC_PAGEINFO.search(self.oom.text)
#if match:
# self.details.update(match.groupdict())
match = self.REC_PROCESSES.search(self.oom.text)
if match:
self.details['process_table'] = match.group()
match = self.REC_KILLED.search(self.oom.text)
if match:
self.details.update(match.groupdict())
def _calc_from_oom_details(self):
"""
Calculate values from already extracted details
@see: self.details
"""
# TODO Check if bug in transcrypt
# for item in self.details: -> "Uncaught TypeError: Result of the Symbol.iterator"
# convert all *_pages and *_kb to integer
for item in self.details.keys():
if item.endswith('_kb') or item.endswith('_pages'):
try:
self.details[item] = int(self.details[item])
except:
error('Converting item {}: {} to integer failed'. format(item, self.details[item]))
kernel_version = self.details.get('kernel_version', '')
if 'x86_64' in kernel_version:
self.details['platform'] = 'x86 64bit'
else:
self.details['platform'] = 'unknown'
# guess distribution from kernel version
if '.el7' in kernel_version:
self.details['dist'] = 'RHEL/CentOS 7'
elif '.el6' in kernel_version:
self.details['dist'] = 'RHEL/CentOS 6'
elif '.el5' in kernel_version:
self.details['dist'] = 'RHEL/CentOS 5'
elif 'ARCH' in kernel_version:
self.details['dist'] = 'Arch Linux'
elif '_generic' in kernel_version:
self.details['dist'] = 'Ubuntu'
else:
self.details['dist'] = 'unknown'
# educated guess
self.details['page_size'] = 4
self.details['swap_cache_kb'] = self.details['swap_cache_pages'] * self.details['page_size']
del self.details['swap_cache_pages']
# SwapUsed = SwapTotal - SwapFree - SwapCache
self.details['swap_used_kb'] = self.details['swap_total_kb'] - self.details['swap_free_kb'] - \
self.details['swap_cache_kb']
def _show_details(self):
"""
Show all extracted details as well as additionally generated information
"""
if DEBUG:
print(self.details)
show_element("analysis")
for item in self.details.keys():
self._set_single_item(item)
svg_swap = self._generate_svg_bar_chart(
('Swap Used', self.details['swap_used_kb']),
('Swap Free', self.details['swap_free_kb']),
('Swap Cached', self.details['swap_cache_kb']),
)
elem_svg_swap = document.getElementById('svg_swap')
elem_svg_swap.appendChild(svg_swap)
svg_ram = self._generate_svg_bar_chart(
('Active mem', self.details['active_anon_pages']),
('Inactive mem', self.details['inactive_anon_pages']),
('Isolated mem', self.details['isolated_anon_pages']),
('Active PC', self.details['active_file_pages']),
('Inactive PC', self.details['inactive_file_pages']),
('Isolated PC', self.details['isolated_file_pages']),
('Unevictable', self.details['unevictable_pages']),
('Dirty', self.details['dirty_pages']),
('Writeback', self.details['writeback_pages']),
('Unstable', self.details['unstable_pages']),
('Slab reclaimable', self.details['slab_reclaimable_pages']),
('Slab unreclaimable', self.details['slab_unreclaimable_pages']),
('Mapped', self.details['mapped_pages']),
('Shared', self.details['shmem_pages']),
('Pagetable', self.details['pagetables_pages']),
('Bounce', self.details['bounce_pages']),
('Free', self.details['free_pages']),
('Free PCP', self.details['free_pcp_pages']),
('Free CMA', self.details['free_cma_pages']),
)
elem_svg_ram = document.getElementById('svg_ram')
elem_svg_ram.appendChild(svg_ram)
def analyse(self):
# reset the output elements to default
self._set_defaults(False)
element = document.getElementById('textarea_oom')
oom_text = element.textContent
self.oom = OOM(oom_text)
if not self.oom.complete:
error('The inserted test is not a valid OOM!')
return
self._extract_from_oom_text()
self._calc_from_oom_details()
self._show_details()
def reset(self):
self._set_defaults()
def copy_example(self):
document.getElementById('textarea_oom').textContent = self.example
oomAnalyser = OOMAnalyser()

90
README.md Normal file
View File

@ -0,0 +1,90 @@
# Linux OOM Analyser
I've started this project to give the Python to JavaScript compiler
[Transcrypt](https://www.transcrypt.org/) a try.
This web page splits the content of a Linux Out Of Memory message into
smaller pieces, aggregates these and presents them in a more human friendly
format.
## Design Goals
* A local copy of the web page should run offline - without an Internet
connection, without loading 3rd party libraries nor transferring data to
foreign servers
* A better understanding of the Linux Memory Management
* Start learning JavaScript, CSS and HTML
## Requirements
* [Python](http://www.python.org) 3.6 or later
* [Transcrypt](https://www.transcrypt.org/) 3.6.53 or later
## Installation
Install Python virtual environment
Use the provided Makefile:
```
# make venv
```
or setup the virtual environment manually:
```
# virtualenv env
# . env/bin/activate
# env/bin/pip install -Ur requirements.txt
```
## Build
Use the provided Makefile:
```
# make venv
```
or build it manually:
```
# . env/bin/activate
# transcrypt --build --map --nomin -e 6 OOMAnalyser.py
```
## Further Information
* [Transcrypt](https://www.transcrypt.org/).
* [Linux man pages online](https://man7.org/)
* [Decoding the Linux kernel's page allocation failure messages](https://utcc.utoronto.ca/~cks/space/blog/linux/DecodingPageAllocFailures)
* [Linux Kernel OOM Log Analysis](http://elearningmedium.com/linux-kernel-oom-log-analysis/)
## Known Bugs/Issues
Check the bug tracker on [GitHub](https://github.com/CarstenGrohmann/OOMAnalyser/issues) for current open bugs.
New bugs can be reported there also.
## License
```
Copyright (c) 2017 Carsten Grohmann mail <add at here> carsten-grohmann.de
Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and associated documentation files (the "Software"), to deal in
the Software without restriction, including without limitation the rights to
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
of the Software, and to permit persons to whom the Software is furnished to do
so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
```
Enjoy!
Carsten Grohmann

1
requirements.txt Normal file
View File

@ -0,0 +1 @@
Transcrypt>=3.6.53