Skip to main content

user_metrics

Creates, updates, deletes, gets or lists a user_metrics resource.

Overview​

Nameuser_metrics
TypeResource
Idpagerduty.analytics.user_metrics

Fields​

The following fields are returned by SELECT queries:

Returns user metrics aggregated across the account

NameDatatypeDescription
total_downloaded_mobile_app_countintegerThe number of users who have downloaded the mobile app.
total_downloaded_mobile_app_percentagenumber (float)The percentage of users who have downloaded the mobile app.
total_on_escalation_policy_countintegerThe number of users who are on at least one escalation policy.
total_on_escalation_policy_percentagenumber (float)The percentage of users who are on at least one escalation policy.
total_signed_up_countintegerThe number of users who have signed up (completed onboarding).
total_signed_up_percentagenumber (float)The percentage of users who have signed up.
total_user_countintegerThe total number of users in the account that match the filters.
total_with_notification_methods_countintegerThe number of users who have at least one notification method configured.
total_with_notification_methods_percentagenumber (float)The percentage of users who have at least one notification method configured.

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
listselectProvides aggregated metrics across all users within their account. This endpoint provides summary statistics about user activity and performance.<br /><br /><!-- theme: info --><br />> Note: Data availability reflects [pipeline processing cycles](https:​//support.pagerduty.com/main/docs/insights#:~:text=Data%20Update%20Schedule) and is generally within 24 hours under normal conditions.<br /><br />Scoped OAuth requires: analytics.write<br />

Parameters​

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription

SELECT examples​

Provides aggregated metrics across all users within their account. This endpoint provides summary statistics about user activity and performance.<br /><br /><!-- theme: info --><br />> Note: Data availability reflects [pipeline processing cycles](https:​//support.pagerduty.com/main/docs/insights#:~:text=Data%20Update%20Schedule) and is generally within 24 hours under normal conditions.<br /><br />Scoped OAuth requires: analytics.write<br />

SELECT
total_downloaded_mobile_app_count,
total_downloaded_mobile_app_percentage,
total_on_escalation_policy_count,
total_on_escalation_policy_percentage,
total_signed_up_count,
total_signed_up_percentage,
total_user_count,
total_with_notification_methods_count,
total_with_notification_methods_percentage
FROM pagerduty.analytics.user_metrics
;