google/torq

최근 기록된 소스 활동: 2026년 6월 11일 20:38

SkillsMP 카탈로그 업데이트: 2026년 10월 29일 18:30

수집된 skills: 1

GitHub 스타: 13
GitHub 포크: 6

AI 어시스턴트로 설치

이 프롬프트를 복사해 사용 중인 AI 어시스턴트에 입력하세요.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/google/torq.

저장소 README

README 원본 파일: README.md

README 원본 보기

README 전체 펼치기

# torq: AAOS Performance CLI **torq** is a command-line tool designed to streamline and standardize OS performance profiling across Android Automotive devices. By providing a flexible and easy-to-use interface, **torq** enables engineers and OEMs to capture and analyze performance data for critical system events such as boot, user switch, app startup, or any of their own interactions with their device. This tool helps ensure consistent results amongst different users and helps reduce the time and effort required for performance analysis, ensuring that developers can focus on optimizing their systems and bug detection rather than navigating fragmented tooling solutions. ## Getting Started To start using **torq** follow these steps: - Go to *torq*'s directory and build it: ```bash bazel build //:torq export PATH="$(pwd)/bazel-bin:$PATH" ``` - Connect to an Android device or start an emulator. - Ensure the connected device appears in `adb devices`. - Capture a perfetto trace using *torq*: ```bash torq -d 7000 ``` ## Building Torq **torq** uses [Bazel](https://bazel.build) as its build system. To build and use torq using [Bazel](https://bazel.build/), run: ```bash bazel build //:torq ./bazel-bin/torq --help ``` ## Quick one-line commands **torq**'s main goal is to allow developers to quickly trace and profile Android in the least amount of steps while being flexible enough to cover many different use cases. This list of commands demonstrates just that. | Command | Description | |----------|-------------| | `torq -d 7000` | Run a custom event for 7 seconds. | | `torq -e user-switch --from-user 10 --to-user 11` | Run a user-switch event, switching from user 10 to user 11. | | `torq -e boot --perfetto-config ./config` | Run a boot event, using the user's local Perfetto config specified in the ./config file path. | | `torq -e boot -r 5 --between-dur-ms 3000` | Run a boot event 5 times, waiting 3 seconds between each boot run. | | `torq -e app-startup -a android.google.kitchensink` | Run an app-startup event, starting the android.google.kitchensink package. | | `torq -e user-switch --to-user 9 --serial emulator-5554` | Run a user-switch event, switching to user 9 on the connected device with serial, emulator-5554. | | `torq -p simpleperf -d 10000` | Run a custom event using the Simpleperf profiler for 10 seconds. | | `torq -p simpleperf -s cpu-cycles -s instructions` | Run a custom event using the Simpleperf profiler, in which the stats, cpu-cycles and instructions, are collected. | | `torq -d 10000 --perfetto-config lightweight` | Run a custom event for 10 seconds using the "lightweight" predefined Perfetto config. | | `torq --script "sleep 10"` | Run a custom event and execute a host-side sleep command, stopping the trace when the command exits. | | `torq config show memory` | Print the contents of the memory predefined Perfetto config to the terminal. | | `torq open trace.perfetto-trace` | Open a trace in the perfetto UI. | | `torq -d 10000 --exclude-ftrace-event power/cpu_idle` | Run a custom event for 10 seconds, using the "default" predefined Perfetto config, in which the ftrace event, power/cpu_idle, is not collected. | ## CLI Reference For a complete list of all the `torq` subcommands and flags, please refer to the [CLI Reference](docs/REFERENCE.md). ## Host-Side Script Execution during Tracing Torq allows you to run a host-side script while capturing a trace on the device, dynamically controlling the trace duration. The trace stops automatically when your script exits. For a detailed guide on how to use this feature (including inline scripts, script files, and stdin redirection), please refer to the [Host-Side Script Execution Guide](docs/HOST_SCRIPT_EXECUTION.md). ## Configure perfetto in virtualized Android Working on a multi-VM environments has its challenges. In order to obtain a unified trace containing the trace data from multiple VMs you could leverage Perfetto's *traced* and *traced_relay* binaries. Torq provides commands to greatly simplify the configuration process. For example, to switch a VM from using `traced` to `traced_relay`, you could run: ```console torq vm traced-relay enable vsock://3:30001 ``` To enable the relay producer port in `traced`, you could run: ```console torq vm relay-producer enable ``` ### CLI Arguments For a complete list of arguments for the `torq vm` subcommand, please refer to the [CLI Reference](docs/REFERENCE.md#subcommand-vm). ## Configure trigger configs for perfetto When you want to get traces in response to specific code paths, Perfetto's trigger configs can collect traces when specific triggers are received via the trigger_perfetto binary. Torq provides commands to add Perfetto triggers to your trace configs as well as to call the trigger_perfetto binary. To add a trigger to your config, you could run: ```console torq --trigger-names trigger1 ``` To add a trigger to your config that traces for 10 seconds after the trigger is received, you could run: ```console torq --trigger-names trigger1 --trigger-stop-delay-ms 10000 ``` To trigger a trace collection, you could run: ```console torq trigger <trigger-name> ``` ### CLI Arguments For a complete list of arguments for the `torq trigger` subcommand, please refer to the [CLI Reference](docs/REFERENCE.md#subcommand-trigger). ## Activate Perfetto triggers When you want to get traces in response to specific code paths, Perfetto's trigger configs can collect traces when specific triggers are received via the trigger_perfetto binary. Torq provides a subcommand to trigger trace collection for a trigger included in a Perfetto config. ### CLI Arguments For a complete list of arguments for the `torq trigger` subcommand, please refer to the [CLI Reference](docs/REFERENCE.md#subcommand-trigger). ## Testing Torq For a detailed guide on test setup, VM requirements, and troubleshooting, please refer to the [Torq Testing Doc](docs/TORQ_TESTING.md) ## Contributing to Torq Before starting development in **torq**'s codebase, run: ```bash ./tools/build_deps ``` Also, before submitting code remember to format the code. Run: ```bash ./tools/format_sources ```

저장소 README를 불러오는 중…

이 저장소의 skills

네트워크·컴퓨터 시스템 관리자

직업 카테고리 1개 · 100% 분류됨

skill

직업 분류

설명

업데이트

torq

네트워크·컴퓨터 시스템 관리자

Capture a perfetto or simpleperf trace using the Torq CLI.

원문 언어: 영어

2026-06-11

수집된 skill 1개 중 1개를 표시합니다.