Downloading Trace Information

If you used CTF on an application that you ran on Microsoft Azure (rather than locally) you must download the CTF trace information from Microsoft Azure table storage before you can view it. To do this you use the ctfazure utility which enables you to list, extract, and delete CTF trace events that have been written to Microsoft Azure table storage

You run the ctfazure utility from the command line and its format is as follows:

ctfazure action parameters

where:

action

specifies the action that the utility is to perform and can be one of:

delete: Deletes an Microsoft Azure table containing CTF trace events.
extract: Extracts CTF trace events from Microsoft Azure table storage into a local trace file.
list: Lists Microsoft Azure tables containing CTF trace events.

parameters

specify additional information:

-account:account name: The name of the Microsoft Azure storage account.
-key:account-key: The Microsoft Azure storage account key.
-file:file name: The name of local trace file to download the CTF trace events to.
-table:table-name: The name of the table in Microsoft Azure table storage containing the CTF trace events.
-tracetype:trace-type: Used with the extract action to specify the type of trace file that is to be created if the table to be downloaded contains both binary and text events. Valid values for trace-type are BINSTORAGE and TEXTSTORAGE.

Examples:

Delete the table named "mytable" from the Microsoft Azure storage account named "myacc":
```
ctfazure delete -table:mytable -account:myacc -key:abc123
```
List all tables containing CTF trace events in the Microsoft Azure storage account named "myacc":
```
ctfazure list -account:myacc -key:abc123
```
Create a trace file named mytrace.log from the contents of the table named "mytable" in the Microsoft Azure storage account name "myacc":
```
ctfazure extract -file:mytrace.log -table:mytable -account:myacc -key:abc123
```