Skip to content

Commit 3d1ec8f

Browse files
authored
Rename network-observability-operator -> netobserv-operator (#2518)
1 parent 32b413d commit 3d1ec8f

File tree

153 files changed

+462
-492
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

153 files changed

+462
-492
lines changed

.mk/development.mk

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -188,7 +188,7 @@ endif
188188

189189
.PHONY: pprof
190190
pprof:
191-
@echo -e "\n==> Enabling pprof... Check https://github.com/netobserv/network-observability-operator/blob/main/DEVELOPMENT.md#profiling for help."
191+
@echo -e "\n==> Enabling pprof... Check https://github.com/netobserv/netobserv-operator/blob/main/DEVELOPMENT.md#profiling for help."
192192
kubectl -n $(NAMESPACE) set env deployment netobserv-controller-manager -c "manager" PROFILING_BIND_ADDRESS=:6060
193193
@echo -e "\n==> Redeploying..."
194194
kubectl rollout status -n $(NAMESPACE) --timeout=60s deployment netobserv-controller-manager

.tekton/network-observability-operator-bundle-ystream-pull-request.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ apiVersion: tekton.dev/v1
22
kind: PipelineRun
33
metadata:
44
annotations:
5-
build.appstudio.openshift.io/repo: https://github.com/netobserv/network-observability-operator?rev={{revision}}
5+
build.appstudio.openshift.io/repo: https://github.com/netobserv/netobserv-operator?rev={{revision}}
66
build.appstudio.redhat.com/commit_sha: '{{revision}}'
77
build.appstudio.redhat.com/pull_request_number: '{{pull_request_number}}'
88
build.appstudio.redhat.com/target_branch: '{{target_branch}}'

.tekton/network-observability-operator-bundle-ystream-push.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ apiVersion: tekton.dev/v1
22
kind: PipelineRun
33
metadata:
44
annotations:
5-
build.appstudio.openshift.io/repo: https://github.com/netobserv/network-observability-operator?rev={{revision}}
5+
build.appstudio.openshift.io/repo: https://github.com/netobserv/netobserv-operator?rev={{revision}}
66
build.appstudio.redhat.com/commit_sha: '{{revision}}'
77
build.appstudio.redhat.com/target_branch: '{{target_branch}}'
88
pipelinesascode.tekton.dev/max-keep-runs: "3"

.tekton/network-observability-operator-ystream-pull-request.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ apiVersion: tekton.dev/v1
22
kind: PipelineRun
33
metadata:
44
annotations:
5-
build.appstudio.openshift.io/repo: https://github.com/netobserv/network-observability-operator?rev={{revision}}
5+
build.appstudio.openshift.io/repo: https://github.com/netobserv/netobserv-operator?rev={{revision}}
66
build.appstudio.redhat.com/commit_sha: '{{revision}}'
77
build.appstudio.redhat.com/pull_request_number: '{{pull_request_number}}'
88
build.appstudio.redhat.com/target_branch: '{{target_branch}}'

.tekton/network-observability-operator-ystream-push.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ kind: PipelineRun
33
metadata:
44
annotations:
55
build.appstudio.openshift.io/build-nudge-files: hack/nudging/container_digest.sh
6-
build.appstudio.openshift.io/repo: https://github.com/netobserv/network-observability-operator?rev={{revision}}
6+
build.appstudio.openshift.io/repo: https://github.com/netobserv/netobserv-operator?rev={{revision}}
77
build.appstudio.redhat.com/commit_sha: '{{revision}}'
88
build.appstudio.redhat.com/target_branch: '{{target_branch}}'
99
pipelinesascode.tekton.dev/max-keep-runs: "3"

AGENTS.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Best practices for AI coding agents on NetObserv Operator.
1414
flow generation from packets (DaemonSet)
1515
- **[flowlogs-pipeline](https://github.com/netobserv/flowlogs-pipeline)**: Flow
1616
collection, enrichment, export (Deployment/StatefulSet) -
17-
**[Console Plugin](https://github.com/netobserv/network-observability-console-plugin)**:
17+
**[Console Plugin](https://github.com/netobserv/netobserv-web-console)**:
1818
OpenShift visualization (optional)
1919
- **CRD**: `FlowCollector` v1beta2 - **single cluster-wide resource named
2020
`cluster`**

DEVELOPMENT.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -344,7 +344,7 @@ This workflow is triggered when something is merged into `main`, to push new ima
344344
git push upstream HEAD:workflow-test -f
345345
```
346346

347-
Then, open the [action page](https://github.com/netobserv/network-observability-operator/actions/workflows/push_image.yml) in Github to monitor the jobs triggered. Make sure on Quay that you get the expected images for the [Operator](https://quay.io/repository/netobserv/network-observability-operator?tab=tags), the [bundle](https://quay.io/repository/netobserv/network-observability-operator-bundle?tab=tags) and the [catalog](https://quay.io/repository/netobserv/network-observability-operator-catalog?tab=tags).
347+
Then, open the [action page](https://github.com/netobserv/netobserv-operator/actions/workflows/push_image.yml) in Github to monitor the jobs triggered. Make sure on Quay that you get the expected images for the [Operator](https://quay.io/repository/netobserv/network-observability-operator?tab=tags), the [bundle](https://quay.io/repository/netobserv/network-observability-operator-bundle?tab=tags) and the [catalog](https://quay.io/repository/netobserv/network-observability-operator-catalog?tab=tags).
348348

349349
Expected images:
350350
- Operator's tagged "workflow-test" manifest + every support archs
@@ -364,7 +364,7 @@ git push origin HEAD:dummy
364364
Then, open a PR in github, making sure to select `workflow-test` as the base branch and not `main`.
365365
On the PR, add the `ok-to-test` label.
366366

367-
This will trigger the corresponding `push_image_pr.yml` workflow ([view on github](https://github.com/netobserv/network-observability-operator/actions/workflows/push_image_pr.yml)). As above, you should check that the images are well created in Quay:
367+
This will trigger the corresponding `push_image_pr.yml` workflow ([view on github](https://github.com/netobserv/netobserv-operator/actions/workflows/push_image_pr.yml)). As above, you should check that the images are well created in Quay:
368368

369369
Expected images:
370370
- Operator's tagged with SHA manifest + single arch amd64 (make sure they expire)
@@ -379,7 +379,7 @@ git tag -a "0.0.0-rc0" -m "0.0.0-rc0"
379379
git push upstream --tags
380380
```
381381

382-
When the tag is pushed, it will trigger the corresponding workflow ([view on github](https://github.com/netobserv/network-observability-operator/actions/workflows/release.yml)). As above, you should check that the images are well created in Quay. It's fine if you tag from the `workflow-test` branch (or any branch).
382+
When the tag is pushed, it will trigger the corresponding workflow ([view on github](https://github.com/netobserv/netobserv-operator/actions/workflows/release.yml)). As above, you should check that the images are well created in Quay. It's fine if you tag from the `workflow-test` branch (or any branch).
383383

384384
Expected images:
385385
- Operator's tagged 0.0.0-rc0 manifest + every support archs

FAQ.md

Lines changed: 3 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# F.A.Q / Troubleshooting
22

3-
If you can't find help here, don't hesitate to open [an issue](https://github.com/netobserv/network-observability-operator/issues) or a [Q&A](https://github.com/netobserv/network-observability-operator/discussions/categories/q-a). There are several repositories under _netobserv_ github org, but it is fine to centralize these in _network-observability-operator_.
3+
If you can't find help here, don't hesitate to open [an issue](https://github.com/netobserv/netobserv-operator/issues) or a [Q&A](https://github.com/netobserv/netobserv-operator/discussions/categories/q-a). There are several repositories under _netobserv_ github org, but it is fine to centralize these in _network-observability-operator_.
44

55
## Table of Contents
66

@@ -20,34 +20,6 @@ If you can't find help here, don't hesitate to open [an issue](https://github.co
2020

2121
## Q&A
2222

23-
### Is it for OpenShift only?
24-
25-
No! While some features are developed primarily for OpenShift, we want to keep it on track with other / "vanilla" Kubes. For instance, there has been some work to make the console plugin [run as a standalone](https://github.com/netobserv/network-observability-console-plugin/pull/163), or the operator to manage upstream (non-OpenShift) [ovn-kubernetes](https://github.com/netobserv/network-observability-operator/pull/97).
26-
27-
And if something is not working as hoped with your setup, you are welcome to contribute to the project ;-)
28-
29-
### Which version of Kubernetes / OpenShift is supported?
30-
31-
All versions of Kubernetes since 1.22 should work, although there is no official support (best effort).
32-
33-
All versions of OpenShift currently supported by Red Hat are supported. Older version, greater than 4.10, should also work although not being officially supported (best effort).
34-
35-
Some features depend on the Linux kernel version in use. It should be at least 4.18 (earlier versions have never been tested). More recent kernels (> 5.14) are better, for agent feature completeness and improved performances.
36-
37-
### How do I visualize flows and metrics?
38-
39-
For OpenShift users, a visualization tool is integrated in the OpenShift console. Just open the console in your browser, and you will see new menu items (such as Network Traffic under Observe) once NetObserv is installed and configured.
40-
41-
Non-OpenShift users can deploy the standalone console, as explained in the Getting Started section from the readme.
42-
43-
Alternatively, you can still access the data (Loki logs, Prometheus metrics) in different ways:
44-
45-
- Querying Loki (or Prometheus) directly
46-
- Using the Prometheus console
47-
- Using and configuring Grafana
48-
49-
All these options depend on how you installed these components.
50-
5123
### How can I make sure everything is correctly deployed?
5224

5325
Make sure all pods are up and running:
@@ -109,7 +81,7 @@ If using IPFIX (ie. `spec.agent.type` is `IPFIX` in FlowCollector), wait 10 minu
10981

11082
Else, check for any suspicious error in logs, especially in the `flowlogs-pipeline` pods and the eBPF agent pods. You may also take a look at prometheus metrics prefixed with `netobserv_`: they can give you clues if flows are processed, if errors are reported, etc.
11183

112-
Finally, don't hesitate to [open an issue](https://github.com/netobserv/network-observability-operator/issues).
84+
Finally, don't hesitate to [open an issue](https://github.com/netobserv/netobserv-operator/issues).
11385

11486
### There is no Network Traffic menu entry in OpenShift Console
11587

@@ -182,7 +154,7 @@ With Loki queries, a first thing to understand is that, while Loki allows to que
182154
183155
Depending on what you are trying to get, you may as well **consider querying Prometheus rather than Loki**. Queries on Prometheus are much faster than on Loki, it should not struggle with large time ranges, hence should be favored whenever possible. But Prometheus metrics do not contain as much information as flow logs in Loki, so whether or not you can do that really depends on the use case. When you use the NetObserv console plugin, it will try automatically to favor Prometheus over Loki if the query is compatible; else it falls back to Loki. If your query does't run against Prometheus, changing some filters or aggregations can make the switch. In the console plugin, you can force the use of Prometheus. Incompatible queries will fail, and the error message displayed should help you figure out which labels you can try to change to make the query compatible (for instance, changing a filter or an aggregation from Resource/Pods to Owner).
184156
185-
If the data that you need isn't available as a Prometheus metric, you may also **consider using the [FlowMetrics API](https://github.com/netobserv/network-observability-operator/blob/main/docs/Metrics.md#custom-metrics-using-the-flowmetrics-api)** to create your own metric. You need to be careful about the metrics cardinality, as explained in this link.
157+
If the data that you need isn't available as a Prometheus metric, you may also **consider using the [FlowMetrics API](https://github.com/netobserv/netobserv-operator/blob/main/docs/Metrics.md#custom-metrics-using-the-flowmetrics-api)** to create your own metric. You need to be careful about the metrics cardinality, as explained in this link.
186158
187159
If the problem persists, there are ways to **configure Loki to improve the query performance**. Some options depend on the installation mode you used for Loki (using the Operator and `LokiStack`, or `Monolithic` mode, or `Microservices` mode):
188160

PROJECT

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,15 +8,15 @@ layout:
88
plugins:
99
manifests.sdk.operatorframework.io/v2: {}
1010
projectName: netobserv-operator
11-
repo: github.com/netobserv/network-observability-operator
11+
repo: github.com/netobserv/netobserv-operator
1212
resources:
1313
- api:
1414
crdVersion: v1
1515
controller: true
1616
domain: netobserv.io
1717
group: flows
1818
kind: FlowCollector
19-
path: github.com/netobserv/network-observability-operator/api/flowcollector/v1beta2
19+
path: github.com/netobserv/netobserv-operator/api/flowcollector/v1beta2
2020
version: v1beta2
2121
webhooks:
2222
conversion: false
@@ -33,7 +33,7 @@ resources:
3333
domain: netobserv.io
3434
group: flows
3535
kind: FlowMetric
36-
path: github.com/netobserv/network-observability-operator/api/flowmetrics/v1alpha1
36+
path: github.com/netobserv/netobserv-operator/api/flowmetrics/v1alpha1
3737
version: v1alpha1
3838
webhooks:
3939
validation: true
@@ -44,6 +44,6 @@ resources:
4444
domain: netobserv.io
4545
group: flows
4646
kind: FlowCollectorSlice
47-
path: github.com/netobserv/network-observability-operator/api/flowcollectorslice/v1alpha1
47+
path: github.com/netobserv/netobserv-operator/api/flowcollectorslice/v1alpha1
4848
version: v1alpha1
4949
version: "3"

README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
![GitHub release (latest by date)](https://img.shields.io/github/v/release/netobserv/network-observability-operator)
44
[![Artifact HUB](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/NetObserv)](https://artifacthub.io/packages/helm/netobserv/netobserv-operator)
5-
[![Go Report Card](https://goreportcard.com/badge/github.com/netobserv/network-observability-operator)](https://goreportcard.com/report/github.com/netobserv/network-observability-operator)
5+
[![Go Report Card](https://goreportcard.com/badge/github.com/netobserv/netobserv-operator)](https://goreportcard.com/report/github.com/netobserv/netobserv-operator)
66

77
NetObserv Operator is a Kubernetes operator for network observability. It deploys a monitoring pipeline that consists in:
88
- An eBPF agent, that generates network flows from captured packets.
@@ -91,7 +91,7 @@ EOF
9191
```
9292

9393
A few remarks:
94-
- You can change the Prometheus and Loki URLs depending on your installation. This example works if you use the "standalone" installation described above, with `install.loki=true` and `install.prom-stack=true`. Check more configuration options for [Prometheus](https://github.com/netobserv/network-observability-operator/blob/main/docs/FlowCollector.md#flowcollectorspecprometheus-1) and [Loki](https://github.com/netobserv/network-observability-operator/blob/main/docs/FlowCollector.md#flowcollectorspecloki-1).
94+
- You can change the Prometheus and Loki URLs depending on your installation. This example works if you use the "standalone" installation described above, with `install.loki=true` and `install.prom-stack=true`. Check more configuration options for [Prometheus](https://github.com/netobserv/netobserv-operator/blob/main/docs/FlowCollector.md#flowcollectorspecprometheus-1) and [Loki](https://github.com/netobserv/netobserv-operator/blob/main/docs/FlowCollector.md#flowcollectorspecloki-1).
9595
- Depending on the Kubernetes distribution and CNI, NetObserv may come secured by default with a built-in network policy. You can force installing it or not by setting `spec.networkPolicy.enable` in `FlowCollector`. If the built-in policy does not work as intended, it is recommended to turn it off and create your own instead. NetObserv runs some highly privileged workloads, thus it is important to keep it as much isolated as possible. See [NetworkPolicy.md](./docs/NetworkPolicy.md) for more details on how to create a policy.
9696
- The processor env `SERVER_NOTLS` means that the communication between eBPF agents and Flowlogs-pipeline won't be encrypted. To enable TLS, you need to supply the TLS certificates to Flowlogs-pipeline (a Secret named `flowlogs-pipeline-cert`), and the CA to the eBPF agents (a ConfigMap named `flowlogs-pipeline-ca` in the privileged namespace).
9797

@@ -108,7 +108,7 @@ Then open http://localhost:9001/ in your browser.
108108
A couple of `make` targets are provided in this repository to allow installing without OLM:
109109

110110
```bash
111-
git clone https://github.com/netobserv/network-observability-operator.git && cd network-observability-operator
111+
git clone https://github.com/netobserv/netobserv-operator.git && cd network-observability-operator
112112
USER=netobserv make deploy deploy-loki deploy-grafana
113113
```
114114

0 commit comments

Comments
 (0)