[Tracing] Add Perfetto support to Open Screen

This patch adds Perfetto support to Open Screen, and the standalone
cast sender and receiver binaries. This should help make diagnosing
issues with Cast and other components easier.

With this patch, you can now run Open Screen binaries, such as the
Cast standalone sender and receiver, with Perfetto enabled by passing
the `-P` or `--perfetto` flag. A pftrace file is automatically generated
upon application exit that can be loaded in the Perfetto UI.

Bug: 479649464
Change-Id: I45e44017a88cf5b8ef95fe894a417b01d34c4d85
Reviewed-on: https://chromium-review.googlesource.com/c/openscreen/+/7530400
Reviewed-by: Muyao Xu <muyaoxu@google.com>
Commit-Queue: Jordan Bayles <jophba@chromium.org>

Author: baylesj

.github/workflows/main.yml

@@ -0,0 +1,58 @@
+name: Exact OpenScreen Mirror with .github Protection
+
+on:
+  workflow_dispatch:  # Manuel olarak tetiklenebilir
+  schedule:
+    - cron: '0 0 */3 * *'  # Her 3 günde bir otomatik olarak çalışır
+
+jobs:
+  mirror:
+    runs-on: ubuntu-latest  # İş akışı Ubuntu üzerinde çalışır
+    steps:
+      # Adım 1: Mevcut depoyu tam tarihçe ile al
+      - name: Checkout Full History
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # Tüm commit geçmişini al
+
+      # Adım 2: OpenScreen verilerini mevcut depoya entegre et
+      - name: Integrate OpenScreen
+        run: |
+          # 'actions' branch'ine geç
+          git checkout actions
+          
+          # OpenScreen'i uzak depo olarak ekle
+          git remote add openscreen https://chromium.googlesource.com/openscreen
+          
+          # OpenScreen'den tüm branch'leri ve tag'leri al
+          git fetch openscreen --tags
+          
+          # OpenScreen'deki tüm branch'leri yerel olarak oluştur (main hariç)
+          git branch -r | grep 'openscreen/' | grep -v 'HEAD' | while read remote; do
+            branch_name=${remote#openscreen/}
+            git branch -f "$branch_name" "$remote"
+          done
+
+      # Adım 3: Main branch'i koru ve .github dosyalarını güncelle
+      - name: Protect Main Branch
+        run: |
+          # Main branch'e geç
+          git checkout main
+          
+          # Git kullanıcı bilgilerini ayarla (commit için)
+          git config user.name "GitHub Actions"
+          git config user.email "actions@github.com"
+          
+          # 'actions' branch'inden .github klasörünü al ve main branch'ine merge et
+          git checkout actions -- .github
+          git add .github
+          git commit --amend --no-edit  # Commit'i güncelle (fast-forward olmadan)
+
+      # Adım 4: Tüm branch'leri ve tag'leri force push et
+      - name: Force Push Mirrored Branches
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}  # GitHub token'ı kullan
+        run: |           
+          # Tüm branch'leri ve tag'leri force push et
+          git push origin --all --force
+          git push origin --tags --force

.gitmodules

@@ -72,3 +72,7 @@
 	path = third_party/googleurl/src
 	url = https://quiche.googlesource.com/googleurl
 	gclient-condition = not build_with_chromium
+[submodule "third_party/perfetto/src"]
+	path = third_party/perfetto/src
+	url = https://chromium.googlesource.com/external/github.com/google/perfetto
+	gclient-condition = not build_with_chromium

DEPS

@@ -413,7 +413,13 @@ deps = {
     'url': Var('quiche_git') + '/googleurl.git' +
       '@' + '94ff147fe0b96b4cca5d6d316b9af6210c0b8051',  #2025-11-11
     'condition': 'not build_with_chromium',
-  }
+  },
+
+  'third_party/perfetto/src': {
+    'url': Var('chromium_git') + '/external/github.com/google/perfetto.git' +
+      '@' + '1d9994a93c6ada2fb261dc72984fa07683a6c86e',
+    'condition': 'not build_with_chromium',
+  },
 }
 
 hooks = [

build_overrides/build.gni

@@ -39,3 +39,5 @@ if (host_os == "mac" || is_apple) {
   assert(current_os != "ios" || use_system_xcode)
   assert(host_os == "mac" || !use_system_xcode)
 }
+
+import("//build_overrides/perfetto.gni")

build_overrides/perfetto.gni

@@ -0,0 +1,34 @@
+# Copyright 2026 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+# This file is imported by Perfetto's BUILD.gn files.
+
+# The location of the Perfetto checkout.
+perfetto_root = "//third_party/perfetto/src"
+perfetto_root_path = "//third_party/perfetto/src/"
+
+# Prevent Perfetto from trying to use its own standalone build setup.
+perfetto_build_with_embedder = true
+
+# We don't want to build the trace processor, just the tracing SDK.
+enable_perfetto_trace_processor = false
+
+# We don't need the IPC layer.
+enable_perfetto_ipc = false
+
+# We want the client library.
+enable_perfetto_platform_services = false
+
+# Other flags to minimize build size/deps.
+enable_perfetto_heapprofd = false
+enable_perfetto_traced_probes = false
+enable_perfetto_tools = false
+enable_perfetto_unittests = false
+enable_perfetto_benchmarks = false
+enable_perfetto_fuzzers = false
+enable_perfetto_integration_tests = false
+
+# Map dependencies.
+perfetto_protobuf_target = "//third_party/protobuf:protobuf_lite"
+perfetto_protobuf_config = "//third_party/protobuf:protobuf_config"

cast/standalone_receiver/main.cc

@@ -29,6 +29,10 @@
 #include "util/trace_logging.h"
 #include "util/uuid.h"
 
+#if defined(USE_PERFETTO)
+#include "platform/impl/perfetto_trace_logging_platform.h"
+#endif
+
 namespace openscreen::cast {
 namespace {
 
@@ -69,12 +73,13 @@ usage: {} <options> <interface>
     -q, --disable-dscp: Disable DSCP packet prioritization, used for QoS over
                         the UDP socket connection.
 
-    -t, --tracing: Enable performance tracing logging.
+    -t, --tracing: Enable text based performance trace logging.
 
     -v, --verbose: Enable verbose logging.
 
     -x, --disable-discovery: Disable discovery.
 
+    -P, --perfetto: Enable Perfetto based performance trace logging.
 )";
 
   std::cerr << StringFormat(kTemplate, argv0);
@@ -126,7 +131,7 @@ struct Arguments {
   bool should_generate_credentials = false;
   std::string model_name = "cast_standalone_receiver";
   std::string private_key_path;
-  std::unique_ptr<TextTraceLoggingPlatform> trace_logger;
+  std::unique_ptr<TraceLoggingPlatform> trace_logger;
   bool is_verbose = false;
 };
 
@@ -146,11 +151,14 @@ std::optional<Arguments> ParseArgs(int argc, char* argv[]) {
       {"private-key", required_argument, nullptr, 'p'},
       {"tracing", no_argument, nullptr, 't'},
       {"verbose", no_argument, nullptr, 'v'},
+#if defined(USE_PERFETTO)
+      {"perfetto", no_argument, nullptr, 'P'},
+#endif
       {nullptr, 0, nullptr, 0}};
 
   Arguments args;
   int ch = -1;
-  while ((ch = getopt_long(argc, argv, "d:f:ghm:p:qtvx", kArgumentOptions,
+  while ((ch = getopt_long(argc, argv, "d:f:ghm:p:qtvxP", kArgumentOptions,
                            nullptr)) != -1) {
     switch (ch) {
       case 'd':
@@ -182,6 +190,11 @@ std::optional<Arguments> ParseArgs(int argc, char* argv[]) {
       case 'x':
         args.enable_discovery = false;
         break;
+#if defined(USE_PERFETTO)
+      case 'P':
+        args.trace_logger = std::make_unique<PerfettoTraceLoggingPlatform>();
+        break;
+#endif
     }
   }
 

cast/standalone_sender/main.cc

@@ -33,6 +33,10 @@
 #include "util/string_util.h"
 #include "util/stringprintf.h"
 
+#if defined(USE_PERFETTO)
+#include "platform/impl/perfetto_trace_logging_platform.h"
+#endif
+
 namespace openscreen::cast {
 namespace {
 
@@ -82,10 +86,12 @@ usage: {} <options> addr[:port] media_file
 
     -r, --remoting: Enable remoting content instead of mirroring.
 
-    -t, --tracing: Enable performance tracing logging.
+    -t, --tracing: Enable text based performance trace logging.
 
     -v, --verbose: Enable verbose logging.
 
+    -P, --perfetto: Enable perfetto based performance trace logging.
+
 )";
 
   std::cerr << StringFormat(kTemplate, argv0, argv0, kDefaultCastPort,
@@ -139,7 +145,7 @@ struct Arguments {
   bool use_remoting = false;
   bool is_verbose = false;
   VideoCodec codec = VideoCodec::kVp8;
-  std::unique_ptr<TextTraceLoggingPlatform> trace_logger;
+  std::unique_ptr<TraceLoggingPlatform> trace_logger;
   bool enable_dscp = true;
 };
 
@@ -158,12 +164,15 @@ std::optional<Arguments> ParseArgs(int argc, char* argv[]) {
       {"disable-dscp", no_argument, nullptr, 'q'},
       {"remoting", no_argument, nullptr, 'r'},
       {"tracing", no_argument, nullptr, 't'},
+#if defined(USE_PERFETTO)
+      {"perfetto", no_argument, nullptr, 'P'},
+#endif
       {"verbose", no_argument, nullptr, 'v'},
       {nullptr, 0, nullptr, 0}};
 
   Arguments args;
   int ch = -1;
-  while ((ch = getopt_long(argc, argv, "ac:d:hm:nqrtv", kArgumentOptions,
+  while ((ch = getopt_long(argc, argv, "ac:d:hm:nqrtvP", kArgumentOptions,
                            nullptr)) != -1) {
     switch (ch) {
       case 'a':
@@ -206,6 +215,11 @@ std::optional<Arguments> ParseArgs(int argc, char* argv[]) {
           return std::nullopt;
         }
         break;
+#if defined(USE_PERFETTO)
+      case 'P':
+        args.trace_logger = std::make_unique<PerfettoTraceLoggingPlatform>();
+        break;
+#endif
     }
   }
 

docs/trace_logging.md

@@ -334,6 +334,10 @@ The code for Trace Logging is divided up as follows:
       *trace_logging.h*, and connecting it to the platform API.
 * *platform/api/trace_logging_platform.h*: the platform implementation that is
       used as the trace logging destination while tracing is active.
+* *platform/impl/text_trace_logging_platform.h*: a basic implementation that
+      logs trace events to the console.
+* *platform/impl/perfetto_trace_logging_platform.h*: an implementation that
+      logs trace events to a Perfetto trace file.
 
 This information is intended to be only explanatory for embedders - only the one
 file mentioned above in Imports must be imported.
@@ -353,5 +357,36 @@ For an embedder to create a custom TraceLogging implementation:
   These activate/deactivate tracing by providing the TraceLoggingPlatform
   instance and later clearing references to it.
 
-**The default implementation of this layer can be seen in
-platform/impl/trace_logging_platform.cc.**
+**Example implementations of this layer can be seen in
+platform/impl/text_trace_logging_platform.cc (console logging) and
+platform/impl/perfetto_trace_logging_platform.cc (Perfetto tracing).**
+
+## Perfetto Tracing Support
+
+Open Screen supports [Perfetto](https://perfetto.dev/) for trace logging in
+standalone builds. This allows for generating trace files that can be viewed in
+the Perfetto UI.
+
+### Enabling Perfetto
+
+To enable Perfetto support, ensure the `use_perfetto` GN argument is set to
+`true`. This is the default for standalone builds (i.e., when
+`build_with_chromium` is `false`).
+
+```bash
+gn gen out/Default --args="use_perfetto=true"
+```
+
+### Using Perfetto in Standalone Apps
+
+When Perfetto support is compiled in, you can enable it in the standalone sender
+and receiver applications using the `--perfetto` or `-P` flag.
+
+```bash
+./out/Default/cast_sender -P ...
+./out/Default/cast_receiver -P ...
+```
+
+When enabled, a trace file (e.g., `openscreen_<pid>.pftrace`) will be generated
+upon termination of the application. This file can be opened at
+[ui.perfetto.dev](https://ui.perfetto.dev/).

platform/BUILD.gn

@@ -81,6 +81,16 @@ openscreen_source_set("api") {
   ]
 }
 
+declare_args() {
+  use_perfetto = !build_with_chromium
+}
+
+config("standalone_config") {
+  if (use_perfetto) {
+    defines = [ "USE_PERFETTO" ]
+  }
+}
+
 # The following target is only activated in standalone builds (see :platform).
 # Disable standalone implementation for IOS. It is not supported.
 if (!is_ios) {
@@ -119,7 +129,10 @@ if (!is_ios) {
       "impl/tls_write_buffer.h",
     ]
 
-    public_configs = [ "../util:trace_logging_config" ]
+    public_configs = [
+      "../util:trace_logging_config",
+      ":standalone_config",
+    ]
 
     if (is_linux || is_chromeos || is_android) {
       sources += [ "impl/network_interface_linux.cc" ]
@@ -167,6 +180,13 @@ if (!is_ios) {
       "../third_party/boringssl",
       "../util",
     ]
+
+    if (use_perfetto) {
+      public += [ "impl/perfetto_trace_logging_platform.h" ]
+      sources += [ "impl/perfetto_trace_logging_platform.cc" ]
+      deps += [ "../third_party/perfetto" ]
+    }
+
     friend = [ ":unittests" ]
   }
 }
@@ -279,5 +299,9 @@ openscreen_source_set("unittests") {
         "impl/udp_socket_reader_posix_unittest.cc",
       ]
     }
+
+    if (use_perfetto) {
+      sources += [ "impl/perfetto_trace_logging_platform_unittest.cc" ]
+    }
   }
 }

platform/base/trace_logging_types.cc

@@ -34,25 +34,25 @@ bool operator!=(const TraceIdHierarchy& lhs, const TraceIdHierarchy& rhs) {
 const char* ToString(TraceCategory category) {
   switch (category) {
     case TraceCategory::kAny:
-      return "Any";
+      return "any";
     case TraceCategory::kMdns:
-      return "Mdns";
+      return "mdns";
     case TraceCategory::kQuic:
-      return "Quic";
+      return "quic";
     case TraceCategory::kSsl:
-      return "SSL";
+      return "ssl";
     case TraceCategory::kPresentation:
-      return "Presentation";
+      return "presentation";
     case TraceCategory::kStandaloneReceiver:
-      return "StandaloneReceiver";
+      return "standalone_receiver";
     case TraceCategory::kDiscovery:
-      return "Discovery";
+      return "discovery";
     case TraceCategory::kStandaloneSender:
-      return "StandaloneSender";
+      return "standalone_sender";
     case TraceCategory::kReceiver:
-      return "Receiver";
+      return "receiver";
     case TraceCategory::kSender:
-      return "Sender";
+      return "sender";
   }
 
   // OSP_NOTREACHED is not available in platform/base.