trace 일괄 분석

ProfilingManager를 사용하여 여러 트레이스를 수집한 후에는 개별적으로 탐색하여 성능 문제를 찾는 것이 비현실적입니다. 일괄 trace 분석을 사용하면 trace 데이터 세트를 동시에 쿼리하여 다음을 수행할 수 있습니다.

• 일반적인 성능 회귀를 식별합니다.
• 통계 분포(예: P50, P90, P99 지연 시간)를 계산합니다.
• 여러 trace에서 패턴을 찾습니다.
• 이상치 trace를 찾아 성능 문제를 파악하고 디버깅합니다.

이 섹션에서는 Perfetto Python Batch Trace Processor를 사용하여 로컬에 저장된 트레이스 집합에서 시작 측정항목을 분석하고 심층 분석을 위해 이상치 트레이스를 찾는 방법을 보여줍니다.

쿼리 설계

먼저 비교하려는 측정항목을 추출하는 PerfettoSQL 쿼리를 만듭니다. 다음 예에서는 그림 1과 같이 activityStart에서 첫 번째 렌더링된 프레임(Choreographer#doFrame)까지 앱 제어 시작 지연 시간을 측정합니다.

참고: 일괄 쿼리를 실행하기 전에 Perfetto UI의 단일 트레이스에서 테스트하여 결과를 검증합니다.

그림 1. activityStart부터 생성된 첫 번째 프레임까지의 트레이스 섹션

CREATE OR REPLACE PERFETTO FUNCTION find_slices(pattern STRING) RETURNS
TABLE (name STRING, ts LONG, dur LONG) AS
SELECT name,ts,dur FROM slice WHERE name GLOB $pattern;

CREATE OR REPLACE PERFETTO FUNCTION generate_start_to_end_slices(startSlicePattern STRING, endSlicePattern STRING, inclusive BOOL) RETURNS
TABLE(name STRING, ts LONG, dur LONG) AS
SELECT name, ts, MIN(startToEndDur) as dur
FROM
  (SELECT S.name as name, S.ts as ts, E.ts + IIF($inclusive, E.dur, 0) - S.ts as startToEndDur
  FROM find_slices($startSlicePattern) as S CROSS JOIN find_slices($endSlicePattern) as E
  WHERE startToEndDur > 0)
GROUP BY name, ts;

SELECT ts,name,dur from generate_start_to_end_slices('activityStart','*Choreographer#doFrame [0-9]*', true)

Perfetto UI 내에서 쿼리를 실행한 다음 쿼리 결과를 사용하여 디버그 트랙을 생성하고(그림 2) 타임라인 내에서 시각화할 수 있습니다(그림 3).

그림 2. 시작 쿼리의 디버그 트랙을 만듭니다.

그림 3. 시작 쿼리에 대한 디버그 트랙이 생성되었습니다.

Python 환경 설정

로컬 머신에 Python을 설치하고 필요한 라이브러리를 설치합니다.

pip install perfetto pandas plotly

일괄 trace 분석 스크립트 만들기

다음 샘플 스크립트는 Perfetto의 Python BatchTraceProcessor를 사용하여 여러 트레이스에서 쿼리를 실행합니다.

from perfetto.batch_trace_processor import BatchTraceProcessor
import glob
import plotly.express as px

# Collect all trace files in the local directory
traces = glob.glob('*.perfetto-trace')

if not traces:
    print("No .perfetto-trace files found in the current directory.")
    exit(1)

if __name__ == '__main__':
    # Process all traces in parallel to aggregate metrics across runs
    with BatchTraceProcessor(traces) as btp:
        query = """
        CREATE OR REPLACE PERFETTO FUNCTION find_slices(pattern STRING) RETURNS
        TABLE (name STRING, ts LONG, dur LONG) AS
        SELECT name,ts,dur FROM slice WHERE name GLOB $pattern;

        CREATE OR REPLACE PERFETTO FUNCTION generate_start_to_end_slices(startSlicePattern STRING, endSlicePattern STRING, inclusive BOOL) RETURNS
        TABLE(name STRING, ts LONG, dur LONG) AS
        SELECT name, ts, MIN(startToEndDur) as dur
        FROM
          (SELECT S.name as name, S.ts as ts, E.ts + IIF($inclusive, E.dur, 0) - S.ts as startToEndDur
          FROM find_slices($startSlicePattern) as S CROSS JOIN find_slices($endSlicePattern) as E
          WHERE startToEndDur > 0)
        GROUP BY name, ts;

        SELECT ts,name,dur / 1000000 as dur_ms from generate_start_to_end_slices('activityStart','*Choreographer#doFrame [0-9]*', true)
        """
        df = btp.query_and_flatten(query)
        # Plot the distribution of startup times, tracking trace file paths on
        # hover
        violin = px.violin(df, x='dur_ms', hover_data='_path', title='startup time', points='all')
        violin.show()

스크립트 이해하기

Python 스크립트를 실행하면 다음 작업이 수행됩니다.

1. 스크립트는 로컬 디렉터리에서 접미사가 .perfetto-trace인 모든 Perfetto 트레이스를 검색하고 이를 분석을 위한 소스 트레이스로 사용합니다.
2. activityStart 트레이스 슬라이스부터 앱에서 생성된 첫 번째 프레임까지의 시간에 해당하는 시작 시간의 하위 집합을 계산하는 일괄 트레이스 쿼리를 실행합니다.
3. 바이올린 플롯을 사용하여 지연 시간을 밀리초 단위로 표시하여 시작 시간의 분포를 시각화합니다.

결과 해석

그림 4. 쿼리된 시작 지연 시간의 바이올린 플롯

스크립트를 실행하면 두 개의 고유한 지연 시간 피크가 있는 바이모달 분포를 보여주는 바이올린 플롯이 생성됩니다(그림 4). 플롯의 개별 데이터 포인트 위로 마우스를 가져가 _path 파일 이름을 검사하고 각 피크의 트레이스를 비교합니다(그림 5).

• 지연 시간이 긴 트레이스(오른쪽 피크): Perfetto UI에서 이 그룹의 트레이스를 열면 시작 중에 실행되는 추가 MyFlaggedFeature 슬라이스가 표시됩니다(그림 6).
• 지연 시간이 짧은 트레이스(왼쪽 피크): 더 빠른 그룹에서 트레이스를 열면 MyFlaggedFeature가 없음을 확인할 수 있습니다(그림 7). 이는 일부 사용자에게 사용 설정된 기능 플래그로 인해 시작 회귀가 발생했음을 나타냅니다.

그림 5. 바이올린 플롯의 지연 시간이 긴 데이터 포인트

그림 6. 추가 MyFlaggedFeature 슬라이스가 있는 지연 시간이 긴 trace 시작

그림 7. 지연 시간이 짧은 trace 시작

이 예시에서는 일괄 trace 분석을 사용할 수 있는 여러 방법 중 하나를 보여줍니다. 다른 사용 사례로는 현장에서 통계를 추출하여 영향을 측정하고 회귀를 감지하는 등이 있습니다.

참고: 로컬 Batch Trace Processor Python API는 사용 가능한 메모리에 따라 수십 또는 수백 개의 트레이스를 분석할 수 있습니다. 수천 개의 트레이스를 분석하려면 Perfetto Bigtrace 문서를 참고하세요.