Interface Tracing


public interface Tracing
  • Method Details

    • end

      void end()
      Stop trace events collection.
    • getCategories

      List<String> getCategories()
      Gets supported tracing categories.
      Returns:
      A list of supported tracing categories.
    • recordClockSyncMarker

      void recordClockSyncMarker(String syncId)
      Record a clock sync marker in the trace.
      Parameters:
      syncId - The ID of this clock sync marker
    • requestMemoryDump

      RequestMemoryDumpResult requestMemoryDump()
      Request a global memory dump.
      Returns:
      RequestMemoryDumpResult
    • requestMemoryDump

      RequestMemoryDumpResult requestMemoryDump(Boolean deterministic, MemoryDumpLevelOfDetail levelOfDetail)
      Request a global memory dump.
      Parameters:
      deterministic - Enables more deterministic results by forcing garbage collection
      levelOfDetail - Specifies level of details in memory dump. Defaults to "detailed".
      Returns:
      RequestMemoryDumpResult
    • start

      void start()
      Start trace events collection.
    • start

      void start(@Deprecated String categories, @Deprecated String options, Double bufferUsageReportingInterval, TracingTransferMode transferMode, StreamFormat streamFormat, StreamCompression streamCompression, TraceConfig traceConfig, String perfettoConfig, TracingBackend tracingBackend)
      Start trace events collection.
      Parameters:
      categories - Category/tag filter
      options - Tracing options
      bufferUsageReportingInterval - If set, the agent will issue bufferUsage events at this interval, specified in milliseconds
      transferMode - Whether to report trace events as series of dataCollected events or to save trace to a stream (defaults to ReportEvents).
      streamFormat - Trace data format to use. This only applies when using ReturnAsStream transfer mode (defaults to json).
      streamCompression - Compression format to use. This only applies when using ReturnAsStream transfer mode (defaults to none)
      perfettoConfig - Base64-encoded serialized perfetto.protos.TraceConfig protobuf message When specified, the parameters categories, options, traceConfig are ignored. (Encoded as a base64 string when passed over JSON)
      tracingBackend - Backend type (defaults to auto)