Find a file
Jens Johansen 1574e860c8 [CFE] Add instrumenter that can produce flame graph output
Could for instance be run like this:

out/ReleaseX64/dart pkg/front_end/tool/flame/instrumenter.dart pkg/front_end/tool/_fasta/compile.dart
out/ReleaseX64/dart pkg/front_end/tool/_fasta/compile.dart.dill.instrumented.dill --omit-platform pkg/front_end/tool/_fasta/compile.dart
out/ReleaseX64/dart pkg/front_end/tool/flame/instrumenter.dart pkg/front_end/tool/_fasta/compile.dart --candidates=cfe_compile_trace_candidates.txt
out/ReleaseX64/dart pkg/front_end/tool/_fasta/compile.dart.dill.instrumented.dill --omit-platform pkg/front_end/tool/_fasta/compile.dart
out/ReleaseX64/dart pkg/front_end/tool/flame/instrumenter.dart pkg/front_end/tool/_fasta/compile.dart --candidates=cfe_compile_trace_candidates_subsequent.txt
out/ReleaseX64/dart pkg/front_end/tool/_fasta/compile.dart.dill.instrumented.dill --omit-platform pkg/front_end/tool/_fasta/compile.dart

 * The first command compiles and instruments "compile.dart" to record
   all procedure calls.
 * The second command runs the instrumented compiler on "compile.dart"
   (but it could have compiled anything). Because every procedure is
   instrumented this will take a lot longer than a usual run.
   This produces a trace "cfe_compile_trace.txt" with every call taking
   at least 1000 microseconds. This can be displayed via Chromes
   about://tracing tool.
   It also produces a file "cfe_compile_trace_candidates.txt" with a map
   of the procedures that on average took at least 500 microseconds.
 * The third command compiles and instruments "compile.dart", this time
   only instrumenting the procedures mentioned in the map
   "cfe_compile_trace_candidates.txt".
 * The forth command runs the instrumented compiler on "compile.dart".
   This run shouldn't take significantly longer than a non-instrumented
   run. It produces a new "cfe_compile_trace.txt" which this time is
   not filtered. It also produces a file
   "cfe_compile_trace_candidates_subsequent.txt" of recorded procedures
   that on average took at least 50 microseconds.
 * The fifth and sixth commands repeats the third and forth but
   instrumenting only the procedures mention in
   "cfe_compile_trace_candidates_subsequent.txt".

The third iteration might not be needed, but if the first run was on a
smaller input (which it isn't in this example) there might be some calls
that on average took long enough to be included in the candidate list
because the first call was slow and there were only very few of them,
making the second trace very big because there are now a lot of - as it
turns out - very quick calls recorded. Adding the third iteration will
filter (at least some of) those out.

Change-Id: I702c5c9142e525502b02f37744fcdc9d2b0f9b20
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/296902
Reviewed-by: Johnni Winther <johnniwinther@google.com>
Commit-Queue: Jens Johansen <jensj@google.com>
2023-04-25 08:34:01 +00:00
.dart_tool [infra] re-land work to auto-generate .dart_tool/package_config.json 2022-04-12 17:21:02 +00:00
.github Bump github/codeql-action from 2.2.11 to 2.2.12 2023-04-18 08:20:48 +00:00
benchmarks - migrate sound_splay_tree.dart to null safety 2023-04-05 15:57:33 +00:00
build add tools for generating shim headers 2023-04-19 01:37:48 +00:00
docs Spelling pkg analyzer lib 2023-01-25 14:08:27 +00:00
pkg [CFE] Add instrumenter that can produce flame graph output 2023-04-25 08:34:01 +00:00
runtime [VM/Timeline] Disable SUPPORT_PERFETTO macro to investigate flaky Flutter crashes 2023-04-24 20:32:31 +00:00
samples [test] Introduce status variable $simulator, and fix some cases missing simarm_x64. 2023-04-04 03:10:26 +00:00
sdk Remove left-over patch declarations for List constructor. 2023-04-22 00:38:28 +00:00
tests Remove left-over patch declarations for List constructor. 2023-04-22 00:38:28 +00:00
third_party [pkgs/native] MacOS support + CI 2023-04-20 14:17:39 +00:00
tools [infra] Adjust sharding for VM JIT builders 2023-04-24 10:18:05 +00:00
utils Remove code which no longer compiles. 2023-04-03 23:40:05 +00:00
.clang-format
.gitattributes
.gitconfig
.gitignore [test_runner] Create --write-logs dir, add default dir to .gitignore 2022-11-15 09:59:08 +00:00
.gn
.mailmap Fixed various typos in a lot of files 2022-07-25 12:21:59 +00:00
.style.yapf
.vpython
AUTHORS Simplify the license situation 2022-09-14 21:06:22 +00:00
BUILD.gn Roll Fuchsia SDK to 7b3b23b2c0da59b3aceab6c49fbe7d9ed34d7382. 2023-02-09 22:43:36 +00:00
CHANGELOG.md Reland "[ Observatory ] Disable serving Observatory by default" 2023-04-20 18:16:09 +00:00
codereview.settings [infra] Default presubmits to use python3 2021-08-24 08:20:47 +00:00
CONTRIBUTING.md Add more details to contributing docs 2022-03-16 07:56:58 +00:00
DEPS [deps] rev async, characters, convert, crypto, dartdoc, intl, markdown, sse, stream_channel, test, tools, usage, webdev 2023-04-24 17:08:01 +00:00
LICENSE
OWNERS [owners] update the top-level owners file 2022-11-11 21:03:52 +00:00
PATENT_GRANT
PRESUBMIT.py Add year checking in PRESUBMIT.py 2023-02-01 16:31:32 +00:00
README.dart-sdk Fix README.dart-sdk file to reflect current contents of the SDK 2023-02-02 03:10:09 +00:00
README.md master => main 2021-09-10 08:02:49 +00:00
sdk_args.gni Fix typos 2022-06-15 11:08:28 +00:00
SECURITY.md Add link to published advisories 2022-02-08 19:45:07 +00:00
WATCHLISTS Add a watchlist entry for changes to _fe_analyzer_shared 2023-03-31 13:59:27 +00:00

Dart

A client-optimized language for fast apps on any platform

Dart is:

  • Optimized for UI: Develop with a programming language specialized around the needs of user interface creation.

  • Productive: Make changes iteratively: use hot reload to see the result instantly in your running app.

  • Fast on all platforms: Compile to ARM & x64 machine code for mobile, desktop, and backend. Or compile to JavaScript for the web.

Dart's flexible compiler technology lets you run Dart code in different ways, depending on your target platform and goals:

  • Dart Native: For programs targeting devices (mobile, desktop, server, and more), Dart Native includes both a Dart VM with JIT (just-in-time) compilation and an AOT (ahead-of-time) compiler for producing machine code.

  • Dart Web: For programs targeting the web, Dart Web includes both a development time compiler (dartdevc) and a production time compiler (dart2js).

Dart platforms illustration

License & patents

Dart is free and open source.

See LICENSE and PATENT_GRANT.

Using Dart

Visit dart.dev to learn more about the language, tools, and to find codelabs.

Browse pub.dev for more packages and libraries contributed by the community and the Dart team.

Our API reference documentation is published at api.dart.dev, based on the stable release. (We also publish docs from our beta and dev channels, as well as from the primary development branch).

Building Dart

If you want to build Dart yourself, here is a guide to getting the source, preparing your machine to build the SDK, and building.

There are more documents on our wiki.

Contributing to Dart

The easiest way to contribute to Dart is to file issues.

You can also contribute patches, as described in Contributing.