Traffic Mirroring

    • You need to enable KubeSphere Service Mesh.
    • You need to create a workspace, a project and an account (). The account must be invited to the project with the role of operator. For more information, see .
    • You need to enable Application Governance and have an available app so that you can mirror the traffic of it. The sample app used in this tutorial is Bookinfo. For more information, see Deploy Bookinfo and Manage Traffic.

    1. Log in to KubeSphere as project-regular. Under Categories, click Create Job on the right of Traffic Mirroring.

    2. Set a name for it and click Next.

      traffic-mirroring-2

    3. Select your app from the drop-down list and the service of which you want to mirror the traffic. If you also use the sample app Bookinfo, select reviews and click Next.

    4. On the Grayscale Release Version page, add another version of it (e.g. v2) as shown in the image below and click Next:

      traffic-mirroring-4

      The image version is v2 in the screenshot.

    5. Click Create in the final step.

    6. You can see the traffic is being mirrored to v2 with real-time traffic displaying in the line chart.

      traffic-mirroring-6

    7. The new Deployment is created as well.

    8. You can directly get the virtual service to view mirror and weight by executing the following command:

      Note

      • When you execute the command above, replace demo-project with your own project (i.e. namespace) name.
      • If you want to execute the command from the web kubectl on the KubeSphere console, you need to use the account admin.

    9. Expected output:

      1. ...
      3.  hosts:
      4.  - reviews
      5.  http:
      6.    - destination:
      7.        host: reviews
      8.        port:
      9.          number: 9080
      10.        subset: v1
      11.      weight: 100
      13.      host: reviews
      14.      port:
      15.        number: 9080
      16.      subset: v2

      This route rule sends 100% of the traffic to v1. The last stanza specifies that you want to mirror to the service reviews v2. When traffic gets mirrored, the requests are sent to the mirrored service with their Host/Authority headers appended with -shadow. For example, cluster-1 becomes cluster-1-shadow.

      Note

      These requests are mirrored as “fire and forget”, which means that the responses are discarded. You can specify the field to mirror a fraction of the traffic, instead of mirroring all requests. If this field is absent, for compatibility with older versions, all traffic will be mirrored. For more information, see .

    You can remove the traffic mirroring job by clicking Job offline, which does not affect the current app version.