Add support for app_state metricset (#20639) (#21510)

* mofidy doc

* add metricset

* chnagelog

* config

* work on app_state

* remove extra

* fix changelog

* mage fmt update

* work on mapping fields

* work on tests

* fix vis name

* no default

* fix tests

* add headers

(cherry picked from commit 67a2d38)

CHANGELOG.next.asciidoc

@@ -394,6 +394,7 @@ field. You can revert this change by configuring tags for the module and omittin
 - Updates vm_compute metricset with more info on guest metrics. {pull}20448[20448]
 - Add fallback for PdhExpandWildCardPathW failing in perfmon metricset. {issue}20139[20139] {pull}20630[20630]
 - Fix resource tags in aws cloudwatch metricset {issue}20326[20326]  {pull}20385[20385]
+- Add support for azure light metricset app_stats. {pull}20639[20639]
 - Fix ec2 disk and network metrics to use Sum statistic method. {pull}20680[20680]
 - Fill cloud.account.name with accountID if account alias doesn't exist. {pull}20736[20736]
 - Fix ec2 disk and network metrics to use Sum statistic method. {pull}20680[20680]

metricbeat/docs/fields.asciidoc

@@ -4665,6 +4665,16 @@ type: keyword
 The subscription ID
 
 
+type: keyword
+
+--
+
+*`azure.application_id`*::
++
+--
+The application ID
+
+
 type: keyword
 
 --
@@ -4696,17 +4706,44 @@ application insights
 
 
 
-*`azure.app_insights.application_id`*::
+*`azure.app_insights.start_date`*::
 +
 --
-The application ID
+The start date
 
 
-type: keyword
+type: date
 
 --
 
-*`azure.app_insights.start_date`*::
+*`azure.app_insights.end_date`*::
++
+--
+The end date
+
+
+type: date
+
+--
+
+*`azure.app_insights.metrics.*.*`*::
++
+--
+The metrics
+
+
+type: object
+
+--
+
+[float]
+=== app_state
+
+application state
+
+
+
+*`azure.app_state.start_date`*::
 +
 --
 The start date
@@ -4716,7 +4753,7 @@ type: date
 
 --
 
-*`azure.app_insights.end_date`*::
+*`azure.app_state.end_date`*::
 +
 --
 The end date
@@ -4726,13 +4763,183 @@ type: date
 
 --
 
-*`azure.app_insights.metrics.*.*`*::
+*`azure.app_state.requests_count.sum`*::
 +
 --
-The metrics
+Request count
 
 
-type: object
+type: float
+
+--
+
+*`azure.app_state.requests_failed.sum`*::
++
+--
+Request failed count
+
+
+type: float
+
+--
+
+*`azure.app_state.users_count.unique`*::
++
+--
+User count
+
+
+type: float
+
+--
+
+*`azure.app_state.sessions_count.unique`*::
++
+--
+Session count
+
+
+type: float
+
+--
+
+*`azure.app_state.users_authenticated.unique`*::
++
+--
+Authenticated users count
+
+
+type: float
+
+--
+
+*`azure.app_state.browser_timings_network_duration.avg`*::
++
+--
+Browser timings network duration
+
+
+type: float
+
+--
+
+*`azure.app_state.browser_timings_send_duration.avg`*::
++
+--
+Browser timings send duration
+
+
+type: float
+
+--
+
+*`azure.app_state.browser_timings_receive_uration.avg`*::
++
+--
+Browser timings receive duration
+
+
+type: float
+
+--
+
+*`azure.app_state.browser_timings_processing_duration.avg`*::
++
+--
+Browser timings processing duration
+
+
+type: float
+
+--
+
+*`azure.app_state.browser_timings_total_duration.avg`*::
++
+--
+Browser timings total duration
+
+
+type: float
+
+--
+
+*`azure.app_state.exceptions_count.sum`*::
++
+--
+Exception count
+
+
+type: float
+
+--
+
+*`azure.app_state.exceptions_browser.sum`*::
++
+--
+Exception count at browser level
+
+
+type: float
+
+--
+
+*`azure.app_state.exceptions_server.sum`*::
++
+--
+Exception count at server level
+
+
+type: float
+
+--
+
+*`azure.app_state.performance_counters_memory_available_bytes.avg`*::
++
+--
+Performance counters memory available bytes
+
+
+type: float
+
+--
+
+*`azure.app_state.performance_counters_process_private_bytes.avg`*::
++
+--
+Performance counters process private bytes
+
+
+type: float
+
+--
+
+*`azure.app_state.performance_counters_process_cpu_percentage_total.avg`*::
++
+--
+Performance counters process cpu percentage total
+
+
+type: float
+
+--
+
+*`azure.app_state.performance_counters_process_cpu_percentage.avg`*::
++
+--
+Performance counters process cpu percentage
+
+
+type: float
+
+--
+
+*`azure.app_state.performance_counters_processiobytes_per_second.avg`*::
++
+--
+Performance counters process IO bytes per second
+
+
+type: float
 
 --
 

metricbeat/docs/modules/azure.asciidoc

@@ -45,6 +45,10 @@ The Azure billing dashboards show relevant usage and forecast information:
 
 image::./images/metricbeat-azure-billing-overview.png[]
 
+The Azure app_state dashboard shows relevant application insights information:
+
+image::./images/metricbeat-azure-app-state-overview.png[]
+
 [float]
 === Module-specific configuration notes
 
@@ -120,6 +124,10 @@ so the `period` for `billing` metricset  should be `24h` or multiples of `24h`.
 === `app_insights`
 This metricset will collect application insights metrics, the `period` (interval) for the `app-insights` metricset is set by default at `300s`.
 
+[float]
+=== `app_state`
+This metricset concentrate on the most relevant application insights metrics and provides a dashboard for visualization, the `period` (interval) for the `app_state` metricset is set by default at `300s`.
+
 [float]
 [[azure-api-cost]]
 == Additional notes about metrics and costs
@@ -242,6 +250,14 @@ metricbeat.modules:
   api_key: ''
   metrics:
     - id: ["requests/count", "requests/duration"]
+
+- module: azure
+  metricsets:
+    - app_state
+  enabled: true
+  period: 300s
+  application_id: ''
+  api_key: ''
 ----
 
 [float]
@@ -251,6 +267,8 @@ The following metricsets are available:
 
 * <<metricbeat-metricset-azure-app_insights,app_insights>>
 
+* <<metricbeat-metricset-azure-app_state,app_state>>
+
 * <<metricbeat-metricset-azure-billing,billing>>
 
 * <<metricbeat-metricset-azure-compute_vm,compute_vm>>
@@ -271,6 +289,8 @@ The following metricsets are available:
 
 include::azure/app_insights.asciidoc[]
 
+include::azure/app_state.asciidoc[]
+
 include::azure/billing.asciidoc[]
 
 include::azure/compute_vm.asciidoc[]

metricbeat/docs/modules/azure/app_state.asciidoc

@@ -0,0 +1,24 @@
+////
+This file is generated! See scripts/mage/docs_collector.go
+////
+
+[[metricbeat-metricset-azure-app_state]]
+[role="xpack"]
+=== Azure app_state metricset
+
+beta[]
+
+include::../../../../x-pack/metricbeat/module/azure/app_state/_meta/docs.asciidoc[]
+
+
+==== Fields
+
+For a description of each field in the metricset, see the
+<<exported-fields-azure,exported fields>> section.
+
+Here is an example document generated by this metricset:
+
+[source,json]
+----
+include::../../../../x-pack/metricbeat/module/azure/app_state/_meta/data.json[]
+----

metricbeat/docs/modules_list.asciidoc

@@ -33,7 +33,8 @@ This file is generated! See scripts/mage/docs_collector.go
 |<<metricbeat-metricset-aws-usage,usage>> beta[]  
 |<<metricbeat-metricset-aws-vpn,vpn>> beta[]  
 |<<metricbeat-module-azure,Azure>>     |image:./images/icon-yes.png[Prebuilt dashboards are available]    |  
-.10+| .10+|  |<<metricbeat-metricset-azure-app_insights,app_insights>> beta[]  
+.11+| .11+|  |<<metricbeat-metricset-azure-app_insights,app_insights>> beta[]  
+|<<metricbeat-metricset-azure-app_state,app_state>> beta[]  
 |<<metricbeat-metricset-azure-billing,billing>> beta[]  
 |<<metricbeat-metricset-azure-compute_vm,compute_vm>>   
 |<<metricbeat-metricset-azure-compute_vm_scaleset,compute_vm_scaleset>>   

x-pack/metricbeat/metricbeat.reference.yml

@@ -343,6 +343,14 @@ metricbeat.modules:
   metrics:
     - id: ["requests/count", "requests/duration"]
 
+- module: azure
+  metricsets:
+    - app_state
+  enabled: true
+  period: 300s
+  application_id: ''
+  api_key: ''
+
 #--------------------------------- Beat Module ---------------------------------
 - module: beat
   metricsets:

x-pack/metricbeat/module/azure/_meta/config.reference.yml

@@ -102,3 +102,11 @@
   api_key: ''
   metrics:
     - id: ["requests/count", "requests/duration"]
+
+- module: azure
+  metricsets:
+    - app_state
+  enabled: true
+  period: 300s
+  application_id: ''
+  api_key: ''

x-pack/metricbeat/module/azure/_meta/config.yml

@@ -111,3 +111,11 @@
 #  api_key: ''
 #  metrics:
 #   - id: ["requests/count", "requests/duration"]
+
+#- module: azure
+#  metricsets:
+#    - app_state
+#  enabled: true
+#  period: 300s
+#  application_id: ''
+#  api_key: ''