Ensure mDNS is functioning properly on MacOS

daprdocs/content/en/developing-applications/building-blocks/service-invocation/service-invocation-overview.md

@@ -90,6 +90,8 @@ Connection establishment via gRPC to the target sidecar has a timeout of 5 secon
 
 Dapr can run on any [hosting platform]({{< ref hosting >}}). For the supported hosting platforms this means they have a [name resolution component](https://github.com/dapr/components-contrib/tree/master/nameresolution) developed for them that enables service discovery. For example, the Kubernetes name resolution component uses the Kubernetes DNS service to resolve the location of other applications running in the cluster. For local and multiple physical machines this uses the mDNS protocol.
 
+> Note: [For local and physical machines, ensure mDNS is functioning properly.]({{< ref "common_issues.md#my-dapr-service-instance-is-missing-an-app-id-value-macos" >}})
+
 ### Round robin load balancing with mDNS
 Dapr provides round robin load balancing of service invocation requests with the mDNS protocol, for example with a single machine or with multiple, networked, physical machines.
 

daprdocs/content/en/operations/troubleshooting/common_issues.md

@@ -212,3 +212,17 @@ This is usually due to one of the following issues
 - You may have defined the `NAMESPACE` environment variable locally or deployed your components into a different namespace in Kubernetes. Check which namespace your app and the components are deployed to. Read [scoping components to one or more applications]({{< ref "component-scopes.md" >}}) for more information. 
 - You may have not provided a `--components-path` with the Dapr `run` commands or not placed your components into the default components folder for your OS. Read [define a component]({{< ref "get-started-component.md" >}}) for more information. 
 - You may have a syntax issue in component YAML file. Check your component YAML with the component [YAML samples]({{< ref "components.md" >}}).
+
+## My dapr service instance is missing an app-id value (MacOS)
+
+Some organizations will implement software that filters out all UPD traffic, which is what mDNS is based on. Mostly commonly, on MacOS, `Microsoft Content Filter` is the culprit.
+
+In order for mDNS to function properly, ensure `Micorosft Content Filter` is inactive.
+
+- Open a terminal shell.
+- Type `mdatp system-extension network-filter disable` and hit enter.
+- Enter your account password.
+
+Microsoft Content Filter is disbaled when the output is "Success". 
+
+> Some organizations will re-enable the filter from time to time. If you repeatedly encounter app-id values missing, first check to see if the filter has been re-enabled before doing more extensive troubleshooting.