behavior

Queries the build data of a behavior profile stored on the Control Node. You can specify a date range to retrieve data for a specific period.

Command properties

Item	Description
Command type	Driver query
Required permission	Logged-in user (profile owner, shared target, or administrator)
License usage	Not counted
Parallel execution	Not supported
Distributed execution	Not supported

Syntax

behavior guid=STR [from=DATE] [to=DATE]

Options

guid=STR: Behavior profile GUID
from=DATE: Start time of the query range. Specify in yyyyMMddHHmmss format. If omitted, the query starts from the beginning of the available data.
to=DATE: End time of the query range. Specify in yyyyMMddHHmmss format. If omitted, the query runs to the end of the available data.

Output fields

The output fields are the result fields from the behavior profile's build query. The exact fields depend on each profile's build query.

Error codes

Parse errors

Error code	Message	Description
300101	Invalid session.	The session is not valid.
300102	Enter the from option in yyyyMMddHHmmss format.	The `from` option value is not in the correct date format.
300103	Enter the to option in yyyyMMddHHmmss format.	The `to` option value is not in the correct date format.
300104	Behavior profile not found.	No behavior profile exists for the specified GUID.
300105	Invalid guid option format.	The `guid` option value is not a valid GUID format.
300106	No data access permission.	You do not have access permission for the behavior profile.
300118	Specify the guid option for the behavior command.	The `guid` option is not specified.

Runtime errors

N/A

Description

The behavior command retrieves the build result data of a behavior profile stored on the Control Node. If the behavior profile has not been built yet, no results are returned.

Use the from and to options to specify a date range and retrieve data only for that period. The date format is yyyyMMddHHmmss.

Only the profile owner, users with whom the profile is shared, or administrators can run this command. Accessing a profile belonging to another tenant requires master administrator privileges.

Examples

Querying all data from a behavior profile
```
behavior guid=550e8400-e29b-41d4-a716-446655440000
```
Retrieves all available build data for the behavior profile with the specified GUID.
Querying data for a specific date range
```
behavior guid=550e8400-e29b-41d4-a716-446655440000 from=20260101000000 to=20260317235959
```
Retrieves behavior profile build data from January 1, 2026 to March 17, 2026.
Querying data from a specific start time
```
behavior guid=550e8400-e29b-41d4-a716-446655440000 from=20260301000000
```
Retrieves behavior profile build data from March 1, 2026 onward.