VNFs/DPPD-PROX/helper-scripts/rapid/rapid_flowsizetest.py

   1 #!/usr/bin/python
   2
   3 ##
   4 ## Copyright (c) 2020 Intel Corporation
   5 ##
   6 ## Licensed under the Apache License, Version 2.0 (the "License");
   7 ## you may not use this file except in compliance with the License.
   8 ## You may obtain a copy of the License at
   9 ##
  10 ##
  11 ##     http://www.apache.org/licenses/LICENSE-2.0
  12 ##
  13 ## Unless required by applicable law or agreed to in writing, software
  14 ## distributed under the License is distributed on an "AS IS" BASIS,
  15 ## WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  16 ## See the License for the specific language governing permissions and
  17 ## limitations under the License.
  18 ##
  19 import sys
  20 import time
  21 import copy
  22 from math import ceil
  23 from statistics import mean
  24 from past.utils import old_div
  25 from rapid_log import RapidLog
  26 from rapid_log import bcolors
  27 from rapid_test import RapidTest
  28 inf = float("inf")
  29
  30 class FlowSizeTest(RapidTest):
  31     """
  32     Class to manage the flowsizetesting
  33     """
  34     def __init__(self, test_param, lat_percentile, runtime, testname,
  35             environment_file, gen_machine, sut_machine, background_machines):
  36         super().__init__(test_param, runtime, testname, environment_file)
  37         self.gen_machine = gen_machine
  38         self.sut_machine = sut_machine
  39         self.background_machines = background_machines
  40         self.test['lat_percentile'] = lat_percentile
  41         if self.test['test'] == 'TST009test':
  42             # This test implements some of the testing as defined in
  43             # https://docbox.etsi.org/ISG/NFV/open/Publications_pdf/Specs-Reports/NFV-TST%20009v3.2.1%20-%20GS%20-%20NFVI_Benchmarks.pdf
  44             self.test['TST009_n'] = int(ceil(old_div(
  45                 self.test['maxframespersecondallingress'],
  46                 self.test['stepsize'])))
  47             self.test['TST009'] = True
  48             self.test['TST009_L'] = 0
  49             self.test['TST009_R'] = self.test['TST009_n'] - 1
  50             self.test['TST009_S']= []
  51             for m in range(0, self.test['TST009_n']):
  52                 self.test['TST009_S'].append((m+1) * self.test['stepsize'])
  53         elif self.test['test'] == 'fixed_rate':
  54             for key in['drop_rate_threshold','lat_avg_threshold',
  55                     'lat_perc_threshold','lat_max_threshold','mis_ordered_threshold']:
  56                 self.test[key] = inf
  57
  58     def new_speed(self, speed,size,success):
  59         if self.test['test'] == 'fixed_rate':
  60             return (self.test['startspeed'])
  61         elif self.test['test'] == 'increment_till_fail':
  62             return (speed + self.test['step'])
  63         elif 'TST009' in self.test.keys():
  64             if success:
  65                 self.test['TST009_L'] = self.test['TST009_m'] + 1
  66             else:
  67                 self.test['TST009_R'] = max(self.test['TST009_m'] - 1,
  68                         self.test['TST009_L'])
  69             self.test['TST009_m'] = int (old_div((self.test['TST009_L'] +
  70                 self.test['TST009_R']),2))
  71             return (self.get_percentageof10Gbps(self.test['TST009_S'][self.test['TST009_m']],size))
  72         else:
  73             if success:
  74                 self.test['minspeed'] = speed
  75             else:
  76                 self.test['maxspeed'] = speed
  77             return (old_div((self.test['minspeed'] + self.test['maxspeed']),2.0))
  78
  79     def get_start_speed_and_init(self, size):
  80         if self.test['test'] == 'fixed_rate':
  81             return (self.test['startspeed'])
  82         elif self.test['test'] == 'increment_till_fail':
  83             return (self.test['startspeed'])
  84         elif 'TST009' in self.test.keys():
  85             self.test['TST009_L'] = 0
  86             self.test['TST009_R'] = self.test['TST009_n'] - 1
  87             self.test['TST009_m'] = int(old_div((self.test['TST009_L'] +
  88                 self.test['TST009_R']), 2))
  89             return (self.get_percentageof10Gbps(self.test['TST009_S'][self.test['TST009_m']],size))
  90         else:
  91             self.test['minspeed'] = 0
  92             self.test['maxspeed'] = self.test['startspeed']
  93             return (self.test['startspeed'])
  94
  95     def resolution_achieved(self):
  96         if self.test['test'] == 'fixed_rate':
  97             return (True)
  98         elif 'TST009' in self.test.keys():
  99             return (self.test['TST009_L'] == self.test['TST009_R'])
 100         else:
 101             return ((self.test['maxspeed'] - self.test['minspeed']) <= self.test['accuracy'])
 102
 103     def warm_up(self):
 104         # Running at low speed to make sure the ARP messages can get through.
 105         # If not doing this, the ARP message could be dropped by a switch in overload and then the test will not give proper results
 106         # Note however that if we would run the test steps during a very long time, the ARP would expire in the switch.
 107         # PROX will send a new ARP request every seconds so chances are very low that they will all fail to get through
 108         imix = self.test['warmupimix']
 109         FLOWSIZE = self.test['warmupflowsize']
 110         WARMUPSPEED = self.test['warmupspeed']
 111         WARMUPTIME = self.test['warmuptime']
 112
 113         RapidLog.info(("Warming up during {} seconds..., packet size = {},"
 114             " flows = {}, speed = {}").format(WARMUPTIME, imix, FLOWSIZE,
 115                 WARMUPSPEED))
 116         self.gen_machine.set_generator_speed(WARMUPSPEED)
 117         self.set_background_speed(self.background_machines, WARMUPSPEED)
 118         self.gen_machine.set_udp_packet_size(imix)
 119         self.set_background_size(self.background_machines, imix)
 120         if FLOWSIZE:
 121             _ = self.gen_machine.set_flows(FLOWSIZE)
 122             self.set_background_flows(self.background_machines, FLOWSIZE)
 123         self.gen_machine.start()
 124         self.start_background_traffic(self.background_machines)
 125         time.sleep(WARMUPTIME)
 126         self.stop_background_traffic(self.background_machines)
 127         self.gen_machine.stop()
 128
 129     def run(self):
 130         result_details = {'Details': 'Nothing'}
 131         TestResult = 0
 132         end_data = {}
 133         iteration_prefix = {}
 134         self.warm_up()
 135         for imix in self.test['imixs']:
 136             size = mean(imix)
 137             self.gen_machine.set_udp_packet_size(imix)
 138             if self.background_machines:
 139                 backgroundinfo = ('{}Running {} x background traffic not '
 140                     'represented in the table{}').format(bcolors.FLASH,
 141                             len(self.background_machines),bcolors.ENDC)
 142             else:
 143                 backgroundinfo = '{}{}'.format(bcolors.FLASH,bcolors.ENDC)
 144             self.set_background_size(self.background_machines, imix)
 145             RapidLog.info('+' + '-' * 200 + '+')
 146             RapidLog.info(("| UDP, {:>5} bytes, different number of flows by "
 147                 "randomizing SRC & DST UDP port. {:128.128}|").
 148                 format(round(size), backgroundinfo))
 149             RapidLog.info('+' + '-' * 8 + '+' + '-' * 18 + '+' + '-' * 13 +
 150                     '+' + '-' * 13 + '+' + '-' * 13 + '+' + '-' * 24 + '+' +
 151                     '-' * 10 + '+' + '-' * 10 + '+' + '-' * 10 + '+' + '-' * 11
 152                     + '+' + '-' * 11 + '+' + '-' * 11 + '+'  + '-' * 11 +  '+'
 153                     + '-' * 7 + '+' + '-' * 11 + '+' + '-' * 4 + '+')
 154             RapidLog.info(('| Flows  | Speed requested  | Gen by core | Sent by'
 155                 ' NIC | Fwrd by SUT | Rec. by core           | Avg. Lat.|{:.0f}'
 156                 ' Pcentil| Max. Lat.|   Sent    |  Received |    Lost   | Total'
 157                 ' Lost|L.Ratio|Mis-ordered|Time').format(self.test['lat_percentile']*100))
 158             RapidLog.info('+' + '-' * 8 + '+' + '-' * 18 + '+' + '-' * 13 +
 159                     '+' + '-' * 13 + '+' + '-' * 13 + '+' + '-' * 24 + '+' +
 160                     '-' * 10 + '+' + '-' * 10 + '+' + '-' * 10 + '+' + '-' * 11
 161                     + '+' + '-' * 11 + '+' + '-' * 11 + '+'  + '-' * 11 +  '+'
 162                     + '-' * 7 + '+' + '-' * 11 + '+' + '-' * 4 + '+')
 163             for flow_number in self.test['flows']:
 164                 attempts = 0
 165                 self.gen_machine.reset_stats()
 166                 if self.sut_machine:
 167                     self.sut_machine.reset_stats()
 168                 if flow_number != 0:
 169                     flow_number = self.gen_machine.set_flows(flow_number)
 170                     self.set_background_flows(self.background_machines, flow_number)
 171                 end_data['speed'] = None
 172                 speed = self.get_start_speed_and_init(size)
 173                 while True:
 174                     attempts += 1
 175                     endwarning = False
 176                     print('{} flows: Measurement ongoing at speed: {}%'.format(
 177                         str(flow_number), str(round(speed, 2))), end='     \r')
 178                     sys.stdout.flush()
 179                     iteration_data = self.run_iteration(
 180                             float(self.test['runtime']),flow_number,size,speed)
 181                     if iteration_data['r'] > 1:
 182                         retry_warning = '{} {:1} retries needed{}'.format(
 183                                 bcolors.WARNING, iteration_data['r'],
 184                                 bcolors.ENDC)
 185                     else:
 186                         retry_warning = ''
 187                     # Drop rate is expressed in percentage. lat_used is a ratio
 188                     # (0 to 1). The sum of these 2 should be 100%.
 189                     # If the sum is lower than 95, it means that more than 5%
 190                     # of the latency measurements where dropped for accuracy
 191                     # reasons.
 192                     if (iteration_data['drop_rate'] +
 193                             iteration_data['lat_used'] * 100) < 95:
 194                         lat_warning = ('{} Latency accuracy issue?: {:>3.0f}%'
 195                             '{}').format(bcolors.WARNING,
 196                                     iteration_data['lat_used'] * 100,
 197                                     bcolors.ENDC)
 198                     else:
 199                         lat_warning = ''
 200                     iteration_prefix = {'speed' : bcolors.ENDC,
 201                             'lat_avg' : bcolors.ENDC,
 202                             'lat_perc' : bcolors.ENDC,
 203                             'lat_max' : bcolors.ENDC,
 204                             'abs_drop_rate' : bcolors.ENDC,
 205                             'mis_ordered' : bcolors.ENDC,
 206                             'drop_rate' : bcolors.ENDC}
 207                     if self.test['test'] == 'fixed_rate':
 208                         end_data = copy.deepcopy(iteration_data)
 209                         end_prefix = copy.deepcopy(iteration_prefix)
 210                         if lat_warning or retry_warning:
 211                             endwarning = '|        | {:177.177} |'.format(
 212                                     retry_warning + lat_warning)
 213                         success = True
 214                         # TestResult = TestResult + iteration_data['pps_rx']
 215                         # fixed rate testing result is strange: we just report
 216                         # the pps received
 217                     # The following if statement is testing if we pass the
 218                     # success criteria of a certain drop rate, average latency
 219                     # and maximum latency below the threshold.
 220                     # The drop rate success can be achieved in 2 ways: either
 221                     # the drop rate is below a treshold, either we want that no
 222                     # packet has been lost during the test.
 223                     # This can be specified by putting 0 in the .test file
 224                     elif ((iteration_data['drop_rate'] < self.test['drop_rate_threshold']) or (iteration_data['abs_dropped']==self.test['drop_rate_threshold']==0)) and (iteration_data['lat_avg']< self.test['lat_avg_threshold']) and (iteration_data['lat_perc']< self.test['lat_perc_threshold']) and (iteration_data['lat_max'] < self.test['lat_max_threshold'] and iteration_data['mis_ordered'] <= self.test['mis_ordered_threshold']):
 225                         if (old_div((self.get_pps(speed,size) - iteration_data['pps_tx']),self.get_pps(speed,size)))>0.01:
 226                             iteration_prefix['speed'] = bcolors.WARNING
 227                             if iteration_data['abs_tx_fail'] > 0:
 228                                 gen_warning = bcolors.WARNING + ' Network limit?: requesting {:<.3f} Mpps and getting {:<.3f} Mpps - {} failed to be transmitted'.format(self.get_pps(speed,size), iteration_data['pps_tx'], iteration_data['abs_tx_fail']) + bcolors.ENDC
 229                             else:
 230                                 gen_warning = bcolors.WARNING + ' Generator limit?: requesting {:<.3f} Mpps and getting {:<.3f} Mpps'.format(self.get_pps(speed,size), iteration_data['pps_tx']) + bcolors.ENDC
 231                         else:
 232                             iteration_prefix['speed'] = bcolors.ENDC
 233                             gen_warning = ''
 234                         end_data = copy.deepcopy(iteration_data)
 235                         end_prefix = copy.deepcopy(iteration_prefix)
 236                         if lat_warning or gen_warning or retry_warning:
 237                             endwarning = '|        | {:186.186} |'.format(retry_warning + lat_warning + gen_warning)
 238                         success = True
 239                         success_message=' SUCCESS'
 240                         RapidLog.debug(self.report_result(-attempts, size,
 241                             iteration_data, iteration_prefix) + success_message +
 242                             retry_warning + lat_warning + gen_warning)
 243                     else:
 244                         success_message=' FAILED'
 245                         if ((iteration_data['abs_dropped']>0) and (self.test['drop_rate_threshold'] ==0)):
 246                             iteration_prefix['abs_drop_rate'] = bcolors.FAIL
 247                         if (iteration_data['drop_rate'] <= self.test['drop_rate_threshold']):
 248                             iteration_prefix['drop_rate'] = bcolors.ENDC
 249                         else:
 250                             iteration_prefix['drop_rate'] = bcolors.FAIL
 251                         if (iteration_data['lat_avg']< self.test['lat_avg_threshold']):
 252                             iteration_prefix['lat_avg'] = bcolors.ENDC
 253                         else:
 254                             iteration_prefix['lat_avg'] = bcolors.FAIL
 255                         if (iteration_data['lat_perc']< self.test['lat_perc_threshold']):
 256                             iteration_prefix['lat_perc'] = bcolors.ENDC
 257                         else:
 258                             iteration_prefix['lat_perc'] = bcolors.FAIL
 259                         if (iteration_data['lat_max']< self.test['lat_max_threshold']):
 260                             iteration_prefix['lat_max'] = bcolors.ENDC
 261                         else:
 262                             iteration_prefix['lat_max'] = bcolors.FAIL
 263                         if ((old_div((self.get_pps(speed,size) - iteration_data['pps_tx']),self.get_pps(speed,size)))<0.001):
 264                             iteration_prefix['speed'] = bcolors.ENDC
 265                         else:
 266                             iteration_prefix['speed'] = bcolors.FAIL
 267                         if (iteration_data['mis_ordered']< self.test['mis_ordered_threshold']):
 268                             iteration_prefix['mis_ordered'] = bcolors.ENDC
 269                         else:
 270                             iteration_prefix['mis_ordered'] = bcolors.FAIL
 271
 272                         success = False
 273                         RapidLog.debug(self.report_result(-attempts, size,
 274                             iteration_data, iteration_prefix) +
 275                             success_message + retry_warning + lat_warning)
 276                     speed = self.new_speed(speed, size, success)
 277                     if self.test['test'] == 'increment_till_fail':
 278                         if not success:
 279                             break
 280                     elif self.resolution_achieved():
 281                         break
 282                 if end_data['speed'] is None:
 283                     end_data = iteration_data
 284                     end_prefix = iteration_prefix
 285                     RapidLog.info('|{:>7} | {:<177} |'.format("FAILED","Speed 0 or close to 0, data for last failed step below:"))
 286                 RapidLog.info(self.report_result(flow_number, size,
 287                     end_data, end_prefix))
 288                 if end_data['avg_bg_rate']:
 289                     tot_avg_rx_rate = end_data['pps_rx'] + (end_data['avg_bg_rate'] * len(self.background_machines))
 290                     endtotaltrafficrate = '|        | Total amount of traffic received by all generators during this test: {:>4.3f} Gb/s {:7.3f} Mpps {} |'.format(RapidTest.get_speed(tot_avg_rx_rate,size) , tot_avg_rx_rate, ' '*84)
 291                     RapidLog.info (endtotaltrafficrate)
 292                 if endwarning:
 293                     RapidLog.info (endwarning)
 294                 if self.test['test'] != 'fixed_rate':
 295                     TestResult = TestResult + end_data['pps_rx']
 296                     end_data['test'] = self.test['testname']
 297                     end_data['environment_file'] = self.test['environment_file']
 298                     end_data['Flows'] = flow_number
 299                     end_data['Size'] = size
 300                     end_data['RequestedSpeed'] = RapidTest.get_pps(end_data['speed'] ,size)
 301                     result_details = self.post_data(end_data)
 302                     RapidLog.debug(result_details)
 303                 RapidLog.info('+' + '-' * 8 + '+' + '-' * 18 + '+' + '-' * 13 +
 304                     '+' + '-' * 13 + '+' + '-' * 13 + '+' + '-' * 24 + '+' +
 305                     '-' * 10 + '+' + '-' * 10 + '+' + '-' * 10 + '+' + '-' * 11
 306                     + '+' + '-' * 11 + '+' + '-' * 11 + '+'  + '-' * 11 +  '+'
 307                     + '+' + '-' * 11 + '+'
 308                     + '-' * 7 + '+' + '-' * 4 + '+')
 309         return (TestResult, result_details)