From d89fed3b9c26782057f5ae8f8c85e054ea4bbf86 Mon Sep 17 00:00:00 2001 From: Meg McRoberts Date: Thu, 16 Nov 2023 02:35:44 -0800 Subject: [PATCH] docs: remove duplicated DORA section from otel.md (#2511) Co-authored-by: Moritz Wiesinger --- docs/content/en/docs/implementing/dora.md | 22 ++++--- docs/content/en/docs/implementing/otel.md | 76 +++++------------------ 2 files changed, 28 insertions(+), 70 deletions(-) diff --git a/docs/content/en/docs/implementing/dora.md b/docs/content/en/docs/implementing/dora.md index dcb9a218ff..ed40e926b6 100644 --- a/docs/content/en/docs/implementing/dora.md +++ b/docs/content/en/docs/implementing/dora.md @@ -23,7 +23,7 @@ Keptn starts collecting these metrics as soon as you apply [basic annotations](./integrate.md#basic-annotations) to the -[Workload](https://kubernetes.io/docs/concepts/workloads/) +[workload](https://kubernetes.io/docs/concepts/workloads/) resources ([Deployments](https://kubernetes.io/docs/concepts/workloads/controllers/deployment/), [StatefulSets](https://kubernetes.io/docs/concepts/workloads/controllers/statefulset/), @@ -39,21 +39,23 @@ To view DORA metrics, run the following two commands: - Retrieve the service name with: -```shell -kubectl -n keptn-lifecycle-toolkit-system get service -l control-plane=lifecycle-operator -``` + ```shell + kubectl -n keptn-lifecycle-toolkit-system get service \ + -l control-plane=lifecycle-operator + ``` - Then port-forward to the name of your service: -```shell -kubectl -n keptn-lifecycle-toolkit-system port-forward service/ 2222 -``` + ```shell + kubectl -n keptn-lifecycle-toolkit-system port-forward \ + service/ 2222 + ``` Then view the metrics at: -```shell -http://localhost:2222/metrics -``` + ```shell + http://localhost:2222/metrics + ``` DORA metrics are also displayed on Grafana or whatever dashboard application you choose. diff --git a/docs/content/en/docs/implementing/otel.md b/docs/content/en/docs/implementing/otel.md index 4de827bd57..3233f451b3 100644 --- a/docs/content/en/docs/implementing/otel.md +++ b/docs/content/en/docs/implementing/otel.md @@ -22,69 +22,23 @@ This means that: The observability data is an amalgamation of the following: -- DORA metrics are collected out of the box - when Keptn is enabled -- OpenTelemetry runs traces that show - everything that happens in the Kubernetes cluster -- Custom Keptn metrics that you can use to monitor - information from all the data providers configured in your cluster +- [DORA metrics](dora.md) + are collected out of the box when Keptn is enabled +- [OpenTelemetry](https://opentelemetry.io/) + runs traces that show everything that happens in the Kubernetes cluster +- Custom + [Keptn metrics](evaluatemetrics.md) + that you can use to monitor information + from all the data providers configured in your cluster All this information can be displayed with dashboard tools such as Grafana. For an introduction to using OpenTelemetry with Keptn metrics, see the -[Standardize observability](../intro/usecase-observability.md) +[Keptn Observability](../getting-started/observability.md) getting started guide. -## DORA metrics - -DORA metrics are an industry-standard set of measurements; -see the following for a description: - -- [What are DORA Metrics and Why Do They Matter?](https://codeclimate.com/blog/dora-metrics) -- [Are you an Elite DevOps Performer? - Find out with the Four Keys Project](https://cloud.google.com/blog/products/devops-sre/using-the-four-keys-to-measure-your-devops-performance) - -DORA metrics provide information such as: - -- How many deployments happened in the last six hours? -- Time between deployments -- Deployment time between versions -- Average time between versions. - -Keptn starts collecting these metrics -as soon as you apply -[basic annotations](./integrate.md#basic-annotations) -to the [workload](https://kubernetes.io/docs/concepts/workloads/). -Metrics are collected only for the resources -that are annotated. - -To view DORA metrics, run the following two commands: - -- Retrieve the service name with: - -```shell -kubectl -n keptn-lifecycle-toolkit-system get service -l control-plane=lifecycle-operator -``` - -- Then port-forward to the name of your service: - -```shell -kubectl -n keptn-lifecycle-toolkit-system port-forward service/ 2222 -``` - -Then view the metrics at: - -```shell -http://localhost:2222/metrics -``` - -DORA metrics can be displayed on Grafana -or whatever dashboard application you choose. - -## OpenTelemetry - -### Requirements for OpenTelemetry +## Requirements for OpenTelemetry To access OpenTelemetry metrics with Keptn, you must have the following on your cluster: @@ -97,13 +51,15 @@ you must have the following on your cluster: See [Prometheus Operator Setup](https://github.com/prometheus-operator/kube-prometheus/blob/main/docs/customizing.md). - The Prometheus Operator must have the required permissions - to watch resources of your Keptn namespace (default is `keptn-lifecycle-toolkit-system`) (see + to watch resources of your Keptn namespace + (default is `keptn-lifecycle-toolkit-system`). + See [Setup for Monitoring other Namespaces](https://prometheus-operator.dev/docs/kube/monitoring-other-namespaces/)). - To install Prometheus into the `monitoring` namespace using the example configuration included with Keptn, use the following command sequence. - Use similar commands if you define a different configuration: + You can modify these commands to define a different configuration: > **Note** You must clone the `lifecycle-toolkit` repository @@ -135,13 +91,13 @@ you must have the following on your cluster: See [Accessing Metrics via the Kubernetes Custom Metrics API](evaluatemetrics.md/#accessing-metrics-via-the-kubernetes-custom-metrics-api) -### Integrate OpenTelemetry into Keptn +## Integrate OpenTelemetry into Keptn To integrate OpenTelemetry into Keptn: - Apply [basic annotations](./integrate.md#basic-annotations) - for your `Deployment` resource + for the `Deployment` resource(s) to integrate Keptn into your Kubernetes cluster. - To expose OpenTelemetry metrics, define a [KeptnConfig](../yaml-crd-ref/config.md) resource