| # Trace specification file | |
| A trace specification file is a JSON file that can be passed to `trace record` | |
| to configure parameters of tracing. For those parameters that can be | |
| passed both on the command line and set in the specification file, the command | |
| line value overrides the one from the file. | |
| The file supports the following top level-parameters: | |
| - `app`: string, url of the application to be run | |
| - `args`: array of strings, startup arguments to be passed to the application | |
| - `categories`: array of strings, tracing categories to be enabled | |
| - `duration`: integer, duration of tracing in seconds | |
| - `measure`: array of measurement specifications, see Benchmarking | |
| For information about the Fuchsia tracing system, | |
| see [Fuchsia tracing system](/docs/concepts/tracing/README.md). | |
| For information on how to record a trace, see | |
| [Recording a Fuchsia | |
| trace](/docs/development/tracing/tutorial/recording-a-fuchsia-trace.md). | |
| ## Configuration | |
| The tracing configuration is a JSON file consisting of a list of known | |
| category names and descriptions. | |
| The format is as follows: | |
| ```json | |
| { | |
| "categories": { | |
| "category1": "description1", | |
| "category2": "description2" | |
| }, | |
| "providers": { | |
| "provider-label": "file:///provider-to-start-automatically" | |
| } | |
| } | |
| ``` | |