Push Monitor

Tracks freshness of externally-reported results instead of making an active network request.

Basic Example

apiVersion: monitoring.yuptime.io/v1
kind: Monitor
metadata:
  name: backup-job
  namespace: yuptime
spec:
  type: push
  schedule:
    intervalSeconds: 300
    timeoutSeconds: 10
  target:
    push:
      tokenSecretRef:
        name: push-token
        key: token
      expireSeconds: 300
      gracePeriodSeconds: 60

Target Configuration

target:
  push:
    tokenSecretRef:
      name: push-token              # Secret containing push token
      key: token                     # Key in secret
    expireSeconds: 300               # Time until status expires
    gracePeriodSeconds: 60           # Grace period after expiry

Field	Required	Default	Description
tokenSecretRef.name	Yes	-	Secret name
tokenSecretRef.key	Yes	-	Key for token
expireSeconds	No	300	Status expiration time
gracePeriodSeconds	No	60	Grace period before unhealthy

Current Status

The current repository does not expose a built-in push ingestion HTTP route. The push monitor type and checker exist, but you need an external component to write the latest result into monitor status if you want to use it end-to-end today.

Examples

Cron Job Monitoring

apiVersion: monitoring.yuptime.io/v1
kind: Monitor
metadata:
  name: nightly-backup
  namespace: yuptime
spec:
  type: push
  schedule:
    intervalSeconds: 86400
    timeoutSeconds: 10
  target:
    push:
      tokenSecretRef:
        name: backup-push-token
        key: token
      expireSeconds: 90000    # 25 hours
      gracePeriodSeconds: 3600

Heartbeat from External System

apiVersion: monitoring.yuptime.io/v1
kind: Monitor
metadata:
  name: payment-processor
  namespace: yuptime
spec:
  type: push
  schedule:
    intervalSeconds: 60
    timeoutSeconds: 10
  target:
    push:
      tokenSecretRef:
        name: payment-push-token
        key: token
      expireSeconds: 120
      gracePeriodSeconds: 30

Token Secret

apiVersion: v1
kind: Secret
metadata:
  name: push-token
  namespace: yuptime
type: Opaque
stringData:
  token: "your-secure-random-token"

Use Cases

• Cron job completion
• Backup job status
• Batch process health
• External system integration
• Serverless function health