REST Resource: vitals.slowrenderingrate
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
리소스: SlowRenderingRateMetricSet
느린 렌더링 측정항목 집합을 나타내는 싱글톤 리소스입니다.
이 측정항목 세트에는 SurfaceFlinger에서 캡처한 하위 수준 렌더링 데이터가 포함됩니다. 세션은 앱이 소유한 SurfaceFlinger 레이어에서 처리한 프레임의 present-to-present 히스토그램을 기반으로 평가됩니다.
느린 세션은 세션의 프레임 중 25% 이상이 측정항목의 타겟 프레임 속도 (20fps 또는 30fps)를 충족하지 않는 세션입니다.
참고: 이 측정항목 세트는 게임에만 사용할 수 있습니다.
지원되는 집계 기간:
DAILY
: 측정항목이 캘린더 날짜 간격으로 집계됩니다. 이전의 제약으로 인해 지원되는 시간대는 America/Los_Angeles
뿐입니다.
지원되는 측정항목:
slowRenderingRate20Fps
(google.type.Decimal
): 집계 기간에 렌더링이 느린 고유 사용자의 비율입니다.
slowRenderingRate20Fps7dUserWeighted
(google.type.Decimal
): 지난 7일 동안의 slowRenderingRate20Fps
이동 평균 값입니다. 일일 값은 해당 날짜의 순 사용자 수에 따라 가중치가 부여됩니다.
slowRenderingRate20Fps28dUserWeighted
(google.type.Decimal
): 지난 28일 동안의 slowRenderingRate20Fps
이동 평균 값입니다. 일일 값은 해당 날짜의 순 사용자 수에 따라 가중치가 부여됩니다.
slowRenderingRate30Fps
(google.type.Decimal
): 집계 기간에 렌더링이 느린 고유 사용자의 비율입니다.
slowRenderingRate30Fps7dUserWeighted
(google.type.Decimal
): 지난 7일 동안의 slowRenderingRate30Fps
이동 평균 값입니다. 일일 값은 해당 날짜의 순 사용자 수에 따라 가중치가 부여됩니다.
slowRenderingRate30Fps28dUserWeighted
(google.type.Decimal
): 지난 28일 동안의 slowRenderingRate30Fps
이동 평균 값입니다. 일일 값은 해당 날짜의 순 사용자 수에 따라 가중치가 부여됩니다.
distinctUsers
(google.type.Decimal
): slowRenderingRate20Fps
/slowRenderingRate30Fps
측정항목의 정규화 값으로 사용된 집계 기간의 순 사용자 수입니다. 앱이 프레임을 렌더링한 경우 사용자가 이 측정항목에 포함됩니다. 사용자가 여러 번 집계될 수 있으므로 이 수치를 더 집계하지 않도록 주의해야 합니다. 값의 크기에 따라 10, 100, 1,000 또는 1,000,000의 가장 가까운 배수로 반올림됩니다.
지원되는 측정기준:
apiLevel
(string
): 사용자 기기에서 실행된 Android의 API 수준입니다(예: 26.
versionCode
(int64
): 사용자 기기에서 실행된 앱의 버전입니다.
deviceModel
(string
): 사용자 기기 모델의 고유 식별자입니다. 식별자 형식은 'deviceBrand/device'입니다. 여기서 deviceBrand는 Build.BRAND에 해당하고 device는 Build.DEVICE에 해당합니다(예: google/coral).
deviceBrand
(string
): 사용자 기기 브랜드의 고유 식별자입니다(예: google).
deviceType
(string
): 사용자 기기의 유형(폼 팩터라고도 함)(예: PHONE.
countryCode
(string
): IP 주소를 기반으로 한 사용자 기기의 국가 또는 지역으로, 2자리 ISO-3166 코드 (예: 미국의 경우 US)로 표시됩니다.
deviceRamBucket
(int64
): 기기의 RAM(MB)입니다(버킷: 3GB, 4GB 등).
deviceSocMake
(string
): 기기의 기본 시스템 온 칩의 제조사입니다(예: Samsung. 참조
deviceSocModel
(string
): 기기의 기본 시스템 온 칩 모델입니다(예: 'Exynos 2100' 참조
deviceCpuMake
(string
): 기기 CPU의 제조사입니다(예: Qualcomm
deviceCpuModel
(string
): 기기 CPU 모델입니다(예: 'Kryo 240'
deviceGpuMake
(string
): 기기 GPU의 제조업체입니다(예: ARM
deviceGpuModel
(string
): 기기 GPU 모델입니다(예: 말리
deviceGpuVersion
(string
): 기기의 GPU 버전입니다(예: T750
deviceVulkanVersion
(string
): 기기의 Vulkan 버전입니다(예: '4198400'
deviceGlEsVersion
(string
): 기기의 OpenGL ES 버전입니다(예: '196610'
deviceScreenSize
(string
): 기기의 화면 크기입니다(예: 보통, 대형
deviceScreenDpi
(string
): 기기의 화면 밀도(예: mdpi, hdpi)
필요한 권한: 이 리소스에 액세스하려면 호출 사용자에게 앱에 대한 앱 정보 보기 (읽기 전용) 권한이 있어야 합니다.
JSON 표현 |
{
"name": string,
"freshnessInfo": {
object (FreshnessInfo )
}
} |
필드 |
name |
string
식별자. 리소스 이름입니다. 형식: apps/{app}/slowRenderingRateMetricSet
|
freshnessInfo |
object (FreshnessInfo )
이 리소스의 데이터 업데이트에 관한 요약입니다.
|
메서드 |
|
측정항목 세트의 속성을 설명합니다. |
|
측정항목 세트의 측정항목을 쿼리합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 2025-07-26(UTC)"],[[["\u003cp\u003eThe Slow Rendering Rate Metric Set provides insights into low-level rendering data for games, specifically focusing on frames handled by SurfaceFlinger.\u003c/p\u003e\n"],["\u003cp\u003eA slow session is defined as one where over 25% of frames fail to meet the target frame rate (20fps or 30fps).\u003c/p\u003e\n"],["\u003cp\u003eMetrics include slow rendering rates at both 20fps and 30fps, along with their 7-day and 28-day rolling averages, and distinct user counts.\u003c/p\u003e\n"],["\u003cp\u003eDimensions allow filtering data by device attributes (e.g., API level, model, brand), location, and app version.\u003c/p\u003e\n"],["\u003cp\u003eAccess requires the "View app information (read-only)" permission for the app in question.\u003c/p\u003e\n"]]],["The SlowRenderingRateMetricSet resource provides low-level rendering metrics for games, evaluating sessions where over 25% of frames fail to meet 20fps or 30fps targets. Metrics include slow rendering rates, 7/28-day user-weighted averages, and distinct user counts, aggregated daily in the `America/Los_Angeles` timezone. Supported dimensions cover API level, version code, device details, country code, RAM, SOC, CPU/GPU information, and screen properties. The resource can be accessed via `get` and `query` methods with the *View app information* permission.\n"],null,["# REST Resource: vitals.slowrenderingrate\n\n- [Resource: SlowRenderingRateMetricSet](#SlowRenderingRateMetricSet)\n - [JSON representation](#SlowRenderingRateMetricSet.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: SlowRenderingRateMetricSet\n------------------------------------\n\nSingleton resource representing the set of Slow Rendering metrics.\n\nThis metric set contains low-level rendering data captured by SurafeFlinger. Sessions are evaluated based on the present-to-present histogram of frames handled by any SurfaceFlinger layer owned by the app.\n\nA slow session is a session where more than 25% of frames for the session did not meet the metric's target frame rate (either 20fps, or 30fps).\n\n*NOTE:* This metric set is only available for games.\n\n**Supported aggregation periods:**\n\n- [DAILY](/play/developer/reporting/reference/rest/v1alpha1/AggregationPeriod#ENUM_VALUES.DAILY): metrics are aggregated in calendar date intervals. Due to historical constraints, the only supported timezone is `America/Los_Angeles`.\n\n**Supported metrics:**\n\n- `slowRenderingRate20Fps` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that had slow rendering.\n- `slowRenderingRate20Fps7dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowRenderingRate20Fps` in the last 7 days. The daily values are weighted by the count of distinct users for the day.\n- `slowRenderingRate20Fps28dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowRenderingRate20Fps` in the last 28 days. The daily values are weighted by the count of distinct users for the day.\n- `slowRenderingRate30Fps` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that had slow rendering.\n- `slowRenderingRate30Fps7dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowRenderingRate30Fps` in the last 7 days. The daily values are weighted by the count of distinct users for the day.\n- `slowRenderingRate30Fps28dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowRenderingRate30Fps` in the last 28 days. The daily values are weighted by the count of distinct users for the day.\n- `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `slowRenderingRate20Fps`/`slowRenderingRate30Fps` metric. A user is counted in this metric if their app rendered any frames. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value.\n\n**Supported dimensions:**\n\n- `apiLevel` ([string](/play/developer/reporting/reference/rest/v1alpha1/anomalies#DimensionValue.FIELDS.string_value)): the API level of Android that was running on the user's device, e.g., 26.\n- `versionCode` ([int64](/play/developer/reporting/reference/rest/v1alpha1/anomalies#DimensionValue.FIELDS.int64_value)): version of the app that was running on the user's device.\n- `deviceModel` ([string](/play/developer/reporting/reference/rest/v1alpha1/anomalies#DimensionValue.FIELDS.string_value)): unique identifier of the user's device model. The form of the identifier is 'deviceBrand/device', where deviceBrand corresponds to Build.BRAND and device corresponds to Build.DEVICE, e.g., google/coral.\n- `deviceBrand` ([string](/play/developer/reporting/reference/rest/v1alpha1/anomalies#DimensionValue.FIELDS.string_value)): unique identifier of the user's device brand, e.g., google.\n- `deviceType` ([string](/play/developer/reporting/reference/rest/v1alpha1/anomalies#DimensionValue.FIELDS.string_value)): the type (also known as form factor) of the user's device, e.g., PHONE.\n- `countryCode` ([string](/play/developer/reporting/reference/rest/v1alpha1/anomalies#DimensionValue.FIELDS.string_value)): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States).\n- `deviceRamBucket` ([int64](/play/developer/reporting/reference/rest/v1alpha1/anomalies#DimensionValue.FIELDS.int64_value)): RAM of the device, in MB, in buckets (3GB, 4GB, etc.).\n- `deviceSocMake` ([string](/play/developer/reporting/reference/rest/v1alpha1/anomalies#DimensionValue.FIELDS.string_value)): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER)\n- `deviceSocModel` ([string](/play/developer/reporting/reference/rest/v1alpha1/anomalies#DimensionValue.FIELDS.string_value)): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL)\n- `deviceCpuMake` ([string](/play/developer/reporting/reference/rest/v1alpha1/anomalies#DimensionValue.FIELDS.string_value)): Make of the device's CPU, e.g., Qualcomm.\n- `deviceCpuModel` ([string](/play/developer/reporting/reference/rest/v1alpha1/anomalies#DimensionValue.FIELDS.string_value)): Model of the device's CPU, e.g., \"Kryo 240\".\n- `deviceGpuMake` ([string](/play/developer/reporting/reference/rest/v1alpha1/anomalies#DimensionValue.FIELDS.string_value)): Make of the device's GPU, e.g., ARM.\n- `deviceGpuModel` ([string](/play/developer/reporting/reference/rest/v1alpha1/anomalies#DimensionValue.FIELDS.string_value)): Model of the device's GPU, e.g., Mali.\n- `deviceGpuVersion` ([string](/play/developer/reporting/reference/rest/v1alpha1/anomalies#DimensionValue.FIELDS.string_value)): Version of the device's GPU, e.g., T750.\n- `deviceVulkanVersion` ([string](/play/developer/reporting/reference/rest/v1alpha1/anomalies#DimensionValue.FIELDS.string_value)): Vulkan version of the device, e.g., \"4198400\".\n- `deviceGlEsVersion` ([string](/play/developer/reporting/reference/rest/v1alpha1/anomalies#DimensionValue.FIELDS.string_value)): OpenGL ES version of the device, e.g., \"196610\".\n- `deviceScreenSize` ([string](/play/developer/reporting/reference/rest/v1alpha1/anomalies#DimensionValue.FIELDS.string_value)): Screen size of the device, e.g., NORMAL, LARGE.\n- `deviceScreenDpi` ([string](/play/developer/reporting/reference/rest/v1alpha1/anomalies#DimensionValue.FIELDS.string_value)): Screen density of the device, e.g., mdpi, hdpi.\n\n**Required permissions** : to access this resource, the calling user needs the *View app information (read-only)* permission for the app.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"freshnessInfo\": { object (/play/developer/reporting/reference/rest/v1alpha1/FreshnessInfo) } } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Identifier. The resource name. Format: apps/{app}/slowRenderingRateMetricSet |\n| `freshnessInfo` | `object (`[FreshnessInfo](/play/developer/reporting/reference/rest/v1alpha1/FreshnessInfo)`)` Summary about data freshness in this resource. |\n\n| Methods ------- ||\n|-----------------------------------------------------------------------------------------------|---------------------------------------------|\n| ### [get](/play/developer/reporting/reference/rest/v1alpha1/vitals.slowrenderingrate/get) | Describes the properties of the metric set. |\n| ### [query](/play/developer/reporting/reference/rest/v1alpha1/vitals.slowrenderingrate/query) | Queries the metrics in the metric set. |"]]