註冊追蹤記錄提供者

本頁說明如何在 Fuchsia 系統中註冊新的追蹤服務供應商。

如要加入追蹤記錄，您必須向 Fuchsia 追蹤系統中的追蹤記錄管理工具註冊新的追蹤記錄提供者。(不過，由於 devhost 程序是透過 libdriver.so 執行，因此驅動程式不必註冊為追蹤提供者)。

如要註冊追蹤提供者，請按照下列步驟操作：

1. 使用追蹤記錄管理員註冊元件。
2. 設定功能轉送。

使用追蹤記錄管理員註冊元件

如要將元件註冊為追蹤程式，您可以使用 libtrace-provider 程式庫，在元件的程式碼中提供非同步迴圈。(如要進一步瞭解追蹤程式庫，請參閱「追蹤程式庫」)。

請參考以下範例：

#include <lib/async-loop/cpp/loop.h>
#include <lib/async-loop/default.h>
#include <lib/trace-provider/provider.h>
// further includes

int main(int argc, const char** argv) {
  // process argv

  async::Loop loop(&kAsyncLoopConfigAttachToCurrentThread);
  trace::TraceProviderWithFdio trace_provider(
      loop.dispatcher(), "my_trace_provider");

  // further setup

  loop.Run();
  return 0;
}

#include <lib/async-loop/cpp/loop.h>
#include <lib/async-loop/default.h>
#include <lib/trace-provider/provider.h>

int main(int argc, char** argv) {
  zx_status_t status;
  async_loop_t* loop;
  trace_provider_t* trace_provider;

  // Create a message loop.
  status = async_loop_create(&kAsyncLoopConfigNoAttachToCurrentThread, &loop);
  if (status != ZX_OK) exit(1);

  // Start a thread for the loop to run on.
  // Alternatively, use async_loop_run() to run on the current thread.
  status = async_loop_start_thread(loop, "loop", NULL);
  if (status != ZX_OK) exit(1);

  // Create the trace provider.
  async_dispatcher_t* dispatcher = async_loop_get_dispatcher(loop);
  trace_provider = trace_provider_create(dispatcher);
  if (!trace_provider) exit(1);

  // Do something...

  // Tear down.
  trace_provider_destroy(trace_provider);
  async_loop_shutdown(loop);
  return 0;
}

fn main() {
    fuchsia_trace_provider::trace_provider_create_with_fdio();
    // ...
}

設定能力轉送

如要讓元件要求適當的追蹤功能，請在元件資訊清單 (.cml) 中加入下列欄位：

{
  include: [
    "trace/client.shard.cml",
  ],
  ...
}

如此一來，您的元件就能使用 fuchsia.tracing.provider.Registry 通訊協定與追蹤記錄管理工具通訊，並將優惠轉送至其子項。

如果您的元件使用以 Chromium 為基礎的 fuchsia.web 服務，且您想從服務收集追蹤資料，就必須為 Context 提供 fuchsia.tracing.provider.Registry 和 fuchsia.tracing.perfetto.ProducerConnector 功能。(如要瞭解功能如何傳遞至 Context，請參閱「fuchsia.web/CreateContextParams.service_directory」)。

將元件註冊為追蹤提供者後，即可在程式碼中啟用追蹤功能。詳情請參閱下一節「在程式碼中新增追蹤記錄」頁面。