From ea33c390ce33b10cc47a0fc60f536f02920b82db Mon Sep 17 00:00:00 2001 From: woz5999 Date: Tue, 25 Aug 2020 15:19:42 -0700 Subject: [PATCH] update docs and add changelog --- .changelog/8564.txt | 3 +++ website/content/docs/connect/proxies/envoy.mdx | 8 +++++--- 2 files changed, 8 insertions(+), 3 deletions(-) create mode 100644 .changelog/8564.txt diff --git a/.changelog/8564.txt b/.changelog/8564.txt new file mode 100644 index 0000000000..2cb931f685 --- /dev/null +++ b/.changelog/8564.txt @@ -0,0 +1,3 @@ +```release-notes:improvement +cli: the `consul connect envoy --envoy_statsd_url` flag will now resolve the `$HOST_IP` environment variable, as part of a full url. +``` diff --git a/website/content/docs/connect/proxies/envoy.mdx b/website/content/docs/connect/proxies/envoy.mdx index cd9188588a..f30b7fdbfb 100644 --- a/website/content/docs/connect/proxies/envoy.mdx +++ b/website/content/docs/connect/proxies/envoy.mdx @@ -130,15 +130,17 @@ definition](/docs/connect/registration/service-registration) or ~> **Note:** currently the url **must use an ip address** not a dns name due to the way Envoy is setup for StatsD. + Expansion of the environment variable `HOST_IP` is supported, e.g. + `udp://${HOST_IP}:8125`. + Users can also specify the whole parameter in the form `$ENV_VAR_NAME`, which will cause the `consul connect envoy` command to resolve the actual URL from the named environment variable when it runs. This, for example, allows each pod in a Kubernetes cluster to learn of a pod-specific IP address for StatsD when the Envoy instance is bootstrapped while still allowing global configuration of all proxies to use StatsD in the [global `proxy-defaults` - configuration entry](/docs/connect/config-entries/proxy-defaults). The env variable must contain a full valid URL - value as specified above and nothing else. It is not currently possible to use - environment variables as only part of the URL. + configuration entry](/docs/connect/config-entries/proxy-defaults). The env + variable must contain a full valid URL value as specified above and nothing else. - `envoy_dogstatsd_url` - The same as `envoy_statsd_url` with the following differences in behavior: