Merge pull request #97600 from gwynnemonahan/OSDOCS-15821

OSDOCS-15821 [NETOBSERV] Modularize release notes 1.1.0

Author: JoeAldinger

_topic_maps/_topic_map.yml

@@ -3270,12 +3270,15 @@ Topics:
   Topics:
   - Name: Network Observability Operator release notes 1.10
     File: network-observability-operator-release-notes-1-10
-  #- Name: Network observability release notes 1.9.3
-  #  File: network-observability-release-notes-1-9-3
-  #- Name: Network observability release notes 1.9.2
-  #  File: network-observability-release-notes-1-9-2
+#Keeping network-observability-operator-release-notes until all entries have been modularized.
+#Once all entire have been modularized, it will be updated with modules from 1-10 and these comments will be removed.
   - Name: Network observability release notes
     File: network-observability-operator-release-notes
+  - Name: Network Observability Operator archived release notes
+    Dir: release_notes_archive
+    Topics:
+    - Name: Network Observability Operator release notes archive
+      File: network-observability-operator-release-notes-archive
   - Name: Network observability overview
     File: network-observability-overview
   - Name: Installing the Network Observability Operator

modules/network-observability-release-notes-1-1-0-bug-fixes.adoc

@@ -0,0 +1,8 @@
+// Module included in the following assemblies:
+// * network_observability/network-observability-operator-release-notes-1-1-0.adoc
+
+:_mod-docs-content-type: REFERENCE
+[id="network-observability-release-notes-1-1-0-bug-fixes_{context}"]
+= Network observability 1.1.0 bug fixes
+
+* Previously, unless the Loki `authToken` configuration was set to `FORWARD` mode, authentication was not enforced, allowing unauthorized users to retrieve flows. Now, regardless of the Loki `authToken` mode, only cluster administrators can retrieve flows. (link:https://bugzilla.redhat.com/show_bug.cgi?id=2169468[*BZ#2169468*])

modules/network-observability-release-notes-1-1-0-enhancements.adoc

@@ -0,0 +1,12 @@
+// Module included in the following assemblies:
+// * network_observability/network-observability-release--operator-notes-1-1-0.adoc
+
+:_mod-docs-content-type: REFERENCE
+[id="network-observability-release-notes-1-1-0-enhancements_{context}"]
+= Network observability 1.1.0 enhancements
+
+The following advisory is available for the Network Observability Operator 1.1.0:
+
+* link:https://access.redhat.com/errata/RHSA-2023:0786[RHSA-2023:0786 Network Observability Operator Security Advisory Update]
+
+The Network Observability Operator is now stable and the release channel is upgraded to `v1.1.0`.

modules/network-observability-release-notes-1-2-0-bug-fixes.adoc

@@ -0,0 +1,17 @@
+// Module included in the following assemblies:
+
+// * power_monitoring/network-observability-operator-release-notes-1-2-0.adoc
+
+:_mod-docs-content-type: REFERENCE
+[id="network-observability-release-notes-1-2-0-bug-fixes_{context}"]
+= Network observability 1.2.0 bug fixes
+
+* Previously, after changing the `namespace` value in the FlowCollector spec, `eBPF` agent pods running in the previous namespace were not appropriately deleted. Now, the pods running in the previous namespace are appropriately deleted. (link:https://issues.redhat.com/browse/NETOBSERV-774[*NETOBSERV-774*])
+
+* Previously, after changing the `caCert.name` value in the FlowCollector spec (such as in Loki section), FlowLogs-Pipeline pods and Console plug-in pods were not restarted, therefore they were unaware of the configuration change. Now, the pods are restarted, so they get the configuration change. (link:https://issues.redhat.com/browse/NETOBSERV-772[*NETOBSERV-772*])
+
+* Previously, network flows between pods running on different nodes were sometimes not correctly identified as being duplicates because they are captured by different network interfaces. This resulted in over-estimated metrics displayed in the console plug-in. Now, flows are correctly identified as duplicates, and the console plug-in displays accurate metrics. (link:https://issues.redhat.com/browse/NETOBSERV-755[*NETOBSERV-755*])
+
+* The "reporter" option in the console plug-in is used to filter flows based on the observation point of either source node or destination node. Previously, this option mixed the flows regardless of the node observation point. This was due to network flows being incorrectly reported as Ingress or Egress at the node level. Now, the network flow direction reporting is correct. The "reporter" option filters for source observation point, or destination observation point, as expected. (link:https://issues.redhat.com/browse/NETOBSERV-696[*NETOBSERV-696*])
+
+* Previously, for agents configured to send flows directly to the processor as gRPC+protobuf requests, the submitted payload could be too large and is rejected by the processors' GRPC server. This occurred under  very-high-load scenarios and with only some configurations of the agent. The agent logged an error message, such as: _grpc: received message larger than max_. As a consequence, there was information loss about those flows. Now, the gRPC payload is split into several messages when the size exceeds a threshold. As a result, the server maintains connectivity. (link:https://issues.redhat.com/browse/NETOBSERV-617[*NETOBSERV-617*])

modules/network-observability-release-notes-1-2-0-new-features-enhancements.adoc

@@ -0,0 +1,28 @@
+// Module included in the following assemblies:
+// * power_monitoring/network-observability-operator-release-notes-1-2-0.adoc
+
+:_mod-docs-content-type: REFERENCE
+[id="network-observability-release-notes-new-features-enhancements-1-2-0_{context}"]
+= Network observability 1.2.0 new features and enhancements
+
+This release of network observability and the Network Observability Operator includes the following new features and enhancements:
+
+[id="network-observability-operator-preparing-to-update_{context}"]
+== Preparing for the next update
+
+The subscription of an installed Operator specifies an update channel that tracks and receives updates for the Operator. Until the 1.2 release of the Network Observability Operator, the only channel available was `v1.0.x`. The 1.2 release of the Network Observability Operator introduces the `stable` update channel for tracking and receiving updates. You must switch your channel from `v1.0.x` to `stable` to receive future Operator updates. The `v1.0.x` channel is deprecated and planned for removal in a following release.
+
+[id="histogram-feature-1-2_{context}"]
+== Histogram in Traffic Flows view
+
+You can now choose to show a histogram of flows over time. The histogram enables you to visualize the history of flows without hitting the Loki query limit. For more information, see "Using the histogram".
+
+[id="conversation-tracking-feature-1-2_{context}"]
+== Conversation tracking
+
+You can now query flows by *Log Type*, which enables grouping network flows that are part of the same conversation. For more information, see "Working with conversations".
+
+[id="health-alerts-feature-1-2_{context}"]
+== Network observability health alerts
+
+The Network Observability Operator now creates automatic alerts if the `flowlogs-pipeline` is dropping flows because of errors at the write stage or if the Loki ingestion rate limit has been reached. For more information, see "Health dashboards".

observability/network_observability/network-observability-operator-release-notes.adoc

@@ -14,11 +14,17 @@ These release notes track the development of the 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].
 
-include::modules/network-observability-operator-release-notes-1-9-3-advisory.adoc[leveloffset=+1]
+////
+When all content in this assembly has been modularized:
+- move NETOSBERV 1.10 modules into this assembly
+- remove the network-observability-operator-release-notes-1-10.adoc file
+- update the _topic_map accordingly
+- update the addtl-release-notes.adoc file for each OCP version.
 
-include::modules/network-observability-operator-release-notes-1-9-2-advisory.adoc[leveloffset=+1]
+This will meet migration requirements, simplify future updates, and remove the need to update addtle-release-notes with each NETOBSERV release.
 
-include::modules/network-observability-release-notes-1-9-2-bug-fixes.adoc[leveloffset=+1]
+Delete this comment block when all of that is done.
+////
 
 [id="network-observability-operator-release-notes-1-9-1_{context}"]
 == Network Observability Operator 1.9.1
@@ -756,17 +762,8 @@ The subscription of an installed Operator specifies an update channel that track
 === Notable technical changes
 * Previously, you could install the Network Observability Operator using a custom namespace. This release introduces the `conversion webhook` which changes the `ClusterServiceVersion`. Because of this change, all the available namespaces are no longer listed. Additionally, to enable Operator metrics collection, namespaces that are shared with other Operators, like the `openshift-operators` namespace, cannot be used. Now, the Operator must be installed in the `openshift-netobserv-operator` namespace. You cannot automatically upgrade to the new Operator version if you previously installed the Network Observability Operator using a custom namespace. If you previously installed the Operator using a custom namespace, you must delete the instance of the Operator that was installed and re-install your operator in the `openshift-netobserv-operator` namespace. It is important to note that custom namespaces, such as the commonly used `netobserv` namespace, are still possible for the `FlowCollector`, Loki, Kafka, and other plug-ins. (link:https://issues.redhat.com/browse/NETOBSERV-907[*NETOBSERV-907*])(link:https://https://issues.redhat.com/browse/NETOBSERV-956[*NETOBSERV-956*])
 
-[id="network-observability-operator-release-notes-1-1"]
-== Network Observability Operator 1.1.0
+[id="network-observability-operatpr-1-1"]
+== Network Observability Operator 1.1
+include::modules/network-observability-release-notes-1-1-0-enhancements.adoc[leveloffset=+1]
 
-The following advisory is available for the Network Observability Operator 1.1.0:
-
-* link:https://access.redhat.com/errata/RHSA-2023:0786[RHSA-2023:0786 Network Observability Operator Security Advisory Update]
-
-The Network Observability Operator is now stable and the release channel is upgraded to `v1.1.0`.
-
-[id="network-observability-operator-1.1.0-bug-fixes"]
-=== Bug fix
-
-* Previously, unless the Loki `authToken` configuration was set to `FORWARD` mode, authentication was no longer enforced, allowing any user who could connect to the {product-title} console in an {product-title} cluster to retrieve flows without authentication.
-Now, regardless of the Loki `authToken` mode, only cluster administrators can retrieve flows. (link:https://bugzilla.redhat.com/show_bug.cgi?id=2169468[*BZ#2169468*])
+include::modules/network-observability-release-notes-1-1-0-bug-fixes.adoc[leveloffset=+1]

observability/network_observability/network-observability-release-notes-1-9-2.adoc

@@ -0,0 +1 @@
+../../../_attributes/

observability/network_observability/network-observability-release-notes-1-9-3.adoc

@@ -0,0 +1 @@
+../../../images/