PCE Health
The Public Stable Health Check API displays health information about a 4X2 Supercluster or a PCE virtual appliance.
Note
This API is only available for Illumio Core PCE installed on-premises and is not available for Illumio Cloud customers.
About PCE Health API
With this API, you can see the following health information:
How long the PCE has been running, its runlevel, and overall health (normal, warning, or error).
Each node hostname, IP address, uptime, runlevel, and whether the PCE software is running properly.
Each node type (core or data), and which data node is the database replica and which is the primary database. The replication delay for the database replica is also displayed.
Information about PCE service alerts, such as the number of degraded or failed services in the cluster, so you can see where service failures have occurred.
PCE Health API Method
Functionality | HTTP | URI |
|---|---|---|
Check the health of the PCE. |
|
|
Check PCE Health
URI to Check PCE Health
GET [api_version]/health
Curl Command Check PCE Health
curl -i -X GET https://pce.my-company.com:8443/api/v2/health -H 'Accept: application/json' -u $KEY:'TOKEN'
PCE Health parameters
| Current health status of the PCE. Possible values:
| String |
| The type of PCE:
| String |
| The fully qualified domain name (FQDN) of the PCE. | String |
| The length of time that this PCE has been available, measured in seconds. | Number |
| Health warnings related to the PCE, which contain the following properties:
| |
| Indicates when listen-only mode was enabled for this PCE. For information about enabling or disabling listen-only mode for a PCE, see Listen Only Mode. | String |
| The nodes that comprise your PCE cluster. For each node of your PCE, this API call returns the following properties:
| String |
PCE Health Response Properties
Property | Description | Type |
|---|---|---|
| Reference to | String |
| The type of PCE:
| String |
| The fully qualified domain name (FQDN) of the PCE. | String |
| The length of time that this PCE has been available, measured in seconds. | Number |
| Health warnings related to the PCE, which contain the following properties:
| |
| Indicates when listen-only mode was enabled for this PCE. For information about enabling or disabling listen-only mode for a PCE, see Listen Only Mode. | String |
| The nodes that comprise your PCE cluster. For each node of your PCE, this API call returns the following properties;. Required:
| String |
| Network information of the PCE For a PCE 2x2 or 4x2 deployment, the This property also indicates which data node in your PCE is the database primary database and which is the database replica. This Sub-properties include:
Supercluster Deployment If you have deployed a PCE Supercluster, the PCE health call also returns information about the database replication between the PCE you are currently logged into and all other PCEs in the Supercluster. In a Supercluster deployment, the security policy provisioned on the leader is replicated to all other PCEs in the Supercluster. Additionally, all PCEs in the Supercluster (leader and members) replicate copies of each workload's context, such as IP addresses, to all other PCEs in the Supercluster. This other Properties include:
information for a PCE cluster.
| Object |
PCE Health Response
Example response returned from the PCE Health API.
[
{
"status": "normal",
"type": "standalone",
"fqdn": "pce.mycompany.com",
"available_seconds": 84133,
"notifications": [],
"listen_only_mode_enabled_at": null,
"nodes": [
{
"hostname": "pce_core1.mycompany.com,
"ip_address": "192.0.1.0",
"type": "core",
"runlevel": 5,
"uptime_seconds": 2051301,
"cpu": {
"status": "normal",
"percent": 7
},
"disk": [
{
"location": "disk",
"value": {
"status": "normal",
"percent": 17
}
}
],
"memory": {
"status": "warning",
"percent": 85
},
"services": {
"status": "normal",
"services": {
"running": [
"agent_background_worker_service",
"agent_service",
"agent_traffic_service",
"auditable_events_service",
"collector_service",
"ev_service",
"executor_service",
"fluentd_source_service",
"login_service",
"memcached",
"node_monitor",
"search_index_service",
"server_load_balancer",
"service_discovery_server",
"traffic_worker_service",
"web_server",
]
}
},
"generated_at": "2020-03-03T19:38:52+00:00"
},
{
"hostname": "pce_core2.mycompany.com",
"ip_address": "192.0.2.0",
"type": "core",
"runlevel": 5,
"uptime_seconds": 2051226,
"cpu": {
"status": "normal",
"percent": 7
},
"disk": [
{
"location": "disk",
"value": {
"status": "normal",
"percent": 16
}
}
],
"memory": {
"status": "warning",
"percent": 81
},
"services": {
"status": "normal",
"services": {
"running": [
"agent_background_worker_service",
"agent_service",
"agent_traffic_service",
"auditable_events_service",
"collector_service",
"ev_service",
"executor_service",
"fluentd_source_service",
"login_service",
"memcached",
"node_monitor",
"search_index_service",
"service_discovery_server",
"traffic_worker_service",
"web_server"
]
}
},
"generated_at": "2020-03-03T19:38:30+00:00"
},
{
"hostname": "pce_core3.mycompany.com",
"ip_address": "192.0.3.0",
"type": "core",
"runlevel": 5,
"uptime_seconds": 2051192,
"cpu": {
"status": "normal",
"percent": 7
},
"disk": [
{
"location": "disk",
"value": {
"status": "normal",
"percent": 16
}
}
],
"memory": {
"status": "warning",
"percent": 90
},
"services": {
"status": "normal",
"services": {
"running": [
"agent_background_worker_service",
"agent_service",
"agent_traffic_service",
"auditable_events_service",
"collector_service",
"ev_service",
"executor_service",
"fluentd_source_service",
"login_service",
"memcached",
"node_monitor",
"search_index_service",
"service_discovery_server",
"traffic_worker_service",
"web_server"
]
}
},
"generated_at": "2020-03-03T19:38:48+00:00"
},
{
"hostname": "pce_core4.mycompany.com",
"ip_address": "192.0.4.0",
"type": "core",
"runlevel": 5,
"uptime_seconds": 2051136,
"cpu": {
"status": "normal",
"percent": 6
},
"disk": [
{
"location": "disk",
"value": {
"status": "normal",
"percent": 16
}
}
],
"memory": {
"status": "warning",
"percent": 84
},
"services": {
"status": "normal",
"services": {
"running": [
"agent_background_worker_service",
"agent_service",
"agent_traffic_service",
"auditable_events_service",
"collector_service",
"ev_service",
"executor_service",
"fluentd_source_service",
"login_service",
"memcached",
"node_monitor",
"search_index_service",
"server_load_balancer",
"service_discovery_server",
"traffic_worker_service",
"web_server"
]
}
},
"generated_at": "2020-03-03T19:38:51+00:00"
},
{
"hostname": "pce_datae0.mycompany.com",
"ip_address": "192.0.5.0",
"type": "data0",
"runlevel": 5,
"uptime_seconds": 2051052,
"cpu": {
"status": "normal",
"percent": 41
},
"disk": [
{
"location": "disk",
"value": {
"status": "normal",
"percent": 19
}
}
],
"memory": {
"status": "normal",
"percent": 26
},
"services": {
"status": "normal",
"services": {
"running": [
"agent_traffic_redis_cache",
"agent_traffic_redis_server",
"citus_database_service",
"database_monitor",
"database_service",
"fileserver_service",
"flow_analytics_service",
"fluentd_data_service",
"node_monitor",
"service_discovery_server",
"set_server_redis_server",
"traffic_query_service"
]
}
},
"generated_at": "2020-03-03T19:38:21+00:00"
},
{
"hostname": "pce_datae1.mycompany.com",
"ip_address": "192.0.6.0",
"type": "data1",
"runlevel": 5,
"uptime_seconds": 2050979,
"cpu": {
"status": "normal",
"percent": 2
},
"disk": [
{
"location": "disk",
"value": {
"status": "normal",
"percent": 21
}
}
],
"memory": {
"status": "normal",
"percent": 21
},
"services": {
"status": "normal",
"services": {
"running": [
"agent_traffic_redis_cache",
"citus_database_replica_service",
"database_monitor",
"database_replica_service",
"fileserver_replica_service",
"flow_analytics_service",
"fluentd_data_service",
"node_monitor",
"service_discovery_agent",
"traffic_query_service"
]
}
},
"generated_at": "2020-03-03T19:38:02+00:00"
}
],
"network": {
"replication": [
{
"type": "intracluster",
"details": {
"database_name": "agent",
"primary_fqdn": "bkhorram-qa-6node-v0-pce-1-dbase0"
},
"value": {
"status": "normal",
"lag_seconds": 0
}
},
{
"type": "intracluster",
"details": {
"database_name": "traffic",
"primary_fqdn": "bkhorram-qa-6node-v0-pce-1-dbase0"
},
"value": {
"status": "normal",
"lag_seconds": 0
}
}
]
},
"generated_at": "2020-03-03T19:38:52+00:00"
}
]