Executions of Invantive products: one record per completed execution of a product on a machine - which product and version, for which user and licence, when it started and ended, and with which exit code, severity and message it ended. Appended to `executionlog.ndjson` in the configuration folder of the user, or to the file named by the environment variable [[INVANTIVE_EXECUTION_LOG_FILE]].
Read the files as a table with Invantive UniversalSQL through the Big Data JSON driver, for instance with the connection string:
```
provider=BigDataJson;swagger-specification-files={specification};directories={directory};extension=executionlog.ndjson;recurse-directories=false
```
## Columns
The columns of the table `ExecutionLogs` are shown below with the OpenAPI type of each, whether the value may be absent, and what it holds.
| Name | Label | Type | Nullable | Description | Example |
| --- | --- | --- | --- | --- | --- |
| `MetadataType` | Metadata Type | `string` | ☑ | Full name of the .NET type of the record, Invantive.Basics.ExecutionLog, which tells a reader of a mixed stream what shape the line has. | `Invantive.Basics.ExecutionLog` |
| `MachineNameFull` | Machine Name Full | `string` | ☑ | Full name of the machine the process ran on. | |
| `Action` | Action | `string` | ☑ | Name of the action executed, such as the command the product ran. | |
| `ExecutableName` | Executable Name | `string` | ☑ | Name of the executable of the process. | |
| `UserName` | User Name | `string` | ☑ | Operating system user of the process. | |
| `ProcessId` | Process Id | `integer / int64` | ☑ | Operating system process identifier. | |
| `StartTimeUtc` | Start Time Utc | `string / date-time` | ☐ | Start of the execution, in UTC. ISO 8601 date and time; a moment in UTC carries the suffix Z. | `2026-09-22T10:15:30.1234567Z` |
| `EndTimeUtc` | End Time Utc | `string / date-time` | ☐ | End of the execution, in UTC. ISO 8601 date and time; a moment in UTC carries the suffix Z. | |
| `ExitCode` | Exit Code | `integer / int32` | ☐ | Exit code of the process. | `0` |
| `ExitMessageCode` | Exit Message Code | `string` | ☑ | Message code of the message the process ended with. | |
| `IsHeadless` | Is Headless | `boolean` | ☐ | Whether the process ran without a user interface. | |
| `RecordFormatVersion` | Record Format Version | `integer / int32` | ☐ | Version of the record format. | `1` |
| `ExitLevel` | Exit Level | `string (enumeration)` | ☐ | Severity of the message the process ended with. An enumeration (Invantive.Basics.LoggingLevel) written as the name of its member. Members: Failure = 0: Failure of the system itself.; Error = 1: Error caused by the user, the data or the data source.; Warning = 2: Warning: something to look at, no failure.; Info = 3: Information.; Debug = 4: Debug output, the bulk of a trace.; Audit = 5: Audit record of an action.; License = 6: Licensing.; Unknown = 7: Unknown.. | |
| `MessageUid` | Message Uid | `string / uuid` | ☐ | Unique identifier of the message the process ended with, as registered with Invantive Cloud. | |
| `ApplicationVersion` | Application Version | `string` | ☑ | Version of the product. | |
| `ApplicationName` | Application Name | `string` | ☑ | Name of the product. | |
| `LicenseCode` | License Code | `string` | ☑ | Code of the licence contract. | |
| `LicenseKeyIdentifier` | License Key Identifier | `string` | ☑ | Identifier of the licence key. | |
| `Iiid` | Iiid | `string` | ☑ | Invantive Installation ID of the device. | |
| `SessionId` | Session Id | `string` | ☑ | Identifier of the session. | |
| `ManagedThreadId` | Managed Thread Id | `integer / int32` | ☑ | Identifier of the managed .NET thread which wrote the record. | |
| `TaskId` | Task Id | `integer / int32` | ☑ | Identifier of the .NET task which wrote the record, when written from within a task. | |
| `ComputerManufacturer` | Computer Manufacturer | `string` | ☑ | Manufacturer of the computer. | |
| `ComputerModel` | Computer Model | `string` | ☑ | Model of the computer. | |
| `OSVersion` | OS Version | `object` | ☑ | Version of the operating system, as major.minor.build.revision. A nested object of the .NET type System.Version, written as JSON. | `10.0.26200.0` |
| `PhysicalMemoryInBytes` | Physical Memory In Bytes | `integer / int64` | ☑ | Physical memory of the computer in bytes. An unsigned 64-bit integer, which may exceed what a signed 64-bit reader holds. | |
| `RequestId` | Request Id | `string` | ☑ | Identifier of the request being handled, for a web application. | |
| `ExceptionMessageCode` | Exception Message Code | `string` | ☑ | Message code of the exception the process ended with, when it ended with one. | |
| `ExceptionMessageText` | Exception Message Text | `string` | ☑ | Message text of the exception the process ended with, when it ended with one. | |
## Specification
The OpenAPI specification is published as `Invantive.Basics.ExecutionLog.swagger.json` beside this page and is written by every product into the folder of the files themselves, named after the record type and the product version. It is the file a connection string of the Big Data JSON driver points at.
```json
{
"openapi": "3.0.3",
"info": {
"title": "Invantive Execution Logging",
"version": "26.1",
"description": "Executions of Invantive products: one record per completed execution of a product on a machine - which product and version, for which user and licence, when it started and ended, and with which exit code, severity and message it ended. Appended to executionlog.ndjson in the configuration folder of the user, or to the file named by the environment variable INVANTIVE_EXECUTION_LOG_FILE.\n\nEvery line of a file is one JSON object: a record of the .NET type Invantive.Basics.ExecutionLog of assembly Invantive.Basics version 26.1.88.0 (NDJSON, newline-delimited JSON, see https://github.com/ndjson/ndjson-spec), written by System.Text.Json.\n\nRead the files as a table with Invantive UniversalSQL through the Big Data JSON driver, for instance with the connection string: provider=BigDataJson;swagger-specification-files={specification};directories={directory};extension=executionlog.ndjson;recurse-directories=false\n\nGenerated at run time from the metadata of the type by Invantive.Basics.NdjsonOpenApiGenerator and written again whenever the assembly changes, so a property added to the type is in this specification without any other step.",
"contact": {
"name": "Invantive B.V.",
"email": "
[email protected]",
"url": "https://invantive.eu"
},
"x-invantive-generator": "Invantive.Basics.NdjsonOpenApiGenerator",
"x-invantive-record-type": "Invantive.Basics.ExecutionLog",
"x-invantive-assembly": "Invantive.Basics",
"x-invantive-assembly-version": "26.1.88.0",
"x-invantive-assembly-mvid": "6118c4c5-2552-40ac-aa6c-e4adb0f19d92",
"x-invantive-serializer": "System.Text.Json",
"x-invantive-content-type": "application/x-ndjson",
"x-invantive-nulls-omitted": false,
"x-invantive-connection-string-example": "provider=BigDataJson;swagger-specification-files={specification};directories={directory};extension=executionlog.ndjson;recurse-directories=false"
},
"tags": [
{
"name": "ExecutionLogs",
"description": "Records of the .NET type Invantive.Basics.ExecutionLog, read as the table ExecutionLogs.ExecutionLogs."
}
],
"paths": {
"/": {
"get": {
"tags": [
"ExecutionLogs"
],
"summary": "Gets all executions",
"description": "Executions of Invantive products: one record per completed execution of a product on a machine - which product and version, for which user and licence, when it started and ended, and with which exit code, severity and message it ended. Appended to executionlog.ndjson in the configuration folder of the user, or to the file named by the environment variable INVANTIVE_EXECUTION_LOG_FILE.",
"operationId": "ExecutionLogs",
"x-invantive-label-singular": "Execution",
"x-invantive-label-plural": "Executions",
"parameters": [],
"responses": {
"200": {
"description": "Successful operation.",
"content": {
"application/x-ndjson": {
"schema": {
"$ref": "#/components/schemas/ExecutionLog"
}
}
}
}
}
}
}
},
"components": {
"schemas": {
"ExecutionLog": {
"type": "object",
"description": "One execution of an Invantive product: which product, on which machine and for which user, when it started and ended, and with which exit code and message it ended.",
"x-invantive-record-type": "Invantive.Basics.ExecutionLog",
"items": {
"type": "object",
"properties": {
"MetadataType": {
"type": "string",
"title": "Metadata Type",
"description": "Full name of the .NET type of the record, Invantive.Basics.ExecutionLog, which tells a reader of a mixed stream what shape the line has.",
"example": "Invantive.Basics.ExecutionLog",
"nullable": true,
"x-invantive-clr-type": "System.String",
"x-invantive-clr-property": "MetadataType"
},
"MachineNameFull": {
"type": "string",
"title": "Machine Name Full",
"description": "Full name of the machine the process ran on.",
"nullable": true,
"x-invantive-clr-type": "System.String",
"x-invantive-clr-property": "MachineNameFull"
},
"Action": {
"type": "string",
"title": "Action",
"description": "Name of the action executed, such as the command the product ran.",
"nullable": true,
"x-invantive-clr-type": "System.String",
"x-invantive-clr-property": "Action"
},
"ExecutableName": {
"type": "string",
"title": "Executable Name",
"description": "Name of the executable of the process.",
"nullable": true,
"x-invantive-clr-type": "System.String",
"x-invantive-clr-property": "ExecutableName"
},
"UserName": {
"type": "string",
"title": "User Name",
"description": "Operating system user of the process.",
"nullable": true,
"x-invantive-clr-type": "System.String",
"x-invantive-clr-property": "UserName"
},
"ProcessId": {
"type": "integer",
"format": "int64",
"title": "Process Id",
"description": "Operating system process identifier.",
"nullable": true,
"x-invantive-clr-type": "System.UInt32",
"x-invantive-clr-property": "ProcessId"
},
"StartTimeUtc": {
"type": "string",
"format": "date-time",
"title": "Start Time Utc",
"description": "Start of the execution, in UTC. ISO 8601 date and time; a moment in UTC carries the suffix Z.",
"example": "2026-09-22T10:15:30.1234567Z",
"x-invantive-clr-type": "System.DateTime",
"x-invantive-clr-property": "StartTimeUtc"
},
"EndTimeUtc": {
"type": "string",
"format": "date-time",
"title": "End Time Utc",
"description": "End of the execution, in UTC. ISO 8601 date and time; a moment in UTC carries the suffix Z.",
"x-invantive-clr-type": "System.DateTime",
"x-invantive-clr-property": "EndTimeUtc"
},
"ExitCode": {
"type": "integer",
"format": "int32",
"title": "Exit Code",
"description": "Exit code of the process.",
"example": 0,
"x-invantive-clr-type": "System.Int32",
"x-invantive-clr-property": "ExitCode"
},
"ExitMessageCode": {
"type": "string",
"title": "Exit Message Code",
"description": "Message code of the message the process ended with.",
"nullable": true,
"x-invantive-clr-type": "System.String",
"x-invantive-clr-property": "ExitMessageCode"
},
"IsHeadless": {
"type": "boolean",
"title": "Is Headless",
"description": "Whether the process ran without a user interface.",
"x-invantive-clr-type": "System.Boolean",
"x-invantive-clr-property": "IsHeadless"
},
"RecordFormatVersion": {
"type": "integer",
"format": "int32",
"title": "Record Format Version",
"description": "Version of the record format.",
"example": 1,
"x-invantive-clr-type": "System.Int32",
"x-invantive-clr-property": "RecordFormatVersion"
},
"ExitLevel": {
"type": "string",
"enum": [
"Failure",
"Error",
"Warning",
"Info",
"Debug",
"Audit",
"License",
"Unknown"
],
"title": "Exit Level",
"description": "Severity of the message the process ended with. An enumeration (Invantive.Basics.LoggingLevel) written as the name of its member. Members: Failure = 0: Failure of the system itself.; Error = 1: Error caused by the user, the data or the data source.; Warning = 2: Warning: something to look at, no failure.; Info = 3: Information.; Debug = 4: Debug output, the bulk of a trace.; Audit = 5: Audit record of an action.; License = 6: Licensing.; Unknown = 7: Unknown..",
"x-invantive-clr-type": "Invantive.Basics.LoggingLevel",
"x-invantive-clr-property": "ExitLevel"
},
"MessageUid": {
"type": "string",
"format": "uuid",
"title": "Message Uid",
"description": "Unique identifier of the message the process ended with, as registered with Invantive Cloud.",
"x-invantive-clr-type": "System.Guid",
"x-invantive-clr-property": "MessageUid"
},
"ApplicationVersion": {
"type": "string",
"title": "Application Version",
"description": "Version of the product.",
"nullable": true,
"x-invantive-clr-type": "System.String",
"x-invantive-clr-property": "ApplicationVersion"
},
"ApplicationName": {
"type": "string",
"title": "Application Name",
"description": "Name of the product.",
"nullable": true,
"x-invantive-clr-type": "System.String",
"x-invantive-clr-property": "ApplicationName"
},
"LicenseCode": {
"type": "string",
"title": "License Code",
"description": "Code of the licence contract.",
"nullable": true,
"x-invantive-clr-type": "System.String",
"x-invantive-clr-property": "LicenseCode"
},
"LicenseKeyIdentifier": {
"type": "string",
"title": "License Key Identifier",
"description": "Identifier of the licence key.",
"nullable": true,
"x-invantive-clr-type": "System.String",
"x-invantive-clr-property": "LicenseKeyIdentifier"
},
"Iiid": {
"type": "string",
"title": "Iiid",
"description": "Invantive Installation ID of the device.",
"nullable": true,
"x-invantive-clr-type": "System.String",
"x-invantive-clr-property": "Iiid"
},
"SessionId": {
"type": "string",
"title": "Session Id",
"description": "Identifier of the session.",
"nullable": true,
"x-invantive-clr-type": "System.String",
"x-invantive-clr-property": "SessionId"
},
"ManagedThreadId": {
"type": "integer",
"format": "int32",
"title": "Managed Thread Id",
"description": "Identifier of the managed .NET thread which wrote the record.",
"nullable": true,
"x-invantive-clr-type": "System.Int32",
"x-invantive-clr-property": "ManagedThreadId"
},
"TaskId": {
"type": "integer",
"format": "int32",
"title": "Task Id",
"description": "Identifier of the .NET task which wrote the record, when written from within a task.",
"nullable": true,
"x-invantive-clr-type": "System.Int32",
"x-invantive-clr-property": "TaskId"
},
"ComputerManufacturer": {
"type": "string",
"title": "Computer Manufacturer",
"description": "Manufacturer of the computer.",
"nullable": true,
"x-invantive-clr-type": "System.String",
"x-invantive-clr-property": "ComputerManufacturer"
},
"ComputerModel": {
"type": "string",
"title": "Computer Model",
"description": "Model of the computer.",
"nullable": true,
"x-invantive-clr-type": "System.String",
"x-invantive-clr-property": "ComputerModel"
},
"OSVersion": {
"type": "object",
"title": "OS Version",
"description": "Version of the operating system, as major.minor.build.revision. A nested object of the .NET type System.Version, written as JSON.",
"example": "10.0.26200.0",
"nullable": true,
"x-invantive-clr-type": "System.Version",
"x-invantive-clr-property": "OSVersion"
},
"PhysicalMemoryInBytes": {
"type": "integer",
"format": "int64",
"title": "Physical Memory In Bytes",
"description": "Physical memory of the computer in bytes. An unsigned 64-bit integer, which may exceed what a signed 64-bit reader holds.",
"nullable": true,
"x-invantive-clr-type": "System.UInt64",
"x-invantive-clr-property": "PhysicalMemoryInBytes"
},
"RequestId": {
"type": "string",
"title": "Request Id",
"description": "Identifier of the request being handled, for a web application.",
"nullable": true,
"x-invantive-clr-type": "System.String",
"x-invantive-clr-property": "RequestId"
},
"ExceptionMessageCode": {
"type": "string",
"title": "Exception Message Code",
"description": "Message code of the exception the process ended with, when it ended with one.",
"nullable": true,
"x-invantive-clr-type": "System.String",
"x-invantive-clr-property": "ExceptionMessageCode"
},
"ExceptionMessageText": {
"type": "string",
"title": "Exception Message Text",
"description": "Message text of the exception the process ended with, when it ended with one.",
"nullable": true,
"x-invantive-clr-type": "System.String",
"x-invantive-clr-property": "ExceptionMessageText"
}
},
"required": []
}
}
}
}
}
```