OSDOCS-15129 [NETOBSERV] Refactor network-observability-overview.adoc

gwynnemonahan · gwynnemonahan · commit ecffbd8a8df7 · 2025-08-18T14:11:51.000-05:00
diff --git a/modules/network-observability-cli.adoc b/modules/network-observability-cli.adoc
@@ -0,0 +1,9 @@
+// Module included in the following assemblies:
+//
+// network_observability/network-observability-overview.adoc
+
+:_mod-docs-content-type: CONCEPT
+[id="network-observability-cli_{context}"]
+= Network Observability CLI
+
+You can quickly debug and troubleshoot networking issues with network observability by using the Network Observability command-line interface (CLI), `oc netobserv`. The Network Observability CLI is a flow and packet visualization tool that relies on eBPF agents to stream collected data to an ephemeral collector pod. It requires no persistent storage during the capture. After the run, the output is transferred to your local machine. This enables quick, live insight into packets and flow data without installing the Network Observability Operator.
diff --git a/modules/network-observability-dashboards.adoc b/modules/network-observability-dashboards.adoc
@@ -0,0 +1,11 @@
+// Module included in the following assemblies:
+//
+// network_observability/network-observability-overview.adoc
+
+:_mod-docs-content-type: CONCEPT
+[id="network-observability-dashboards_{context}"]
+= Network observability metrics dashboards
+
+In the {product-title} console on the *Overview* tab, you can view the overall aggregated metrics of the network traffic flow on the cluster. You can choose to display the information by cluster, node, namespace, owner, pod, and service. Filters and display options can further refine the metrics. For more information, see "Observing the network traffic from the Overview view".
+
+In *Observe* -> *Dashboards*, the *Netobserv* dashboards provide a quick overview of the network flows in your {product-title} cluster. The *Netobserv/Health* dashboard provides metrics about the health of the Operator. For more information, see "Network observability metrics" and "Viewing health information".
diff --git a/modules/network-observability-dependency-network-observability-operator.adoc b/modules/network-observability-dependency-network-observability-operator.adoc
@@ -0,0 +1,13 @@
+// Module included in the following assemblies:
+//
+// network_observability/network-observability-overview.adoc
+
+:_mod-docs-content-type: CONCEPT
+[id="network-observability-dependency-network-observability-operator_{context}"]
+= Optional dependencies of the Network Observability Operator
+
+You can optionally integrate the Network Observability Operator with other components to enhance its functionality and scalability. Supported optional dependencies include the {loki-op} for flow storage, and AMQ Streams for large-scale data handling with Kafka.
+
+{loki-op}:: You can use Loki as the backend to store all collected flows with a maximal level of details. It is recommended to use the Red Hat supported {loki-op} to install Loki. You can also choose to use network observability without Loki, but you need to consider some factors. For more information, see "Network observability without Loki".
+
+AMQ Streams Operator:: Kafka provides scalability, resiliency and high availability in the {product-title} cluster for large scale deployments. If you choose to use Kafka, it is recommended to use Red Hat supported AMQ Streams Operator.
diff --git a/modules/network-observability-openshift-console-integration.adoc b/modules/network-observability-openshift-console-integration.adoc
@@ -0,0 +1,14 @@
+// Module included in the following assemblies:
+//
+// network_observability/network-observability-overview.adoc
+
+:_mod-docs-content-type: CONCEPT
+[id="network-observability-openshift-console-integration_{context}"]
+= {product-title} console integration
+
+{product-title} console integration offers an overview, a topology view, and traffic flow tables. The Network observability metrics dashboards in *Observe* -> *Dashboards* are available only to users with administrator access.
+
+[NOTE]
+====
+To enable multi-tenancy for developer access and for administrators with limited access to namespaces, you must specify permissions by defining roles. For more information, see "Enabling multi-tenancy in network observability".
+====
diff --git a/modules/network-observability-operator.adoc b/modules/network-observability-operator.adoc
@@ -0,0 +1,11 @@
+// Module included in the following assemblies:
+//
+// network_observability/network-observability-overview.adoc
+
+:_mod-docs-content-type: CONCEPT
+[id="network-observability-operator_{context}"]
+= Network Observability Operator
+
+The Network Observability Operator provides the `FlowCollector` API custom resource. A `FlowCollector` instance is a cluster-scoped resource that enables configuration of network flow collection. This instance deploys pods and services that form a monitoring pipeline.
+
+The `eBPF` agent is deployed as a `daemonset` object and creates the network flows. The pipeline collects and enriches network flows with Kubernetes metadata before storing them in Loki or generating Prometheus metrics.
diff --git a/modules/network-observability-topology-views.adoc b/modules/network-observability-topology-views.adoc
@@ -0,0 +1,9 @@
+// Module included in the following assemblies:
+//
+// network_observability/network-observability-overview.adoc
+
+:_mod-docs-content-type: CONCEPT
+[id="network-observability-topology-views_{context}"]
+= Network observability topology views
+
+The {product-title} console offers the *Topology* tab which displays a graphical representation of the network flows and the amount of traffic. The topology view represents traffic between the {product-title} components as a network graph. You can refine the graph by using the filters and display options. You can access the information for cluster, zone, udn, node, namespace, owner, pod, and service.
diff --git a/modules/network-observability-traffic-flow-tables.adoc b/modules/network-observability-traffic-flow-tables.adoc
@@ -0,0 +1,9 @@
+// Module included in the following assemblies:
+//
+// network_observability/network-observability-overview.adoc
+
+:_mod-docs-content-type: CONCEPT
+[id="traffic-flow-tables_{context}"]
+= Traffic flow tables
+
+The *Traffic flow* table view provides a view for raw flows, non aggregated filtering options, and configurable columns. The {product-title} console offers the *Traffic flows* tab which displays the data of the network flows and the amount of traffic.
diff --git a/observability/network_observability/network-observability-operator-release-notes.adoc b/observability/network_observability/network-observability-operator-release-notes.adoc
@@ -11,7 +11,7 @@ The Network Observability Operator enables administrators to observe and analyze
 
 These release notes track the development of the Network Observability Operator in the {product-title}.
 
-For an overview of the Network Observability Operator, see xref:../../observability/network_observability/network-observability-overview.adoc#dependency-network-observability[About Network Observability Operator].
+For an overview of the Network Observability Operator, see xref:../../observability/network_observability/network-observability-overview.adoc#network-observability-overview[About network observability].
 
 [id="network-observability-operator-release-notes-1-9-1_{context}"]
 == Network Observability Operator 1.9.1
@@ -224,7 +224,7 @@ You can now export enriched network flows to a compatible OpenTelemetry endpoint
 
 [id="network-observability-operator-developer-perspective-1-7_{context}"]
 ==== Network observability Developer perspective
-You can now use network observability in the *Developer* perspective. For more information, see xref:../../observability/network_observability/network-observability-overview.adoc#no-console-integration[{product-title} console integration].
+You can now use network observability in the *Developer* perspective. For more information, see xref:../../observability/network_observability/network-observability-overview.adoc#network-observability-openshift-console-integration_network-observability-overview[{product-title} console integration].
 
 ==== TCP flags filtering
 You can now use the `tcpFlags` filter to limit the volume of packets processed by the eBPF program. For more information, see xref:../../observability/network_observability/observing-network-traffic.adoc#network-observability-flowcollector-flowfilter-parameters_nw-observe-network-traffic[Flow filter configuration parameters], xref:../../observability/network_observability/observing-network-traffic.adoc#network-observability-ebpf-flow-rule-filter_nw-observe-network-traffic[eBPF flow rule filter], and xref:../../observability/network_observability/metrics-alerts-dashboards.adoc#network-observability-tcp-flag-syn-flood_metrics-dashboards-alerts[Detecting SYN flooding using the FlowMetric API and TCP flags].
@@ -386,7 +386,7 @@ With the duplicated flows update, the *Interface* and *Interface Direction* fiel
 =====
 
 For more information, see xref:../../observability/network_observability/network-observability-operator-monitoring.adoc#network-observability-netobserv-dashboard-ebpf-agent-alerts_network_observability[Using the eBPF agent alert]
-and xref:../../observability/network_observability/observing-network-traffic.adoc#network-observability-quickfilter_nw-observe-network-traffic[Quick filters].
+and For more information, see xref:../../observability/network_observability/network-observability-overview.adoc#network-observability-dashboards_network-observability-overview[Network observability metrics dashboards] and xref:../../observability/network_observability/observing-network-traffic.adoc#network-observability-quickfilter_nw-observe-network-traffic[Filtering the network traffic].
 
 
 [id="network-observability-ebpf-collection-filtering-1.6_{context}"]
@@ -440,11 +440,11 @@ You can use TCP handshake Round-Trip Time (RTT) captured from the `fentry/tcp_rc
 
 [id="network-observability-metrics-dashboard-enhancements"]
 ==== Metrics, dashboards, and alerts enhancements
-The network observability metrics dashboards in *Observe* → *Dashboards* → *NetObserv* have new metrics types you can use to create Prometheus alerts. You can now define available metrics in the `includeList` specification. In previous releases, these metrics were defined in the `ignoreTags` specification. For a complete list of these metrics, see xref:../../observability/network_observability/metrics-alerts-dashboards.adoc#network-observability-metrics_metrics-dashboards-alerts[Network observability Metrics].
+The network observability metrics dashboards in *Observe* → *Dashboards* → *NetObserv* have new metrics types you can use to create Prometheus alerts. You can now define available metrics in the `includeList` specification. In previous releases, these metrics were defined in the `ignoreTags` specification. For a complete list of these metrics, see xref:../../observability/network_observability/metrics-alerts-dashboards.adoc#network-observability-metrics_metrics-dashboards-alerts[Network observability metrics].
 
 [id="network-observability-improved-lokistack-integration"]
 ==== Improvements for network observability without Loki
-You can create Prometheus alerts for the *Netobserv* dashboard using DNS, Packet drop, and RTT metrics, even if you don't use Loki. In the previous version of network observability, 1.4, these metrics were only available for querying and analysis in the *Network Traffic*, *Overview*, and *Topology* views, which are not available without Loki. For more information, see xref:../../observability/network_observability/metrics-alerts-dashboards.adoc#network-observability-metrics_metrics-dashboards-alerts[Network observability Metrics].
+You can create Prometheus alerts for the *Netobserv* dashboard using DNS, Packet drop, and RTT metrics, even if you don't use Loki. In the previous version of network observability, 1.4, these metrics were only available for querying and analysis in the *Network Traffic*, *Overview*, and *Topology* views, which are not available without Loki. For more information, see xref:../../observability/network_observability/metrics-alerts-dashboards.adoc#network-observability-metrics_metrics-dashboards-alerts[Network observability metrics]
 
 [id="network-observability-zones"]
 ==== Availability zones
@@ -567,7 +567,7 @@ The 1.4 release of the Network Observability Operator adds improvements and new
 ** The *NetObserv / Health* dashboard shows flows overhead as well as top flow rates per nodes, namespaces, and workloads.
 ** Infrastructure and Application metrics are shown in a split-view for namespaces and workloads.
 
-For more information, see xref:../../observability/network_observability/network-observability-overview.adoc#network-observability-dashboards[Network observability metrics] and xref:../../observability/network_observability/observing-network-traffic.adoc#network-observability-quickfilter_nw-observe-network-traffic[Quick filters].
+For more information, see xref:../../observability/network_observability/network-observability-overview.adoc#network-observability-dashboards_network-observability-overview[Network observability metrics dashboards] and xref:../../observability/network_observability/observing-network-traffic.adoc#network-observability-quickfilter_nw-observe-network-traffic[Quick filters].
 
 [discrete]
 [id="configuration-enhancements-1.4_{context}"]
@@ -645,7 +645,7 @@ You must switch your channel from `v1.0.x` to `stable` to receive future Operato
 
 [id="flow-based-dashboard-1.3"]
 ==== Flow-based metrics dashboard
-* This release adds a new dashboard, which provides an overview of the network flows in your {product-title} cluster. For more information, see xref:../../observability/network_observability/network-observability-overview.adoc#network-observability-dashboards[Network observability metrics].
+* This release adds a new dashboard, which provides an overview of the network flows in your {product-title} cluster. For more information, see xref:../../observability/network_observability/network-observability-overview.adoc#network-observability-dashboards_network-observability-overview[Network observability metrics dashboards].
 
 [id="must-gather-1.3"]
 ==== Troubleshooting with the must-gather tool
diff --git a/observability/network_observability/network-observability-overview.adoc b/observability/network_observability/network-observability-overview.adoc
