ospatrol-reportd

ospatrol-reportd is a program to create reports from OSPatrol alerts. ospatrol-reportd accepts alerts on stdin, and outputs a report on stderr.

Note

Since ospatrol-reportd outputs to stderr some utilities like less will not work if you do not redirect the output. End the ospatrol-reportd with 2>&1 to redirect stderr to stdout. more or less can be easily used after the stderr redirect.

ospatrol-reportd argument options

-h

Display the help message

-f <filter> <value>

Filter the results.

-r <filter> <value>

Show related entries.

-n <string>

Create a description for the report.

-s

Show the alerts related to the summary.

ospatrol-reportd example usage

Example 1: Show Successful Logins

# cat /var/ospatrol/logs/alerts/alerts.log | /var/ospatrol/bin/ospatrol-reportd -f group authentication_success

Example 2: Show Alerts Level 10 and Greater

# cat /var/ospatrol/logs/alerts/alerts.log | /var/ospatrol/bin/ospatrol-reportd -f level 10

Example 3: Show the srcip for all users

# cat /var/ospatrol/logs/alerts/alerts.log | /var/ospatrol/bin/ospatrol-reportd -f group authentication -r user srcip

Example 4: Show Changed files as reported by Syscheck

# cat /var/ospatrol/logs/alerts/alerts.log | /var/ospatrol/bin/ospatrol-reportd -f group syscheck -r location filename

Example output

# cat /var/ospatrol/logs/alerts/alerts.log | /var/ospatrol/bin/ospatrol-reportd 2>&1 | more
2011/07/11 21:01:36 ospatrol-reportd: INFO: Started (pid: 1444).
2011/07/11 21:01:41 ospatrol-reportd: INFO: Report completed. Creating output...

Report completed. ==
------------------------------------------------
->Processed alerts: 17
->Post-filtering alerts: 17
->First alert: 2011 Jul 11 00:00:46
->Last alert: 2011 Jul 11 00:16:52


Top entries for 'Username':
------------------------------------------------
_nrpe                                           |6       |
SYSTEM                                          |2       |


Top entries for 'Level':
------------------------------------------------
Severity 3                                      |13      |
Severity 2                                      |4       |


Top entries for 'Group':
------------------------------------------------
syslog                                          |10      |
sudo                                            |6       |
dropbearrecon                                   |4       |
ospatrol                                           |4       |
sshd                                            |4       |
authentication_success                          |2       |
windows                                         |2       |
clamd                                           |1       |
freshclam                                       |1       |
virus                                           |1       |


Top entries for 'Location':
------------------------------------------------
ix->/var/log/secure                             |4       |
ix->ospatrol-logcollector                          |3       |
(vistapc) 192.168.17.0->WinEvtLog               |2       |
buffalo1->/var/log/secure                       |2       |
buffalo2->/var/log/secure                       |2       |
(junction) 192.168.17.17->/var/log/secure       |1       |
(junction) 192.168.17.17->ospatrol-logcollector    |1       |
ix->/var/log/local6                             |1       |
junction->/var/log/secure                       |1       |


Top entries for 'Rule':
------------------------------------------------
5402 - Successful sudo to ROOT executed         |6       |
51006 - Client exited before authentication.    |4       |
591 - Log file rotated.                         |4       |
18107 - Windows Logon Success.                  |2       |
52507 - ClamAV database update                  |1       |