diff --git a/CHANGELOG.next.asciidoc b/CHANGELOG.next.asciidoc
index 4b24c9417fd..8db5577e913 100644
--- a/CHANGELOG.next.asciidoc
+++ b/CHANGELOG.next.asciidoc
@@ -169,6 +169,7 @@ https://github.com/elastic/beats/compare/v7.0.0-alpha2...master[Check the HEAD d
 - Fix storage metricset to allow config without region/zone. {issue}17623[17623] {pull}17624[17624]
 - Fix overflow on Prometheus rates when new buckets are added on the go. {pull}17753[17753]
 - Add a switch to the driver definition on SQL module to use pretty names {pull}17378[17378]
+- Modify doc for app_insights metricset to contain example of config. {pull}20185[20185]
 
 *Packetbeat*
 
diff --git a/x-pack/metricbeat/module/azure/app_insights/_meta/docs.asciidoc b/x-pack/metricbeat/module/azure/app_insights/_meta/docs.asciidoc
index 2ba1150078b..2b587acbbdd 100644
--- a/x-pack/metricbeat/module/azure/app_insights/_meta/docs.asciidoc
+++ b/x-pack/metricbeat/module/azure/app_insights/_meta/docs.asciidoc
@@ -45,17 +45,15 @@ This value is only valid when segment is specified.
 `filter`:: (_string_) An expression used to filter the results.
 This value should be a valid OData filter expression where the keys of each clause should be applicable dimensions for the metric you are retrieving.
 
-Users can select the options to retrieve all metrics from a specific namespace using the following:
+Example configuration:
 
 ["source","yaml"]
 ----
- metrics:
- - id: ["*"]
-   timespan: "Microsoft.Storage/storageAccounts"
+metrics:
+ - id: ["requests/count", "requests/failed"]
+   segment: "request/name"
+   aggregation: ["sum"]
 ----
 
 
 
-A default non configurable timegrain of 5 min is set so users are advised to configure an interval of 300s or  a multiply of it.
-
-