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 has the PCE been running, what is its runlevel, and overall health (normal, warning, or error).
Each node hostname, IP address, uptime, runlevel, and whether the PCE software runs properly.
Each node type (core or data), 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 Response Properties
Property | Description | Type |
|---|---|---|
| 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, 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 PCE Administration Guide at Listen-Only Mode for PCE | String |
| The nodes that comprise your PCE cluster. For each node of your PCE, this API call returns the following properties:
| String |
| PCE 2x2 or 4x2 Deployment 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 provided to 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:
| Array |
| The timestamp of when the information was generated. | String |
PCE Health Response
An example response was 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",
"nfc_service"
]
}
},
"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"
}
]