From a04652e11657e5c5a4295a433363ede84d182118 Mon Sep 17 00:00:00 2001 From: Pengyuan Bian Date: Tue, 7 Jan 2020 10:39:34 -0800 Subject: [PATCH] update doc to remove usage of stats filter (#6308) * update doc to remove usage of stats filter doc * update * update empty line --- .../in-proxy-service-telemetry/index.md | 38 +------------------ .../in-proxy-service-telemetry/index.md | 37 +----------------- 2 files changed, 4 insertions(+), 71 deletions(-) diff --git a/content/en/docs/ops/configuration/telemetry/in-proxy-service-telemetry/index.md b/content/en/docs/ops/configuration/telemetry/in-proxy-service-telemetry/index.md index 365f789ca5..2dc59ec2b7 100644 --- a/content/en/docs/ops/configuration/telemetry/in-proxy-service-telemetry/index.md +++ b/content/en/docs/ops/configuration/telemetry/in-proxy-service-telemetry/index.md @@ -19,44 +19,10 @@ metrics that Mixer currently generates: ## Enable service-level metrics generation in Envoy -To generate service-level metrics directly in the Envoy proxies, follow these steps: - -Option 1: +To generate service-level metrics directly in the Envoy proxies, set the following values: {{< text bash >}} - $ istioctl manifest apply --set values.telemetry.enabled=true,values.telemetry.v2.enabled=true - {{< /text >}} - -Option 2: - -Follow these steps manually: - -1. To disable Mixer http reporting, set `disableMixerHttpReports` to true in your mesh configuration - - Check the existing status: - - {{< text bash >}} - $ kubectl -n istio-system get cm istio -o jsonpath="{@.data.mesh}" | grep disableMixerHttpReports - disableMixerHttpReports: true - {{< /text >}} - - If disableMixerHttpReports is set to false, update your mesh configuration: - - {{< text bash >}} - $ kubectl -n istio-system get cm istio -o yaml | sed -e 's/disableMixerHttpReports: false/disableMixerHttpReports: true/g' | kubectl replace -f - - {{< /text >}} - -1. To generate service-level metrics, the proxies must exchange {{< gloss >}}workload{{< /gloss >}} metadata. - A custom filter handles this exchange. Enable the metadata exchange filter with the following command: - - {{< text bash >}} - $ kubectl -n istio-system apply -f @tests/integration/telemetry/stats/prometheus/testdata/metadata_exchange_filter.yaml@ - {{< /text >}} - -1. To actually generate the service-level metrics, you must apply the custom stats filter. - - {{< text bash >}} - $ kubectl -n istio-system apply -f @tests/integration/telemetry/stats/prometheus/testdata/stats_filter.yaml@ + $ istioctl manifest apply --set values.telemetry.enabled=true,values.telemetry.v1.enabled=false,values.telemetry.v2.enabled=true,values.telemetry.v2.prometheus.enabled=true {{< /text >}} Go to the **Istio Mesh** Grafana dashboard. Verify that the dashboard displays the same telemetry as before but without diff --git a/content/zh/docs/ops/configuration/telemetry/in-proxy-service-telemetry/index.md b/content/zh/docs/ops/configuration/telemetry/in-proxy-service-telemetry/index.md index 0a954ef7ab..07991dbe6a 100644 --- a/content/zh/docs/ops/configuration/telemetry/in-proxy-service-telemetry/index.md +++ b/content/zh/docs/ops/configuration/telemetry/in-proxy-service-telemetry/index.md @@ -17,43 +17,10 @@ Istio 1.4 对直接在 Envoy 代理中生成服务级别的 HTTP 指标添加了 ## 在 Envoy 中启用服务级别指标生成功能{#enable-service-level-metrics-generation-in-envoy} -要直接在 Envoy 代理中生成服务级别的指标，请按照下列步骤操作： - -选项 1： +要直接在 Envoy 代理中生成服务级别的指标，请配置以下选项： {{< text bash >}} - $ istioctl manifest apply --set values.telemetry.enabled=true,values.telemetry.v2.enabled=true - {{< /text >}} - -选项 2： - -手动执行以下步骤： - -1. 要禁用 Mixer http 报告，请在您的网格配置中将 `disableMixerHttpReports` 设置为 true - - 检查现有状态： - - {{< text bash >}} - $ kubectl -n istio-system get cm istio -o jsonpath="{@.data.mesh}" | grep disableMixerHttpReports - disableMixerHttpReports: true - {{< /text >}} - - 如果 disableMixerHttpReports 被设置为 false，更新您的网格配置： - - {{< text bash >}} - $ kubectl -n istio-system get cm istio -o yaml | sed -e 's/disableMixerHttpReports: false/disableMixerHttpReports: true/g' | kubectl replace -f - - {{< /text >}} - -1. 为了生成服务级别的指标，代理必须交换 {{< gloss >}}workload{{< /gloss >}} 元数据。有一个自定义的过滤器可以来处理元数据交换。请使用如下命令来启用元数据交换过滤器： - - {{< text bash >}} - $ kubectl -n istio-system apply -f @tests/integration/telemetry/stats/prometheus/testdata/metadata_exchange_filter.yaml@ - {{< /text >}} - -1. 为了最终生成服务级别的指标，你必须应用一个自定义的统计过滤器。 - - {{< text bash >}} - $ kubectl -n istio-system apply -f @tests/integration/telemetry/stats/prometheus/testdata/stats_filter.yaml@ + $ istioctl manifest apply --set values.telemetry.enabled=true,values.telemetry.v1.enabled=false,values.telemetry.v2.enabled=true,values.telemetry.v2.prometheus.enabled=true {{< /text >}} 打开 **Istio Mesh** Grafana 面板。可以验证在没有任何请求经过 Istio Mixer 的情况下仍然显示和之前一样的遥测指标。