image/svg+xml
docs.unity3d.com
  • Manual
  • Scripting API
  • Changelog
  • License
    Show / Hide Table of Contents
    • Scriptable Build Pipeline
      • Getting Started
      • Terminology
      • Usage Examples
      • Upgrade Guide
      • Unity Cache Server
      • Build Log
    • Manual
    • Scriptable Build Pipeline
    • Build Log

    Build Logging

    Scriptable Build Pipeline has a profiling instrumentation system enabling build performance logging. By default, building AssetBundles will create a .json log file in the Trace Event Profiler Format within the target output directory. The file contains timing measurements of various build tasks and can be viewed using the Trace Event Profiling Tool.

    The default logger can be overriden by passing in an IBuildLogger object as a context object input. This could be useful if you want to log performance data in a different format or want the build events to be added to a custom performance repot. The BuildLog class implements IBuildLogger and is used as the default logger.

    Adding Custom Instrumentation

    If you are creating or modifying build tasks that could affect build performance, you should consider adding instrumentation blocks to your new code. You can do this by calling the IBuildLogger methods directly or using the ScopedStep and AddEntrySafe extension methods.

    In This Article
    • Build Logging
    • Adding Custom Instrumentation
    Back to top
    Copyright © 2023 Unity Technologies — Terms of use
    • Legal
    • Privacy Policy
    • Cookies
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)
    "Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S. and elsewhere (more info here). Other names or brands are trademarks of their respective owners.
    Generated by DocFX on 18 October 2023