Google Git
Sign in
flutter / third_party / perfetto / 2af6ef702e16a6ab90257a971b26e35e3bd786fe
commit2af6ef702e16a6ab90257a971b26e35e3bd786fe[log] [tgz]
authorBruce Dawson <brucedawson@google.com>Tue May 01 15:28:39 2018 +0100
committerBruce Dawson <brucedawson@google.com>Tue May 01 15:28:39 2018 +0100
treeae2ce20a9849dffe209a1ab68eee76f7a245ce5c
parent68574f22cc7145d9dafca9fb9866f9c496269643 [diff]
Get one Perfetto unittest working on Windows

This change disables most source files from building on Windows and
makes enough adjustments to what remains so that they will build, in
order to give a starting point for a strategy of gradually getting more
code building and running on Windows.

There are probably more source files which could be easily made to work
on Windows but the goal of this change is just to get one test class
working, which is TimeTest, which passes.

This change also adds a test which crudely validates that GetWallTimeNs
and GetThreadCPUTimeNs work.

Testing this on Windows in Chromium requires applying the following
patch to BUILD.gn:

@@ -656,7 +656,7 @@ group("gn_all") {
     }
   }

-  if (is_mac || is_linux || is_android) {
+  if (is_mac || is_linux || is_android || is_win) {
     deps += [ "//third_party/perfetto:all" ]
   }

Bug: 78878306

Change-Id: I692582afea63685c6c73b68b788183489de5c9c2
12 files changed
tree: ae2ce20a9849dffe209a1ab68eee76f7a245ce5c
  1. build_overrides/
  2. buildtools/
  3. debian/
  4. docs/
  5. gn/
  6. include/
  7. infra/
  8. protos/
  9. src/
  10. test/
  11. tools/
  12. .clang-format
  13. .gitignore
  14. .gn
  15. .travis.yml
  16. Android.bp
  17. Android.bp.extras
  18. BUILD.gn
  19. codereview.settings
  20. MODULE_LICENSE_APACHE2
  21. NOTICE
  22. OWNERS
  23. perfetto.rc
  24. PRESUBMIT.py
  25. README.chromium
  26. README.md
README.md

Perfetto - Performance instrumentation and tracing

Perfetto is an open-source project for performance instrumentation and tracing of Linux/Android/Chrome platforms and user-space apps.
It consists of:

A portable, high efficiency, user-space tracing library
designed for tracing of multi-process systems, based on zero-alloc zero-copy zero-syscall (on fast-paths) writing of protobufs over shared memory.

OS-wide Linux/Android probes for platform debugging

  • Kernel tracing: a daemon that converts Kernel Ftrace events into API-stable protobufs, on device, with low overhead.
  • I/O tracing
  • Many new probes coming soon: heap profiling, perf sampling, syscall tracing.

Web-based frontend
A UI for inspection and analysis of traces (coming soon).

Batch processing of traces
A python / C++ (TBD) library for trace-based metrics (coming soon).

Perfetto Stack

Goals

Perfetto is building the next-gen unified tracing ecosystem for:

  • Android platform tracing (Systrace)
  • Chrome platform tracing (chrome://tracing)
  • App-defined user-space tracing (including support for non-Android apps).

The goal is to create an open, portable and developer friendly tracing ecosystem for app and platform performance debugging.

Key features

Designed for production
Perfetto's tracing library and daemons are designed for use in production. Privilege isolation is a key design goal:

  • The interface for writing trace events are decoupled from the interface for read-back and control and can be subjected to different ACLs.
  • Despite being based on shared memory, Perfetto is designed to prevent cross-talk between data sources, even in case of arbitrary code execution (memory is shared point-to-point, memory is never shared between processes).
  • Perfetto daemons are designed following to the principle of least privilege, in order to allow strong sandboxing (via SELinux on Android).

See docs/security-model.md for more details.

Long traces
Pefetto aims at supporting hours-long / O(100GB) traces, both in terms of recording backend and UI frontend.

Interoperability
Perfetto traces (output) and configuration (input) consists of protobuf messages, in order to allow interoperability with several languages.

See docs/trace-format.md for more details.

Composability
As Perfetto is designed both for OS-level tracing and app-level tracing, its design allows to compose several instances of the Perfetto tracing library, allowing to nest multiple layers of tracing and drive then with the same frontend. This allows powerful blending of app-specific and OS-wide trace events. See docs/multi-layer-tracing.md for more details.

Portability
The only dependencies of Perfetto's tracing libraries are C++11 and Protobuf lite (plus google-test, google-benchmark, libprotobuf-full for testing).

Extensibility
Perfetto allows third parties to defined their own protobufs for:

Allowing apps to define their own strongly-typed input and output schema. See docs/trace-format.md for more details.

Docs