X-Git-Url: https://gerrit.fd.io/r/gitweb?p=csit.git;a=blobdiff_plain;f=resources%2Flibraries%2Frobot%2Fperformance%2Fperformance_utils.robot;h=4cabe5660efd3bc9a7fb28345d16f779ab0914c4;hp=b61c0ca2ac2bbb3190847c477b69de5c30e85b5e;hb=7dda8f57f750c253d3c96ac1b02a84c58e36a6d8;hpb=b883aab899c75a351b2c4af42c98e918810f2272 diff --git a/resources/libraries/robot/performance/performance_utils.robot b/resources/libraries/robot/performance/performance_utils.robot index b61c0ca2ac..4cabe5660e 100644 --- a/resources/libraries/robot/performance/performance_utils.robot +++ b/resources/libraries/robot/performance/performance_utils.robot @@ -20,6 +20,7 @@ | Library | resources.libraries.python.KubernetesUtils | Library | resources.libraries.python.VhostUser | Library | resources.libraries.python.TrafficGenerator +| Library | resources.libraries.python.TrafficGenerator.OptimizedSearch | Library | resources.libraries.python.TrafficGenerator.TGDropRateSearchImpl | Library | resources.libraries.python.Trace | Resource | resources/libraries/robot/shared/default.robot @@ -37,11 +38,99 @@ | ... | and PDR. *** Keywords *** +| Get Max Rate And Jumbo +| | [Documentation] +| | ... | Argument framesize can be either integer in case of a single packet +| | ... | in stream, or IMIX string defining mix of packets. +| | ... | For jumbo frames detection, the maximal packet size is relevant. +| | ... | For maximal transmit rate, the average packet size is relevant. +| | ... | In both cases, encapsulation overhead (if any) has effect. +| | ... | The maximal rate is computed from line limit bandwidth, +| | ... | but NICs also have an independent limit in packet rate. +| | ... | For some NICs, the limit is not reachable (bps limit is stricter), +| | ... | in those cases None is used (meaning no limiting). +| | ... +| | ... | This keyword returns computed maximal unidirectional transmit rate +| | ... | and jumbo boolean (some suites need that). +| | ... +| | ... | *Arguments:* +| | ... | - bps_limit - Line rate limit in bps. Type: integer +| | ... | - framesize - Framesize in bytes or IMIX. Type: integer or string +| | ... | - overhead - Overhead in bytes. Default: 0. Type: integer +| | ... | - pps_limit - NIC limit rate value in pps. Type: integer or None +| | ... +| | ... | *Returns:* +| | ... | - 2-tuple, consisting of: +| | ... | - Calculated unidirectional maximal transmit rate. +| | ... | Type: integer or float +| | ... | - Jumbo boolean, true if jumbo packet support has to be enabled. +| | ... | Type: boolean +| | ... +| | ... | *Example:* +| | ... +| | ... | \| Get Max Rate And Jumbo | \${10000000} \| IMIX_v4_1 \ +| | ... | \| overhead=\${40} \| pps_limit=\${18750000} \| +| | ... +| | [Arguments] | ${bps_limit} | ${framesize} +| | ... | ${overhead}=${0} | ${pps_limit}=${None} +| | ... +| | ${avg_size} = | Set Variable If | '${framesize}' == 'IMIX_v4_1' +| | ... | ${353.83333} | ${framesize} +| | ${max_size} = | Set Variable If | '${framesize}' == 'IMIX_v4_1' +| | ... | ${1518} | ${framesize} +| | # swo := size_with_overhead +| | ${avg_swo} = | Evaluate | ${avg_size} + ${overhead} +| | ${max_swo} = | Evaluate | ${max_size} + ${overhead} +| | ${jumbo} = | Set Variable If | ${max_swo} < 1522 +| | ... | ${False} | ${True} +| | # For testing None see: https://groups.google.com/\ +| | # forum/#!topic/robotframework-users/XntFz0ocD9E +| | ${limit_set} = | Set Variable | ${pps_limit != None} +| | ${rate} = | Evaluate | (${bps_limit}/((${avg_swo}+20)*8)).__trunc__() +| | ${max_rate} = | Set Variable If | ${limit_set} and ${rate} > ${pps_limit} +| | ... | ${pps_limit} | ${rate} +| | Return From Keyword | ${max_rate} | ${jumbo} + +| Get Max Rate And Jumbo And Handle Multi Seg +| | [Documentation] +| | ... | This keyword adds correct multi seg configuration, +| | ... | then returns the result of Get Max Rate And Jumbo keyword. +| | ... +| | ... | See Documentation of Get Max Rate And Jumbo for more details. +| | ... +| | ... | *Arguments:* +| | ... | - bps_limit - Line rate limit in bps. Type: integer +| | ... | - framesize - Framesize in bytes. Type: integer or string +| | ... | - overhead - Overhead in bytes. Default: 0. Type: integer +| | ... | - pps_limit - NIC limit rate value in pps. Type: integer or None +| | ... +| | ... | *Returns:* +| | ... | - 2-tuple, consisting of: +| | ... | - Calculated unidirectional maximal transmit rate. +| | ... | Type: integer or float +| | ... | - Jumbo boolean, true if jumbo packet support has to be enabled. +| | ... | Type: boolean +| | ... +| | ... | *Example:* +| | ... +| | ... | \| Get Max Rate And Jumbo And Handle Multi Seg | \${10000000} \ +| | ... | \| IMIX_v4_1 \| overhead=\${40} \| pps_limit=\${18750000} \| +| | ... +| | [Arguments] | ${bps_limit} | ${framesize} +| | ... | ${overhead}=${0} | ${pps_limit}=${None} +| | ... +| | ${max_rate} | ${jumbo} = | Get Max Rate And Jumbo +| | ... | ${bps_limit} | ${framesize} | ${overhead} | ${pps_limit} +| | Run Keyword If | not ${jumbo} | Add no multi seg to all DUTs +| | Return From Keyword | ${max_rate} | ${jumbo} + | Calculate pps | | [Documentation] | | ... | Calculate pps for given rate and L2 frame size, | | ... | additional 20B are added to L2 frame size as padding. | | ... +| | ... | FIXME: Migrate callers to Get Max Rate And Jumbo +| | ... | | ... | *Arguments* | | ... | - bps - Rate in bps. Type: integer | | ... | - framesize - L2 frame size in Bytes. Type: integer @@ -65,6 +154,8 @@ | | ... | in stream, or set of packets in case of IMIX type or simmilar. | | ... | This keyword returns average framesize. | | ... +| | ... | FIXME: Migrate callers to Get Max Rate And Jumbo +| | ... | | ... | *Arguments:* | | ... | - framesize - Framesize. Type: integer or string | | ... @@ -74,18 +165,9 @@ | | ... | | [Arguments] | ${framesize} | | ... -| | Run Keyword If | '${framesize}' == 'IMIX_v4_1' -| | ... | Return From Keyword | 353.83333 +| | Return From Keyword If | '${framesize}' == 'IMIX_v4_1' | ${353.83333} | | Return From Keyword | ${framesize} -| Is DPDK performance test -| | [Documentation] -| | ... | Return TRUE if variable DPDK_TEST exist, otherwise FALSE. -| | ${ret} | ${tmp}= | Run Keyword And Ignore Error -| | ... | Variable Should Exist | ${DPDK_TEST} -| | Return From Keyword If | "${ret}" == "PASS" | ${True} -| | Return From Keyword | ${False} - | Find NDR using linear search and pps | | [Documentation] | | ... | Find throughput by using RFC2544 linear search with non drop rate. @@ -363,6 +445,170 @@ | | ... | ${framesize} | ${topology_type} | ${loss_acceptance} | | ... | ${loss_acceptance_type} | fail_on_loss=${False} +| Find NDR and PDR intervals using optimized search +| | [Documentation] +| | ... | Find boundaries for RFC2544 compatible NDR and PDR values +| | ... | using an optimized search algorithm. +| | ... | Display results as formatted test message. +| | ... | Fail if a resulting lower bound has too high loss fraction. +| | ... | Proceed with Perform additional measurements based on NDRPDR result. +| | ... | Input rates are understood as uni-directional, +| | ... | reported result contains bi-directional rates. +| | ... +| | ... | TODO: Should the trial duration of the additional +| | ... | measurements be configurable? +| | ... +| | ... | *Arguments:* +| | ... | - frame_size - L2 Frame Size [B] or IMIX string. Type: int or str +| | ... | - topology_type - Topology type. Type: string +| | ... | - minimum_transmit_rate - Lower limit of search [pps]. Type: float +| | ... | - maximum_transmit_rate - Upper limit of search [pps]. Type: float +| | ... | - packet_loss_ratio - Accepted loss during search. Type: float +| | ... | - final_relative_width - Maximal width multiple of upper. Type: float +| | ... | - final_trial_duration - Duration of final trials [s]. Type: float +| | ... | - initial_trial_duration - Duration of initial trials [s]. Type: float +| | ... | - intermediate phases - Number of intermediate phases [1]. Type: int +| | ... | - timeout - Fail if search duration is longer [s]. Type: float +| | ... +| | ... | *Example:* +| | ... +| | ... | \| Find NDR and PDR intervals using optimized search \| \${64} \| \ +| | ... | 3-node-IPv4 \| \${100000} \| \${14880952} \| \${0.005} \| \${0.005} \ +| | ... | \| \${30.0} \| \${1.0} \| \${2} \| ${600.0} \| +| | ... +| | [Arguments] | ${frame_size} | ${topology_type} | ${minimum_transmit_rate} +| | ... | ${maximum_transmit_rate} | ${packet_loss_ratio}=${0.005} +| | ... | ${final_relative_width}=${0.005} | ${final_trial_duration}=${30.0} +| | ... | ${initial_trial_duration}=${1.0} +| | ... | ${number_of_intermediate_phases}=${2} | ${timeout}=${720.0} +| | ... +| | ${result} = | Perform optimized ndrpdr search | ${frame_size} +| | ... | ${topology_type} | ${minimum_transmit_rate*2} +| | ... | ${maximum_transmit_rate*2} | ${packet_loss_ratio} +| | ... | ${final_relative_width} | ${final_trial_duration} +| | ... | ${initial_trial_duration} | ${number_of_intermediate_phases} +| | ... | timeout=${timeout} +| | Display result of NDRPDR search | ${result} | ${frame_size} +| | Check NDRPDR interval validity | ${result.pdr_interval} +| | ... | ${packet_loss_ratio} +| | Check NDRPDR interval validity | ${result.ndr_interval} +| | Perform additional measurements based on NDRPDR result +| | ... | ${result} | ${frame_size} | ${topology_type} + +| Display single bound +| | [Documentation] +| | ... | Display one bound of NDR+PDR search, +| | ... | in packet per seconds (total and per stream) +| | ... | and Gbps total bandwidth with untagged packet. +| | ... | Througput is calculated as: +| | ... | Measured rate per stream * Total number of streams +| | ... | Bandwidth is calculated as: +| | ... | (Throughput * (L2 Frame Size + IPG) * 8) / Max bitrate of NIC +| | ... | The given result should contain latency data as well. +| | ... +| | ... | *Arguments:* +| | ... | - text - Flavor text describing which bound is this. Type: string +| | ... | - rate_total - Total (not per stream) measured Tr [pps]. Type: float +| | ... | - framesize - L2 Frame Size [B]. Type: integer +| | ... | - latency - Latency data to display if non-empty. Type: string +| | ... +| | ... | *Example:* +| | ... +| | ... | \| Display single bound \| NDR lower bound \| \${12345.67} \ +| | ... | \| \${64} \| show_latency=\${EMPTY} \| +| | ... +| | [Arguments] | ${text} | ${rate_total} | ${framesize} | ${latency}=${EMPTY} +| | ... +| | ${bandwidth_total}= | Evaluate | ${rate_total}*(${framesize}+20)*8/(10**9) +| | Set Test Message | ${\n}${text}: ${rate_total} pps, | append=yes +| | Set Test Message | ${bandwidth_total} Gbps (untagged) | append=yes +| | Return From Keyword If | not """${latency}""" +| | Set Test Message | ${\n}LATENCY usec [min/avg/max] per stream: ${latency} +| | ... | append=yes + +| Display result of NDRPDR search +| | [Documentation] +| | ... | Display result of NDR+PDR search, both quantities, both bounds, +| | ... | in packet per seconds (total and per stream) +| | ... | and Gbps total bandwidth with untagged packet. +| | ... | Througput is calculated as: +| | ... | Measured rate per stream * Total number of streams +| | ... | Bandwidth is calculated as: +| | ... | (Throughput * (L2 Frame Size + IPG) * 8) / Max bitrate of NIC +| | ... | The given result should contain latency data as well. +| | ... +| | ... | *Arguments:* +| | ... | - result - Measured result data per stream [pps]. Type: NdrPdrResult +| | ... | - framesize - L2 Frame Size [B]. Type: integer +| | ... +| | ... | *Example:* +| | ... +| | ... | \| Display result of NDRPDR search \| \${result} \| \${64} \| +| | ... +| | [Arguments] | ${result} | ${framesize} +| | ... +| | ${framesize}= | Get Frame Size | ${framesize} +| | Display single bound | NDR_LOWER +| | ... | ${result.ndr_interval.measured_low.transmit_rate} | ${framesize} +| | ... | ${result.ndr_interval.measured_low.latency} +| | Display single bound | NDR_UPPER +| | ... | ${result.ndr_interval.measured_high.transmit_rate} | ${framesize} +| | Display single bound | PDR_LOWER +| | ... | ${result.pdr_interval.measured_low.transmit_rate} | ${framesize} +| | ... | ${result.pdr_interval.measured_low.latency} +| | Display single bound | PDR_UPPER +| | ... | ${result.pdr_interval.measured_high.transmit_rate} | ${framesize} + +| Check NDRPDR interval validity +| | [Documentation] +| | ... | Extract loss ratio of lower bound of the interval. +| | ... | Fail if it does not reach the allowed value. +| | ... +| | ... | *Arguments:* +| | ... | - interval - Measured interval. Type: ReceiveRateInterval +| | ... | - packet_loss_ratio - Accepted loss (0.0 for NDR). Type: float +| | ... +| | ... | *Example:* +| | ... +| | ... | \| Check NDRPDR interval validity \| \${result.pdr_interval} \ +| | ... | \| \${0.005} \| +| | ... +| | [Arguments] | ${interval} | ${packet_loss_ratio}=${0.0} +| | ... +| | ${lower_bound_lf} = | Set Variable | ${interval.measured_low.loss_fraction} +| | Return From Keyword If | ${lower_bound_lf} <= ${packet_loss_ratio} +| | ${message}= | Catenate | SEPARATOR=${SPACE} +| | ... | Minimal rate loss fraction ${lower_bound_lf} +| | ... | does not reach target ${packet_loss_ratio}. +| | ${message} = | Set Variable If | ${lower_bound_lf} >= 1.0 +| | ... | ${message}${\n}Zero packets forwarded! | ${message} +| | Fail | ${message} + +| Perform additional measurements based on NDRPDR result +| | [Documentation] +| | ... | Perform any additional measurements which are not directly needed +| | ... | for determining NDR nor PDR, but which are needed for gathering +| | ... | additional data for debug purposes. +| | ... | Currently, just "Traffic should pass with no loss" is called. +| | ... | TODO: Move latency measurements from optimized search here. +| | ... +| | ... | *Arguments:* +| | ... | - result - Measured result data per stream [pps]. Type: NdrPdrResult +| | ... | - frame_size - L2 Frame Size [B] or IMIX string. Type: int or str +| | ... | - topology_type - Topology type. Type: string +| | ... +| | ... | *Example:* +| | ... | \| Perform additional measurements based on NDRPDR result \ +| | ... | \| \${result} \| ${64} \| 3-node-IPv4 \| +| | ... +| | [Arguments] | ${result} | ${framesize} | ${topology_type} +| | ... +| | ${duration}= | Set Variable | 5.0 +| | ${rate_per_stream}= | Evaluate +| | ... | ${result.ndr_interval.measured_low.target_tr} / 2.0 +| | Traffic should pass with no loss | ${duration} | ${rate_per_stream}pps +| | ... | ${framesize} | ${topology_type} | fail_on_loss=${False} + | Display result of NDR search | | [Documentation] | | ... | Display result of NDR search in packet per seconds (total and per @@ -435,30 +681,6 @@ | | ... | ${\n}LOSS_ACCEPTANCE: ${loss_acceptance} ${loss_acceptance_type} | | ... | append=yes -| Display raw results -| | [Documentation] -| | ... | Display raw results from TG in total received/send packets over trial -| | ... | duration in seconds. -| | ... -| | ... | *Arguments:* -| | ... | - framesize - L2 Frame Size [B]. Type: integer -| | ... | - results - Measured results. Type: string -| | ... -| | ... | *Example:* -| | ... -| | ... | \| Display raw results \| 64 \| results \| -| | ... -| | [Arguments] | ${framesize} | ${results} -| | ... -| | ${framesize}= | Get Frame Size | ${framesize} -| | @{tokens}= | Split String | ${results} | , -| | @{received}= | Split String | @{tokens}[1] | = -| | @{sent}= | Split String | @{tokens}[2] | = -| | ${total_received} = | Set Variable | @{received}[1] -| | ${total_sent} = | Set Variable | @{sent}[1] -| | Set Test Message | MaxReceivedRate_Results [pkts/${perf_trial_duration}sec]: -| | Set Test Message | tx ${total_sent}, rx ${total_received} | append=yes - | Measure latency pps | | [Documentation] | | ... | Send traffic at specified rate. Measure min/avg/max latency @@ -537,52 +759,67 @@ | | ... | Send traffic at maximum rate. | | ... | | ... | *Arguments:* -| | ... | - duration - Duration of traffic run [s]. Type: integer | | ... | - rate - Rate for sending packets. Type: string | | ... | - framesize - L2 Frame Size [B] or IMIX_v4_1. Type: integer/string | | ... | - topology_type - Topology type. Type: string -| | ... | Type: boolean +| | ... | - subsamples - How many trials in this measurement. Type:int +| | ... | - trial_duration - Duration of single trial [s]. Type: float +| | ... | - fail_no_traffic - Whether to fail on zero receive count. Type: boolean | | ... | | ... | *Example:* | | ... -| | ... | \| Traffic should pass with no loss \| 10 \| 4.0mpps \| 64 \ -| | ... | \| 3-node-IPv4 \| +| | ... | \| Traffic should pass with maximum rate \| 4.0mpps \| 64 \ +| | ... | \| 3-node-IPv4 \| ${1} \| ${10.0} | ${False} \| | | ... -| | [Arguments] | ${duration} | ${rate} | ${framesize} | ${topology_type} +| | [Arguments] | ${rate} | ${framesize} | ${topology_type} +| | ... | ${trial_duration}=${perf_trial_duration} | ${fail_no_traffic}=${True} +| | ... | ${subsamples}=${perf_trial_multiplicity} | | ... -| | ${results}= | Send traffic at specified rate | ${duration} | ${rate} -| | ... | ${framesize} | ${topology_type} -| | Display raw results | ${framesize} | ${results} +| | ${results} = | Send traffic at specified rate | ${trial_duration} | ${rate} +| | ... | ${framesize} | ${topology_type} | ${subsamples} +| | Set Test Message | ${\n}Maximum Receive Rate trial results +| | Set Test Message | in packets per second: ${results} +| | ... | append=yes +| | # TODO: Should we also report the percentage relative to transmit rate, +| | # so that people looking at console can decide how close to 100% it is? +| | Run Keyword If | ${fail_no_traffic} | Fail if no traffic forwarded | Send traffic at specified rate | | [Documentation] | | ... | Send traffic at specified rate. +| | ... | Return list of measured receive rates. | | ... | | ... | *Arguments:* -| | ... | - duration - Duration of traffic run [s]. Type: integer +| | ... | - trial_duration - Duration of single trial [s]. Type: float | | ... | - rate - Rate for sending packets. Type: string | | ... | - framesize - L2 Frame Size [B]. Type: integer/string | | ... | - topology_type - Topology type. Type: string -| | ... | Type: boolean +| | ... | - subsamples - How many trials in this measurement. Type: int | | ... | | ... | *Example:* | | ... -| | ... | \| Send traffic at specific rate \| 10 \| 4.0mpps \| 64 \ -| | ... | \| 3-node-IPv4 \| +| | ... | \| Send traffic at specified rate \| ${1.0} \| 4.0mpps \| 64 \ +| | ... | \| 3-node-IPv4 \| ${10} \| | | ... -| | [Arguments] | ${duration} | ${rate} | ${framesize} | ${topology_type} +| | [Arguments] | ${trial_duration} | ${rate} | ${framesize} +| | ... | ${topology_type} | ${subsamples}=${1} | | ... -| | Clear and show runtime counters with running traffic | ${duration} +| | Clear and show runtime counters with running traffic | ${trial_duration} | | ... | ${rate} | ${framesize} | ${topology_type} -| | ${ret}= | Is DPDK performance test -| | Run Keyword If | ${ret}==${False} | Clear all counters on all DUTs -| | Run Keyword If | ${ret}==${False} and ${pkt_trace}==${True} +| | Run Keyword If | ${dut_stats}==${True} | Clear all counters on all DUTs +| | Run Keyword If | ${dut_stats}==${True} and ${pkt_trace}==${True} | | ... | VPP Enable Traces On All DUTs | ${nodes} -| | ${results} = | Send traffic on tg | ${duration} | ${rate} | ${framesize} -| | ... | ${topology_type} | warmup_time=0 -| | Run Keyword If | ${ret}==${False} | Show statistics on all DUTs | ${nodes} -| | Run Keyword If | ${ret}==${False} and ${pkt_trace}==${True} -| | ... | Show Packet Trace On All Duts | ${nodes} +| | ${results} = | Create List +| | :FOR | ${i} | IN RANGE | ${subsamples} +| | | Send traffic on tg | ${trial_duration} | ${rate} | ${framesize} +| | | ... | ${topology_type} | warmup_time=0 +| | | ${rx} = | Get Received +| | | ${rr} = | Evaluate | ${rx} / ${trial_duration} +| | | Append To List | ${results} | ${rr} +| | Run Keyword If | ${dut_stats}==${True} | Show statistics on all DUTs +| | ... | ${nodes} +| | Run Keyword If | ${dut_stats}==${True} and ${pkt_trace}==${True} +| | ... | Show Packet Trace On All Duts | ${nodes} | maximum=${100} | | Return From Keyword | ${results} | Clear and show runtime counters with running traffic @@ -606,10 +843,9 @@ | | ... | | Send traffic on tg | -1 | ${rate} | ${framesize} | ${topology_type} | | ... | warmup_time=0 | async_call=${True} | latency=${False} -| | ${ret}= | Is DPDK performance test -| | Run Keyword If | ${ret}==${False} +| | Run Keyword If | ${dut_stats}==${True} | | ... | Clear runtime counters on all DUTs | ${nodes} | | Sleep | ${duration} -| | Run Keyword If | ${ret}==${False} +| | Run Keyword If | ${dut_stats}==${True} | | ... | Show runtime counters on all DUTs | ${nodes} | | Stop traffic on tg