mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 21:46:22 +01:00
97 lines
2.9 KiB
Plaintext
97 lines
2.9 KiB
Plaintext
// Module included in the following assemblies:
|
|
//
|
|
// * scalability_and_performance/understanding-node-observability-operator.adoc
|
|
|
|
:_mod-docs-content-type: PROCEDURE
|
|
[id="creating-node-observability-custom-resource_{context}"]
|
|
= Creating the Node Observability custom resource
|
|
|
|
You must create and run the `NodeObservability` custom resource (CR) before you run the profiling query. When you run the `NodeObservability` CR, it creates the necessary machine config and machine config pool CRs to enable the CRI-O profiling on the worker nodes matching the `nodeSelector`.
|
|
|
|
[IMPORTANT]
|
|
====
|
|
If CRI-O profiling is not enabled on the worker nodes, the `NodeObservabilityMachineConfig` resource gets created. Worker nodes matching the `nodeSelector` specified in `NodeObservability` CR restarts. This might take 10 or more minutes to complete.
|
|
====
|
|
|
|
[NOTE]
|
|
====
|
|
Kubelet profiling is enabled by default.
|
|
====
|
|
|
|
The CRI-O unix socket of the node is mounted on the agent pod, which allows the agent to communicate with CRI-O to run the pprof request. Similarly, the `kubelet-serving-ca` certificate chain is mounted on the agent pod, which allows secure communication between the agent and node's kubelet endpoint.
|
|
|
|
.Prerequisites
|
|
* You have installed the Node Observability Operator.
|
|
* You have installed the OpenShift CLI (oc).
|
|
* You have access to the cluster with `cluster-admin` privileges.
|
|
|
|
.Procedure
|
|
|
|
. Log in to the {product-title} CLI by running the following command:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ oc login -u kubeadmin https://<HOSTNAME>:6443
|
|
----
|
|
|
|
. Switch back to the `node-observability-operator` namespace by running the following command:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ oc project node-observability-operator
|
|
----
|
|
|
|
. Create a CR file named `nodeobservability.yaml` that contains the following text:
|
|
+
|
|
[source,yaml]
|
|
----
|
|
apiVersion: nodeobservability.olm.openshift.io/v1alpha2
|
|
kind: NodeObservability
|
|
metadata:
|
|
name: cluster <1>
|
|
spec:
|
|
nodeSelector:
|
|
kubernetes.io/hostname: <node_hostname> <2>
|
|
type: crio-kubelet
|
|
----
|
|
<1> You must specify the name as `cluster` because there should be only one `NodeObservability` CR per cluster.
|
|
<2> Specify the nodes on which the Node Observability agent must be deployed.
|
|
|
|
. Run the `NodeObservability` CR:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
oc apply -f nodeobservability.yaml
|
|
----
|
|
|
|
+
|
|
.Example output
|
|
[source,terminal]
|
|
----
|
|
nodeobservability.olm.openshift.io/cluster created
|
|
----
|
|
|
|
. Review the status of the `NodeObservability` CR by running the following command:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ oc get nob/cluster -o yaml | yq '.status.conditions'
|
|
----
|
|
|
|
+
|
|
.Example output
|
|
[source,terminal]
|
|
----
|
|
conditions:
|
|
conditions:
|
|
- lastTransitionTime: "2022-07-05T07:33:54Z"
|
|
message: 'DaemonSet node-observability-ds ready: true NodeObservabilityMachineConfig
|
|
ready: true'
|
|
reason: Ready
|
|
status: "True"
|
|
type: Ready
|
|
----
|
|
|
|
+
|
|
`NodeObservability` CR run is completed when the reason is `Ready` and the status is `True`.
|