title | description | ms.topic | ms.assetid | ms.author | author | manager | ms.date |
---|---|---|---|---|---|---|---|
logman create api |
Reference article for the logman create api command, which creates an API-tracing data collector. |
reference |
2ecc0a75-2613-464a-8616-c5dc404bb736 |
jgerend |
JasonGerend |
mtillman |
10/16/2017 |
Applies to: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012
Creates an API tracing data collector.
logman create api <[-n] <name>> [options]
Parameter | Description |
---|---|
-s <computer name> |
Performs the command on the specified remote computer. |
-config <value> |
Specifies the settings file containing command options. |
[-n] <name> |
Name of the target object. |
-f `<bin | bincirc>` |
-[-]u <user [password]> |
Specifies the user to Run As. Entering a * for the password produces a prompt for the password. The password is not displayed when you type it at the password prompt. |
-m <[start] [stop] [[start] [stop] [...]]> |
Changed to manual start or stop instead of a scheduled begin or end time. |
-rf <[[hh:]mm:]ss> |
Run the data collector for the specified period of time. |
-b `<M/d/yyyy h:mm:ss[AM | PM]>` |
-e `<M/d/yyyy h:mm:ss[AM | PM]>` |
-si <[[hh:]mm:]ss> |
Specifies the sample interval for performance counter data collectors. |
-o `<path | dsn!log>` |
-[-]r | Repeat the data collector daily at the specified begin and end times. |
-[-]a | Append an existing log file. |
-[-]ow | Overwrite an existing log file. |
-[-]v `<nnnnnn | mmddhhmm>` |
-[-]rc <task> |
Run the command specified each time the log is closed. |
-[-]max <value> |
Maximum log file size in MB or maximum number of records for SQL logs. |
-[-]cnf <[[hh:]mm:]ss> |
When time is specified, creates a new file when the specified time has elapsed. When time is not specified, creates a new file when the maximum size is exceeded. |
-y | Answer yes to all questions without prompting. |
-mods <path [path [...]]> |
Specifies the list of modules to log API calls from. |
-inapis <module!api [module!api [...]]> |
Specifies the list of API calls to include in logging. |
-exapis <module!api [module!api [...]]> |
Specifies the list of API calls to exclude from logging. |
-[-]ano | Log (-ano) API names only, or do not log only (-ano) API names. |
-[-]recursive | Log (-recursive) or do not log (-recursive) APIs recursively beyond the first layer. |
-exe <value> |
Specifies the full path to an executable for API Tracing. |
/? | Displays context-sensitive help. |
- Where [-] is listed, adding an extra hyphen (-) negates the option.
To create an API trace counter called trace_notepad, for the executable file c:\windows\notepad.exe, and putting the results in the file c:\notepad.etl, type:
logman create api trace_notepad -exe c:\windows\notepad.exe -o c:\notepad.etl
To create an API trace counter called trace_notepad, for the executable file c:\windows\notepad.exe, collecting values produced by the module at c:\windows\system32\advapi32.dll, type:
logman create api trace_notepad -exe c:\windows\notepad.exe -mods c:\windows\system32\advapi32.dll
To create an API trace counter called trace_notepad, for the executable file c:\windows\notepad.exe, excluding the API call TlsGetValue produced by the module kernel32.dll, type:
logman create api trace_notepad -exe c:\windows\notepad.exe -exapis kernel32.dll!TlsGetValue