Top.Mail.Ru
System Tables
CTRL+K

System Tables

In this article

The system allows you to retrieve up-to-date information about users, access rights, dashboards, scripts, and other elements. You can extract this data and send it to ClickHouse using the Get system table automation block.

Below is a description of the available system tables and their fields, which can be obtained using this block.

Important
  • When creating a new table from the output of the Get system table block, it is recommended to specify the appropriate ClickHouse type in the Data type column.
  • The selection of the appropriate data type for numerical values in the id field depends on the size of the added table. In the majority of cases, preferable types are Int64 and UInt64, but you can select the required type from the following: UInt32, UInt64, UInt128, UInt256, Int64, Int128, or Int256. It is recommended to specify the data type that is most appropriate to your requirements. You can read the descriptions of the types on the official ClickHouse website.
  • The ClickHouse data type Array(Type) cannot be Nullable. When entering the column type Array(Type) remove the check mark next to the option Null in the corresponding fields.

Creating a table from output

System Table Relationships

The diagram below shows how the Operavix system tables are related to one another.

The diagram includes:

  • All primary Operavix system tables
  • Primary and foreign keys of the system tables
  • Relationships between tables

System Table Relationships

access_role

Source FieldRecommended ClickHouse TypeDescription
idIntegerAccess role ID
is_adminBool"Application Admin" role
nameStringName of the access role

access_role_privilege

Source FieldRecommended ClickHouse TypeDescription
idIntegerPrivilege ID
access_role_idIntegerAccess role ID
is_createBoolCreate operation
is_deleteBoolDelete operation
is_executeBoolExecute operation
is_readBoolRead operation
is_writeBoolWrite operation
name_ruStringPrivilege name (Russian)
nameStringPrivilege code (with module name)

ad_attribute

The table contains information about synchronized attributes.

Source FieldRecommended ClickHouse TypeDescription
idIntegerAttribute value ID
additional_field_nameStringName of the additional field
attribute_nameStringAttribute name
data_typeStringData type
employee_idIntegerUser ID to whom the attribute belongs
indexIntegerIndex if the attribute stores an array
is_long_value_nullBoolIndicates if numeric value is empty
is_string_value_nullBoolIndicates if string value is empty
long_valueIntegerNumeric value
string_valueStringString value

automation_block_execution_history

Source FieldRecommended ClickHouse TypeDescription
idIntegerRecord ID
activator_nameStringFull name or API key name
api_key_idIntegerID of the API key that triggered the script
block_errorStringError message (if any)
block_idIntegerBlock ID
block_nameStringBlock name
block_typeStringBlock type
count_output_dataIntegerNumber of output items
duration_executionIntegerDuration of script execution
employee_idIntegerUser ID
execution_fieldsStringSQL query ID executed in ClickHouse (JSON format for Space/ClickHouse packages)
execution_typeStringExecution type: Test / Active
input_dataStringInput parameters in JSON
script_general_idIntegerScript ID
start_executionDateTimeScript start time

dashboard

Source FieldRecommended ClickHouse TypeDescription
idIntegerDashboard ID
dashboard_author_idIntegerAuthor ID
dashboard_creation_timeDateTime / DateTime64Creation time
dashboard_nameStringDashboard name
guidStringDashboard GUID
workspace_idIntegerWorkspace ID

dashboard_access

Source FieldRecommended TypeDescription
idIntegerRecord ID
dashboard_idIntegerDashboard ID
employee_idIntegerUser ID
operationStringType of access (Read/Write)

department

FieldTypeDescription
idIntegerDepartment ID
nameStringDepartment name
parent_department_idIntegerParent department ID
parent_department_idsArray(Int64)Array of parent department IDs

employee

FieldTypeDescription
idIntegerUser ID (also sort key)
access_role_idsArray(Int64)User access role IDs
access_to_department_idsArray(Int64)Department IDs user has access to
access_to_employee_idsArray(Int64)Employee IDs user has access to
additional_fields_namesArray(String)Names of user custom fields
additional_fields_valuesArray(String)Values of user custom fields
all_employee_accessBoolHas access to all employees
authentication_assignedBoolWhether the user can authenticate
authentication_types_assignedArray(String)Authentication types assigned
department_idsArray(Int64)IDs of root/intermediate/final department
departmentsArray(String)Names of root/intermediate/final departments
emailStringEmail
employee_account_domainsArray(String)Domains of the user’s accounts (empty string if none)
employee_account_idsArray(Int64)IDs of activity sources
employee_account_loginsArray(String)Logins of user accounts (empty string if none)
first_nameStringFirst name
license_rolesArray(String)Assigned license roles
loginStringLogin
monitoring_typeStringActivity collection mode (DISABLED/SIMPLE/EXTENDED)
nameStringDisplay name
patronymicStringMiddle name
personnel_numberStringPersonnel number
phonesArray(String)Phone numbers
second_nameStringLast name

employee_account

FieldTypeDescription
idIntegerAccount ID
employee_idIntegerUser ID

employee_ad_group

FieldTypeDescription
idIntegerRecord ID
ad_account_distinguished_nameStringAD account DN
ad_account_guidStringAD account GUID
ad_account_idIntegerAD account ID
ad_group_canonical_nameStringAD group canonical name
ad_group_distinguished_nameStringAD group DN
ad_group_guidStringAD group GUID
ad_group_idIntegerAD group ID
ad_group_nameStringAD group name
display_nameStringDisplay name
employee_idIntegerUser ID

employee_favourite_workspace

FieldTypeDescription
idIntegerRecord ID
employee_idIntegerEmployee ID
workspace_idIntegerWorkspace ID

employee_workspace_access

FieldTypeDescription
idIntegerRecord ID
employee_idIntegerEmployee ID
operationStringAccess operation
workspace_idIntegerWorkspace ID

employee_workspace_main_page_group

Important

A record is created in this table only if the bookmark contains at least one workspace. Empty bookmarks are not shown.

FieldTypeDescription
idIntegerRecord ID
employee_idIntegerEmployee ID
main_page_group_idIntegerBookmark ID
main_page_group_nameStringBookmark name
workspace_idIntegerWorkspace ID

employee_license_role_log

FieldTypeDescription
idIntegerRecord ID
api_key_descriptionStringSource of change (format ID~message; ID is API key ID, message is part of key)
employee_descriptionStringSource of change (format ID~message; ID is user ID, message is display_name)
employee_idIntegerUser ID
event_dateDateTime/DateTime64Event date
license_roleStringLicense role
operationStringAdd or remove operation
source_typeStringSource type (EMPLOYEE or API_KEY)
FieldTypeDescription
idIntegerAccess object ID
employee_idIntegerUser ID
operationStringAccess type (Read/Write)
workspace_idIntegerWorkspace ID

monitoring_screenshot

FieldTypeDescription
idIntegerMonitoring ID
blurBoolBlur
employeesArray(Int64)Employees included in the monitoring
endDateTimeEnd date
nameStringMonitoring name
startDateTimeStart date
statusStringMonitoring status

monitoring_employee_log_type

Tracks changes of a user's monitoring type.

Events are logged when:

  • A new user is created automatically in the system (from AD/integration/agent); then SYSTEM is recorded and the value is set to DISABLED
  • The monitoring type is changed by a user, administrator, or API; in that case the source is EMPLOYEE or API_KEY, with old and new values
FieldTypeDescription
idIntegerRecord ID
api_descriptionStringSource of change (format ID~message, API key ID and masked key)
employee_descriptionStringSource of change (format ID~message, user ID and display_name)
employee_idIntegerUser whose monitoring type was changed
event_dateDateTime/DateTime64Change date
event_sourceStringSource (SYSTEM, EMPLOYEE, API_KEY)
new_valueStringNew monitoring type
old_valueStringPrevious monitoring type

resource_monitor

The table collects data about the current state of the system. It does not contain historical records and reflects only the information available in memory at the time of the request.

FieldTypeDescription
idIntegerResource monitor ID (timestamp)
cpuFloat32CPU load at the time of the request (%)
diskFloat32Disk usage at the time of the request (MB)
node_idStringCluster node ID
node_nameStringCluster node name
ramFloat32RAM usage at the time of the request (MB)

script_event_history

FieldTypeDescription
idIntegerRecord ID
api_key_idIntegerAPI key ID
author_event_nameStringFull name or API key name
employee_idIntegerUser ID
event_timeDateTime/DateTime64Event time
event_typeStringType of event: Create / Delete / Publish / Restore version
script_general_idIntegerScript ID
script_versionIntegerScript version

script_execution

The table collects data on script executions within the last 24 hours.

FieldTypeDescription
idIntegerScript execution ID
durationIntegerDuration (ms)
errorStringError (if any)
execution_statusStringStatus of execution
node_nameStringAutomation node name
script_idIntegerScript ID
script_nameStringScript name
script_versionIntegerScript version
start_timeDateTimeStart time
workspace_idIntegerWorkspace ID
workspace_nameStringWorkspace name

system_event

The table collects data on current system events. It does not contain historical records and displays only the events that are in memory at the time of the request.

FieldTypeDescription
idIntegerRecord ID
event_typeStringEvent type determined by the monitor
levelIntegerAlert level: 1CRITICAL, 2ERROR, 3WARNING, 4INFO
messageStringMessage generated by the monitor
subsystem_uuidStringUnique module identifier
timeDateTime/DateTime64Time of the event
ttlIntegerDisplay period in ms

tag

FieldTypeDescription
idIntegerRecord ID
colourStringTag color
read_onlyBoolWhether the tag is read-only
nameStringTag name

workspace

FieldTypeDescription
idIntegerWorkspace ID
descriptionStringDescription
folder_idIntegerFolder ID
is_in_waste_binBoolIndicates if workspace is in the recycle bin
nameStringWorkspace name

workspace_database

FieldTypeDescription
idIntegerRecord ID
database_nameStringDatabase name
storage_guidStringData storage identifier
workspace_idIntegerWorkspace ID

workspace_folder

FieldTypeDescription
idIntegerFolder ID
nameStringFolder name
parent_idIntegerParent folder ID

workspace_tag

FieldTypeDescription
idIntegerRecord ID
tag_idIntegerTag ID
workspace_idIntegerWorkspace ID

Was the article helpful?

Yes
No
Previous
Data Storages
We use cookies to improve our website for you.