InfraGuard

Backup report integration

A placed backup script POSTs its run result to the report callback, recording it to infr_backup_run.

Overview — what it does

Once a generated backup script runs on the target host, it calls the report callback so InfraGuard can track results. The script POSTs /api/v1/backup/report (authenticated by an API key) → infr_backup_run (plus a legacy backup_history compatibility write).

How to use

Issue a key in API Keys and wire the reporter into your backup script. The pm2 runner scripts/infr_backup_runner.cjs can also drive due jobs.

{ "job_id": 123, "status": "done", "duration_sec": 42, "bytes": 10485760,
  "artifact_path": "/data/bk/foo_202608101200.sql", "message": "" }

The run then appears on the Schedule Board with success/failure and duration.

Data sources

Access

Authenticated by infr.apikey (issued in Admin ▸ API Keys, level≥10).

Related

The API key issuing screen
The API key issuing screen