Начиная с 27 марта 2025 г. мы рекомендуем использовать android-latest-release вместо aosp-main для создания и участия в AOSP. Дополнительные сведения см. в разделе Изменения в AOSP .

Эта страница переведена с помощью Cloud Translation API.

Захват следов с помощью команд adb

Трассировки Winscope можно собирать с помощью командной строки adb в отладочных сборках (то есть, сборках userdebug и eng ). Перед сборкой трассировок Winscope с помощью adb запустите adb root .

Начиная с Android 15 трассировки Winscope интегрированы в Perfetto и собираются с помощью командной строки Perfetto. Каждая трассировка Winscope — это источник данных Perfetto со своей собственной конфигурацией. Вы можете включать конфигурации по отдельности или в одном сеансе трассировки.

В Android 14 и ниже каждая трассировка Winscope имеет отдельную команду, и вы можете собирать каждую независимо. См. раздел Сбор трассировок в Android 14 и ниже для получения дополнительной информации.

Менеджер окон

Для этого типа трассировки используйте имя источника данных android.windowmanager .

Параметры конфигурации

Уровень журнала ( log_level ): определяет уровень детализации журнала. Поддерживаемые значения:
- LOG_LEVEL_VERBOSE : регистрирует все элементы с максимальным объемом информации.
- LOG_LEVEL_DEBUG : регистрирует все элементы, но не записывает все данные конфигурации.
- LOG_LEVEL_CRITICAL : регистрирует только видимые элементы с минимальными издержками производительности.
Частота регистрации ( log_frequency ) : определяет частоту регистрации элементов:
- LOG_FREQUENCY_FRAME : отслеживает моментальные снимки состояния при фиксации кадра.
- LOG_FREQUENCY_TRANSACTION : отслеживает снимки состояния каждый раз при фиксации транзакции.
- LOG_FREQUENCY_SINGLE_DUMP : отслеживает отдельные моментальные снимки состояния при запуске источника данных.

Подробную информацию о значениях конфигурации см. в разделе WindowManager .

Пример

Ниже приведен пример типа трассировки WindowManager для adb:

$ adb shell -t perfetto \
     -c - --txt \
     -o /data/misc/perfetto-traces/trace \
   <<EOF
   unique_session_name: "my_custom_session"
   buffers: {
       size_kb: 63488
       fill_policy: RING_BUFFER
   }
   data_sources: {
       config {
           name: "android.windowmanager"
           windowmanager_config: {
              log_level: LOG_LEVEL_VERBOSE
              log_frequency: LOG_FREQUENCY_TRANSACTION
           }
       }
   }
EOF

ПротоЛог

Для этого типа трассировки используйте имя источника данных android.protolog .

Параметры конфигурации

Режим трассировки ( tracing_mode ) : определяет используемую конфигурацию журнала:

DEFAULT : отслеживает только группы и уровни журналов, указанные в group_overrides .
ENABLE_ALL : отслеживает все группы и уровни журналов, если не указано иное в group_overrides .

Минимальный уровень журнала ( default_log_from_level ) : если установлено, отслеживается любое сообщение с уровнем журнала выше этого уровня и включая его, если не указано групповое переопределение. Например, это используется для включения регистрации всех предупреждений и ошибок без необходимости включения всех журналов. Поддерживаемые значения:

PROTOLOG_LEVEL_DEBUG
PROTOLOG_LEVEL_VERBOSE
PROTOLOG_LEVEL_INFO
PROTOLOG_LEVEL_WARN
PROTOLOG_LEVEL_ERROR
PROTOLOG_LEVEL_WTF

Group overrides ( group_overrides ) : позволяет вручную настраивать уровень журнала для каждой группы ProtoLog. Каждая группа содержит:

name : имя группы ProtoLog, используемое в исходном коде Android.
log_from : то же, что и default_log_from_level но указано только для текущей группы.
collect_stacktrace : если установлено значение true , собирает трассировку стека для каждого сообщения ProtoLog в отслеживаемой группе.
Предупреждение: Ведение журнала трассировок стека происходит медленно и влияет на производительность устройства. Эта функция лучше подходит для локальной разработки.

Пример

Ниже приведен пример типа трассировки ProtoLog для adb:

$ adb shell -t perfetto \
     -c - --txt \
     -o /data/misc/perfetto-traces/trace \
   <<EOF
   unique_session_name: "my_custom_session"
   buffers: {
       size_kb: 63488
       fill_policy: RING_BUFFER
   }
   data_sources: {
       config {
           name: "android.protolog"
           protolog_config: {
              tracing_mode: DEFAULT
              default_log_from_level: PROTOLOG_LEVEL_WARN
              group_overrides: {
                 group_name: "WM_SHELL_STARTING_WINDOW"
                 log_from: PROTOLOG_LEVEL_DEBUG
                 collect_stacktrace: true
              }
           }
       }
   }
EOF

Вход

Для этого типа трассировки используйте имя источника данных android.input.inputevent .

Параметры конфигурации

Режим трассировки ( trace_mode ) : определяет, следует ли запускать трассировку ввода с использованием правил сохранения конфиденциальности или записывать все события ввода:

TRACE_MODE_TRACE_ALL : записывает все входные события, обработанные системой, независимо от контекста, в котором они были обработаны.
TRACE_MODE_USE_RULES : Использует правила трассировки, определенные в этой конфигурации, чтобы указать, какие события отслеживать. См. android_input_event_config.proto для получения дополнительной информации об указании правил для трассировки.

Пример

Ниже приведен пример типа трассировки ввода для adb:

$ adb shell -t perfetto \
     -c - --txt \
     -o /data/misc/perfetto-traces/trace \
   <<EOF
   unique_session_name: "my_custom_session"
   buffers: {
       size_kb: 63488
       fill_policy: RING_BUFFER
   }
   data_sources: {
       config {
           name: "android.input.inputevent"
           android_input_event_config: {
              mode: TRACE_MODE_TRACE_ALL
           }
       }
   }
EOF

SurfaceFlinger (слои)

Для этого типа трассировки используйте имя источника данных android.surfaceflinger.layers .

Параметры конфигурации

Режим трассировки ( mode ) : определяет частоту, с которой регистрируются элементы:

MODE_ACTIVE : Отслеживает снимки слоев. Снимок делается каждый раз, когда происходит изменение слоев.
MODE_GENERATED : Генерирует снимки слоев из транзакций, хранящихся во внутреннем кольцевом буфере SurfaceFlinger. Генерация снимков слоя происходит, когда этот источник данных очищается.
MODE_DUMP : отслеживает снимок одного слоя.
MODE_GENERATED_BUGREPORT_ONLY : то же, что и MODE_GENERATED , но запускает генерацию снимков слоев только при создании отчета об ошибке, а не при очистке трассировки.

Флаги трассировки ( trace_flags ) :

TRACE_FLAG_INPUT : Если поверхность содержит входные данные, отслеживает специфику входного окна.
TRACE_FLAG_COMPOSITION : отслеживает тип композиции и видимую область.
TRACE_FLAG_EXTRA : отслеживает дополнительные метаданные поверхности, включая внеэкранные слои.
Предупреждение: это поле очень подробное и требует большого объема памяти.
TRACE_FLAG_HWC : отслеживает дополнительные неструктурированные метаданные аппаратного композитора.
Предупреждение: это поле очень подробное и требует большого объема памяти.
TRACE_FLAG_BUFFERS : Настраивает SurfaceFlinger для отслеживания всех изменений буфера на поверхности. По умолчанию SurfaceFlinger отслеживает новое состояние только при возникновении изменений геометрии.
TRACE_FLAG_VIRTUAL_DISPLAYS : включает в трассировку виртуальные слои отображения.

Пример

Ниже приведен пример типа трассировки SurfaceFlinger для adb:

$ adb shell -t perfetto \
     -c - --txt \
     -o /data/misc/perfetto-traces/trace \
   <<EOF
   unique_session_name: "my_custom_session"
   buffers: {
       size_kb: 63488
       fill_policy: RING_BUFFER
   }
   data_sources: {
       config {
           name: "android.surfaceflinger.layers"
           surfaceflinger_layers_config: {
              mode: MODE_ACTIVE
              trace_flags: TRACE_FLAG_INPUT
              trace_flags: TRACE_FLAG_COMPOSITION
              trace_flags: TRACE_FLAG_HWC
              trace_flags: TRACE_FLAG_BUFFERS
              trace_flags: TRACE_FLAG_VIRTUAL_DISPLAYS
           }
       }
   }
EOF

Подробную информацию о значении различных значений конфигурации см. в SurfaceFlinger.

Переходы оболочки

Для этого типа трассировки используйте имя источника данных com.android.wm.shell.transition .

Параметры конфигурации

Этот тип трассировки не имеет параметров конфигурации.

Пример

Ниже приведен пример типа трассировки перехода оболочки для adb:

$ adb shell -t perfetto \
     -c - --txt \
     -o /data/misc/perfetto-traces/trace \
   <<EOF
   unique_session_name: "my_custom_session"
   buffers: {
       size_kb: 63488
       fill_policy: RING_BUFFER
   }
   data_sources: {
       config {
           name: "com.android.wm.shell.transition"
       }
   }
EOF

SurfaceFlinger (транзакции)

Для этого типа трассировки используйте имя источника данных android.surfaceflinger.transactions .

Параметры конфигурации

Режим трассировки ( mode ) : определяет частоту, с которой регистрируются элементы:

MODE_CONTINUOUS : SurfaceFlinger записывает свой внутренний кольцевой буфер транзакций каждый раз, когда источник данных очищается. Кольцевой буфер содержит начальное состояние SurfaceFlinger и последние транзакции.
MODE_ACTIVE : SurfaceFlinger записывает начальное состояние, а затем каждую входящую транзакцию, пока источник данных не будет остановлен.

Пример

Ниже приведен пример типа трассировки транзакций SurfaceFlinger для adb.

$ adb shell -t perfetto \
     -c - --txt \
     -o /data/misc/perfetto-traces/trace \
   <<EOF
   unique_session_name: "my_custom_session"
   buffers: {
       size_kb: 63488
       fill_policy: RING_BUFFER
   }
   data_sources: {
       config {
           name: "android.surfaceflinger.transactions"
           surfaceflinger_transactions_config: {
              mode: MODE_ACTIVE
           }
       }
   }
EOF

ИМЕ

Для этого типа трассировки используйте имя источника данных: android.inputmethod .

Параметры конфигурации

Этот тип трассировки не имеет параметров конфигурации.

Пример

Ниже приведен пример типа трассировки IME для adb:

$ adb shell -t perfetto \
     -c - --txt \
     -o /data/misc/perfetto-traces/trace \
   <<EOF
   unique_session_name: "my_custom_session"
   buffers: {
       size_kb: 63488
       fill_policy: RING_BUFFER
   }
   data_sources: {
       config {
           name: "android.inputmethod"
       }
   }
EOF

ПросмотрЗахвата

Для этого типа трассировки используйте имя источника данных android.viewcapture .

Параметры конфигурации

Этот тип трассировки не имеет параметров конфигурации.

Пример

Ниже приведен пример типа трассировки ViewCapture для adb:

$ adb shell -t perfetto \
     -c - --txt \
     -o /data/misc/perfetto-traces/trace \
   <<EOF
   unique_session_name: "my_custom_session"
   buffers: {
       size_kb: 63488
       fill_policy: RING_BUFFER
   }
   data_sources: {
       config {
           name: "android.viewcapture"
       }
   }
EOF

Полный пример

Perfetto позволяет собирать данные из нескольких источников в одной конфигурации. Вы можете собрать все трассировки Winscope с помощью одной команды:

$ adb shell -t perfetto \
     -c - --txt \
     -o /data/misc/perfetto-traces/trace \
   <<EOF
   unique_session_name: "my_custom_session"
   buffers: {
       size_kb: 63488
       fill_policy: RING_BUFFER
   }
   data_sources: {
       config {
           name: "android.windowmanager"
           windowmanager_config: {
              log_level: LOG_LEVEL_VERBOSE
              log_frequency: LOG_FREQUENCY_TRANSACTION
           }
       }
   }
   data_sources: {
       config {
           name: "android.protolog"
           protolog_config: {
              tracing_mode: ENABLE_ALL
           }
       }
   }
   data_sources: {
       config {
           name: "android.input.inputevent"
           android_input_event_config: {
              mode: TRACE_MODE_TRACE_ALL
           }
       }
   }
   data_sources: {
       config {
           name: "android.surfaceflinger.layers"
           surfaceflinger_layers_config: {
              mode: MODE_ACTIVE
              trace_flags: TRACE_FLAG_INPUT
              trace_flags: TRACE_FLAG_COMPOSITION
              trace_flags: TRACE_FLAG_HWC
              trace_flags: TRACE_FLAG_BUFFERS
              trace_flags: TRACE_FLAG_VIRTUAL_DISPLAYS
           }
       }
   }
   data_sources: {
       config {
           name: "com.android.wm.shell.transition"
       }
   }
   data_sources: {
       config {
           name: "android.surfaceflinger.transactions"
           surfaceflinger_transactions_config: {
              mode: MODE_ACTIVE
           }
       }
   }
   data_sources: {
       config {
           name: "android.inputmethod"
       }
   }
   data_sources: {
       config {
           name: "android.viewcapture"
       }
   }
EOF

Захват следов в Android 14 и ниже

Запустите adb root перед запуском команд adb shell для каждой из следующих трассировок. В конце трассировки файлы трассировки будут доступны в /data/misc/wmtrace . Чтобы скопировать файл или каталог и его подкаталоги с устройства, см. Копирование файлов на устройство и с него .

Трассировки WindowManager

Чтобы захватить трассировки WindowManager:

Включить трассировку:
```
adb shell wm tracing start
```
Отключить трассировку:
```
adb shell wm tracing stop
```
Сохранение данных журнала в файл во время выполнения трассировки:
```
adb shell wm tracing save-for-bugreport
```
Запись трассировки журнала один раз за кадр:
```
adb shell wm tracing frame
```
Регистрируйте каждую транзакцию:
```
adb shell wm tracing transaction
```
Установите максимальный размер журнала (в КБ):
```
adb shell wm tracing size
```
Статус трассировки печати:
```
adb shell wm tracing status
```
Установите уровень журнала: critical (видны только окна с ограниченной информацией), trim (все окна с ограниченной информацией) или all (все окна и информация):
```
adb shell wm tracing level
```

Дампы WindowManager

Чтобы захватить дампы WindowManager:

adb exec-out dumpsys window --proto > window_dump.winscope

ПротоЛог

Для системы ProtoLog используются следующие команды.

В процессе system_server :

Запустить ProtoLog:
```
adb shell cmd window logging start
```
Остановить ProtoLog:
```
adb shell cmd window logging stop
```
Включить ProtoLog для указанных групп журналов:
```
adb shell cmd window logging enable [group...]
```
Отключить ProtoLog для указанных групп журналов:
```
adb shell cmd window logging disable [group...]
```
Включить ведение журнала Logcat для указанных групп журналов:
```
adb shell cmd window logging enable-text [group...]
```
Отключить ведение журнала Logcat для указанных групп журналов:
```
adb shell cmd window logging disable-text [group...]
```

В WMShell:

Запустить ProtoLog:

adb shell dumpsys activity service SystemUIService WMShell

Следы SurfaceFlinger (слои)

Трассировка слоя SurfaceFlinger использует трассировку Perfetto для захвата. Информацию о конфигурации см. в разделе Конфигурация трассировки .

См. следующий пример конфигурации для трассировки слоя SurfaceFlinger:

unique_session_name: "surfaceflinger_layers_active"
buffers: {
    size_kb: 63488
    fill_policy: RING_BUFFER
}
data_sources: {
    config {
        name: "android.surfaceflinger.layers"
        surfaceflinger_layers_config: {
            mode: MODE_ACTIVE
            trace_flags: TRACE_FLAG_INPUT
            trace_flags: TRACE_FLAG_COMPOSITION
            trace_flags: TRACE_FLAG_HWC
            trace_flags: TRACE_FLAG_BUFFERS
            trace_flags: TRACE_FLAG_VIRTUAL_DISPLAYS
        }
    }
}

См. следующий пример команды для создания трассировки для слоев SurfaceFlinger:

adb shell -t perfetto \
    -c - --txt \
    -o /data/misc/perfetto-traces/trace \

SurfaceFlinger отвалы (слои)

Чтобы захватить дампы SurfaceFlinger:

adb exec-out dumpsys SurfaceFlinger --proto > sf_dump.winscope

Переходы оболочки

Для отслеживания переходов используются следующие команды.

В процессе system_server :

Начать трассировку:

adb shell cmd window shell tracing start

Остановить трассировку:
```
adb shell cmd window shell tracing stop
```

Запустите трассировку в WMShell:

adb shell dumpsys activity service SystemUIService WMShell transitions tracing start

Остановить трассировку в WMShell:

adb shell dumpsys activity service SystemUIService WMShell transitions tracing stop

ИМЕ

Для трассировки редактора метода ввода (IME) используются следующие команды:

Запустите трассировку IME для клиентов метода ввода (IM), службы метода ввода (IMS) и службы управления методом ввода (IMMS):
```
adb shell ime tracing start
```
Начните отслеживать клиентов IME, IMS и IMMS:
```
adb shell ime tracing stop
```

SurfaceFlinger (транзакции)

Трассировка транзакций SurfaceFlinger использует трассировку Perfetto для захвата. Информацию о конфигурации см. в разделе Конфигурация трассировки .

См. следующий пример конфигурации Perfetto для активной трассировки SurfaceFlinger:

unique_session_name: "surfaceflinger_transactions_active"
buffers: {
    size_kb: 1024
    fill_policy: RING_BUFFER
}
data_sources: {
    config {
        name: "android.surfaceflinger.transactions"
        surfaceflinger_transactions_config: {
            mode: MODE_ACTIVE
        }
    }
}
write_into_file: true
file_write_period_ms: 100

См. следующий пример конфигурации Perfetto для непрерывной трассировки SurfaceFlinger:

unique_session_name: "surfaceflinger_transactions_continuous"
buffers: {
    size_kb: 1024
    fill_policy: RING_BUFFER
}
data_sources: {
    config {
        name: "android.surfaceflinger.transactions"
        surfaceflinger_transactions_config: {
            mode: MODE_CONTINUOUS
        }
    }
}

См. следующий пример команды для создания трассировки транзакций SurfaceFlinger:

    adb shell perfetto \
    -c - --txt \
    -o /data/misc/perfetto-traces/trace \

Захват следов с помощью команд adb Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Менеджер окон

Параметры конфигурации

Пример

ПротоЛог

Параметры конфигурации

Пример

Вход

Параметры конфигурации

Пример

SurfaceFlinger (слои)

Параметры конфигурации

Пример

Переходы оболочки

Параметры конфигурации

Пример

SurfaceFlinger (транзакции)

Параметры конфигурации

Пример

ИМЕ

Параметры конфигурации

Пример

ПросмотрЗахвата

Параметры конфигурации

Пример

Полный пример

Захват следов в Android 14 и ниже

Трассировки WindowManager

Дампы WindowManager

ПротоЛог

Следы SurfaceFlinger (слои)

SurfaceFlinger отвалы (слои)

Переходы оболочки

ИМЕ

SurfaceFlinger (транзакции)

Захват следов с помощью команд adb