diff options
| -rw-r--r-- | docs/sections/healthcheck.rst | 163 |
1 files changed, 99 insertions, 64 deletions
diff --git a/docs/sections/healthcheck.rst b/docs/sections/healthcheck.rst index 57266bbf..d9b5e1f2 100644 --- a/docs/sections/healthcheck.rst +++ b/docs/sections/healthcheck.rst @@ -1,73 +1,108 @@ .. This work is licensed under a Creative Commons Attribution 4.0 International License. .. http://creativecommons.org/licenses/by/4.0 -HealthCheck -=========== - -DCAE Healthcheck . +DCAE Health Check +================= OOM Deployment -------------- +In OOM deployments, DCAE healthchecks are performed by a separate service--dcae-healthcheck. +This service is packaged into a Docker image (``onap/org.onap.dcaegen2.deployments.healthcheck-container``), +which is built in the ``healthcheck-container`` module in the ``dcaegen2/deployments`` repository. - In OOM deployments DCAE healthcheck are reported by separate service - dcae-healthcheck; this is deployment of org.onap.dcaegen2.deployments.healthcheck-container which is built from dcaegen2/deployment repo - healthcheck-container module. The container includes list of deployments done in DCAE (both via helm charts and Cloudify) for which periodic health check is performed. For helm deployed component - servicename defined is charts are used and for cloudify, the deployments identified in bootstrap are prefixed with release name. The container itself is deployed via helm charts (oom/kubernetes/dcaegen2/charts/dcae-healthcheck). This polls the deployments specified periodically and reports the status. The service can be queried for status as below. - -curl dcae-healthcheck -.. code-block:: json +The service is deployed with a Helm chart (``oom/kubernetes/dcaegen2/charts/dcae-healthcheck``) +when DCAE is deployed using OOM. - - - { - "type": "summary", - "count": 11, - "ready": 11, - "items": [{ - "name": "dev-dcaegen2-dcae-cloudify-manager", - "ready": 1, - "unavailable": 0 - }, { - "name": "dep-config-binding-service", - "ready": 1, - "unavailable": 0 - }, { - "name": "dep-deployment-handler", - "ready": 1, - "unavailable": 0 - }, { - "name": "dep-inventory", - "ready": 1, - "unavailable": 0 - }, { - "name": "dep-service-change-handler", - "ready": 1, - "unavailable": 0 - }, { - "name": "dep-policy-handler", - "ready": 1, - "unavailable": 0 - }, { - "name": "dep-dcae-ves-collector", - "ready": 1, - "unavailable": 0 - }, { - "name": "dep-dcae-tca-analytics", - "ready": 1, - "unavailable": 0 - }, { - "name": "dep-dcae-prh", - "ready": 1, - "unavailable": 0 - }, { - "name": "dep-dcae-hv-ves-collector", - "ready": 1, - "unavailable": 0 - }, { - "name": "dep-dcae-datafile-collector", - "ready": 1, - "unavailable": 0 - }] - } - - +The dcae-healthcheck container runs a service that exposes a simple Web API. In response to +request, the service checks Kubernetes to verify that all of the expected +DCAE platform and service components are in a ready state. The service +has a fixed list of platform and service components that are normally deployed when DCAE is +first installed, including components deployed with Helm charts and +components deployed using Cloudify blueprints. In addition, beginning with +the Dublin release, the healthcheck +service tracks and checks components that are deployed dynamically using Cloudify +blueprints after the initial DCAE installation. + +The healthcheck service is exposed as a Kubernetes ClusterIP Service named +`dcae-healthcheck`. The service can be queried for status as shown below. -Heat Deployment ---------------- +.. code-block:: + + $ curl dcae-healthcheck + { + "type": "summary", + "count": 14, + "ready": 14, + "items": [ + { + "name": "dev-dcaegen2-dcae-cloudify-manager", + "ready": 1, + "unavailable": 0 + }, + { + "name": "dev-dcaegen2-dcae-config-binding-service", + "ready": 1, + "unavailable": 0 + }, + { + "name": "dev-dcaegen2-dcae-inventory-api", + "ready": 1, + "unavailable": 0 + }, + { + "name": "dev-dcaegen2-dcae-servicechange-handler", + "ready": 1, + "unavailable": 0 + }, + { + "name": "dev-dcaegen2-dcae-deployment-handler", + "ready": 1, + "unavailable": 0 + }, + { + "name": "dev-dcaegen2-dcae-policy-handler", + "ready": 1, + "unavailable": 0 + }, + { + "name": "dep-dcae-ves-collector", + "ready": 1, + "unavailable": 0 + }, + { + "name": "dep-dcae-tca-analytics", + "ready": 1, + "unavailable": 0 + }, + { + "name": "dep-dcae-prh", + "ready": 1, + "unavailable": 0 + }, + { + "name": "dep-dcae-hv-ves-collector", + "ready": 1, + "unavailable": 0 + }, + { + "name": "dep-dcae-dashboard", + "ready": 1, + "unavailable": 0 + }, + { + "name": "dep-dcae-snmptrap-collector", + "ready": 1, + "unavailable": 0 + }, + { + "name": "dep-holmes-engine-mgmt", + "ready": 1, + "unavailable": 0 + }, + { + "name": "dep-holmes-rule-mgmt", + "ready": 1, + "unavailable": 0 + } + ] + } |