kubevela.github.io/docs/end-user/debug/health.md

title	draft
Aggregated Health Probe	true

The HealthyScope allows you to define an aggregated health probe for all components in same application.

1.Create health scope instance.

apiVersion: core.oam.dev/v1alpha2
kind: HealthScope
metadata:
  name: health-check
  namespace: default
spec:
  probe-interval: 60
  workloadRefs:
  - apiVersion: apps/v1
    kind: Deployment
    name: express-server

2. Create an application that drops in this health scope.

apiVersion: core.oam.dev/v1beta1
kind: Application
metadata:
  name: vela-app
spec:
  components:
    - name: express-server
      type: webservice
      properties:
        image: oamdev/hello-world
        port: 8080 # change port
        cpu: 0.5 # add requests cpu units
      scopes:
        healthscopes.core.oam.dev: health-check

3. Check the reference of the aggregated health probe (status.service.scopes).

kubectl get app vela-app -o yaml

apiVersion: core.oam.dev/v1beta1
kind: Application
metadata:
  name: vela-app
...
status:
...
  services:
   - healthy: true
     name: express-server
     scopes:
       - apiVersion: core.oam.dev/v1alpha2
         kind: HealthScope
         name: health-check

4.Check health scope detail.

kubectl get healthscope health-check -o yaml

apiVersion: core.oam.dev/v1alpha2
kind: HealthScope
metadata:
  name: health-check
...
spec:
  probe-interval: 60
  workloadRefs:
    - apiVersion: apps/v1
      kind: Deployment
      name: express-server
status:
  healthConditions:
    - componentName: express-server
      diagnosis: 'Ready:1/1 '
      healthStatus: HEALTHY
      targetWorkload:
        apiVersion: apps/v1
        kind: Deployment
        name: express-server
  scopeHealthCondition:
    healthStatus: HEALTHY
    healthyWorkloads: 1
    total: 1

It shows the aggregated health status for all components in this application.