From de1043c657260f82da921961a1a50bc9564400b3 Mon Sep 17 00:00:00 2001 From: Matt Moore Date: Tue, 3 Mar 2020 16:49:59 -0800 Subject: [PATCH 1/2] Rename Monitoring bundle to Observability plugin. Related: https://github.com/knative/docs/issues/2265 --- docs/install/any-kubernetes-cluster.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/install/any-kubernetes-cluster.md b/docs/install/any-kubernetes-cluster.md index b9761f0da03..106671000bb 100644 --- a/docs/install/any-kubernetes-cluster.md +++ b/docs/install/any-kubernetes-cluster.md @@ -26,7 +26,7 @@ description of each: - [**Serving**](#installing-the-serving-component) {{< feature-state version="v0.9" state="stable" short=true >}} provides an abstraction for stateless request-based scale-to-zero services. - [**Eventing**](#installing-the-eventing-component) {{< feature-state version="v0.2" state="alpha" short=true >}} provides abstractions to enable binding event sources (e.g. Github Webhooks, Kafka) and consumers (e.g. Kubernetes or Knative Services). -Knative also has a [**Monitoring bundle**](#installing-the-monitoring-bundle) {{< feature-state version="v0.1" state="alpha" short=true >}} which provides standard tooling that can be used to get visibility into the health of the software running on Knative. +Knative also has an [**Observability plugin**](#installing-the-observability-plugin) {{< feature-state version="v0.1" state="alpha" short=true >}} which provides standard tooling that can be used to get visibility into the health of the software running on Knative. ## Before you begin @@ -587,13 +587,13 @@ To learn more about the Cloud Audit Logs source, try [our sample](../eventing/sa You can find a number of samples for Knative Eventing [here](../eventing/samples/README.md). A quick-start guide is available [here](../eventing/getting-started.md). -## Installing the Monitoring bundle +## Installing the Observability plugin {{< feature-state version="v0.2" state="alpha" >}} -Knative provides a bundle of monitoring components that can be used to make the Serving and Eventing components more observable. +Knative provides a collection of observability components that can be used to make the Serving and Eventing components more observable. -Before you install any specific monitoring components, you must first install the core monitoring pieces: +Before you install any specific observability components, you must first install the core: ```bash kubectl apply --filename {{< artifact repo="serving" file="monitoring-core.yaml" >}} From 86b91111e60ca7ddb602fddef8deafd3e577166a Mon Sep 17 00:00:00 2001 From: Matt Moore Date: Tue, 3 Mar 2020 19:16:59 -0800 Subject: [PATCH 2/2] Incorporate feedback from Richie --- docs/install/any-kubernetes-cluster.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/install/any-kubernetes-cluster.md b/docs/install/any-kubernetes-cluster.md index 106671000bb..b986b12c743 100644 --- a/docs/install/any-kubernetes-cluster.md +++ b/docs/install/any-kubernetes-cluster.md @@ -591,14 +591,16 @@ You can find a number of samples for Knative Eventing [here](../eventing/samples {{< feature-state version="v0.2" state="alpha" >}} -Knative provides a collection of observability components that can be used to make the Serving and Eventing components more observable. +Install the following observability features to enable logging, metrics, and request tracing in your Serving and Eventing components. -Before you install any specific observability components, you must first install the core: +All observibility plugins require that you first install the core: ```bash kubectl apply --filename {{< artifact repo="serving" file="monitoring-core.yaml" >}} ``` +After the core is installed, you can choose to install one or all of the following observability plugins: + - Install [Prometheus](https://prometheus.io/) and [Grafana](https://grafana.com/) for metrics: ```bash