dashanji commented on code in PR #116: URL: https://github.com/apache/skywalking-swck/pull/116#discussion_r1575051079
########## docs/examples/event-exporter.md: ########## @@ -0,0 +1,271 @@ +# SkyWalking Kubernetes Event Exporter User Guide + +[SkyWalking Kubernetes Event Exporter](https://github.com/apache/skywalking-kubernetes-event-exporter) is able to watch, +filter, and send Kubernetes events into the Apache SkyWalking backend. + +## Demo + +### Step 1: Create a Local Kubernetes Cluster + +Please follow step 1 to 3 in [getting started](../getting-started.md) to create a cluster. + +### Step 2: Deploy OAP server and Event Exporter + +Create the `skywalking-system` namespace. + +```shell +$ kubectl create namespace skywalking-system +``` + +Deploy an OAP server and an event exporter. + +```shell +cat <<EOF | kubectl apply -f - +apiVersion: operator.skywalking.apache.org/v1alpha1 +kind: OAPServer +metadata: + name: skywalking-system + namespace: skywalking-system +spec: + version: 9.5.0 + instances: 1 + image: apache/skywalking-oap-server:9.5.0 + service: + template: + type: ClusterIP + +--- +apiVersion: operator.skywalking.apache.org/v1alpha1 +kind: EventExporter +metadata: + name: skywalking-system + namespace: skywalking-system +spec: + replicas: 1 + config: | + filters: + - reason: "" + message: "" + minCount: 1 + type: "" + action: "" + kind: "Pod|Service" + namespace: "^skywalking-system$" + name: "" + service: "[^\\s]{1,}" + exporters: + - skywalking + exporters: + skywalking: + template: + source: + service: "{{ .Service.Name }}" + serviceInstance: "{{ .Pod.Name }}" + endpoint: "" + message: "{{ .Event.Message }}" + address: "skywalking-system-oap.skywalking-system:11800" +EOF +``` + +Wait until both components are ready... + +```shell +$ kubectl get pod -n skywalking-system +NAME READY STATUS RESTARTS AGE +skywalking-system-eventexporter-566db46fb6-npx8v 1/1 Running 0 50s +skywalking-system-oap-68bd877f57-zs8hw 1/1 Running 0 50s +``` + +### Step 3: Check Reported Events + +We can verify k8s events is reported to the OAP server by +using [skywalking-cli](https://github.com/apache/skywalking-cli). + +First, port-forward the OAP http service to your local machine. + +```shell +$ kubectl port-forward svc/skywalking-system-oap 12800:12800 -n skywalking-system +``` + +Next, use `swctl` to list reported events in YAML format. + +```shell +$ swctl --display yaml event ls +``` + +The output should contain k8s events of the OAP server. + +```yaml +events: + - uuid: 1d5bfe48-bc8d-4f5a-9680-188f59793459 + source: + service: skywalking-system-oap + serviceinstance: skywalking-system-oap-68bd877f57-cvkjb + endpoint: "" + name: Pulled + type: Normal + message: Successfully pulled image "apache/skywalking-oap-server:9.5.0" in 6m4.108914335s + parameters: [ ] + starttime: 1713793327000 + endtime: 1713793327000 + layer: K8S + - uuid: f576f6ad-748d-4cec -9260-6587c145550e + source: + service: skywalking-system-oap + serviceinstance: skywalking-system-oap-68bd877f57-cvkjb + endpoint: "" + name: Created + type: Normal + message: Created container oap + parameters: [ ] + starttime: 1713793327000 + endtime: 1713793327000 + layer: K8S + - uuid: 0cec5b55-4cb0-4ff7-a670-a097609c531f + source: + service: skywalking-system-oap + serviceinstance: skywalking-system-oap-68bd877f57-cvkjb + endpoint: "" + name: Started + type: Normal + message: Started container oap + parameters: [ ] + starttime: 1713793327000 + endtime: 1713793327000 + layer: K8S + - uuid: 28f0d004-befe-4c27-a7b7-dfdc4dd755fa + source: + service: skywalking-system-oap + serviceinstance: skywalking-system-oap-68bd877f57-cvkjb + endpoint: "" + name: Pulling + type: Normal + message: Pulling image "apache/skywalking-oap-server:9.5.0" + parameters: [ ] + starttime: 1713792963000 + endtime: 1713792963000 + layer: K8S + - uuid: 6d766801-5057-42c0-aa63-93ce1e201418 + source: + service: skywalking-system-oap + serviceinstance: skywalking-system-oap-68bd877f57-cvkjb + endpoint: "" + name: Scheduled + type: Normal + message: Successfully assigned skywalking-system/skywalking-system-oap-68bd877f57-cvkjb + to kind-worker + parameters: [ ] + starttime: 1713792963000 + endtime: 1713792963000 + layer: K8S +``` + +We can also verify by checking logs of the event exporter. + +```shell +kubectl logs -f skywalking-system-eventexporter-566db46fb6-npx8v -n skywalking-system +... +DEBUG done: rendered event is: uuid:"8d8c2bd1-1812-4b0c-8237-560688366280" source:{service:"skywalking-system-oap" serviceInstance:"skywalking-system-oap-68bd877f57-zs8hw"} name:"Started" message:"Started container oap" startTime:1713795214000 endTime:1713795214000 layer:"K8S" +``` + +## Spec + +| name | description | default value | +|----------|--------------------------------------------------------|------------------------------------------------------| +| image | Docker image of the event exporter. | `apache/skywalking-kubernetes-event-exporter:latest` |. | `"skywalking-system-oap.skywalking-system:11800"` | Review Comment: ditto -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
