EDB Postgres Enterprise Manager REST APIs v4.0: Schemas v10.2
AlertPayload
{ "id": 0, "alert_name": "string", "alert_template": 0, "description": "string", "enabled": true, "history_retention": 0, "frequency_min": 0, "operator": "string", "low_threshold_value": 0, "medium_threshold_value": 0, "high_threshold_value": 0, "all_alert_enable": true, "email_group_id": 0, "low_alert_enable": true, "low_email_group_id": 0, "med_alert_enable": true, "med_email_group_id": 0, "high_alert_enable": true, "high_email_group_id": 0, "send_trap": true, "snmp_trap_version": 0, "low_send_trap": true, "med_send_trap": true, "high_send_trap": true, "params": [ { "paramname": "string", "paramvalue": "string" } ], "execute_script": true, "execute_script_on_clear": true, "execute_script_on_pem_server": true, "script_code": "string", "submit_to_nagios": true }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
id | integer | false | none | Alert Id. NOTE: It is not applicable for POST request. |
alert_name | string | false | none | Name of the alert. NOTE: It is a mandatory parameter for the POST request. |
alert_template | integer | false | none | ID of the alert template, positive integer value. NOTE: It is a mandatory parameter for the POST request. |
description | string | false | none | none |
enabled | boolean | false | none | Defines whether this alert is enabled/disabled. NOTE: It is a mandatory parameter for the POST request. |
history_retention | integer | false | none | For how many days to keep the history of this alert. Possible values are from 1 to 99999. NOTE: It is a mandatory parameter for the POST request. |
frequency_min | integer | false | none | Defines how frequently the alert needs to be checked on PEM database server. Possible values are from 1 to 65534 minutes. NOTE: It is a mandatory parameter for the POST request. |
operator | string | false | none | Defines the operator for checking the threshold values. Valid string are ">" and "<". NOTE: It is a mandatory parameter for the POST request. |
low_threshold_value | number | false | none | Threshold value for triggering the low alert. It can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request. |
medium_threshold_value | number | false | none | Threshold value for triggering the medium alert. It can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request. |
high_threshold_value | number | false | none | Threshold value for triggering the high alert. It can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request. |
all_alert_enable | boolean | false | none | Defines whether to send an email notification to the group, specified by the parameter 'email_group_id' when state of the alert is changed. |
email_group_id | integer | false | none | Defines to which email group the email notification will be sent, when state of alert is changed. |
low_alert_enable | boolean | false | none | Defines whether to send an email notification to the group, specified by the parameter 'low_email_group_id' when state of the alert is set to LOW. |
low_email_group_id | integer | false | none | Defines to which email group the email notification will be sent, when state of the alert is changed to LOW. |
med_alert_enable | boolean | false | none | Defines whether to send an email notification to the group, specified by the parameter 'medium_email_group_id' when state of the alert is set to MEDIUM. |
med_email_group_id | integer | false | none | Defines to which email group the email notification will be sent, when state of the alert is changed to MEDIUM. |
high_alert_enable | boolean | false | none | Defines whether to send an email notification to the group, specified by the parameter 'high_email_group_id' when state of the alert is set to HIGH. |
high_email_group_id | integer | false | none | Defines to which email group the email notification will be sent, when state of the alert is changed to HIGH. |
send_trap | boolean | false | none | Defines whether to send the SNMP trap notification when the state of the alert changes. |
snmp_trap_version | integer | false | none | Defines the SNMP trap version. Supported SNMP trap version is 1, 2 or 3 |
low_send_trap | boolean | false | none | Defines whether to send the SNMP trap notification when state of the alert chagnes to LOW. |
med_send_trap | boolean | false | none | Defines whether to send the SNMP trap notification when state of the alert chagnes to MEDIUM. |
high_send_trap | boolean | false | none | Defines whether to send the SNMP trap notification when state of the alert chagnes to HIGH. |
params | [AlertParams] | false | none | List of the parameter/value pair to be used by the alert template for checking the alerts. NOTE: The all parameter must be defined as per the alert template. |
execute_script | boolean | false | none | Defines whether to execute the provided script if the state of the alert is changed to LOW/MEDIUM/HIGH. |
execute_script_on_clear | boolean | false | none | Defines whether to execute the provided script if the state of the alert is cleared. |
execute_script_on_pem_server | boolean | false | none | Defines whether to execute the provided script on the PEM Host, or on the host from where the object is being monitored by the agent. |
script_code | string | false | none | The script, which will be executed. It could be a shell/batch script. Please read the documention for detailed information. |
submit_to_nagios | boolean | false | none | Defines whether to send notification to the nagios, when state of the alert is chagned. |
Alert
{ "id": 0, "alert_name": "string", "alert_template": 0, "description": "string", "enabled": true, "history_retention": 0, "frequency_min": 0, "operator": "string", "low_threshold_value": 0, "medium_threshold_value": 0, "high_threshold_value": 0, "send_email": true, "all_alert_enable": true, "email_group_id": 0, "low_alert_enable": true, "low_email_group_id": 0, "med_alert_enable": true, "med_email_group_id": 0, "high_alert_enable": true, "high_email_group_id": 0, "send_trap": true, "snmp_trap_version": 0, "low_send_trap": true, "med_send_trap": true, "high_send_trap": true, "params": [ { "paramname": "string", "paramvalue": "string" } ], "execute_script": true, "execute_script_on_clear": true, "execute_script_on_pem_server": true, "script_code": "string", "submit_to_nagios": true }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
id | integer | false | none | Alert Id. NOTE: It is not applicable for POST request. |
alert_name | string | false | none | Name of the alert. NOTE: It is a mandatory parameter for the POST request. |
alert_template | integer | false | none | ID of the alert template, positive integer value. NOTE: It is a mandatory parameter for the POST request. |
description | string | false | none | none |
enabled | boolean | false | none | Defines whether this alert is enabled/disabled. NOTE: It is a mandatory parameter for the POST request. |
history_retention | integer | false | none | For how many days to keep the history of this alert. Possible values are from 1 to 99999. NOTE: It is a mandatory parameter for the POST request. |
frequency_min | integer | false | none | Defines how frequently the alert needs to be checked on PEM database server. Possible values are from 1 to 65534 minutes. NOTE: It is a mandatory parameter for the POST request. |
operator | string | false | none | Defines the operator for checking the threshold values. Valid string are ">" and "<". NOTE: It is a mandatory parameter for the POST request. |
low_threshold_value | number | false | none | Threshold value for triggering the low alert. It can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request. |
medium_threshold_value | number | false | none | Threshold value for triggering the medium alert. It can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request. |
high_threshold_value | number | false | none | Threshold value for triggering the high alert. It can be any valid integer/float value. NOTE: It is a mandatory parameter for the POST request. |
send_email | boolean | false | none | Defines whether to send an email, when the state of alert is changed. |
all_alert_enable | boolean | false | none | Defines whether to send an email notification to the group, specified by the parameter 'email_group_id' when state of the alert is changed. |
email_group_id | integer | false | none | Defines to which email group the email notification will be sent, when state of alert is changed. |
low_alert_enable | boolean | false | none | Defines whether to send an email notification to the group, specified by the parameter 'low_email_group_id' when state of the alert is set to LOW. |
low_email_group_id | integer | false | none | Defines to which email group the email notification will be sent, when state of the alert is changed to LOW. |
med_alert_enable | boolean | false | none | Defines whether to send an email notification to the group, specified by the parameter 'medium_email_group_id' when state of the alert is set to MEDIUM. |
med_email_group_id | integer | false | none | Defines to which email group the email notification will be sent, when state of the alert is changed to MEDIUM. |
high_alert_enable | boolean | false | none | Defines whether to send an email notification to the group, specified by the parameter 'high_email_group_id' when state of the alert is set to HIGH. |
high_email_group_id | integer | false | none | Defines to which email group the email notification will be sent, when state of the alert is changed to HIGH. |
send_trap | boolean | false | none | Defines whether to send the SNMP trap notification when the state of the alert changes. |
snmp_trap_version | integer | false | none | Defines the SNMP trap version. Supported SNMP trap version is 1, 2 or 3 |
low_send_trap | boolean | false | none | Defines whether to send the SNMP trap notification when state of the alert chagnes to LOW. |
med_send_trap | boolean | false | none | Defines whether to send the SNMP trap notification when state of the alert chagnes to MEDIUM. |
high_send_trap | boolean | false | none | Defines whether to send the SNMP trap notification when state of the alert chagnes to HIGH. |
params | [AlertParams] | false | none | List of the parameter/value pair to be used by the alert template for checking the alerts. NOTE: The all parameter must be defined as per the alert template. |
execute_script | boolean | false | none | Defines whether to execute the provided script if the state of the alert is changed to LOW/MEDIUM/HIGH. |
execute_script_on_clear | boolean | false | none | Defines whether to execute the provided script if the state of the alert is cleared. |
execute_script_on_pem_server | boolean | false | none | Defines whether to execute the provided script on the PEM Host, or on the host from where the object is being monitored by the agent. |
script_code | string | false | none | The script, which will be executed. It could be a shell/batch script. Please read the documention for detailed information. |
submit_to_nagios | boolean | false | none | Defines whether to send notification to the nagios, when state of the alert is chagned. |
AlertParams
{ "paramname": "string", "paramvalue": "string" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
paramname | string | false | none | Name of the parameter. NOTE: This has to present on the alert template parameter list. |
paramvalue | string | false | none | Value for the given parameter |
AlternateServerProbeCode
{ "server_version_id": 0, "server_probe_code": "string" }
Properties
Name | Type | Required | Restrictions | Description | ||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
server_version_id | integer | false | none | Server version id for the support monitored server
| ||||||||||||||||||||||||||
server_probe_code | string | false | none | SQL query to run on the specified server version |
DeletedAlternateServerProbeCode
{ "server_version_id": 0 }
Properties
Name | Type | Required | Restrictions | Description | ||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
server_version_id | integer | false | none | Server version id for the support monitored server
|
AlertTemplate
{ "id": 0, "name": "string", "description": "string", "default_history_retention": 0, "object_type": 0, "sql": "string", "applicable_on_server": "ALL", "default_check_frequency": 0, "threshold_unit": "string", "is_system_template": true, "is_auto_create": true, "thresholds": [ 0 ], "operator": ">", "high_threshold_value": "string", "medium_threshold_value": "string", "low_threshold_value": "string", "info_sql": "string" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
id | integer | false | none | Identifier for the alert template. NOTE: It is not applicable while creating the alert template. |
name | string | false | none | Name of the alert template. NOTE: It is a mandatory parameter for the POST request. |
description | string | false | none | Description about the alert template. NOTE: It is a mandatory parameter for the POST request. |
default_history_retention | integer | false | none | Defines the history retention period in days for this type of alerts. NOTE: It is a mandatory parameter for the POST request. |
object_type | integer | false | none | Defines the type of the object on which this alert template is applicable to.
|
sql | string | false | none | SQL query, possibly parameterized, to get a numeric indicating threshold reached. NOTE: It is a mandatory parameter for the POST request. |
applicable_on_server | string | false | none | Template is applicable on which type of monitored server. Possible values are ALL, POSTGRES_SERVER, ADVANCED_SERVER. NOTE: It is a mandatory parameter for the POST request. |
default_check_frequency | integer | false | none | Defines how frequently to check for the alert defined from this template (in minutes). NOTE: It is a mandatory parameter for the POST request. |
threshold_unit | string | false | none | Unit in which threshold is calculated; purely for GUI, like MB/kB/seconds/days/... |
is_system_template | boolean | false | none | Defines whether the given template is system defined or user defined. NOTE: It is not applicable for the the POST/PUT requests. |
is_auto_create | boolean | false | none | Whether alert should be created as soon as agent or server is added to pem. |
thresholds | [number] | false | none | Default threshold values. Values in the thresholds array must be in the sorted order based on the operator. |
operator | string | false | none | Operator to compare threshold values. |
high_threshold_value | string | false | none | High threshold value. |
medium_threshold_value | string | false | none | Medium threshold value. |
low_threshold_value | string | false | none | Low threshold value. |
info_sql | string | false | none | Specify the SQL query that will provide the detailed information about that alert on Dashboard. |
Enumerated Values
Property | Value |
---|---|
applicable_on_server | ALL |
applicable_on_server | POSTGRES_SERVER |
applicable_on_server | ADVANCED_SERVER |
operator | > |
operator | < |
AlertHistory
{ "alert_id": 0, "state": "High", "value": "string", "actual_value": 0 }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
alert_id | integer | false | none | Alert ID |
state | string | false | none | State |
value | string | false | none | User presentable value |
actual_value | number | false | none | Actual value at the time of state change. |
Enumerated Values
Property | Value |
---|---|
state | High |
state | Medium |
state | Low |
ServerStatus
{ "id": 0, "name": "string", "group_id": 0, "group_name": "string", "blackout": true, "status": "UP", "alerts": { "total": 0, "acknowledged": 0, "high": 0, "medium": 0, "low": 0, "high_acknowledged": 0, "medium_acknowledged": 0, "low_acknowledged": 0 }, "version": "string", "number_connections": 0, "remote_monitoring": true, "agent_id": 0, "sessions": { "last_recorded_time": 0, "sessions": [ { "database_name": "string", "procpid": 0, "usename": "string", "backend_start": 0, "xact_start": 0, "query_start": 0, "is_waiting": true, "is_idle": true, "is_idle_in_transaction": true, "is_vacuum": true, "is_autovacuum": true, "client_addr": "string", "client_port": 0, "memory_usage_mb": 0, "swap_usage_mb": 0, "cpu_usage": 0, "io_read_bytes": 0, "io_write_bytes": 0, "state": "string", "state_change": 0 } ] } }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
id | integer | false | none | Server ID |
name | string | false | none | Server name |
group_id | integer | false | none | Group ID under which database server is visible to the user |
group_name | string | false | none | Group name |
blackout | boolean | false | none | Status of the alert blackout for the database server |
status | string | false | none | Server status can be UP, DOWN, UNKNOWN, or UNMANAGED, |
alerts | object | false | none | List of alert configured for the database server and it's status and how many are acknowledged |
» total | integer | false | none | Number of alerts configured for the database server |
» acknowledged | integer | false | none | Number of alerts, which are already been acknowledged |
» high | integer | false | none | Number of alerts with state as 'High' |
» medium | integer | false | none | Number of alerts with state as 'Medium' |
» low | integer | false | none | Number of alerts with state as 'Low' |
» high_acknowledged | integer | false | none | Number of alerts with state as 'High' and are acknowledged |
» medium_acknowledged | integer | false | none | Number of alerts with state as 'Medium' and are acknowledged |
» low_acknowledged | integer | false | none | Number of alerts with state as 'Low' and are acknowledged |
version | string | false | none | Current version of the database server |
number_connections | integer | false | none | Number of connections on the database servers |
remote_monitoring | boolean | false | none | Whether the database server is being monitored remotely by the pemAgent |
agent_id | integer | false | none | Agent ID, which is monitoring the database server |
sessions | object | false | none | All the session information for the daabase servers |
» last_recorded_time | number | false | none | Unix time representing the last session information recorded time |
» sessions | [object] | false | none | List of all the session information for the database server |
»» database_name | string | false | none | Database name |
»» procpid | integer | false | none | Process ID |
»» usename | string | false | none | User name |
»» backend_start | number | false | none | Unix time representing the session start time |
»» xact_start | number | false | none | Unix time representing the transaction start time |
»» query_start | number | false | none | Unix time representing the query start time (if any running) |
»» is_waiting | boolean | false | none | Is the sesion waiting? |
»» is_idle | boolean | false | none | Is the session idle? |
»» is_idle_in_transaction | boolean | false | none | Is the session idle in a transaction? |
»» is_vacuum | boolean | false | none | Is this a VACUUM session? |
»» is_autovacuum | boolean | false | none | Is this a AUTO VACUUM session? |
»» client_addr | string | false | none | Host address for the client of the session |
»» client_port | integer | false | none | Client port for the session |
»» memory_usage_mb | number | false | none | Memory usage (in MB) of the session (available only when monitoried locally) |
»» swap_usage_mb | number | false | none | Swap memory usage (in MB) of the session (available only when monitoried locally) |
»» cpu_usage | number | false | none | CPU Usage (in percentage) of the session (available only when monitoried locally) |
»» io_read_bytes | number | false | none | I/O Read (in bytes) of the session (available only when monitoried locally) |
»» io_write_bytes | number | false | none | I/O Write (in bytes) of the session (available only when monitoried locally) |
»» state | string | false | none | Current state of the session (idle, active, idle in transcation, etc) |
»» state_change | number | false | none | Unix time representing the last state change time of the session |
Enumerated Values
Property | Value |
---|---|
status | UP |
status | DOWN |
status | UNKNOWN |
status | UNMANAGED |
AgentStatus
{ "id": 0, "name": "string", "group_id": 0, "group_name": "string", "blackout": true, "status": "UP", "alerts": { "total": 0, "acknowledged": 0, "high": 0, "medium": 0, "low": 0, "high_acknowledged": 0, "medium_acknowledged": 0, "low_acknowledged": 0 }, "version": "string", "processes": 0, "threads": 0, "cpu_utilization": 0, "memory_utilization": 0, "swap_utilization": 0, "disk_utilization": 0 }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
id | integer | false | none | Agent ID |
name | string | false | none | Agent name |
group_id | integer | false | none | Group ID under which Agent is visible to the user |
group_name | string | false | none | Group name |
blackout | boolean | false | none | Enabled/Disabled alert blackout for the agent |
status | string | false | none | Agent status can be UP, DOWN, or UNKNOWN |
alerts | object | false | none | List of alert configured for the agent and it's status and how many are acknowledged |
» total | integer | false | none | Number of alerts configured for the agent |
» acknowledged | integer | false | none | Number of alerts, which are already been acknowledged |
» high | integer | false | none | Number of alerts with state as 'High' |
» medium | integer | false | none | Number of alerts with state as 'Medium' |
» low | integer | false | none | Number of alerts with state as 'Low' |
» high_acknowledged | integer | false | none | Number of alerts with state as 'High' and are acknowledged |
» medium_acknowledged | integer | false | none | Number of alerts with state as 'Medium' and are acknowledged |
» low_acknowledged | integer | false | none | Number of alerts with state as 'Low' and are acknowledged |
version | string | false | none | Current version of the agent |
processes | integer | false | none | Number of processes running |
threads | integer | false | none | Number of threads for all the running processes |
cpu_utilization | number | false | none | CPU utilization (Percentage) |
memory_utilization | number | false | none | Memory utilization (Percentage) |
swap_utilization | number | false | none | Swap memory utilization (Percentage) |
disk_utilization | number | false | none | Overall disk utilization (Percentage) |
Enumerated Values
Property | Value |
---|---|
status | UP |
status | DOWN |
status | UNKNOWN |
AlertStatus
{ "alert_since": "string", "alert_id": 0, "alert_name": "string", "alert_state": "High", "value": "string", "object_description": "string", "server_id": 0, "agent_id": 0, "database": "string", "schema": "string", "package": "string", "object": "string", "alert_target_level": "Global", "last_processed": "string", "info": "string", "info_cols": [ "string" ], "info_vals": [ [ "string" ] ] }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
alert_since | string | false | none | Unix Time at which alert state has last changed. |
alert_id | integer | false | none | Alert internal identification number |
alert_name | string | false | none | Name of the alert. |
alert_state | string | false | none | Current state of the alert. 'null' value suggested alert threshold values has not been violated for the alert at the moments. |
value | string | false | none | Current value of the alert |
object_description | string | false | none | Monitoring object description/name |
server_id | integer | false | none | null or ID of the server |
agent_id | integer | false | none | null or ID of the agent |
database | string | false | none | null or name of the database |
schema | string | false | none | null or name of the schema/namespace |
package | string | false | none | null or name of the EDB package |
object | string | false | none | null or name of any other type of object |
alert_target_level | string | false | none | Alert target level |
last_processed | string | false | none | String reprenting unix time at which the alert has been processed |
info | string | false | none | Some information at the time of alert generated |
info_cols | [string] | false | none | Array of column names for the information |
info_vals | [array] | false | none | Detailed information associalted with the alert in the form of table (array of array) |
Enumerated Values
Property | Value |
---|---|
alert_state | High |
alert_state | Medium |
alert_state | Low |
alert_target_level | Global |
alert_target_level | Agent |
alert_target_level | Server |
alert_target_level | Database |
alert_target_level | Schema |
alert_target_level | Table |
alert_target_level | Index |
alert_target_level | Sequence |
alert_target_level | Function |
alert_target_level | View |
CustomProbes
{ "probe_id": 0, "probe_name": "string", "enabled": true, "target_type": 0, "internal_name": "string", "is_system_probe": true, "any_server_version": true, "collection_method": "w", "interval": 0, "lifetime": 0, "discard_history": true, "platform": "string", "probe_code": "string", "probe_columns": [ { "pc_id": 0, "pc_name": "string", "pc_data_type": "bigint", "pc_internal_name": "string", "pc_unit": "string", "pc_col_type": "m", "pc_position": 0, "pc_graphable": true, "pc_calc_pit": true, "pc_pit_default": true } ], "alternate_code": [ { "server_version_id": 0, "server_probe_code": "string" } ] }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
probe_id | integer | false | none | Identifier for a probe. |
probe_name | string | false | none | Name of the probe. |
enabled | boolean | false | none | Defines whether the probe is enabled/disabled by default. |
target_type | integer | false | none | Defines the type of the object on which the probe is applicable to.
|
internal_name | string | false | none | Defines the internal name of the probe. PEM system creates internal tables for storing the probe statistics in 'pemdata', and 'pemhistory' schema, and name of those table will be same as internal name. |
is_system_probe | boolean | false | none | Defines whether this probe is user defined, or not. Value for this flag will always be false for a user defined probe. |
any_server_version | boolean | false | none | Defines whether this probe is applicable to any version of Postgres variant. For more details, please follow the documenation. |
collection_method | string | false | none | Defines the method of statistics collection. PEM supports three methods for custom made probes. i.e. SQL, WMI, Batch/Shell script.
|
interval | integer | false | none | Defines how frequently the probe will collect the statistics (in seconds). |
lifetime | integer | false | none | Defines the history data retention time (in days). It does not have any effect, if 'discard_history' is set to true. |
discard_history | boolean | false | none | Defines whether to discard the history data. It will not store the history of the data for this probe, when 'discard_history' is set to false. |
platform | string | false | none | Defines on which platform this probe can run on. It is only applicable to an agent level probe. |
probe_code | string | false | none | A SQL/Batch script/Shell script/WMI script to collect the statistics as per definition of the code. |
probe_columns | [object] | false | none | none |
» pc_id | integer | false | none | Identifier of the column |
» pc_name | string | false | none | Name of the column |
» pc_data_type | string | false | none | Data type of the column. Supported datatypes are:
|
» pc_internal_name | string | false | none | Returns the internal name of the column. |
» pc_unit | string | false | none | Returns the unit of the column. |
» pc_col_type | string | false | none | Returns the columns is part of the primary key of the internal table, or not. 'k' stands for a key column, and 'm' stands for a member/normal column. |
» pc_position | integer | false | none | Returns the position of the column in the internal table. |
» pc_graphable | boolean | false | none | Returns whether the data of the column is graphable on a chart, or not. |
» pc_calc_pit | boolean | false | none | Returns whether server calculates the point-in-time for the metric data for this column. |
» pc_pit_default | boolean | false | none | Returns the metric is stored by point-in-time by default. Please refer the 'Custom Probes' section in the documentation for detailed information. |
alternate_code | [AlternateServerProbeCode] | false | none | none |
Enumerated Values
Property | Value |
---|---|
collection_method | w |
collection_method | b |
collection_method | s |
pc_data_type | bigint |
pc_data_type | char |
pc_data_type | decimal |
pc_data_type | double precision |
pc_data_type | integer |
pc_data_type | numeric |
pc_data_type | real |
pc_data_type | text |
pc_data_type | text[] |
pc_data_type | timestamp |
pc_data_type | timestamptz |
pc_col_type | m |
pc_col_type | k |
CustomProbePostData
{ "probe_name": "string", "collection_method": "w", "enabled": true, "target_type": 0, "any_server_version": true, "interval": 0, "lifetime": 0, "discard_history": true, "platform": "string", "probe_code": "string", "probe_columns": [ { "pc_name": "string", "pc_data_type": "bigint", "pc_unit": "string", "pc_col_type": "m", "pc_graphable": true, "pc_calc_pit": true, "pc_pit_default": true } ], "alternate_code": [ { "server_version_id": 0, "server_probe_code": "string" } ] }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
probe_name | string | false | none | Name of the probe. |
collection_method | string | false | none | Defines the method of statistics collection. PEM supports three methods for custom made probes. i.e. SQL, WMI, Batch/Shell script.
|
enabled | boolean | false | none | Defines whether the probe is enabled/disabled by default. |
target_type | integer | false | none | Defines the type of the object on which the probe is applicable to.
|
any_server_version | boolean | false | none | Defines whether this probe is applicable to any version of Postgres variant. For more details, please follow the documenation. |
interval | integer | false | none | Defines how frequently the probe will collect the statistics (in seconds). |
lifetime | integer | false | none | Defines the history data retention time (in days). It does not have any effect, if 'discard_history' is set to true. |
discard_history | boolean | false | none | Defines whether to discard the history data. It will not store the history of the data for this probe, when 'discard_history' is set to false. |
platform | string | false | none | Defines on which platform this probe can run on. It is only applicable to an agent level probe. |
probe_code | string | false | none | A SQL/Batch script/Shell script/WMI script to collect the statistics as per definition of the code. |
probe_columns | [object] | false | none | none |
» pc_name | string | false | none | Name of the column |
» pc_data_type | string | false | none | Data type of the column. Supported datatypes are:
|
» pc_unit | string | false | none | Returns the unit of the column. |
» pc_col_type | string | false | none | Returns the columns is part of the primary key of the internal table, or not. 'k' stands for a key column, and 'm' stands for a member/normal column. |
» pc_graphable | boolean | false | none | Returns whether the data of the column is graphable on a chart, or not. |
» pc_calc_pit | boolean | false | none | Returns whether server calculates the point-in-time for the metric data for this column. |
» pc_pit_default | boolean | false | none | Returns the metric is stored by point-in-time by default. Please refer the 'Custom Probes' section in the documentation for detailed information. |
alternate_code | [AlternateServerProbeCode] | false | none | none |
Enumerated Values
Property | Value |
---|---|
collection_method | w |
collection_method | b |
collection_method | s |
pc_data_type | bigint |
pc_data_type | char |
pc_data_type | decimal |
pc_data_type | double precision |
pc_data_type | integer |
pc_data_type | numeric |
pc_data_type | real |
pc_data_type | text |
pc_data_type | text[] |
pc_data_type | timestamp |
pc_data_type | timestamptz |
pc_col_type | m |
pc_col_type | k |
CustomProbePutData
{ "interval_min": 0, "interval_sec": 0, "lifetime": 0, "enabled": true, "probe_code": "string", "probe_columns": { "changed": { "pc_id": 0, "pc_unit": "string", "pc_graphable": true } }, "alternate_code": { "changed": [ { "server_version_id": 0, "server_probe_code": "string" } ], "deleted": [ { "server_version_id": 0 } ], "added": [ { "server_version_id": 0, "server_probe_code": "string" } ] } }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
interval_min | integer | false | none | Defines how frequently the probe will collect the statistics (in minutes). Possible values are from 0 to 2880. |
interval_sec | integer | false | none | Defines how frequently the probe will collect the statistics (in seconds). Possible values are from 0 to 59. |
lifetime | integer | false | none | Defines the history data retention time (in days). It does not have any effect, if 'discard_history' is set to true. |
enabled | boolean | false | none | Defines whether the probe is enabled/disabled by default. |
probe_code | string | false | none | A SQL/Batch script/Shell script/WMI script to collect the statistics as per definition of the code. |
probe_columns | object | false | none | none |
» changed | object | false | none | none |
»» pc_id | integer | false | none | Identifier of the column |
»» pc_unit | string | false | none | Returns the unit of the column. |
»» pc_graphable | boolean | false | none | Returns whether the data of the column is graphable on a chart, or not. |
alternate_code | object | false | none | none |
» changed | [AlternateServerProbeCode] | false | none | List of the changed alternate probe code for some server version. |
» deleted | [DeletedAlternateServerProbeCode] | false | none | List of the delete alternate probe code for some server versions. |
» added | [AlternateServerProbeCode] | false | none | List of the alternate probe code added for some server versions. |
Probes
{ "probe_id": 0, "probe_name": "string", "default_interval_min": 0, "interval_min": 0, "default_interval_sec": 0, "interval_sec": 0, "default_interval": 0, "interval": 0, "default_lifetime": 0, "lifetime": 0, "default_enabled": true, "enabled": true, "target_type_id_returned": 0 }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
probe_id | integer | false | none | Unique id of the probe. |
probe_name | string | false | none | Name of the probe. |
default_interval_min | integer | false | none | Defines default interval for the probe to collect the statistics (in minutes). Possible values are from 0 to 2880. |
interval_min | integer | false | none | Defines how frequently the probe will collect the statistics (in minutes). Possible values are from 0 to 2880. |
default_interval_sec | integer | false | none | Defines default interval for the probe to collect the statistics (in seconds). Possible values are from 0 to 59. |
interval_sec | integer | false | none | Defines how frequently the probe will collect the statistics (in seconds). Possible values are from 0 to 59. |
default_interval | integer | false | none | Defines default interval for the probe to collect the statistics (in seconds). |
interval | integer | false | none | Defines how frequently the probe will collect the statistics (in seconds). |
default_lifetime | integer | false | none | Defines the default history data retention time (in days). |
lifetime | integer | false | none | Defines the history data retention time (in days). It does not have any effect, if 'discard_history' is set to true. |
default_enabled | boolean | false | none | Defines the default probe enabled/disabled value. |
enabled | boolean | false | none | Defines whether the probe is enabled/disabled by default. |
target_type_id_returned | integer | false | none | Defines return target type value.
|
ProbeConfigData
{ "interval_min": 0, "interval_sec": 0, "lifetime": 0, "enabled": true }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
interval_min | integer | false | none | Probe execution frequency (in minutes). Allowed interval value (in minutes) is 0-2880 minutes. NOTE: Total interval must be greater than 10 seconds. i.e. 10 >= interval_min * 60 + interval_sec >= 172800. |
interval_sec | integer | false | none | Probe execution frequency (in seconds). Allowed interval value (in seconds) is 0-59 seconds. NOTE: Total interval must be greater than 10 seconds. i.e. 10 >= interval_min * 60 + interval_sec >= 172800. |
lifetime | integer | false | none | Probe history data retention period (in days). i.e. 1 >= lifetime >= 365. |
enabled | boolean | false | none | Enable/Disable probe for the given object. |
CopyAgentData
{ "type": "string", "agent_id": 0 }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
type | string | false | none | Value must be "agent" |
agent_id | integer | false | none | none |
CopyServerData
{ "type": "string", "server_id": 0 }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
type | string | false | none | Value must be "server" |
server_id | integer | false | none | none |
CopyDatabaseData
{ "type": "string", "server_id": 0, "database_name": "string" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
type | string | false | none | Value must be "database" |
server_id | integer | false | none | none |
database_name | string | false | none | none |
CopySchemaData
{ "type": "string", "server_id": 0, "database_name": "string", "schema_name": "string" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
type | string | false | none | Value must be "schema" |
server_id | integer | false | none | none |
database_name | string | false | none | none |
schema_name | string | false | none | none |
CopyAlertAgentData
{ "type": "string", "agent_id": 0, "ignore_duplicate_alerts": true }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
type | string | false | none | Value must be "agent" |
agent_id | integer | false | none | none |
ignore_duplicate_alerts | boolean | false | none | Defines whether to ignore the duplicate alerts to be copied. |
CopyAlertServerData
{ "type": "string", "server_id": 0, "ignore_duplicate_alerts": true }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
type | string | false | none | Value must be "server" |
server_id | integer | false | none | none |
ignore_duplicate_alerts | boolean | false | none | Defines whether to ignore the duplicate alerts to be copied. |
CopyAlertDatabaseData
{ "type": "string", "server_id": 0, "database_name": "string", "ignore_duplicate_alerts": true }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
type | string | false | none | Value must be "database" |
server_id | integer | false | none | none |
database_name | string | false | none | none |
ignore_duplicate_alerts | boolean | false | none | Defines whether to ignore the duplicate alerts to be copied. |
CopyAlertSchemaData
{ "type": "string", "server_id": 0, "database_name": "string", "schema_name": "string", "ignore_duplicate_alerts": true }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
type | string | false | none | Value must be "schema" |
server_id | integer | false | none | none |
database_name | string | false | none | none |
schema_name | string | false | none | none |
ignore_duplicate_alerts | boolean | false | none | Defines whether to ignore the duplicate alerts to be copied. |
CopyAlertTableData
{ "type": "string", "server_id": 0, "database_name": "string", "schema_name": "string", "table_name": "string", "ignore_duplicate_alerts": true }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
type | string | false | none | Value must be "table" |
server_id | integer | false | none | none |
database_name | string | false | none | none |
schema_name | string | false | none | none |
table_name | string | false | none | none |
ignore_duplicate_alerts | boolean | false | none | Defines whether to ignore the duplicate alerts to be copied. |
CopyAlertIndexData
{ "type": "string", "server_id": 0, "database_name": "string", "schema_name": "string", "index_name": "string", "ignore_duplicate_alerts": true }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
type | string | false | none | Value must be "index" |
server_id | integer | false | none | none |
database_name | string | false | none | none |
schema_name | string | false | none | none |
index_name | string | false | none | none |
ignore_duplicate_alerts | boolean | false | none | Defines whether to ignore the duplicate alerts to be copied. |
CopyAlertFunctionData
{ "type": "string", "server_id": 0, "database_name": "string", "schema_name": "string", "function_name": "string", "function_arguments": "string", "ignore_duplicate_alerts": true }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
type | string | false | none | Value must be "function" |
server_id | integer | false | none | none |
database_name | string | false | none | none |
schema_name | string | false | none | none |
function_name | string | false | none | none |
function_arguments | string | false | none | none |
ignore_duplicate_alerts | boolean | false | none | Defines whether to ignore the duplicate alerts to be copied. |
CopyAlertSequenceData
{ "type": "string", "server_id": 0, "database_name": "string", "schema_name": "string", "sequence_name": "string", "ignore_duplicate_alerts": true }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
type | string | false | none | Value must be "sequence" |
server_id | integer | false | none | none |
database_name | string | false | none | none |
schema_name | string | false | none | none |
sequence_name | string | false | none | none |
ignore_duplicate_alerts | boolean | false | none | Defines whether to ignore the duplicate alerts to be copied. |
Agent
[ { "id": 0, "name": "string", "version": "string", "active": true, "heartbeat_int": 0, "alert_blackout": true, "owner": "string", "team": "string", "group": 0 } ]
Returns the list of the objects, which contains the agent information, version, capabilities, and details about the host on which it has been installed.
For example:
\
[{ /* Agent information */ "id": 1, "gid": 0, "name": "Postgres Enterprise Manager Host" "version": "6.0.1", "active": True, "heartbeat_int": 30, "alert_blackout": False, "owner": "postgres", "team": None, /* Deatils about the Host, on which it is installed */ "operating_sys": "Ubuntu 12.04.5 LTS", "host_name": "akshay-ubuntu", "boot_time": "2016-09-19 12:28:27+05:30", "domain_name": "(none)", "window_domain": None, /* Agent capabilities */ "capability_list": "unix, getloadavg, disk_space, memory_usage, cpu_usage, network_statistics, io_analysis, data_log_file_analysis, disk_busy_info, os_statistics, os_info, slony_replication, auto_discover_servers, allow_server_restart", /* Monitored servers */ "server_bind": "Postgres Enterprise Manager Server, PostgreSQL 9.3, PostgreSQL 9.4" }]
a
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
id | integer | true | none | Identity of the pem-agent |
name | string | true | none | Description (name) of the agent. |
version | string | true | none | Version of the pem-agent |
active | boolean | true | none | Whether the agent is active, or not. An active agent is responsible for collecting the statistics for the host, and the monitored server.. |
heartbeat_int | integer | true | none | heartbeat interval (in seconds) for the agent. How frequently the agent will send the heartbeat status to the PEM database server about itself, and the monitoring database server. |
alert_blackout | boolean | true | none | Flag to indicates about the alert blacked out for the agent |
owner | string | true | none | Username, using whom the agent was installed, is called owner. |
team | string | true | none | Name of the role/user, who can see this agent. null/empty value suggest, all user can see this agent. |
group | integer | false | none | Identity of the group |
Server
{ "id": 0, "name": "string", "host": "string", "port": 0, "database": "string", "ssl": 0, "serviceid": "string", "active": true, "alert_blackout": true, "owner": 0, "team": "string", "server_owner": "string", "is_remote_monitoring": true, "efm_cluster_name": "string", "efm_service_name": "string", "efm_installation_path": "string", "comment": "string", "username": "string", "gid": 0, "db_restriction": "string", "role": "string", "is_edb": true, "agent_id": 0, "asb_host": "string", "asb_port": 0, "asb_username": "string", "asb_database": "string", "asb_sslmode": "string", "asb_password": "string", "asb_allowtakeover": "string", "agent_capability_list": [ "string" ], "agent_description": "string", "fgcolor": "string", "bgcolor": "string", "sslcompression": true }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
id | integer | false | none | Server id |
name | string | false | none | Server name |
host | string | false | none | Server host |
port | integer | false | none | Server port |
database | string | false | none | Maintenance databse |
ssl | integer | false | none | SSL mode |
serviceid | string | false | none | Server service id |
active | boolean | false | none | Defines whether the server is active, or not. |
alert_blackout | boolean | false | none | Defines whether the alerts on the server are blacked out, or not. |
owner | integer | false | none | ID of the owner, who registered the server with PEM. |
team | string | false | none | Defines the role/username, who can see the server information. |
server_owner | string | false | none | Name of the user, who registered the server on the PEM database server. |
is_remote_monitoring | boolean | false | none | Defines whether this server is being monitored remotely (i.e. the monitoring pemAgent does not resides on the same host on the monitored server). |
efm_cluster_name | string | false | none | Cluster name of EFM |
efm_service_name | string | false | none | Service name of EFM |
efm_installation_path | string | false | none | Installation Path of EFM |
comment | string | false | none | Description about the Server. |
username | string | false | none | Username for connecting the database server. |
gid | integer | false | none | ID of the Server group |
db_restriction | string | false | none | Database restriction SQL clause |
role | string | false | none | The role the connection will use |
is_edb | boolean | false | none | Is server an EDB Advanced Server? |
agent_id | integer | false | none | Agent id bound to the server |
asb_host | string | false | none | PEM database host used by agent while creating PEM connection. |
asb_port | integer | false | none | PEM database port used by agent while creating PEM connection. |
asb_username | string | false | none | PEM database user name used by agent while creating PEM connection. |
asb_database | string | false | none | PEM database to which agent will connect. |
asb_sslmode | string | false | none | PEM database ssl mode. |
asb_password | string | false | none | empty string. |
asb_allowtakeover | string | false | none | Whether server allowed to take over by another agent. |
agent_capability_list | [string] | false | none | Array of capabilities the agent has |
agent_description | string | false | none | Agent description |
fgcolor | string | false | none | Foreground color of server node in browser tree |
bgcolor | string | false | none | Background color of server node in browser tree |
sslcompression | boolean | false | none | Whether data sent over ssl should be compressed or not. |
Database
{ "database_name": "string", "connections_allowed": true, "system_database": true, "recorded_time": "2019-08-24T14:15:22Z", "encoding": "string", "server_id": 0 }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
database_name | string | false | none | Database name |
connections_allowed | boolean | false | none | Is connection to database allowed |
system_database | boolean | false | none | Is database system database |
recorded_time | string(date-time) | false | none | When database was first detected by PEM agent |
encoding | string | false | none | Database encoding |
server_id | integer | false | none | Server id of database |
Schema
{ "schema_name": "string", "database_name": "string", "server_id": 0, "recorded_time": "2019-08-24T14:15:22Z" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
schema_name | string | false | none | Schema name |
database_name | string | false | none | Database name of schema |
server_id | integer | false | none | Server id schmea |
recorded_time | string(date-time) | false | none | When schema was first detected by PEM agent |
Table
{ "table_name": "string", "schema_name": "string", "database_name": "string", "server_id": 0, "has_primary_key": true, "recorded_time": "string" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
table_name | string | false | none | Table name |
schema_name | string | false | none | schema name |
database_name | string | false | none | Database name |
server_id | integer | false | none | Server id |
has_primary_key | boolean | false | none | Weather table has primary key |
recorded_time | string | false | none | When table was first detected by PEM agent |
Index
{ "index_name": "string", "ind_keys": [ 0 ], "table_name": "string", "schema_name": "string", "database_name": "string", "server_id": 0, "recorded_time": "string" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
index_name | string | false | none | Index name |
ind_keys | [integer] | false | none | indexed column positions in table |
table_name | string | false | none | Table name |
schema_name | string | false | none | Schema |
database_name | string | false | none | Database name |
server_id | integer | false | none | Server id |
recorded_time | string | false | none | When index was first detected by PEM agent |
Sequence
{ "sequence_name": "string", "schema_name": "string", "database_name": "string", "server_id": 0, "recorded_time": "2019-08-24T14:15:22Z" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
sequence_name | string | false | none | Sequence name |
schema_name | string | false | none | Schema name |
database_name | string | false | none | Database name |
server_id | integer | false | none | Server id |
recorded_time | string(date-time) | false | none | When sequence was first detected by PEM agent |
Function
{ "function_name": "string", "function_type": "string", "return_type": "string", "arg_types": [ "string" ], "function_binary": "string", "extension_name": "string", "package_name": "string", "schema_name": "string", "database_name": "string", "server_id": 0, "recorded_time": "2019-08-24T14:15:22Z" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
function_name | string | false | none | Function name |
function_type | string | false | none | Function type |
return_type | string | false | none | Function return type |
arg_types | [string] | false | none | Function argument types |
function_binary | string | false | none | none |
extension_name | string | false | none | none |
package_name | string | false | none | Function package name |
schema_name | string | false | none | Function schema |
database_name | string | false | none | Function database name |
server_id | integer | false | none | Function server id |
recorded_time | string(date-time) | false | none | When function was first detected by PEM agent |
View
{ "view_name": "string", "view_type": "string", "ispopulated": true, "view_owner": "string", "definition": "string", "tablespace_name": "string", "schema_name": "string", "database_name": "string", "server_id": 0, "recorded_time": "string" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
view_name | string | false | none | View name |
view_type | string | false | none | View type |
ispopulated | boolean | false | none | Is view populated |
view_owner | string | false | none | View owner |
definition | string | false | none | View definition |
tablespace_name | string | false | none | View tablespace |
schema_name | string | false | none | View schema |
database_name | string | false | none | View database |
server_id | integer | false | none | View server id |
recorded_time | string | false | none | When view was first detected by PEM agent |
- On this page
- AlertPayload
- Alert
- AlertParams
- AlternateServerProbeCode
- DeletedAlternateServerProbeCode
- AlertTemplate
- AlertHistory
- ServerStatus
- AgentStatus
- AlertStatus
- CustomProbes
- CustomProbePostData
- CustomProbePutData
- Probes
- ProbeConfigData
- CopyAgentData
- CopyServerData
- CopyDatabaseData
- CopySchemaData
- CopyAlertAgentData
- CopyAlertServerData
- CopyAlertDatabaseData
- CopyAlertSchemaData
- CopyAlertTableData
- CopyAlertIndexData
- CopyAlertFunctionData
- CopyAlertSequenceData
- Agent
- Server
- Database
- Schema
- Table
- Index
- Sequence
- Function
- View