Change:
// Tests network performance using iperf or other containers. import ( <ins> "context" </ins> "fmt" <ins> discoveryv1beta1 "k8s.io/api/discovery/v1beta1" </ins> "time" "github.com/onsi/ginkgo" <ins> appsv1 "k8s.io/api/apps/v1" </ins> v1 "k8s.io/api/core/v1" <ins> metav1 "k8s.io/apimachinery/pkg/apis/meta/v1" "k8s.io/apimachinery/pkg/util/wait" clientset "k8s.io/client-go/kubernetes" </ins> "k8s.io/kubernetes/test/e2e/framework" <ins> e2edeployment "k8s.io/kubernetes/test/e2e/framework/deployment" </ins> e2enode "k8s.io/kubernetes/test/e2e/framework/node" <del> e2eservice "k8s.io/kubernetes/test/e2e/framework/service" </del> imageutils "k8s.io/kubernetes/test/utils/image" ) const ( <del> // empirically derived as a baseline for expectations from running this test using kube-up.sh. gceBandwidthBitsEstimate = int64(30000000000) // on 4 node clusters, we found this test passes very quickly, generally in less then 100 seconds. smallClusterTimeout = 200 * time.Second </del> <ins> // use this timeout for larger clusters largeClusterTimeout = 400 * time.Second // iperf2BaselineBandwidthMegabytesPerSecond sets a baseline for iperf2 bandwidth of 90 MB/s iperf2BaselineBandwidthMegabytesPerSecond = 90 // iperf2Port selects an arbitrary, unique port to run iperf2's client and server on iperf2Port = 6789 // labelKey is used as a key for selectors labelKey = "app" // clientLabelValue is used as a value for iperf2 client selectors clientLabelValue = "iperf2-client" // serverLabelValue is used as a value for iperf2 server selectors serverLabelValue = "iperf2-server" // serverServiceName defines the service name used for the iperf2 server serverServiceName = "iperf2-server" </ins> ) <del> // Declared as Flakey since it has not been proven to run in parallel on small nodes or slow networks in CI var _ = SIGDescribe("Networking IPerf [Experimental] [Slow] [Feature:Networking-Performance]", func() { </del> <ins> func iperf2ServerDeployment(client clientset.Interface, namespace string, isIPV6 bool) (*appsv1.Deployment, error) { framework.Logf("deploying iperf2 server") one := int64(1) replicas := int32(1) labels := map[string]string{labelKey: serverLabelValue} args := []string{ "-s", "-p", fmt.Sprintf("%d", iperf2Port), } if isIPV6 { args = append(args, "-V") } deploymentSpec := &appsv1.Deployment{ ObjectMeta: metav1.ObjectMeta{ Name:   "iperf2-server-deployment", Labels: labels, }, Spec: appsv1.DeploymentSpec{ Replicas: &replicas, Selector: &metav1.LabelSelector{ MatchLabels: labels, }, Template: v1.PodTemplateSpec{ ObjectMeta: metav1.ObjectMeta{ Labels: labels, }, Spec: v1.PodSpec{ TerminationGracePeriodSeconds: &one, Containers: []v1.Container{ { Name:    "iperf2-server", Image:   imageutils.GetE2EImage(imageutils.Agnhost), Command: []string{"iperf"}, Args:    args, Ports: []v1.ContainerPort{ { ContainerPort: iperf2Port, Protocol:      v1.ProtocolTCP, }, }, }, }, }, }, }, } </ins> <del> f := framework.NewDefaultFramework("network-perf") </del> <ins> deployment, err := client.AppsV1().Deployments(namespace).Create(context.TODO(), deploymentSpec, metav1.CreateOptions{}) if err != nil { return nil, fmt.Errorf("deployment %q Create API error: %v", deploymentSpec.Name, err) } framework.Logf("Waiting for deployment %q to complete", deploymentSpec.Name) err = e2edeployment.WaitForDeploymentComplete(client, deployment) if err != nil { return nil, fmt.Errorf("deployment %q failed to complete: %v", deploymentSpec.Name, err) } </ins> <del> // A few simple bandwidth tests which are capped by nodes. // TODO replace the 1 with the scale option implementation // TODO: Make this a function parameter, once we distribute iperf endpoints, possibly via session affinity. numClient := 1 numServer := 1 maxBandwidthBits := gceBandwidthBitsEstimate </del> <ins> return deployment, nil } </ins> <del> familyStr := "" if framework.TestContext.ClusterIsIPv6() { familyStr = "-V " </del> <ins> func iperf2ServerService(client clientset.Interface, namespace string) (*v1.Service, error) { service := &v1.Service{ ObjectMeta: metav1.ObjectMeta{Name: serverServiceName}, Spec: v1.ServiceSpec{ Selector: map[string]string{ labelKey: serverLabelValue, }, Ports: []v1.ServicePort{ {Protocol: v1.ProtocolTCP, Port: iperf2Port}, }, }, </ins> } <ins> return client.CoreV1().Services(namespace).Create(context.TODO(), service, metav1.CreateOptions{}) } </ins> <del> ginkgo.It(fmt.Sprintf("should transfer ~ 1GB onto the service endpoint %v servers (maximum of %v clients)", numServer, numClient), func() { nodes, err := e2enode.GetReadySchedulableNodes(f.ClientSet) framework.ExpectNoError(err) totalPods := len(nodes.Items) // for a single service, we expect to divide bandwidth between the network.  Very crude estimate. expectedBandwidth := int(float64(maxBandwidthBits) / float64(totalPods)) appName := "iperf-e2e" _, err = e2eservice.CreateServiceForSimpleAppWithPods( f.ClientSet, 8001, 8002, f.Namespace.Name, appName, func(n v1.Node) v1.PodSpec { return v1.PodSpec{ Containers: []v1.Container{{ Name:    "iperf-server", Image:   imageutils.GetE2EImage(imageutils.Agnhost), Command: []string{"/bin/sh"}, Args: []string{ "-c", "/usr/local/bin/iperf " + familyStr + "-s -p 8001 ", }, Ports: []v1.ContainerPort{{ContainerPort: 8001}}, }}, NodeName:      n.Name, RestartPolicy: v1.RestartPolicyOnFailure, } </del> <ins> func iperf2ClientDaemonSet(client clientset.Interface, namespace string) (*appsv1.DaemonSet, error) { one := int64(1) labels := map[string]string{labelKey: clientLabelValue} spec := &appsv1.DaemonSet{ ObjectMeta: metav1.ObjectMeta{ Name:   "iperf2-clients", Labels: labels, }, Spec: appsv1.DaemonSetSpec{ Selector: &metav1.LabelSelector{ MatchLabels: labels, </ins> }, <del> // this will be used to generate the -service name which all iperf clients point at. numServer, // Generally should be 1 server unless we do affinity or use a version of iperf that supports LB true,      // Make sure we wait, otherwise all the clients will die and need to restart. ) if err != nil { framework.Failf("Fatal error waiting for iperf server endpoint : %v", err) } iperfClientPodLabels := e2enode.CreatePodsPerNodeForSimpleApp( f.ClientSet, f.Namespace.Name, "iperf-e2e-cli", func(n v1.Node) v1.PodSpec { return v1.PodSpec{ </del> <ins> Template: v1.PodTemplateSpec{ ObjectMeta: metav1.ObjectMeta{ Labels: labels, }, Spec: v1.PodSpec{ </ins> Containers: []v1.Container{ { <del> Name:    "iperf-client", </del> <ins> Name:    "iperf2-client", </ins> Image:   imageutils.GetE2EImage(imageutils.Agnhost), <del> Command: []string{"/bin/sh"}, Args: []string{ "-c", "/usr/local/bin/iperf " + familyStr + "-c service-for-" + appName + " -p 8002 --reportstyle C && sleep 5", }, </del> <ins> Command: []string{"/agnhost"}, Args:    []string{"pause"}, </ins> }, }, <del> RestartPolicy: v1.RestartPolicyOnFailure, // let them successfully die. } </del> <ins> TerminationGracePeriodSeconds: &one, }, </ins> }, <del> numClient, ) expectedCli := numClient if len(nodes.Items) < expectedCli { expectedCli = len(nodes.Items) </del> <ins> }, Status: appsv1.DaemonSetStatus{}, } ds, err := client.AppsV1().DaemonSets(namespace).Create(context.TODO(), spec, metav1.CreateOptions{}) if err != nil { return nil, fmt.Errorf("daemonset %s Create API error: %v", spec.Name, err) } return ds, nil } // Test summary: //   This test uses iperf2 to obtain bandwidth data between nodes in the cluster, providing a coarse measure //   of the health of the cluster network.  The test runs two sets of pods: //     1. an iperf2 server on a single node //     2. a daemonset of iperf2 clients //   The test then iterates through the clients, one by one, running iperf2 from each of them to transfer //   data to the server and back for ten seconds, after which the results are collected and parsed. //   Thus, if your cluster has 10 nodes, then 10 test runs are performed. //     Note: a more complete test could run this scenario with a daemonset of servers as well; however, this //     would require n^2 tests, n^2 time, and n^2 network resources which quickly become prohibitively large //     as the cluster size increases. //   Finally, after collecting all data, the results are analyzed and tabulated. var _ = SIGDescribe("Networking IPerf2 [Feature:Networking-Performance]", func() { // this test runs iperf2: one pod as a server, and a daemonset of clients f := framework.NewDefaultFramework("network-perf") ginkgo.It(fmt.Sprintf("should run iperf2"), func() { readySchedulableNodes, err := e2enode.GetReadySchedulableNodes(f.ClientSet) framework.ExpectNoError(err) familyStr := "" if framework.TestContext.ClusterIsIPv6() { familyStr = "-V " </ins> } <del> framework.Logf("Reading all perf results to stdout.") framework.Logf("date,cli,cliPort,server,serverPort,id,interval,transferBits,bandwidthBits") </del> <ins> serverPodsListOptions := metav1.ListOptions{ LabelSelector: fmt.Sprintf("%s=%s", labelKey, serverLabelValue), } </ins> <del> // Extra 1/10 second per client. iperfTimeout := smallClusterTimeout + (time.Duration(expectedCli/10) * time.Second) iperfResults := &IPerfResults{} </del> <ins> // Step 1: set up iperf2 server -- a single pod on any node _, err = iperf2ServerDeployment(f.ClientSet, f.Namespace.Name, framework.TestContext.ClusterIsIPv6()) framework.ExpectNoError(err, "deploy iperf2 server deployment") </ins> <del> iperfClusterVerification := f.NewClusterVerification( f.Namespace, framework.PodStateVerification{ Selectors:   iperfClientPodLabels, ValidPhases: []v1.PodPhase{v1.PodSucceeded}, }, ) pods, err2 := iperfClusterVerification.WaitFor(expectedCli, iperfTimeout) if err2 != nil { framework.Failf("Error in wait...") } else if len(pods) < expectedCli { framework.Failf("IPerf restuls : Only got %v out of %v, after waiting %v", len(pods), expectedCli, iperfTimeout) } else { // For each builds up a collection of IPerfRecords iperfClusterVerification.ForEach( func(p v1.Pod) { resultS, err := framework.LookForStringInLog(f.Namespace.Name, p.Name, "iperf-client", "0-", 1*time.Second) if err == nil { framework.Logf(resultS) iperfResults.Add(NewIPerf(resultS)) } else { framework.Failf("Unexpected error, %v when running forEach on the pods.", err) } }) </del> <ins> _, err = iperf2ServerService(f.ClientSet, f.Namespace.Name) framework.ExpectNoError(err, "deploy iperf2 server service") // Step 2: set up iperf2 client daemonset //   initially, the clients don't do anything -- they simply pause until they're called _, err = iperf2ClientDaemonSet(f.ClientSet, f.Namespace.Name) framework.ExpectNoError(err, "deploy iperf2 client daemonset") // Make sure the server is ready to go framework.Logf("waiting for iperf2 server endpoints") err = wait.Poll(2*time.Second, largeClusterTimeout, func() (done bool, err error) { listOptions := metav1.ListOptions{LabelSelector: fmt.Sprintf("%s=%s", discoveryv1beta1.LabelServiceName, serverServiceName)} esList, err := f.ClientSet.DiscoveryV1beta1().EndpointSlices(f.Namespace.Name).List(context.TODO(), listOptions) framework.ExpectNoError(err, "Error fetching EndpointSlice for Service %s/%s", f.Namespace.Name, serverServiceName) if len(esList.Items) == 0 { framework.Logf("EndpointSlice for Service %s/%s not found", f.Namespace.Name, serverServiceName) return false, nil } return true, nil }) framework.ExpectNoError(err, "unable to wait for endpoints for the iperf service") framework.Logf("found iperf2 server endpoints") clientPodsListOptions := metav1.ListOptions{ LabelSelector: fmt.Sprintf("%s=%s", labelKey, clientLabelValue), } framework.Logf("waiting for client pods to be running") var clientPodList *v1.PodList err = wait.Poll(2*time.Second, largeClusterTimeout, func() (done bool, err error) { clientPodList, err = f.ClientSet.CoreV1().Pods(f.Namespace.Name).List(context.TODO(), clientPodsListOptions) if err != nil { return false, err } if len(clientPodList.Items) < len(readySchedulableNodes.Items) { return false, nil } for _, pod := range clientPodList.Items { if pod.Status.Phase != v1.PodRunning { return false, nil } } return true, nil }) framework.ExpectNoError(err, "unable to wait for client pods to come up") framework.Logf("all client pods are ready: %d pods", len(clientPodList.Items)) // Get a reference to the server pod for later serverPodList, err := f.ClientSet.CoreV1().Pods(f.Namespace.Name).List(context.TODO(), serverPodsListOptions) framework.ExpectNoError(err) if len(serverPodList.Items) != 1 { framework.Failf("expected 1 server pod, found %d", len(serverPodList.Items)) </ins> } <del> fmt.Println("[begin] Node,Bandwidth CSV") fmt.Println(iperfResults.ToTSV()) fmt.Println("[end] Node,Bandwidth CSV") </del> <ins> serverPod := serverPodList.Items[0] framework.Logf("server pod phase %s", serverPod.Status.Phase) for i, condition := range serverPod.Status.Conditions { framework.Logf("server pod condition %d: %+v", i, condition) } for i, cont := range serverPod.Status.ContainerStatuses { framework.Logf("server pod container status %d: %+v", i, cont) } framework.Logf("found %d matching client pods", len(clientPodList.Items)) nodeResults := &IPerf2NodeToNodeCSVResults{ ServerNode: serverPod.Spec.NodeName, Results:    map[string]*IPerf2EnhancedCSVResults{}, } // Step 3: iterate through the client pods one by one, running iperf2 in client mode to transfer //   data to the server and back and measure bandwidth for _, pod := range clientPodList.Items { podName := pod.Name nodeName := pod.Spec.NodeName iperfVersion := f.ExecShellInPod(podName, "iperf -v || true") framework.Logf("iperf version: %s", iperfVersion) </ins> <del> for ipClient, bandwidth := range iperfResults.BandwidthMap { framework.Logf("%v had bandwidth %v.  Ratio to expected (%v) was %f", ipClient, bandwidth, expectedBandwidth, float64(bandwidth)/float64(expectedBandwidth)) </del> <ins> for try := 0; ; try++ { /* iperf2 command parameters: *  -e: use enhanced reporting giving more tcp/udp and traffic information *  -p %d: server port to connect to *  --reportstyle C: report as Comma-Separated Values *  -i 1: seconds between periodic bandwidth reports *  -c %s: run in client mode, connecting to <host> */ command := fmt.Sprintf(`iperf %s -e -p %d --reportstyle C -i 1 -c %s && sleep 5`, familyStr, iperf2Port, serverServiceName) framework.Logf("attempting to run command '%s' in client pod %s (node %s)", command, podName, nodeName) output := f.ExecShellInPod(podName, command) framework.Logf("output from exec on client pod %s (node %s): n%sn", podName, nodeName, output) results, err := ParseIPerf2EnhancedResultsFromCSV(output) if err == nil { nodeResults.Results[nodeName] = results break } else if try == 2 { framework.ExpectNoError(err, "unable to parse iperf2 output from client pod %s (node %s)", pod.Name, nodeName) } else { framework.Logf("Retrying: IPerf run failed: %+v", err) } } } // Step 4: after collecting all the client<->server data, compile and present the results /* Example output: Dec 22 07:52:41.102: INFO:                                From                                 To    Bandwidth (MB/s) Dec 22 07:52:41.102: INFO:              three-node-ipv6-worker            three-node-ipv6-worker2                2381 Dec 22 07:52:41.102: INFO:             three-node-ipv6-worker2            three-node-ipv6-worker2                2214 Dec 22 07:52:41.102: INFO:             three-node-ipv6-worker3            three-node-ipv6-worker2                3123 */ framework.Logf("%35s%35s%20s", "From", "To", "Bandwidth (MB/s)") for nodeFrom, results := range nodeResults.Results { framework.Logf("%35s%35s%20d", nodeFrom, nodeResults.ServerNode, results.Total.bandwidthMB()) } for clientNode, results := range nodeResults.Results { megabytesPerSecond := results.Total.bandwidthMB() if megabytesPerSecond < iperf2BaselineBandwidthMegabytesPerSecond { framework.Failf("iperf2 MB/s received below baseline of %d for client %s to server %s: %d", iperf2BaselineBandwidthMegabytesPerSecond, clientNode, nodeResults.ServerNode, megabytesPerSecond) } </ins> } }) })

Discussion:
What happened: The iperf tests were written a while ago but i think havent been updated. They measure bandwidth over multiple pods, but they probably should also have a test which reports individual pod's bandwidth between one pod over a SEP. They should pretty print a table so its easy to see exactly what is going on with the bandwidth They should use iperf3 (need to check that) Maybe we should have permutations for udp and tcp? The current output is something like: What you expected to happen: That running the tests would result in a table such as those that you can get from iperf3, i.e. How to reproduce it: run the e2es on any cluster, Environment: Kubernetes version (use ): master, any version
/sig network
/assign
/assign
/triage unresolved Comment when the issue is assessed and confirmed. I am a bot run by vllry. ‍
/remove-triage unresolved
I've taken a first pass at this , working on resolving a couple issues then we can circle back to determine how else it could be improved!
Cool c/p the new test output so we can compare when u get a chance
ah yess. much better then what we have now.
Issues go stale after 90d of inactivity. Mark the issue as fresh with . Stale issues rot after an additional 30d of inactivity and eventually close. If this issue is safe to close now please do so with . Send feedback to sig-testing, kubernetes/test-infra and/or . /lifecycle stale
/remove-lifecycle stale