You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/en/other/4-hpa/1-deploy-otel.md
+8-20Lines changed: 8 additions & 20 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,17 +20,7 @@ You will be able to connect to the workshop instance by using SSH from your Mac,
20
20
Your workshop instance has been pre-configured with the correct **Access Token** and **Realm** for this workshop. There is no need for you to configure these.
21
21
{{% /notice %}}
22
22
23
-
## 3. Namespaces in Kubernetes
24
-
25
-
Most of our customers will make use of some kind of private or public cloud service to run Kubernetes. They often choose to have only a few large Kubernetes clusters as it is easier to manage centrally.
26
-
27
-
Namespaces are a way to organize these large Kubernetes clusters into virtual sub-clusters. This can be helpful when different teams or projects share a Kubernetes cluster as this will give them the easy ability to just see and work with their resources.
28
-
29
-
Any number of namespaces are supported within a cluster, each logically separated from others but with the ability to communicate with each other. Components are only **visible** when selecting a namespace or when adding the `--all-namespaces` flag to `kubectl` instead of allowing you to view just the components relevant to your project by selecting your namespace.
30
-
31
-
Most customers will want to install the Splunk OpenTelemetry Collector into a separate namespace. This workshop will follow that best practice.
32
-
33
-
## 4. Install Splunk OTel using Helm
23
+
## 3. Install Splunk OTel using Helm
34
24
35
25
Install the OpenTelemetry Collector using the Splunk Helm chart. First, add the Splunk Helm chart repository and update.
You can monitor the progress of the deployment by running `kubectl get pods`and adding `-n splunk` to the command to see the pods in the `splunk` namespace which should typically report that the new pods are up and running after about 30 seconds.
76
+
You can monitor the progress of the deployment by running `kubectl get pods` which should typically report that the new pods are up and running after about 30 seconds.
89
77
90
78
Ensure the status is reported as **Running** before continuing.
91
79
92
80
{{< tabs >}}
93
81
{{% tab title="kubectl get pods" %}}
94
82
95
83
```bash
96
-
kubectl get pods -n splunk
84
+
kubectl get pods
97
85
```
98
86
99
87
{{% /tab %}}
@@ -125,7 +113,7 @@ Use the label set by the `helm` install to tail logs (You will need to press `ct
This will add the selected workload to your filters. Try this for the **splunk-otel-collector-k8s-cluster-receiver** workload. It will then list a single workload in the **splunk** namespace.
101
+
This will add the selected workload to your filters. It would then list a single workload in the **default** namespace.
102
102
103
-
The Heat map above will also filter down to a single-colored square. Click on the square to see more information about the workload.
From the Heatmap above find the **splunk-otel-collector-k8s-cluster-receiver** in the **default** namespace and click on the square to see more information about the workload.
What are the CPU request & CPU limit units for the otel-collector?
109
111
{{% /notice %}}
110
112
111
-
At this point, you can drill into the information of the pods, but that is outside the scope of this workshop, for now reset your view by removing the filter for the **splunk-otel-collector-k8s-cluster-receiver** workload and setting the **Color by** option to **Pods Running**.
Most of our customers will make use of some kind of private or public cloud service to run Kubernetes. They often choose to have only a few large Kubernetes clusters as it is easier to manage centrally.
10
+
11
+
Namespaces are a way to organize these large Kubernetes clusters into virtual sub-clusters. This can be helpful when different teams or projects share a Kubernetes cluster as this will give them the easy ability to just see and work with their resources.
12
+
13
+
Any number of namespaces are supported within a cluster, each logically separated from others but with the ability to communicate with each other. Components are only **visible** when selecting a namespace or when adding the `--all-namespaces` flag to `kubectl` instead of allowing you to view just the components relevant to your project by selecting your namespace.
14
+
15
+
Most customers will want to install the applications into a separate namespace. This workshop will follow that best practice.
16
+
17
+
## 2. DNS and Services in Kubernetes
8
18
9
19
The Domain Name System (DNS) is a mechanism for linking various sorts of information with easy-to-remember names, such as IP addresses. Using a DNS system to translate request names into IP addresses makes it easy for end-users to reach their target domain name effortlessly.
More information can be found here: [**DNS for Service and Pods**](https://kubernetes.io/docs/concepts/services-networking/dns-pod-service/)
32
42
33
-
## 2. Review OTel receiver for PHP/Apache
43
+
## 3. Review OTel receiver for PHP/Apache
34
44
35
45
Inspect the YAML file `~/workshop/k3s/otel-apache.yaml` and validate the contents using the following command:
36
46
@@ -55,7 +65,7 @@ agent:
55
65
service.name: php-apache
56
66
```
57
67
58
-
## 3. Observation Rules in the OpenTelemetry config
68
+
## 4. Observation Rules in the OpenTelemetry config
59
69
60
70
The above file contains an observation rule for Apache using the OTel `receiver_creator`. This receiver can instantiate other receivers at runtime based on whether observed endpoints match a configured rule.
@@ -94,16 +103,16 @@ The **REVISION** number of the deployment has changed, which is a helpful way to
94
103
``` text
95
104
Release "splunk-otel-collector" has been upgraded. Happy Helming!
96
105
NAME: splunk-otel-collector
97
-
LAST DEPLOYED: Tue Jan 31 16:57:22 2023
98
-
NAMESPACE: splunk
106
+
LAST DEPLOYED: Tue Feb 6 11:17:15 2024
107
+
NAMESPACE: default
99
108
STATUS: deployed
100
109
REVISION: 2
101
110
TEST SUITE: None
102
111
```
103
112
104
113
{{% /notice %}}
105
114
106
-
## 4. Kubernetes ConfigMaps
115
+
## 5. Kubernetes ConfigMaps
107
116
108
117
A ConfigMap is an object in Kubernetes consisting of key-value pairs that can be injected into your application. With a ConfigMap, you can separate configuration from your Pods.
109
118
@@ -112,7 +121,7 @@ Using ConfigMap, you can prevent hardcoding configuration data. ConfigMaps are u
112
121
The OpenTelemetry collector/agent uses ConfigMaps to store the configuration of the agent and the K8s Cluster receiver. You can/will always verify the current configuration of an agent after a change by running the following commands:
Using Log Observer what is the issue with the PHP/Apache deployment?
223
232
224
-
**Tip:** Adjust your **Table settings** by clicking on the cog to use only `object.involvedObject.name`, `object.message` and `k8s.cluster.name`. Make sure you unselect `_raw`!
233
+
**Tip:** Adjust your filters to use: `object = php-apache-svc` and `k8s.cluster.name = <your_cluster>`.
0 commit comments