Statistics.py 80 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837
  1. import os
  2. import random
  3. import time
  4. import numpy
  5. from math import sqrt, ceil, log
  6. from operator import itemgetter
  7. # TODO: double check this import
  8. # does it complain because libpcapreader is not a .py?
  9. import ID2TLib.libpcapreader as pr
  10. import Core.StatsDatabase as statsDB
  11. import ID2TLib.PcapFile as PcapFile
  12. import ID2TLib.Utility as Util
  13. from ID2TLib.IPv4 import IPAddress
  14. import matplotlib.pyplot as plt
  15. class Statistics:
  16. def __init__(self, pcap_file: PcapFile.PcapFile):
  17. """
  18. Creates a new Statistics object.
  19. :param pcap_file: A reference to the PcapFile object
  20. """
  21. # Fields
  22. self.pcap_filepath = pcap_file.pcap_file_path
  23. self.pcap_proc = None
  24. self.do_extra_tests = False
  25. self.file_info = None
  26. # Create folder for statistics database if required
  27. self.path_db = pcap_file.get_db_path()
  28. path_dir = os.path.dirname(self.path_db)
  29. if not os.path.isdir(path_dir):
  30. os.makedirs(path_dir)
  31. # Class instances
  32. self.stats_db = statsDB.StatsDatabase(self.path_db)
  33. def list_previous_interval_statistic_tables(self, output: bool=True):
  34. """
  35. Prints a list of all interval statistic tables from the database.
  36. :return: A list of intervals in seconds used to create the previous interval statistics tables
  37. """
  38. if self.stats_db.process_db_query("SELECT name FROM sqlite_master WHERE name='interval_tables';"):
  39. previous_interval_tables = self.stats_db.process_db_query("SELECT * FROM interval_tables;")
  40. else:
  41. previous_interval_tables = self.stats_db.process_db_query("SELECT name FROM sqlite_master WHERE "
  42. "type='table' AND name LIKE "
  43. "'interval_statistics_%';")
  44. previous_intervals = []
  45. if previous_interval_tables:
  46. if not isinstance(previous_interval_tables, list):
  47. previous_interval_tables = [previous_interval_tables]
  48. if output:
  49. print("There are " + str(len(previous_interval_tables)) + " interval statistics table(s) in the "
  50. "database:")
  51. i = 0
  52. if output:
  53. print("ID".ljust(3) + " | " + "interval in seconds".ljust(30) + " | is_default", end="")
  54. if len(previous_interval_tables) > 0 and len(previous_interval_tables[0]) > 2:
  55. print( " | extra_tests")
  56. else:
  57. print("")
  58. for table in previous_interval_tables:
  59. seconds = float(table[0][len("interval_statistics_"):])/1000000
  60. if output:
  61. print(str(i).ljust(3) + " | " + str(seconds).ljust(30) + " | " + str(table[1]).ljust(
  62. len("is_default")), end="")
  63. if len(table) > 2:
  64. print(" | " + str(table[2]))
  65. else:
  66. print("")
  67. previous_intervals.append(seconds)
  68. i = i + 1
  69. return previous_intervals
  70. def load_pcap_statistics(self, flag_write_file: bool, flag_recalculate_stats: bool, flag_print_statistics: bool,
  71. flag_non_verbose: bool, intervals, delete: bool=False, recalculate_intervals: bool=None):
  72. """
  73. Loads the PCAP statistics for the file specified by pcap_filepath. If the database is not existing yet, the
  74. statistics are calculated by the PCAP file processor and saved into the newly created database. Otherwise the
  75. statistics are gathered directly from the existing database.
  76. :param flag_write_file: Indicates whether the statistics should be written additionally into a text file (True)
  77. or not (False)
  78. :param flag_recalculate_stats: Indicates whether eventually existing statistics should be recalculated
  79. :param flag_print_statistics: Indicates whether the gathered basic statistics should be printed to the terminal
  80. :param flag_non_verbose: Indicates whether certain prints should be made or not, to reduce terminal clutter
  81. :param intervals: user specified interval in seconds
  82. :param delete: Delete old interval statistics.
  83. :param recalculate_intervals: Recalculate old interval statistics or not. Prompt user if None.
  84. """
  85. # Load pcap and get loading time
  86. time_start = time.clock()
  87. # Make sure user specified intervals are a list
  88. if intervals is None or intervals == []:
  89. intervals = [0.0]
  90. elif not isinstance(intervals, list):
  91. intervals = [intervals]
  92. current_intervals = intervals[:]
  93. # Inform user about recalculation of statistics and its reason
  94. if flag_recalculate_stats:
  95. print("Flag -r/--recalculate found. Recalculating statistics.")
  96. outstring_datasource = "from statistics database."
  97. # Recalculate statistics if database does not exist OR param -r/--recalculate is provided
  98. # FIXME: probably wanna add a "calculate only extra tests" case in the future
  99. if (not self.stats_db.get_db_exists()) or flag_recalculate_stats or self.stats_db.get_db_outdated():
  100. # Get interval statistics tables which already exist
  101. previous_intervals = self.list_previous_interval_statistic_tables()
  102. self.pcap_proc = pr.pcap_processor(self.pcap_filepath, str(self.do_extra_tests), Util.RESOURCE_DIR,
  103. self.path_db)
  104. recalc_intervals = None
  105. if previous_intervals:
  106. if delete:
  107. recalc_intervals = False
  108. else:
  109. recalc_intervals = recalculate_intervals
  110. while recalc_intervals is None:
  111. user_input = input("Do you want to recalculate them as well? (y)es|(n)o|(d)elete: ")
  112. if user_input.lower() == "yes" or user_input.lower() == "y":
  113. recalc_intervals = True
  114. elif user_input.lower() == "no" or user_input.lower() == "n":
  115. recalc_intervals = False
  116. elif user_input.lower() == "delete" or user_input.lower() == "d":
  117. recalc_intervals = False
  118. delete = True
  119. else:
  120. print("This was no valid input.")
  121. if recalc_intervals and previous_intervals:
  122. intervals = list(set(intervals + previous_intervals))
  123. print("The old interval statistics will be recalculated.")
  124. elif delete:
  125. print("The old interval statistics will be deleted.")
  126. else:
  127. print("The old interval statistics wont be recalculated.")
  128. if current_intervals != [0.0]:
  129. print("User specified intervals will be used to calculate interval statistics: " +
  130. str(current_intervals)[1:-1])
  131. self.pcap_proc.collect_statistics(intervals)
  132. self.pcap_proc.write_to_database(self.path_db, intervals, delete)
  133. outstring_datasource = "by PCAP file processor."
  134. # only print summary of new db if -s flag not set
  135. if not flag_print_statistics and not flag_non_verbose:
  136. self.stats_summary_new_db()
  137. elif (intervals is not None and intervals != []) or self.do_extra_tests:
  138. self.pcap_proc = pr.pcap_processor(self.pcap_filepath, str(self.do_extra_tests), Util.RESOURCE_DIR,
  139. self.path_db)
  140. # Get interval statistics tables which already exist
  141. previous_intervals = self.list_previous_interval_statistic_tables(output=False)
  142. final_intervals = []
  143. if not self.do_extra_tests:
  144. for interval in intervals:
  145. if interval not in previous_intervals:
  146. final_intervals.append(interval)
  147. else:
  148. final_intervals = intervals
  149. self.pcap_proc.collect_statistics(final_intervals)
  150. self.pcap_proc.write_new_interval_statistics(self.path_db, final_intervals)
  151. self.stats_db.set_current_interval_statistics_tables(current_intervals)
  152. # Load statistics from database
  153. self.file_info = self.stats_db.get_file_info()
  154. time_end = time.clock()
  155. print("Loaded file statistics in " + str(time_end - time_start)[:4] + " sec " + outstring_datasource)
  156. # Write statistics if param -e/--export provided
  157. if flag_write_file:
  158. self.write_statistics_to_file()
  159. self.write_statistics_to_file(interval=True)
  160. # Print statistics if param -s/--statistics provided
  161. if flag_print_statistics:
  162. self.print_statistics()
  163. def get_file_information(self):
  164. """
  165. Returns a list of tuples, each containing a information of the file.
  166. :return: a list of tuples, each consisting of (description, value, unit), where unit is optional.
  167. """
  168. pdu_count = self.process_db_query("SELECT SUM(pktCount) FROM unrecognized_pdus")
  169. if pdu_count is None:
  170. pdu_count = 0
  171. pdu_share = pdu_count / self.get_packet_count() * 100
  172. last_pdu_timestamp = self.process_db_query(
  173. "SELECT MAX(timestampLastOccurrence) FROM unrecognized_pdus")
  174. return [("Pcap file path", self.pcap_filepath),
  175. ("Total packet count", self.get_packet_count(), "packets"),
  176. ("Recognized packets", self.get_packet_count() - pdu_count, "packets"),
  177. ("Unrecognized packets", pdu_count, "PDUs"),
  178. ("% Recognized packets", 100 - pdu_share, "%"),
  179. ("% Unrecognized packets", pdu_share, "%"),
  180. ("Last unknown PDU", last_pdu_timestamp),
  181. ("Capture duration", self.get_capture_duration(), "seconds"),
  182. ("Capture start", "\t" + str(self.get_pcap_timestamp_start())),
  183. ("Capture end", "\t" + str(self.get_pcap_timestamp_end()))]
  184. def get_general_file_statistics(self):
  185. """
  186. Returns a list of tuples, each containing a file statistic.
  187. :return: a list of tuples, each consisting of (description, value, unit).
  188. """
  189. return [("Avg. packet rate", self.file_info['avgPacketRate'], "packets/sec"),
  190. ("Avg. packet size", self.file_info['avgPacketSize'], "kbytes"),
  191. ("Avg. packets sent", self.file_info['avgPacketsSentPerHost'], "packets"),
  192. ("Avg. bandwidth in", self.file_info['avgBandwidthIn'], "kbit/s"),
  193. ("Avg. bandwidth out", self.file_info['avgBandwidthOut'], "kbit/s")]
  194. def get_interval_statistics(self, table_name: str=""):
  195. """
  196. Returns a list of tuples, each containing interval statistics.
  197. :param table_name: the name of the interval statistics table
  198. :return: a list of tuples, each consisting of (description, values, unit).
  199. """
  200. column_names = self.stats_db.get_field_types(table_name)
  201. column_names = sorted(column_names)
  202. result = column_names[0]
  203. for name in column_names[1:]:
  204. result += ", " + name
  205. interval_stats = self.stats_db.process_interval_statistics_query(
  206. "SELECT {} FROM %s ORDER BY first_pkt_timestamp ASC".format(result),
  207. table_name)
  208. inverted_table = {}
  209. inverted_table["interval_count"] = 0
  210. for name in column_names:
  211. inverted_table[name] = []
  212. for row in interval_stats:
  213. for column, name in zip(row, column_names):
  214. if column is not None:
  215. if type(column) == str:
  216. try:
  217. column = int(column)
  218. except ValueError:
  219. column = float(column)
  220. elif type(column) == float:
  221. column = round(column, 4)
  222. inverted_table[name].append(column)
  223. inverted_table["interval_count"] = len(inverted_table[column_names[0]])
  224. return sorted(inverted_table.items())
  225. @staticmethod
  226. def write_list(desc_val_unit_list, func, line_ending="\n"):
  227. """
  228. Takes a list of tuples (statistic name, statistic value, unit) as input, generates a string of these three
  229. values and applies the function func on this string.
  230. Before generating the string, it identifies text containing a float number, casts the string to a
  231. float and rounds the value to two decimal digits.
  232. :param desc_val_unit_list: The list of tuples consisting of (description, value, unit)
  233. :param func: The function to be applied to each generated string
  234. :param line_ending: The formatting string to be applied at the end of each string
  235. """
  236. for entry in desc_val_unit_list:
  237. # Convert text containing float into float
  238. (description, value) = entry[0:2]
  239. if isinstance(value, str) and "." in value:
  240. try:
  241. value = float(value)
  242. except ValueError:
  243. pass # do nothing -> value was not a float
  244. # round float
  245. if isinstance(value, float):
  246. value = round(value, 4)
  247. # check for lists
  248. if isinstance(value, list):
  249. # remove brackets
  250. value = str(value)[1:-1]
  251. # write into file
  252. if len(entry) == 3:
  253. unit = entry[2]
  254. func(description + ":\t" + str(value) + " " + unit + line_ending)
  255. else:
  256. func(description + ":\t" + str(value) + line_ending)
  257. def print_statistics(self):
  258. """
  259. Prints the basic file statistics to the terminal.
  260. """
  261. print("\nPCAP FILE INFORMATION ------------------------------")
  262. Statistics.write_list(self.get_file_information(), print, "")
  263. print("\nGENERAL FILE STATISTICS ----------------------------")
  264. Statistics.write_list(self.get_general_file_statistics(), print, "")
  265. print("\n")
  266. @staticmethod
  267. def calculate_entropy(frequency: list, normalized: bool = False):
  268. """
  269. Calculates entropy and normalized entropy of list of elements that have specific frequency
  270. :param frequency: The frequency of the elements.
  271. :param normalized: Calculate normalized entropy
  272. :return: entropy or (entropy, normalized entropy)
  273. """
  274. entropy, normalized_ent, n = 0, 0, 0
  275. sum_freq = sum(frequency)
  276. for i, x in enumerate(frequency):
  277. p_x = float(frequency[i] / sum_freq)
  278. if p_x > 0:
  279. n += 1
  280. entropy += - p_x * log(p_x, 2)
  281. if normalized:
  282. if log(n) > 0:
  283. normalized_ent = entropy / log(n, 2)
  284. return entropy, normalized_ent
  285. else:
  286. return entropy
  287. def calculate_complement_packet_rates(self, pps):
  288. """
  289. Calculates the complement packet rates of the background traffic packet rates for each interval.
  290. Then normalize it to maximum boundary, which is the input parameter pps
  291. :return: normalized packet rates for each time interval.
  292. """
  293. result = self.stats_db.process_interval_statistics_query(
  294. "SELECT last_pkt_timestamp,pkts_count FROM %s ORDER BY last_pkt_timestamp")
  295. # print(result)
  296. bg_interval_pps = []
  297. complement_interval_pps = []
  298. intervals_sum = 0
  299. if result:
  300. # Get the interval in seconds
  301. for i, row in enumerate(result):
  302. if i < len(result) - 1:
  303. intervals_sum += ceil((int(result[i + 1][0]) * 10 ** -6) - (int(row[0]) * 10 ** -6))
  304. interval = intervals_sum / (len(result) - 1)
  305. # Convert timestamp from micro to seconds, convert packet rate "per interval" to "per second"
  306. for row in result:
  307. bg_interval_pps.append((int(row[0]) * 10 ** -6, int(row[1] / interval)))
  308. # Find max PPS
  309. max_pps = max(bg_interval_pps, key=itemgetter(1))[1]
  310. for row in bg_interval_pps:
  311. complement_interval_pps.append((row[0], int(pps * (max_pps - row[1]) / max_pps)))
  312. return complement_interval_pps
  313. def get_tests_statistics(self):
  314. """
  315. Writes the calculated basic defects tests statistics into a file.
  316. """
  317. # self.stats_db.process_user_defined_query output is list of tuples, thus, we ned [0][0] to access data
  318. def count_frequncy(values_list):
  319. """
  320. TODO : FILL ME
  321. :param values_list:
  322. :return:
  323. """
  324. values, freq_output = [], []
  325. for x in values_list:
  326. if x in values:
  327. freq_output[values.index(x)] += 1
  328. else:
  329. values.append(x)
  330. freq_output.append(1)
  331. return values, freq_output
  332. # Payload Tests
  333. sum_payload_count = self.stats_db.process_interval_statistics_query("SELECT sum(payload_count) FROM %s")
  334. pkt_count = self.stats_db.process_user_defined_query("SELECT packetCount FROM file_statistics")
  335. if sum_payload_count and pkt_count:
  336. payload_ratio = 0
  337. if pkt_count[0][0] != 0:
  338. payload_ratio = float(sum_payload_count[0][0] / pkt_count[0][0] * 100)
  339. else:
  340. payload_ratio = -1
  341. # TCP checksum Tests
  342. incorrect_checksum_count = self.stats_db.process_interval_statistics_query(
  343. "SELECT sum(incorrect_tcp_checksum_count) FROM %s")
  344. correct_checksum_count = self.stats_db.process_interval_statistics_query(
  345. "SELECT avg(correct_tcp_checksum_count) FROM %s")
  346. if incorrect_checksum_count and correct_checksum_count:
  347. incorrect_checksum_ratio = 0
  348. if (incorrect_checksum_count[0][0] + correct_checksum_count[0][0]) != 0:
  349. incorrect_checksum_ratio = float(incorrect_checksum_count[0][0] /
  350. (incorrect_checksum_count[0][0] + correct_checksum_count[0][0]) * 100)
  351. else:
  352. incorrect_checksum_ratio = -1
  353. # IP Src & Dst Tests
  354. result = self.stats_db.process_user_defined_query("SELECT ipAddress,pktsSent,pktsReceived FROM ip_statistics")
  355. data, src_frequency, dst_frequency = [], [], []
  356. if result:
  357. for row in result:
  358. src_frequency.append(row[1])
  359. dst_frequency.append(row[2])
  360. ip_src_entropy, ip_src_norm_entropy = self.calculate_entropy(src_frequency, True)
  361. ip_dst_entropy, ip_dst_norm_entropy = self.calculate_entropy(dst_frequency, True)
  362. new_ip_src_count = self.stats_db.process_interval_statistics_query("SELECT ip_src_novel_Count FROM %s")
  363. ip_src_novels_per_interval, ip_src_novels_per_interval_frequency = count_frequncy(new_ip_src_count)
  364. ip_src_novelty_dist_entropy = self.calculate_entropy(ip_src_novels_per_interval_frequency)
  365. new_ip_dst_count = self.stats_db.process_interval_statistics_query("SELECT ip_dst_novel_Count FROM %s")
  366. ip_dst_novels_per_interval, ip_dst_novels_per_interval_frequency = count_frequncy(new_ip_dst_count)
  367. ip_dst_novelty_dist_entropy = self.calculate_entropy(ip_dst_novels_per_interval_frequency)
  368. # Ports Tests
  369. port0_count = self.stats_db.process_user_defined_query(
  370. "SELECT SUM(portCount) FROM ip_ports WHERE portNumber = 0")
  371. if not port0_count[0][0]:
  372. port0_count = 0
  373. else:
  374. port0_count = port0_count[0][0]
  375. # FIXME: could be extended
  376. reserved_port_count = self.stats_db.process_user_defined_query(
  377. "SELECT SUM(portCount) FROM ip_ports WHERE portNumber IN (100,114,1023,1024,49151,49152,65535)")
  378. if not reserved_port_count[0][0]:
  379. reserved_port_count = 0
  380. else:
  381. reserved_port_count = reserved_port_count[0][0]
  382. # TTL Tests
  383. result = self.stats_db.process_user_defined_query(
  384. "SELECT ttlValue,SUM(ttlCount) FROM ip_ttl GROUP BY ttlValue")
  385. data, frequency = [], []
  386. for row in result:
  387. frequency.append(row[1])
  388. ttl_entropy, ttl_norm_entropy = self.calculate_entropy(frequency, True)
  389. new_ttl_count = self.stats_db.process_interval_statistics_query("SELECT ttl_novel_count FROM %s")
  390. ttl_novels_per_interval, ttl_novels_per_interval_frequency = count_frequncy(new_ttl_count)
  391. ttl_novelty_dist_entropy = self.calculate_entropy(ttl_novels_per_interval_frequency)
  392. # Window Size Tests
  393. result = self.stats_db.process_user_defined_query("SELECT winSize,SUM(winCount) FROM tcp_win GROUP BY winSize")
  394. data, frequency = [], []
  395. for row in result:
  396. frequency.append(row[1])
  397. win_entropy, win_norm_entropy = self.calculate_entropy(frequency, True)
  398. new_win_size_count = self.stats_db.process_interval_statistics_query("SELECT win_size_novel_count FROM %s")
  399. win_novels_per_interval, win_novels_per_interval_frequency = count_frequncy(new_win_size_count)
  400. win_novelty_dist_entropy = self.calculate_entropy(win_novels_per_interval_frequency)
  401. # ToS Tests
  402. result = self.stats_db.process_user_defined_query(
  403. "SELECT tosValue,SUM(tosCount) FROM ip_tos GROUP BY tosValue")
  404. data, frequency = [], []
  405. for row in result:
  406. frequency.append(row[1])
  407. tos_entropy, tos_norm_entropy = self.calculate_entropy(frequency, True)
  408. new_tos_count = self.stats_db.process_interval_statistics_query("SELECT tos_novel_count FROM %s")
  409. tos_novels_per_interval, tos_novels_per_interval_frequency = count_frequncy(new_tos_count)
  410. tos_novelty_dist_entropy = self.calculate_entropy(tos_novels_per_interval_frequency)
  411. # MSS Tests
  412. result = self.stats_db.process_user_defined_query(
  413. "SELECT mssValue,SUM(mssCount) FROM tcp_mss GROUP BY mssValue")
  414. data, frequency = [], []
  415. for row in result:
  416. frequency.append(row[1])
  417. mss_entropy, mss_norm_entropy = self.calculate_entropy(frequency, True)
  418. new_mss_count = self.stats_db.process_interval_statistics_query("SELECT mss_novel_count FROM %s")
  419. mss_novels_per_interval, mss_novels_per_interval_frequency = count_frequncy(new_mss_count)
  420. mss_novelty_dist_entropy = self.calculate_entropy(mss_novels_per_interval_frequency)
  421. result = self.stats_db.process_user_defined_query("SELECT SUM(mssCount) FROM tcp_mss WHERE mssValue > 1460")
  422. # The most used MSS < 1460. Calculate the ratio of the values bigger that 1460.
  423. if not result[0][0]:
  424. result = 0
  425. else:
  426. result = result[0][0]
  427. big_mss = (result / sum(frequency)) * 100
  428. output = []
  429. if self.do_extra_tests:
  430. output = [("Payload ratio", payload_ratio, "%"),
  431. ("Incorrect TCP checksum ratio", incorrect_checksum_ratio, "%")]
  432. output = output + [("# IP addresses", sum([x[0] for x in new_ip_src_count]), ""),
  433. ("IP Src Entropy", ip_src_entropy, ""),
  434. ("IP Src Normalized Entropy", ip_src_norm_entropy, ""),
  435. ("IP Dst Entropy", ip_dst_entropy, ""),
  436. ("IP Dst Normalized Entropy", ip_dst_norm_entropy, ""),
  437. ("IP SRC Novelty Distribution Entropy", ip_src_novelty_dist_entropy, ""),
  438. ("IP DST Novelty Distribution Entropy", ip_dst_novelty_dist_entropy, ""),
  439. ("# TTL values", sum([x[0] for x in new_ttl_count]), ""),
  440. ("TTL Entropy", ttl_entropy, ""),
  441. ("TTL Normalized Entropy", ttl_norm_entropy, ""),
  442. ("TTL Novelty Distribution Entropy", ttl_novelty_dist_entropy, ""),
  443. ("# WinSize values", sum([x[0] for x in new_win_size_count]), ""),
  444. ("WinSize Entropy", win_entropy, ""),
  445. ("WinSize Normalized Entropy", win_norm_entropy, ""),
  446. ("WinSize Novelty Distribution Entropy", win_novelty_dist_entropy, ""),
  447. ("# ToS values", sum([x[0] for x in new_tos_count]), ""),
  448. ("ToS Entropy", tos_entropy, ""),
  449. ("ToS Normalized Entropy", tos_norm_entropy, ""),
  450. ("ToS Novelty Distribution Entropy", tos_novelty_dist_entropy, ""),
  451. ("# MSS values", sum([x[0] for x in new_mss_count]), ""),
  452. ("MSS Entropy", mss_entropy, ""),
  453. ("MSS Normalized Entropy", mss_norm_entropy, ""),
  454. ("MSS Novelty Distribution Entropy", mss_novelty_dist_entropy, ""),
  455. ("======================", "", "")]
  456. # Reasoning the statistics values
  457. if self.do_extra_tests:
  458. if payload_ratio > 80:
  459. output.append(("WARNING: Too high payload ratio", payload_ratio, "%."))
  460. if payload_ratio < 30:
  461. output.append(("WARNING: Too low payload ratio", payload_ratio, "% (Injecting attacks that are carried "
  462. "out in the packet payloads is not "
  463. "recommmanded)."))
  464. if incorrect_checksum_ratio > 5:
  465. output.append(("WARNING: High incorrect TCP checksum ratio", incorrect_checksum_ratio, "%."))
  466. if ip_src_norm_entropy > 0.65:
  467. output.append(("WARNING: High IP source normalized entropy", ip_src_norm_entropy, "."))
  468. if ip_src_norm_entropy < 0.2:
  469. output.append(("WARNING: Low IP source normalized entropy", ip_src_norm_entropy, "."))
  470. if ip_dst_norm_entropy > 0.65:
  471. output.append(("WARNING: High IP destination normalized entropy", ip_dst_norm_entropy, "."))
  472. if ip_dst_norm_entropy < 0.2:
  473. output.append(("WARNING: Low IP destination normalized entropy", ip_dst_norm_entropy, "."))
  474. if ttl_norm_entropy > 0.65:
  475. output.append(("WARNING: High TTL normalized entropy", ttl_norm_entropy, "."))
  476. if ttl_norm_entropy < 0.2:
  477. output.append(("WARNING: Low TTL normalized entropy", ttl_norm_entropy, "."))
  478. if ttl_novelty_dist_entropy < 1:
  479. output.append(("WARNING: Too low TTL novelty distribution entropy", ttl_novelty_dist_entropy,
  480. "(The distribution of the novel TTL values is suspicious)."))
  481. if win_norm_entropy > 0.6:
  482. output.append(("WARNING: High Window Size normalized entropy", win_norm_entropy, "."))
  483. if win_norm_entropy < 0.1:
  484. output.append(("WARNING: Low Window Size normalized entropy", win_norm_entropy, "."))
  485. if win_novelty_dist_entropy < 4:
  486. output.append(("WARNING: Low Window Size novelty distribution entropy", win_novelty_dist_entropy,
  487. "(The distribution of the novel Window Size values is suspicious)."))
  488. if tos_norm_entropy > 0.4:
  489. output.append(("WARNING: High ToS normalized entropy", tos_norm_entropy, "."))
  490. if tos_norm_entropy < 0.1:
  491. output.append(("WARNING: Low ToS normalized entropy", tos_norm_entropy, "."))
  492. if tos_novelty_dist_entropy < 0.5:
  493. output.append(("WARNING: Low ToS novelty distribution entropy", tos_novelty_dist_entropy,
  494. "(The distribution of the novel ToS values is suspicious)."))
  495. if mss_norm_entropy > 0.4:
  496. output.append(("WARNING: High MSS normalized entropy", mss_norm_entropy, "."))
  497. if mss_norm_entropy < 0.1:
  498. output.append(("WARNING: Low MSS normalized entropy", mss_norm_entropy, "."))
  499. if mss_novelty_dist_entropy < 0.5:
  500. output.append(("WARNING: Low MSS novelty distribution entropy", mss_novelty_dist_entropy,
  501. "(The distribution of the novel MSS values is suspicious)."))
  502. if big_mss > 50:
  503. output.append(("WARNING: High ratio of MSS > 1460", big_mss, "% (High fragmentation rate in Ethernet)."))
  504. if port0_count > 0:
  505. output.append(("WARNING: Port number 0 is used in ", port0_count, "packets (awkward-looking port)."))
  506. if reserved_port_count > 0:
  507. output.append(("WARNING: Reserved port numbers are used in ", reserved_port_count,
  508. "packets (uncommonly-used ports)."))
  509. return output
  510. def write_statistics_to_file(self, interval: bool=False):
  511. """
  512. Writes the calculated basic statistics into a file.
  513. """
  514. def _write_header(title: str):
  515. """
  516. Writes the section header into the open file.
  517. :param title: The section title
  518. """
  519. target.write("====================== \n")
  520. target.write(title + " \n")
  521. target.write("====================== \n")
  522. def _write_sub_header(title: str):
  523. """
  524. Writes the section header into the open file.
  525. :param title: The section title
  526. """
  527. target.write("---------------------- \n")
  528. target.write(title + " \n")
  529. target.write("---------------------- \n")
  530. if interval:
  531. ed = ".interval_stat"
  532. else:
  533. ed = ".stat"
  534. target = open(self.pcap_filepath + ed, 'w')
  535. target.truncate()
  536. _write_header("PCAP file information")
  537. Statistics.write_list(self.get_file_information(), target.write)
  538. if interval:
  539. _write_header("Interval statistics")
  540. tables = self.stats_db.get_all_current_interval_statistics_tables()
  541. for table in tables:
  542. _write_sub_header(table[len("interval_staistiscs_"):] + " microseconds")
  543. Statistics.write_list(self.get_interval_statistics(table), target.write)
  544. else:
  545. _write_header("General statistics")
  546. Statistics.write_list(self.get_general_file_statistics(), target.write)
  547. _write_header("Tests statistics")
  548. Statistics.write_list(self.get_tests_statistics(), target.write)
  549. target.close()
  550. def get_capture_duration(self):
  551. """
  552. :return: The duration of the capture in seconds
  553. """
  554. return self.file_info['captureDuration']
  555. def get_pcap_timestamp_start(self):
  556. """
  557. :return: The timestamp of the first packet in the PCAP file
  558. """
  559. return self.file_info['timestampFirstPacket']
  560. def get_pcap_timestamp_end(self):
  561. """
  562. :return: The timestamp of the last packet in the PCAP file
  563. """
  564. return self.file_info['timestampLastPacket']
  565. def get_pps_sent(self, ip_address: str):
  566. """
  567. Calculates the sent packets per seconds for a given IP address.
  568. :param ip_address: The IP address whose packets per second should be calculated
  569. :return: The sent packets per seconds for the given IP address
  570. """
  571. packets_sent = self.stats_db.process_db_query("SELECT pktsSent from ip_statistics WHERE ipAddress=?", False,
  572. (ip_address,))
  573. capture_duration = float(self.get_capture_duration())
  574. return int(float(packets_sent) / capture_duration)
  575. def get_pps_received(self, ip_address: str):
  576. """
  577. Calculate the packets per second received for a given IP address.
  578. :param ip_address: The IP address used for the calculation
  579. :return: The number of packets per second received
  580. """
  581. packets_received = self.stats_db.process_db_query("SELECT pktsReceived FROM ip_statistics WHERE ipAddress=?",
  582. False,
  583. (ip_address,))
  584. capture_duration = float(self.get_capture_duration())
  585. return int(float(packets_received) / capture_duration)
  586. def get_packet_count(self):
  587. """
  588. :return: The number of packets in the loaded PCAP file
  589. """
  590. return self.file_info['packetCount']
  591. def get_most_used_ip_address(self):
  592. """
  593. :return: The IP address/addresses with the highest sum of packets sent and received
  594. """
  595. return Util.handle_most_used_outputs(self.process_db_query("most_used(ipAddress)"))
  596. def get_ttl_distribution(self, ip_address: str):
  597. """
  598. TODO: FILL ME
  599. :param ip_address:
  600. :return:
  601. """
  602. result = self.process_db_query('SELECT ttlValue, ttlCount from ip_ttl WHERE ipAddress="' + ip_address + '"')
  603. result_dict = {key: value for (key, value) in result}
  604. return result_dict
  605. def get_mss_distribution(self, ip_address: str):
  606. """
  607. TODO: FILL ME
  608. :param ip_address:
  609. :return:
  610. """
  611. result = self.process_db_query('SELECT mssValue, mssCount from tcp_mss WHERE ipAddress="' + ip_address + '"')
  612. result_dict = {key: value for (key, value) in result}
  613. return result_dict
  614. def get_win_distribution(self, ip_address: str):
  615. """
  616. TODO: FILL ME
  617. :param ip_address:
  618. :return:
  619. """
  620. result = self.process_db_query('SELECT winSize, winCount from tcp_win WHERE ipAddress="' + ip_address + '"')
  621. result_dict = {key: value for (key, value) in result}
  622. return result_dict
  623. def get_tos_distribution(self, ip_address: str):
  624. """
  625. TODO: FILL ME
  626. :param ip_address:
  627. :return:
  628. """
  629. result = self.process_db_query('SELECT tosValue, tosCount from ip_tos WHERE ipAddress="' + ip_address + '"')
  630. result_dict = {key: value for (key, value) in result}
  631. return result_dict
  632. def get_ip_address_count(self):
  633. """
  634. TODO: FILL ME
  635. :return:
  636. """
  637. return self.process_db_query("SELECT COUNT(*) FROM ip_statistics")
  638. def get_ip_addresses(self):
  639. """
  640. TODO: FILL ME
  641. :return:
  642. """
  643. return self.process_db_query("SELECT ipAddress FROM ip_statistics")
  644. def get_random_ip_address(self, count: int = 1):
  645. """
  646. :param count: The number of IP addresses to return
  647. :return: A randomly chosen IP address from the dataset or iff param count is greater than one, a list of
  648. randomly chosen IP addresses
  649. """
  650. ip_address_list = self.process_db_query("SELECT ipAddress from ip_statistics ORDER BY ipAddress ASC")
  651. if count == 1:
  652. return random.choice(ip_address_list)
  653. else:
  654. result_list = []
  655. for i in range(0, count):
  656. random_ip = random.choice(ip_address_list)
  657. result_list.append(random_ip)
  658. ip_address_list.remove(random_ip)
  659. return result_list
  660. def get_ip_address_from_mac(self, mac_address: str):
  661. """
  662. :param mac_address: the MAC address of which the IP shall be returned, if existing in DB
  663. :return: the IP address used in the dataset by a given MAC address
  664. """
  665. return self.process_db_query("SELECT DISTINCT ipAddress FROM ip_mac WHERE macAddress = '" + mac_address + "'")
  666. def get_mac_addresses(self, ip_addresses: list):
  667. """
  668. :return: The MAC addresses used in the dataset for the given IP addresses as a dictionary.
  669. """
  670. return dict(self.process_db_query("SELECT DISTINCT ipAddress, macAddress from ip_mac WHERE ipAddress in ("
  671. + str(ip_addresses)[1:-1] + ")"))
  672. def get_mac_address(self, ip_address: str):
  673. """
  674. :return: The MAC address used in the dataset for the given IP address.
  675. """
  676. return self.process_db_query("SELECT DISTINCT macAddress from ip_mac WHERE ipAddress = '" + ip_address + "'")
  677. def get_most_used_ttl_value(self):
  678. """
  679. :return: The most used TTL value.
  680. """
  681. return self.process_db_query("SELECT ttlValue FROM (SELECT ttlValue, SUM(ttlCount) as occ FROM ip_ttl GROUP BY "
  682. "ttlValue) WHERE occ=(SELECT SUM(ttlCount) as occ FROM ip_ttl GROUP BY ttlValue "
  683. "ORDER BY occ DESC LIMIT 1) ORDER BY ttlValue ASC")
  684. def get_most_used_ip_class(self):
  685. """
  686. :return: The most used IP class.
  687. """
  688. return self.process_db_query("SELECT ipClass FROM (SELECT ipClass, COUNT(*) as occ from ip_statistics GROUP BY "
  689. "ipClass ORDER BY occ DESC) WHERE occ=(SELECT COUNT(*) as occ from ip_statistics "
  690. "GROUP BY ipClass ORDER BY occ DESC LIMIT 1) ORDER BY ipClass ASC")
  691. def get_most_used_win_size(self):
  692. """
  693. :return: The most used window size.
  694. """
  695. return self.process_db_query("SELECT winSize FROM (SELECT winSize, SUM(winCount) as occ FROM tcp_win GROUP BY "
  696. "winSize) WHERE occ=(SELECT SUM(winCount) as occ FROM tcp_win GROUP BY winSize "
  697. "ORDER BY occ DESC LIMIT 1) ORDER BY winSize ASC")
  698. def get_most_used_mss_value(self):
  699. """
  700. :return: The most used mss value.
  701. """
  702. return self.process_db_query("SELECT mssValue FROM (SELECT mssValue, SUM(mssCount) as occ FROM tcp_mss GROUP BY"
  703. " mssValue) WHERE occ=(SELECT SUM(mssCount) as occ FROM tcp_mss GROUP BY mssValue "
  704. "ORDER BY occ DESC LIMIT 1) ORDER BY mssValue ASC")
  705. def get_most_used_mss(self, ip_address: str):
  706. """
  707. :param ip_address: The IP address whose used MSS should be determined
  708. :return: The TCP MSS value used by the IP address, or if the IP addresses never specified a MSS,
  709. then None is returned
  710. """
  711. mss_value = self.process_db_query('SELECT mssValue from tcp_mss WHERE ipAddress="' + ip_address +
  712. '" AND mssCount == (SELECT MAX(mssCount) from tcp_mss WHERE ipAddress="'
  713. + ip_address + '")')
  714. if isinstance(mss_value, int):
  715. return mss_value
  716. elif isinstance(mss_value, list):
  717. if len(mss_value) == 0:
  718. return None
  719. else:
  720. mss_value.sort()
  721. return mss_value[0]
  722. else:
  723. return None
  724. def get_most_used_ttl(self, ip_address: str):
  725. """
  726. :param ip_address: The IP address whose used TTL should be determined
  727. :return: The TTL value used by the IP address, or if the IP addresses never specified a TTL,
  728. then None is returned
  729. """
  730. ttl_value = self.process_db_query('SELECT ttlValue from ip_ttl WHERE ipAddress="' + ip_address +
  731. '" AND ttlCount == (SELECT MAX(ttlCount) from ip_ttl WHERE ipAddress="'
  732. + ip_address + '")')
  733. if isinstance(ttl_value, int):
  734. return ttl_value
  735. elif isinstance(ttl_value, list):
  736. if len(ttl_value) == 0:
  737. return None
  738. else:
  739. ttl_value.sort()
  740. return ttl_value[0]
  741. else:
  742. return None
  743. def get_avg_delay_distributions(self, input_pcap: bool=True):
  744. """
  745. :return: tuple consisting of avg delay distributions for local and external communication
  746. """
  747. if input_pcap:
  748. delay_db = self.stats_db
  749. else:
  750. delay_db = statsDB.StatsDatabase(Util.get_botnet_pcap_db())
  751. conv_delays = delay_db.process_user_defined_query(
  752. "SELECT ipAddressA, ipAddressB, avgDelay FROM conv_statistics")
  753. if len(conv_delays) < 2:
  754. conv_delays = delay_db.process_user_defined_query(
  755. "SELECT ipAddressA, ipAddressB, avgDelay FROM conv_statistics_extended")
  756. if conv_delays:
  757. external_conv = []
  758. local_conv = []
  759. for conv in conv_delays:
  760. if conv[2] is not None:
  761. ip_a = IPAddress.parse(conv[0])
  762. ip_b = IPAddress.parse(conv[1])
  763. # split into local and external conversations
  764. if not ip_a.is_private() or not ip_b.is_private():
  765. external_conv.append(conv)
  766. else:
  767. local_conv.append(conv)
  768. local_dist = []
  769. for conv in local_conv:
  770. local_dist.append(conv[2])
  771. external_dist = []
  772. for conv in external_conv:
  773. external_dist.append(conv[2])
  774. return local_dist, external_dist
  775. return [], []
  776. def get_filtered_degree(self, degree_type: str):
  777. """
  778. gets the desired type of degree statistics and filters IPs with degree value zero
  779. :param degree_type: the desired type of degrees, one of the following: inDegree, outDegree, overallDegree
  780. :return: the filtered degrees
  781. """
  782. degrees_raw = self.stats_db.process_user_defined_query(
  783. "SELECT ipAddress, %s FROM ip_degrees" % degree_type)
  784. degrees = []
  785. if degrees_raw:
  786. for deg in degrees_raw:
  787. if int(deg[1]) > 0:
  788. degrees.append(deg)
  789. return degrees
  790. def get_rnd_win_size(self, pkts_num):
  791. """
  792. :param pkts_num: maximum number of window sizes, that should be returned
  793. :return: A list of randomly chosen window sizes with given length.
  794. """
  795. sql_return = self.process_db_query("SELECT DISTINCT winSize FROM tcp_win ORDER BY winsize ASC;")
  796. if not isinstance(sql_return, list):
  797. return [sql_return]
  798. result = []
  799. for i in range(0, min(pkts_num, len(sql_return))):
  800. result.append(random.choice(sql_return))
  801. sql_return.remove(result[i])
  802. return result
  803. def get_statistics_database(self):
  804. """
  805. :return: A reference to the statistics database object
  806. """
  807. return self.stats_db
  808. def process_db_query(self, query_string_in: str, print_results: bool = False):
  809. """
  810. Executes a string identified previously as a query. This can be a standard SQL SELECT/INSERT query or a named
  811. query.
  812. :param query_string_in: The query to be processed
  813. :param print_results: Indicates whether the results should be printed to terminal
  814. :return: The result of the query
  815. """
  816. return self.stats_db.process_db_query(query_string_in, print_results)
  817. def is_query(self, value: str):
  818. """
  819. Checks whether the given string is a standard SQL query (SELECT, INSERT) or a named query.
  820. :param value: The string to be checked
  821. :return: True if the string is recognized as a query, otherwise False.
  822. """
  823. if not isinstance(value, str):
  824. return False
  825. else:
  826. return (any(x in value.lower().strip() for x in self.stats_db.get_all_named_query_keywords()) or
  827. any(x in value.lower().strip() for x in self.stats_db.get_all_sql_query_keywords()))
  828. @staticmethod
  829. def calculate_standard_deviation(lst):
  830. """
  831. Calculates the standard deviation of a list of numbers.
  832. :param lst: The list of numbers to calculate its SD.
  833. """
  834. num_items = len(lst)
  835. mean = sum(lst) / num_items
  836. differences = [x - mean for x in lst]
  837. sq_differences = [d ** 2 for d in differences]
  838. ssd = sum(sq_differences)
  839. variance = ssd / num_items
  840. sd = sqrt(variance)
  841. return sd
  842. def plot_statistics(self, entropy: int, file_format: str = 'pdf'): # 'png'
  843. """
  844. Plots the statistics associated with the dataset.
  845. :param entropy: the statistics entropy
  846. :param file_format: The format to be used to save the statistics diagrams.
  847. """
  848. def plot_distribution(query_output, title, x_label, y_label, file_ending: str):
  849. """
  850. TODO: FILL ME
  851. :param query_output:
  852. :param title:
  853. :param x_label:
  854. :param y_label:
  855. :param file_ending:
  856. :return:
  857. """
  858. plt.gcf().clear()
  859. graphx, graphy = [], []
  860. for row in query_output:
  861. graphx.append(row[0])
  862. graphy.append(row[1])
  863. plt.autoscale(enable=True, axis='both')
  864. plt.title(title)
  865. plt.xlabel(x_label)
  866. plt.ylabel(y_label)
  867. width = 0.1
  868. plt.xlim([0, (max(graphx) * 1.1)])
  869. plt.grid(True)
  870. plt.bar(graphx, graphy, width, align='center', linewidth=1, color='red', edgecolor='red')
  871. out = self.pcap_filepath.replace('.pcap', '_plot-' + title + file_ending)
  872. plt.savefig(out, dpi=500)
  873. return out
  874. def plot_ttl(file_ending: str):
  875. """
  876. TODO: FILL ME
  877. :param file_ending:
  878. :return:
  879. """
  880. query_output = self.stats_db.process_user_defined_query(
  881. "SELECT ttlValue, SUM(ttlCount) FROM ip_ttl GROUP BY ttlValue")
  882. title = "TTL Distribution"
  883. x_label = "TTL Value"
  884. y_label = "Number of Packets"
  885. if query_output:
  886. return plot_distribution(query_output, title, x_label, y_label, file_ending)
  887. def plot_mss(file_ending: str):
  888. """
  889. TODO: FILL ME
  890. :param file_ending:
  891. :return:
  892. """
  893. query_output = self.stats_db.process_user_defined_query(
  894. "SELECT mssValue, SUM(mssCount) FROM tcp_mss GROUP BY mssValue")
  895. title = "MSS Distribution"
  896. x_label = "MSS Value"
  897. y_label = "Number of Packets"
  898. if query_output:
  899. return plot_distribution(query_output, title, x_label, y_label, file_ending)
  900. def plot_win(file_ending: str):
  901. """
  902. TODO: FILL ME
  903. :param file_ending:
  904. :return:
  905. """
  906. query_output = self.stats_db.process_user_defined_query(
  907. "SELECT winSize, SUM(winCount) FROM tcp_win GROUP BY winSize")
  908. title = "Window Size Distribution"
  909. x_label = "Window Size"
  910. y_label = "Number of Packets"
  911. if query_output:
  912. return plot_distribution(query_output, title, x_label, y_label, file_ending)
  913. def plot_protocol(file_ending: str):
  914. """
  915. TODO: FILL ME
  916. :param file_ending:
  917. :return:
  918. """
  919. plt.gcf().clear()
  920. result = self.stats_db.process_user_defined_query(
  921. "SELECT protocolName, SUM(protocolCount) FROM ip_protocols GROUP BY protocolName")
  922. if result:
  923. graphx, graphy = [], []
  924. for row in result:
  925. graphx.append(row[0])
  926. graphy.append(row[1])
  927. plt.autoscale(enable=True, axis='both')
  928. plt.title("Protocols Distribution")
  929. plt.xlabel('Protocols')
  930. plt.ylabel('Number of Packets')
  931. width = 0.1
  932. plt.xlim([0, len(graphx)])
  933. plt.grid(True)
  934. # Protocols' names on x-axis
  935. x = range(0, len(graphx))
  936. my_xticks = graphx
  937. plt.xticks(x, my_xticks)
  938. plt.bar(x, graphy, width, align='center', linewidth=1, color='red', edgecolor='red')
  939. out = self.pcap_filepath.replace('.pcap', '_plot-protocol' + file_ending)
  940. plt.savefig(out, dpi=500)
  941. return out
  942. else:
  943. print("Error plot protocol: No protocol values found!")
  944. def plot_port(file_ending: str):
  945. """
  946. TODO: FILL ME
  947. :param file_ending:
  948. :return:
  949. """
  950. plt.gcf().clear()
  951. result = self.stats_db.process_user_defined_query(
  952. "SELECT portNumber, SUM(portCount) FROM ip_ports GROUP BY portNumber")
  953. graphx, graphy = [], []
  954. for row in result:
  955. graphx.append(row[0])
  956. graphy.append(row[1])
  957. plt.autoscale(enable=True, axis='both')
  958. plt.title("Ports Distribution")
  959. plt.xlabel('Ports Numbers')
  960. plt.ylabel('Number of Packets')
  961. width = 0.1
  962. plt.xlim([0, max(graphx)])
  963. plt.grid(True)
  964. plt.bar(graphx, graphy, width, align='center', linewidth=1, color='red', edgecolor='red')
  965. out = self.pcap_filepath.replace('.pcap', '_plot-port' + file_ending)
  966. plt.savefig(out, dpi=500)
  967. return out
  968. # This distribution is not drawable for big datasets
  969. def plot_ip_src(file_ending: str):
  970. """
  971. TODO: FILL ME
  972. :param file_ending:
  973. :return:
  974. """
  975. plt.gcf().clear()
  976. result = self.stats_db.process_user_defined_query(
  977. "SELECT ipAddress, pktsSent FROM ip_statistics")
  978. graphx, graphy = [], []
  979. for row in result:
  980. graphx.append(row[0])
  981. graphy.append(row[1])
  982. plt.autoscale(enable=True, axis='both')
  983. plt.title("Source IP Distribution")
  984. plt.xlabel('Source IP')
  985. plt.ylabel('Number of Packets')
  986. width = 0.1
  987. plt.xlim([0, len(graphx)])
  988. plt.grid(True)
  989. # IPs on x-axis
  990. x = range(0, len(graphx))
  991. my_xticks = graphx
  992. plt.xticks(x, my_xticks, rotation='vertical', fontsize=5)
  993. # plt.tight_layout()
  994. # limit the number of xticks
  995. plt.locator_params(axis='x', nbins=20)
  996. plt.bar(x, graphy, width, align='center', linewidth=1, color='red', edgecolor='red')
  997. out = self.pcap_filepath.replace('.pcap', '_plot-ip-src' + file_ending)
  998. plt.savefig(out, dpi=500)
  999. return out
  1000. # This distribution is not drawable for big datasets
  1001. def plot_ip_dst(file_ending: str):
  1002. """
  1003. TODO: FILL ME
  1004. :param file_ending:
  1005. :return:
  1006. """
  1007. plt.gcf().clear()
  1008. result = self.stats_db.process_user_defined_query(
  1009. "SELECT ipAddress, pktsReceived FROM ip_statistics")
  1010. graphx, graphy = [], []
  1011. for row in result:
  1012. graphx.append(row[0])
  1013. graphy.append(row[1])
  1014. plt.autoscale(enable=True, axis='both')
  1015. plt.title("Destination IP Distribution")
  1016. plt.xlabel('Destination IP')
  1017. plt.ylabel('Number of Packets')
  1018. width = 0.1
  1019. plt.xlim([0, len(graphx)])
  1020. plt.grid(True)
  1021. # IPs on x-axis
  1022. x = range(0, len(graphx))
  1023. my_xticks = graphx
  1024. plt.xticks(x, my_xticks, rotation='vertical', fontsize=5)
  1025. # plt.tight_layout()
  1026. # limit the number of xticks
  1027. plt.locator_params(axis='x', nbins=20)
  1028. plt.bar(x, graphy, width, align='center', linewidth=1, color='red', edgecolor='red')
  1029. out = self.pcap_filepath.replace('.pcap', '_plot-ip-dst' + file_ending)
  1030. plt.savefig(out, dpi=500)
  1031. return out
  1032. def plot_interval_statistics(query_output, title, x_label, y_label, file_ending: str):
  1033. """
  1034. TODO: FILL ME
  1035. :param query_output:
  1036. :param title:
  1037. :param x_label:
  1038. :param y_label:
  1039. :param file_ending:
  1040. :return:
  1041. """
  1042. plt.gcf().clear()
  1043. graphx, graphy = [], []
  1044. for row in query_output:
  1045. graphx.append(row[0])
  1046. graphy.append(row[1])
  1047. plt.autoscale(enable=True, axis='both')
  1048. plt.title(title)
  1049. plt.xlabel(x_label)
  1050. plt.ylabel(y_label)
  1051. width = 0.5
  1052. plt.xlim([0, len(graphx)])
  1053. plt.grid(True)
  1054. # timestamp on x-axis
  1055. x = range(0, len(graphx))
  1056. # limit the number of xticks
  1057. plt.locator_params(axis='x', nbins=20)
  1058. plt.bar(x, graphy, width, align='center', linewidth=1, color='red', edgecolor='red')
  1059. out = self.pcap_filepath.replace('.pcap', '_plot-' + title + file_ending)
  1060. plt.savefig(out, dpi=500)
  1061. return out
  1062. def plot_interval_pkt_count(file_ending: str):
  1063. """
  1064. TODO: FILL ME
  1065. :param file_ending:
  1066. :return:
  1067. """
  1068. query_output = self.stats_db.process_interval_statistics_query(
  1069. "SELECT last_pkt_timestamp, pkts_count FROM %s ORDER BY last_pkt_timestamp")
  1070. title = "Packet Rate"
  1071. x_label = "Time Interval"
  1072. y_label = "Number of Packets"
  1073. if query_output:
  1074. return plot_interval_statistics(query_output, title, x_label, y_label, file_ending)
  1075. def plot_interval_ip_src_ent(file_ending: str):
  1076. """
  1077. TODO: FILL ME
  1078. :param file_ending:
  1079. :return:
  1080. """
  1081. query_output = self.stats_db.process_interval_statistics_query(
  1082. "SELECT last_pkt_timestamp, ip_src_entropy FROM %s ORDER BY last_pkt_timestamp")
  1083. title = "Source IP Entropy"
  1084. x_label = "Time Interval"
  1085. y_label = "Entropy"
  1086. if query_output:
  1087. return plot_interval_statistics(query_output, title, x_label, y_label, file_ending)
  1088. def plot_interval_ip_dst_ent(file_ending: str):
  1089. """
  1090. TODO: FILL ME
  1091. :param file_ending:
  1092. :return:
  1093. """
  1094. query_output = self.stats_db.process_interval_statistics_query(
  1095. "SELECT last_pkt_timestamp, ip_dst_entropy FROM %s ORDER BY last_pkt_timestamp")
  1096. title = "Destination IP Entropy"
  1097. x_label = "Time Interval"
  1098. y_label = "Entropy"
  1099. if query_output:
  1100. return plot_interval_statistics(query_output, title, x_label, y_label, file_ending)
  1101. def plot_interval_new_ip(file_ending: str):
  1102. """
  1103. TODO: FILL ME
  1104. :param file_ending:
  1105. :return:
  1106. """
  1107. query_output = self.stats_db.process_interval_statistics_query(
  1108. "SELECT last_pkt_timestamp, newIPCount FROM %s ORDER BY last_pkt_timestamp")
  1109. title = "IP Novelty Distribution"
  1110. x_label = "Time Interval"
  1111. y_label = "Novel values count"
  1112. if query_output:
  1113. return plot_interval_statistics(query_output, title, x_label, y_label, file_ending)
  1114. def plot_interval_new_port(file_ending: str):
  1115. """
  1116. TODO: FILL ME
  1117. :param file_ending:
  1118. :return:
  1119. """
  1120. query_output = self.stats_db.process_interval_statistics_query(
  1121. "SELECT last_pkt_timestamp, port_novel_count FROM %s ORDER BY last_pkt_timestamp")
  1122. title = "Port Novelty Distribution"
  1123. x_label = "Time Interval"
  1124. y_label = "Novel values count"
  1125. if query_output:
  1126. return plot_interval_statistics(query_output, title, x_label, y_label, file_ending)
  1127. def plot_interval_new_ttl(file_ending: str):
  1128. """
  1129. TODO: FILL ME
  1130. :param file_ending:
  1131. :return:
  1132. """
  1133. query_output = self.stats_db.process_interval_statistics_query(
  1134. "SELECT last_pkt_timestamp, ttl_novel_count FROM %s ORDER BY last_pkt_timestamp")
  1135. title = "TTL Novelty Distribution"
  1136. x_label = "Time Interval"
  1137. y_label = "Novel values count"
  1138. if query_output:
  1139. return plot_interval_statistics(query_output, title, x_label, y_label, file_ending)
  1140. def plot_interval_new_tos(file_ending: str):
  1141. """
  1142. TODO: FILL ME
  1143. :param file_ending:
  1144. :return:
  1145. """
  1146. query_output = self.stats_db.process_interval_statistics_query(
  1147. "SELECT last_pkt_timestamp, tos_novel_count FROM %s ORDER BY last_pkt_timestamp")
  1148. title = "ToS Novelty Distribution"
  1149. x_label = "Time Interval"
  1150. y_label = "Novel values count"
  1151. if query_output:
  1152. return plot_interval_statistics(query_output, title, x_label, y_label, file_ending)
  1153. def plot_interval_new_win_size(file_ending: str):
  1154. """
  1155. TODO: FILL ME
  1156. :param file_ending:
  1157. :return:
  1158. """
  1159. query_output = self.stats_db.process_interval_statistics_query(
  1160. "SELECT last_pkt_timestamp, win_size_novel_count FROM %s ORDER BY last_pkt_timestamp")
  1161. title = "Window Size Novelty Distribution"
  1162. x_label = "Time Interval"
  1163. y_label = "Novel values count"
  1164. if query_output:
  1165. return plot_interval_statistics(query_output, title, x_label, y_label, file_ending)
  1166. def plot_interval_new_mss(file_ending: str):
  1167. """
  1168. TODO: FILL ME
  1169. :param file_ending:
  1170. :return:
  1171. """
  1172. query_output = self.stats_db.process_interval_statistics_query(
  1173. "SELECT last_pkt_timestamp, mss_novel_count FROM %s ORDER BY last_pkt_timestamp")
  1174. title = "MSS Novelty Distribution"
  1175. x_label = "Time Interval"
  1176. y_label = "Novel values count"
  1177. if query_output:
  1178. return plot_interval_statistics(query_output, title, x_label, y_label, file_ending)
  1179. def plot_interval_ip_cum_ent(ip_type: str, file_ending: str):
  1180. """
  1181. TODO: FILL ME
  1182. :param ip_type: source or destination
  1183. :param file_ending:
  1184. :return:
  1185. """
  1186. if ip_type is "src":
  1187. sod = "Src"
  1188. full = "Source"
  1189. elif ip_type is "dst":
  1190. sod = "Dst"
  1191. full = "Destination"
  1192. else:
  1193. return None
  1194. plt.gcf().clear()
  1195. result = self.stats_db.process_interval_statistics_query(
  1196. "SELECT last_pkt_timestamp, ip{0}_cum_entropy FROM %s ORDER BY last_pkt_timestamp".format(sod))
  1197. graphx, graphy = [], []
  1198. for row in result:
  1199. graphx.append(row[0])
  1200. graphy.append(row[1])
  1201. # If entropy was not calculated do not plot the graph
  1202. if graphy[0] != -1:
  1203. plt.autoscale(enable=True, axis='both')
  1204. plt.title(full + " IP Cumulative Entropy")
  1205. # plt.xlabel('Timestamp')
  1206. plt.xlabel('Time Interval')
  1207. plt.ylabel('Entropy')
  1208. plt.xlim([0, len(graphx)])
  1209. plt.grid(True)
  1210. # timestamp on x-axis
  1211. x = range(0, len(graphx))
  1212. # my_xticks = graphx
  1213. # plt.xticks(x, my_xticks, rotation='vertical', fontsize=5)
  1214. # plt.tight_layout()
  1215. # limit the number of xticks
  1216. plt.locator_params(axis='x', nbins=20)
  1217. plt.plot(x, graphy, 'r')
  1218. out = self.pcap_filepath.replace('.pcap', '_plot-interval-ip-' + ip_type + '-cum-ent' + file_ending)
  1219. plt.savefig(out, dpi=500)
  1220. return out
  1221. def plot_degree(degree_type: str, file_ending: str):
  1222. """
  1223. Creates a Plot, visualizing a degree for every IP Address
  1224. :param degree_type: the type of degree, which should be plotted
  1225. :param file_ending: The file extension for the output file containing the plot, e.g. "pdf"
  1226. :return: A filepath to the file containing the created plot
  1227. """
  1228. if degree_type not in ["in", "out", "overall"]:
  1229. return None
  1230. plt.gcf().clear()
  1231. # retrieve data
  1232. degree = self.stats_db.process_user_defined_query(
  1233. "SELECT ipAddress, %s FROM ip_degrees" % (degree_type + "Degree"))
  1234. if degree is None:
  1235. return None
  1236. graphx, graphy = [], []
  1237. for entry in degree:
  1238. if entry[1] <= 0:
  1239. continue
  1240. # degree values
  1241. graphx.append(entry[1])
  1242. # IP labels
  1243. graphy.append(entry[0])
  1244. # set labels
  1245. plt.title(degree_type + " Degree per IP Address")
  1246. plt.ylabel('IpAddress')
  1247. plt.xlabel(degree_type + 'Degree')
  1248. # set width of the bars
  1249. width = 0.3
  1250. # set scalings
  1251. plt.figure(
  1252. figsize=(int(len(graphx)) / 20 + 5, int(len(graphy) / 5) + 5)) # these proportions just worked well
  1253. # set limits of the axis
  1254. plt.ylim([0, len(graphy)])
  1255. plt.xlim([0, max(graphx) + 10])
  1256. # display numbers at each bar
  1257. for i, v in enumerate(graphx):
  1258. plt.text(v + 1, i + .1, str(v), color='blue', fontweight='bold')
  1259. # display grid for better visuals
  1260. plt.grid(True)
  1261. # plot the bar
  1262. labels = graphy
  1263. graphy = list(range(len(graphx)))
  1264. plt.barh(graphy, graphx, width, align='center', linewidth=1, color='red', edgecolor='red')
  1265. plt.yticks(graphy, labels)
  1266. out = self.pcap_filepath.replace('.pcap', '_plot-' + degree_type + ' Degree of an IP' + file_ending)
  1267. # plt.tight_layout()
  1268. plt.savefig(out, dpi=500)
  1269. return out
  1270. def plot_big_conv_ext_stat(attr: str, title: str, xlabel: str, suffix: str):
  1271. """
  1272. Plots the desired statistc per connection as horizontal bar plot.
  1273. Included are 'half-open' connections, where only one packet is exchanged.
  1274. The given statistics table has to have at least the attributes 'ipAddressA', 'portA', 'ipAddressB',
  1275. 'portB' and the specified additional attribute.
  1276. Note: there may be cutoff/scaling problems within the plot if there is too little data.
  1277. :param attr: The desired statistic, named with respect to its attribute in the given statistics table
  1278. :param title: The title of the created plot
  1279. :param xlabel: The name of the x-axis of the created plot
  1280. :param suffix: The suffix of the created file, including file extension
  1281. :return: A filepath to the file containing the created plot
  1282. """
  1283. plt.gcf().clear()
  1284. result = self.stats_db.process_user_defined_query(
  1285. "SELECT ipAddressA, portA, ipAddressB, portB, %s FROM conv_statistics_extended" % attr)
  1286. if result:
  1287. graphy, graphx = [], []
  1288. # plot data in descending order
  1289. result = sorted(result, key=lambda r: r[4])
  1290. # compute plot data
  1291. for i, row in enumerate(result):
  1292. addr1, addr2 = "%s:%d" % (row[0], row[1]), "%s:%d" % (row[2], row[3])
  1293. # adjust the justification of strings to improve appearance
  1294. len_max = max(len(addr1), len(addr2))
  1295. addr1 = addr1.ljust(len_max)
  1296. addr2 = addr2.ljust(len_max)
  1297. # add plot data
  1298. graphy.append("%s\n%s" % (addr1, addr2))
  1299. graphx.append(row[4])
  1300. # have x axis and its label appear at the top (instead of bottom)
  1301. fig, ax = plt.subplots()
  1302. ax.xaxis.tick_top()
  1303. ax.xaxis.set_label_position("top")
  1304. # compute plot height in inches for scaling the plot
  1305. dist_mult_height = 0.55 # this value turned out to work well
  1306. plt_height = len(graphy) * dist_mult_height
  1307. # originally, a good title distance turned out to be 1.012 with a plot height of 52.8
  1308. title_distance = 1 + 0.012 * 52.8 / plt_height
  1309. plt.gcf().set_size_inches(plt.gcf().get_size_inches()[0], plt_height) # set plot height
  1310. plt.gcf().subplots_adjust(left=0.35)
  1311. # set additional plot parameters
  1312. plt.title(title, y=title_distance)
  1313. plt.xlabel(xlabel)
  1314. plt.ylabel('Connection')
  1315. width = 0.5
  1316. plt.grid(True)
  1317. plt.gca().margins(y=0) # removes the space between data and x-axis within the plot
  1318. # plot the above data, first use plain numbers as graphy to maintain sorting
  1319. plt.barh(range(len(graphy)), graphx, width, align='center', linewidth=0.5, color='red', edgecolor='red')
  1320. # now change the y numbers to the respective address labels
  1321. plt.yticks(range(len(graphy)), graphy)
  1322. # save created figure
  1323. out = self.pcap_filepath.replace('.pcap', suffix)
  1324. plt.savefig(out, dpi=500)
  1325. return out
  1326. def plot_packets_per_connection(file_ending: str):
  1327. """
  1328. Plots the total number of exchanged packets per connection.
  1329. :param file_ending: The file extension for the output file containing the plot
  1330. :return: A filepath to the file containing the created plot
  1331. """
  1332. title = 'Number of exchanged packets per connection'
  1333. suffix = '_plot-PktCount per Connection Distribution' + file_ending
  1334. # plot data and return outpath
  1335. return plot_big_conv_ext_stat("pktsCount", title, "Number of packets", suffix)
  1336. def plot_avg_pkts_per_comm_interval(file_ending: str):
  1337. """
  1338. Plots the average number of exchanged packets per communication interval for every connection.
  1339. :param file_ending: The file extension for the output file containing the plot
  1340. :return: A filepath to the file containing the created plot
  1341. """
  1342. title = 'Average number of exchanged packets per communication interval'
  1343. suffix = '_plot-Avg PktCount Communication Interval Distribution' + file_ending
  1344. # plot data and return outpath
  1345. return plot_big_conv_ext_stat("avgIntervalPktCount", title, "Number of packets", suffix)
  1346. def plot_avg_time_between_comm_interval(file_ending: str):
  1347. """
  1348. Plots the average time between the communication intervals of every connection.
  1349. :param file_ending: The file extension for the output file containing the plot
  1350. :return: A filepath to the file containing the created plot
  1351. """
  1352. title = 'Average time between communication intervals in seconds'
  1353. suffix = '_plot-Avg Time Between Communication Intervals Distribution' + file_ending
  1354. # plot data and return outpath
  1355. return plot_big_conv_ext_stat("avgTimeBetweenIntervals", title, 'Average time between intervals', suffix)
  1356. def plot_avg_comm_interval_time(file_ending: str):
  1357. """
  1358. Plots the average duration of a communication interval of every connection.
  1359. :param file_ending: The file extension for the output file containing the plot
  1360. :return: A filepath to the file containing the created plot
  1361. """
  1362. title = 'Average duration of a communication interval in seconds'
  1363. suffix = '_plot-Avg Duration Communication Interval Distribution' + file_ending
  1364. # plot data and return outpath
  1365. return plot_big_conv_ext_stat("avgIntervalTime", title, 'Average interval time', suffix)
  1366. def plot_total_comm_duration(file_ending: str):
  1367. """
  1368. Plots the total communication duration of every connection.
  1369. :param file_ending: The file extension for the output file containing the plot
  1370. :return: A filepath to the file containing the created plot
  1371. """
  1372. title = 'Total communication duration in seconds'
  1373. suffix = '_plot-Total Communication Duration Distribution' + file_ending
  1374. # plot data and return outpath
  1375. return plot_big_conv_ext_stat("totalConversationDuration", title, 'Duration', suffix)
  1376. def plot_comm_histogram(attr: str, title: str, label: str, suffix: str):
  1377. """
  1378. Plots a histogram about the specified attribute for communications.
  1379. :param attr: The statistics attribute for this histogram
  1380. :param title: The title of the histogram
  1381. :param label: The xlabel of the histogram
  1382. :param suffix: The file suffix
  1383. :return: The path to the created plot
  1384. """
  1385. plt.gcf().clear()
  1386. result_raw = self.stats_db.process_user_defined_query(
  1387. "SELECT %s FROM conv_statistics_extended" % attr)
  1388. # return without plotting if no data available
  1389. if not result_raw:
  1390. return None
  1391. result = []
  1392. for entry in result_raw:
  1393. result.append(entry[0])
  1394. # if title would be cut off, set minimum width
  1395. plt_size = plt.gcf().get_size_inches()
  1396. min_width = len(title) * 0.12
  1397. if plt_size[0] < min_width:
  1398. plt.gcf().set_size_inches(min_width, plt_size[1]) # set plot size
  1399. # set additional plot parameters
  1400. plt.title(title)
  1401. plt.ylabel("Relative frequency of connections")
  1402. plt.xlabel(label)
  1403. plt.grid(True)
  1404. # create 11 bins
  1405. bins = []
  1406. max_val = max(result)
  1407. for i in range(0, 11):
  1408. bins.append(i * max_val / 10)
  1409. # set weights normalize histogram
  1410. weights = numpy.ones_like(result) / float(len(result))
  1411. # plot the above data, first use plain numbers as graphy to maintain sorting
  1412. plt.hist(result, bins=bins, weights=weights, color='red', edgecolor='red', align="mid", rwidth=0.5)
  1413. plt.xticks(bins)
  1414. # save created figure
  1415. out = self.pcap_filepath.replace('.pcap', suffix)
  1416. plt.savefig(out, dpi=500)
  1417. return out
  1418. def plot_histogram_degree(degree_type: str, title: str, label: str, suffix: str):
  1419. """
  1420. Plots a histogram about the specified type for the degree of an IP.
  1421. :param degree_type: The type of degree, i.e. inDegree, outDegree or overallDegree
  1422. :param title: The title of the histogram
  1423. :param label: The xlabel of the histogram
  1424. :param suffix: The file suffix
  1425. :return: The path to the created plot
  1426. """
  1427. plt.gcf().clear()
  1428. result_raw = self.get_filtered_degree(degree_type)
  1429. # return without plotting if no data available
  1430. if not result_raw:
  1431. return None
  1432. result = []
  1433. for entry in result_raw:
  1434. result.append(entry[1])
  1435. # set additional plot parameters
  1436. plt.title(title)
  1437. plt.ylabel("Relative frequency of IPs")
  1438. plt.xlabel(label)
  1439. plt.grid(True)
  1440. # create 11 bins
  1441. bins = []
  1442. max_val = max(result)
  1443. for i in range(0, 11):
  1444. bins.append(int(i * max_val / 10))
  1445. # set weights normalize histogram
  1446. weights = numpy.ones_like(result) / float(len(result))
  1447. # plot the above data, first use plain numbers as graphy to maintain sorting
  1448. plt.hist(result, bins=bins, weights=weights, color='red', edgecolor='red', align="mid", rwidth=0.5)
  1449. plt.xticks(bins)
  1450. # save created figure
  1451. out = self.pcap_filepath.replace('.pcap', suffix)
  1452. plt.savefig(out, dpi=500)
  1453. return out
  1454. ttl_out_path = plot_ttl('.' + file_format)
  1455. print(".", end="", flush=True)
  1456. mss_out_path = plot_mss('.' + file_format)
  1457. print(".", end="", flush=True)
  1458. win_out_path = plot_win('.' + file_format)
  1459. print(".", end="", flush=True)
  1460. protocol_out_path = plot_protocol('.' + file_format)
  1461. print(".", end="", flush=True)
  1462. plot_interval_pktCount = plot_interval_pkt_count('.' + file_format)
  1463. print(".", end="", flush=True)
  1464. if entropy:
  1465. plot_interval_ip_src_ent = plot_interval_ip_src_ent('.' + file_format)
  1466. print(".", end="", flush=True)
  1467. plot_interval_ip_dst_ent = plot_interval_ip_dst_ent('.' + file_format)
  1468. print(".", end="", flush=True)
  1469. plot_interval_ip_src_cum_ent = plot_interval_ip_cum_ent("src", '.' + file_format)
  1470. print(".", end="", flush=True)
  1471. plot_interval_ip_dst_cum_ent = plot_interval_ip_cum_ent("dst", '.' + file_format)
  1472. print(".", end="", flush=True)
  1473. plot_interval_new_ip = plot_interval_new_ip('.' + file_format)
  1474. print(".", end="", flush=True)
  1475. plot_interval_new_port = plot_interval_new_port('.' + file_format)
  1476. print(".", end="", flush=True)
  1477. plot_interval_new_ttl = plot_interval_new_ttl('.' + file_format)
  1478. print(".", end="", flush=True)
  1479. plot_interval_new_tos = plot_interval_new_tos('.' + file_format)
  1480. print(".", end="", flush=True)
  1481. plot_interval_new_win_size = plot_interval_new_win_size('.' + file_format)
  1482. print(".", end="", flush=True)
  1483. plot_interval_new_mss = plot_interval_new_mss('.' + file_format)
  1484. print(".", end="", flush=True)
  1485. plot_hist_indegree_out = plot_histogram_degree("inDegree", "Histogram - Ingoing degree per IP Address",
  1486. "Ingoing degree",
  1487. "_plot-Histogram Ingoing Degree per IP" + file_format)
  1488. print(".", end="", flush=True)
  1489. plot_hist_outdegree_out = plot_histogram_degree("outDegree", "Histogram - Outgoing degree per IP Address",
  1490. "Outgoing degree",
  1491. "_plot-Histogram Outgoing Degree per IP" + file_format)
  1492. print(".", end="", flush=True)
  1493. plot_hist_overalldegree_out = plot_histogram_degree("overallDegree",
  1494. "Histogram - Overall degree per IP Address",
  1495. "Overall degree",
  1496. "_plot-Histogram Overall Degree per IP" + file_format)
  1497. print(".", end="", flush=True)
  1498. plot_hist_pkts_per_connection_out = plot_comm_histogram("pktsCount",
  1499. "Histogram - Number of exchanged packets per connection",
  1500. "Number of packets",
  1501. "_plot-Histogram PktCount per Connection" + "." + file_format)
  1502. print(".", end="", flush=True)
  1503. plot_hist_avgpkts_per_commint_out = plot_comm_histogram("avgIntervalPktCount",
  1504. "Histogram - Average number of exchanged packets per communication interval",
  1505. "Average number of packets",
  1506. "_plot-Histogram Avg PktCount per Interval per Connection" + "." + file_format)
  1507. print(".", end="", flush=True)
  1508. plot_hist_avgtime_betw_commints_out = plot_comm_histogram("avgTimeBetweenIntervals",
  1509. "Histogram - Average time between communication intervals in seconds",
  1510. "Average time between intervals",
  1511. "_plot-Histogram Avg Time Between Intervals per Connection" + "." + file_format)
  1512. print(".", end="", flush=True)
  1513. plot_hist_avg_int_time_per_connection_out = plot_comm_histogram("avgIntervalTime",
  1514. "Histogram - Average duration of a communication interval in seconds",
  1515. "Average interval time",
  1516. "_plot-Histogram Avg Interval Time per Connection" + "." + file_format)
  1517. print(".", end="", flush=True)
  1518. plot_hist_total_comm_duration_out = plot_comm_histogram("totalConversationDuration",
  1519. "Histogram - Total communication duration in seconds",
  1520. "Duration",
  1521. "_plot-Histogram Communication Duration per Connection" + "." + file_format)
  1522. print(".", end="", flush=True)
  1523. if entropy:
  1524. plot_out_degree = plot_degree("out", '.' + file_format)
  1525. print(".", end="", flush=True)
  1526. plot_in_degree = plot_degree("in", '.' + file_format)
  1527. print(".", end="", flush=True)
  1528. plot_overall_degree = plot_degree("overall", '.' + file_format)
  1529. print(".", end="", flush=True)
  1530. plot_packets_per_connection_out = plot_packets_per_connection('.' + file_format)
  1531. print(".", end="", flush=True)
  1532. plot_avg_pkts_per_comm_interval_out = plot_avg_pkts_per_comm_interval('.' + file_format)
  1533. print(".", end="", flush=True)
  1534. plot_avg_time_between_comm_interval_out = plot_avg_time_between_comm_interval('.' + file_format)
  1535. print(".", end="", flush=True)
  1536. plot_avg_comm_interval_time_out = plot_avg_comm_interval_time("." + file_format)
  1537. print(".", end="", flush=True)
  1538. plot_total_comm_duration_out = plot_total_comm_duration("." + file_format)
  1539. print(".", end="", flush=True)
  1540. print(" done.")
  1541. # Time consuming plot
  1542. # port_out_path = plot_port('.' + format)
  1543. # Not drawable for too many IPs
  1544. # ip_src_out_path = plot_ip_src('.' + format)
  1545. # ip_dst_out_path = plot_ip_dst('.' + format)
  1546. print("Saved plots in the input PCAP directory.")
  1547. def stats_summary_post_attack(self, added_packets):
  1548. """
  1549. Prints a summary of relevant statistics after an attack is injected
  1550. :param added_packets: sum of packets added by attacks, gets updated if more than one attack
  1551. :return: None
  1552. """
  1553. total_packet_count = self.get_packet_count() + added_packets
  1554. added_packets_share = added_packets / total_packet_count * 100
  1555. timespan = self.get_capture_duration()
  1556. summary = [("Total packet count", total_packet_count, "packets"),
  1557. ("Added packet count", added_packets, "packets"),
  1558. ("Share of added packets", added_packets_share, "%"),
  1559. ("Capture duration", timespan, "seconds")]
  1560. print("\nPOST INJECTION STATISTICS SUMMARY --------------------------")
  1561. self.write_list(summary, print, "")
  1562. print("------------------------------------------------------------")
  1563. def stats_summary_new_db(self):
  1564. """
  1565. Prints a summary of relevant statistics when a new db is created
  1566. :return: None
  1567. """
  1568. self.file_info = self.stats_db.get_file_info()
  1569. print("\nNew database has been generated, printing statistics summary... ")
  1570. total_packet_count = self.get_packet_count()
  1571. pdu_count = self.process_db_query("SELECT SUM(pktCount) FROM unrecognized_pdus")
  1572. if pdu_count is None:
  1573. pdu_count = 0
  1574. pdu_share = pdu_count / total_packet_count * 100
  1575. last_pdu_timestamp = self.process_db_query(
  1576. "SELECT MAX(timestampLastOccurrence) FROM unrecognized_pdus")
  1577. timespan = self.get_capture_duration()
  1578. summary = [("Total packet count", total_packet_count, "packets"),
  1579. ("Recognized packets", total_packet_count - pdu_count, "packets"),
  1580. ("Unrecognized packets", pdu_count, "PDUs"),
  1581. ("% Recognized packets", 100 - pdu_share, "%"),
  1582. ("% Unrecognized packets", pdu_share, "%"),
  1583. ("Last unknown PDU", last_pdu_timestamp),
  1584. ("Capture duration", timespan, "seconds")]
  1585. print("\nPCAP FILE STATISTICS SUMMARY ------------------------------")
  1586. self.write_list(summary, print, "")
  1587. print("------------------------------------------------------------")