summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--docs/_include/interface-mirror.txt17
-rw-r--r--docs/configuration/interfaces/bonding.rst5
-rw-r--r--docs/configuration/interfaces/bridge.rst5
-rw-r--r--docs/configuration/interfaces/ethernet.rst5
4 files changed, 32 insertions, 0 deletions
diff --git a/docs/_include/interface-mirror.txt b/docs/_include/interface-mirror.txt
new file mode 100644
index 00000000..8cdbf77d
--- /dev/null
+++ b/docs/_include/interface-mirror.txt
@@ -0,0 +1,17 @@
+SPAN port mirroring can copy the inbound/outbound traffic of the interface to the
+specified interface, usually the interface can be connected to some special equipment,
+such as behavior control system, intrusion detection system and traffic collector,
+and can copy all related traffic from this port
+
+VyOS uses the `mirror` option to configure port mirroring. The configuration is divided
+into 2 different directions. Destination ports should be configured for different traffic directions.
+
+.. cfgcmd:: set interfaces {{ var0 }} <interface> mirror ingress <monitor-interface>
+
+ Configure port mirroring for `interface` inbound traffic and copy the traffic to `monitor-interface`
+
+.. cfgcmd:: set interfaces {{ var0 }} <interface> mirror egress <monitor-interface>
+
+ Configure port mirroring for `interface` outbound traffic and copy the traffic to `monitor-interface`
+
+
diff --git a/docs/configuration/interfaces/bonding.rst b/docs/configuration/interfaces/bonding.rst
index 8ec8f34d..547594e5 100644
--- a/docs/configuration/interfaces/bonding.rst
+++ b/docs/configuration/interfaces/bonding.rst
@@ -263,6 +263,11 @@ VLAN
:var0: bond
:var1: bond0
+Port Mirror (SPAN)
+==================
+.. cmdinclude:: ../../_include/interface-mirror.txt
+ :var0: ethernet
+
*******
Example
*******
diff --git a/docs/configuration/interfaces/bridge.rst b/docs/configuration/interfaces/bridge.rst
index 766d2aa5..a471b8f8 100644
--- a/docs/configuration/interfaces/bridge.rst
+++ b/docs/configuration/interfaces/bridge.rst
@@ -135,6 +135,11 @@ VLAN
can either be an individual VLAN id or a range of VLAN ids delimited by a
hyphen.
+Port Mirror (SPAN)
+==================
+.. cmdinclude:: ../../_include/interface-mirror.txt
+ :var0: ethernet
+
*******
Example
*******
diff --git a/docs/configuration/interfaces/ethernet.rst b/docs/configuration/interfaces/ethernet.rst
index 9311c947..562aeabc 100644
--- a/docs/configuration/interfaces/ethernet.rst
+++ b/docs/configuration/interfaces/ethernet.rst
@@ -83,6 +83,11 @@ QinQ (802.1ad)
:var0: ethernet
:var1: eth0
+Port Mirror (SPAN)
+==================
+.. cmdinclude:: ../../_include/interface-mirror.txt
+ :var0: ethernet
+
*********
Operation
*********