From 61d9adbd179739d1b99cb269e9845a3d452c7a97 Mon Sep 17 00:00:00 2001
From: Blake Covarrubias <blake@covarrubi.as>
Date: Sat, 12 Jun 2021 15:21:07 -0700
Subject: [PATCH] docs: Add example of escaping tracing JSON using jq

---
 .../content/docs/connect/proxies/envoy.mdx    | 22 ++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/website/content/docs/connect/proxies/envoy.mdx b/website/content/docs/connect/proxies/envoy.mdx
index 2072b23aa..7c4d65306 100644
--- a/website/content/docs/connect/proxies/envoy.mdx
+++ b/website/content/docs/connect/proxies/envoy.mdx
@@ -401,7 +401,27 @@ For example, given a tracing config:
 ```
 
 JSON escape the value of `tracing` into a string, for example using [https://codebeautify.org/json-escape-unescape](https://codebeautify.org/json-escape-unescape),
-and then use that as the value for `envoy_tracing_json`:
+or using [jq](https://stedolan.github.io/jq/).
+
+```shell
+$ cat <<EOF | jq '. | @json'
+{
+  "http": {
+    "name": "envoy.tracers.zipkin",
+    "typedConfig": {
+      "@type": "type.googleapis.com/envoy.config.trace.v3.ZipkinConfig",
+      "collector_cluster": "zipkin",
+      "collector_endpoint_version": "HTTP_JSON",
+      "collector_endpoint": "/api/v1/spans",
+      "shared_span_context": false
+    }
+  }
+}
+EOF
+"{\"http\":{\"name\":\"envoy.tracers.zipkin\",\"typedConfig\":{\"@type\":\"type.googleapis.com/envoy.config.trace.v3.ZipkinConfig\",\"collector_cluster\":\"zipkin\",\"collector_endpoint_version\":\"HTTP_JSON\",\"collector_endpoint\":\"/api/v1/spans\",\"shared_span_context\":false}}}"
+```
+
+Then use that as the value for `envoy_tracing_json`:
 
 ```json
 {