Skip to content

Commit 568e182

Browse files
authored
Merge pull request #63324 from skrthomas/OSDOCS-6348
OSDOCS-6348: Adding IPFIX exporter option
2 parents 93708e1 + 70f8c34 commit 568e182

File tree

3 files changed

+15
-7
lines changed

3 files changed

+15
-7
lines changed

modules/network-observability-enriched-flows-kafka.adoc renamed to modules/network-observability-enriched-flows.adoc

Lines changed: 13 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,13 +3,13 @@
33
// network_observability/configuring-operator.adoc
44

55
:_content-type: PROCEDURE
6-
[id="network-observability-enriched-flows-kafka_{context}"]
6+
[id="network-observability-enriched-flows_{context}"]
77
= Export enriched network flow data
88

9-
You can send network flows to Kafka, so that they can be consumed by any processor or storage that supports Kafka input, such as Splunk, Elasticsearch, or Fluentd.
9+
You can send network flows to Kafka, IPFIX, or both at the same time. Any processor or storage that supports Kafka or IPFIX input, such as Splunk, Elasticsearch, or Fluentd, can consume the enriched network flow data.
1010

1111
.Prerequisites
12-
* Installed Kafka
12+
* Your Kafka or IPFIX collector endpoint(s) are available from Network Observability `flowlogs-pipeline` pods.
1313
1414
.Procedure
1515

@@ -26,14 +26,22 @@ metadata:
2626
name: cluster
2727
spec:
2828
exporters:
29-
- type: KAFKA
29+
- type: KAFKA <3>
3030
kafka:
3131
address: "kafka-cluster-kafka-bootstrap.netobserv"
3232
topic: netobserv-flows-export <1>
3333
tls:
3434
enable: false <2>
35+
- type: IPFIX <3>
36+
ipfix:
37+
targetHost: "ipfix-collector.ipfix.svc.cluster.local"
38+
targetPort: 4739
39+
transport: tcp or udp <4>
40+
3541

3642
----
3743
<1> The Network Observability Operator exports all flows to the configured Kafka topic.
3844
<2> You can encrypt all communications to and from Kafka with SSL/TLS or mTLS. When enabled, the Kafka CA certificate must be available as a ConfigMap or a Secret, both in the namespace where the `flowlogs-pipeline` processor component is deployed (default: netobserv). It must be referenced with `spec.exporters.tls.caCert`. When using mTLS, client secrets must be available in these namespaces as well (they can be generated for instance using the AMQ Streams User Operator) and referenced with `spec.exporters.tls.userCert`.
39-
. After configuration, network flows data can be sent to an available output in a JSON format. For more information, see _Network flows format reference_
45+
<3> You can export flows to IPFIX instead of or in conjunction with exporting flows to Kafka.
46+
<4> You have the option to specify transport. The default value is `tcp` but you can also specify `udp`.
47+
. After configuration, network flows data can be sent to an available output in a JSON format. For more information, see _Network flows format reference_.

networking/network_observability/configuring-operator.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ include::modules/network-observability-flowcollector-view.adoc[leveloffset=+1]
1616
For more information about conversation tracking, see xref:../../networking/network_observability/observing-network-traffic.adoc#network-observability-working-with-conversations_nw-observe-network-traffic[Working with conversations].
1717

1818
include::modules/network-observability-flowcollector-kafka-config.adoc[leveloffset=+1]
19-
include::modules/network-observability-enriched-flows-kafka.adoc[leveloffset=+1]
19+
include::modules/network-observability-enriched-flows.adoc[leveloffset=+1]
2020

2121
[role="_additional-resources"]
2222
.Additional resources

networking/network_observability/installing-operators.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ include::modules/network-observability-operator-install.adoc[leveloffset=+1]
2626
.Additional resources
2727
* For more information about Flow Collector specifications, see the xref:../../networking/network_observability/flowcollector-api.adoc#network-observability-flowcollector-api-specifications_network_observability[Flow Collector API Reference] and the xref:../../networking/network_observability/configuring-operator.adoc#network-observability-flowcollector-view_network_observability[Flow Collector sample resource].
2828
29-
* For more information about exporting flow data to Kafka for third party processing consumption, see xref:../../networking/network_observability/configuring-operator.adoc#network-observability-enriched-flows-kafka_network_observability[Export enriched network flow data].
29+
* For more information about exporting flow data to Kafka or IPFIX for third party processing consumption, see xref:../../networking/network_observability/configuring-operator.adoc#network-observability-enriched-flows_network_observability[Export enriched network flow data].
3030
3131
include::modules/network-observability-operator-uninstall.adoc[leveloffset=+1]
3232

0 commit comments

Comments
 (0)