diff --git a/docs/templating-language.md b/docs/templating-language.md index 6847fb8a6..c53d8e1cf 100644 --- a/docs/templating-language.md +++ b/docs/templating-language.md @@ -580,11 +580,16 @@ order. If provided a node name, results are ordered by shortest round-trip time to the provided node. If provided `_agent`, results are ordered by shortest round-trip time to the local agent. -The `` attribute is optional; if omitted, only health services are +The `` attribute is optional; if omitted, only healthy services are returned. Providing a filter allows for client-side filtering of services. For example: +```liquid +{{ range service tag1.web@east-aws }} +server {{ .Name }} {{ .Address }}:{{ .Port }}{{ end }} +``` + The example above is querying Consul for healthy "web" services, in the "east-aws" data center. The tag and data center attributes are optional. To query all nodes of the "web" service (regardless of tag) for the current data center: ```liquid