Metrics
These are the all metrics provided by the a9s Backup Monit component.
Description
General Metrics
| Metric Id | Type | Description |
|---|---|---|
health | Integer (1 = unhealthy / 0 = healthy) | Returns the a9s Backup Monit status. If the value is 0, a9s Backup Monit is running and its API is reachable. |
skipped_metrics | Integer | Counts how many instances the a9s Backup Monit failed to get all metrics for. a9s Backup Monit iterates over all service instances known to the a9s Backup Manager. Something could go wrong when fetching the metrics for a service instance, and in this case the metric counter will by increased by one. A high value of skipped_metrics indicates an underlying issue and might need further investigation. |
Format:
backup_monit.health
backup_monit.skipped_metrics
Service Instance Metrics
| Metric Id | Type | Description |
|---|---|---|
backup_method | String (splitted_files or single_file) | Backup method. There are two options: the splitted_files method will store the backup in one or more files, while the single_file method will store the backup in one single file. |
backup_date | Integer (timestamp) | (DEPRECATED: replaced with last_backup_time_store) Backup creation date. This time is the last modified date of the backup files inside the store. It can differ slightly from last_backup_time. |
minutes_since_last_backup | Integer (minutes) | (DEPRECATED) Amount of minutes since the last backup has been created. This number will be calculated like backup_date. |
content_length | Integer (kB) | Size of the backup. The size is calculated by summing up the size of all files in the backup store belonging to the current backup. |
content_length_from_metadata | Integer (kB) | Size of the backup. The value is taken from the metadata file of the current backup. |
file_count | Integer | Number of files that comprise the backup. |
last_backup_time | Integer (timestamp) | Backup creation date of the latest known backup. This value is the date the a9s Backup Manager updated the backup status for the last time. The value can differ slightly from backup_date. |
last_backup_status | Integer | Last backup status known to a9s Backup Manager. Can be 0 (queued), 1 (running), 2 (done), 3 (failed), 4 (deleted). |
last_successful_backup_size_manager | Integer | Size of the last successful backup known to the a9s Backup Manager. This value is only updated when the latest backup has the state done. In any other case the value will not be touched. |
last_successful_backup_time_manager | Integer (timestamp) | The creation date of the last successful backup know to the a9s Backup Manager. This value is only updated when the latest backup has the state done. In any other case the value will not be touched. |
last_backup_time_store | Integer (timestamp) | The creation date known by the storage where the backup is saved. To get this time the Backup Monit asks the corresponding storage for the last modification time of the backup. It can differ slightly from last_backup_time. |
error_fetching_metrics | Integer (1 = error happend / 0 = no error happend) | Returns if an error happened. If so the metrics could be invalid. |
Format:
*.backup_monit.*.backup_method
*.backup_monit.*.backup_date
*.backup_monit.*.minutes_since_last_backup
*.backup_monit.*.content_length
*.backup_monit.*.content_length_from_metadata
*.backup_monit.*.file_count
*.backup_monit.*.last_backup_time
*.backup_monit.*.last_backup_status
*.backup_monit.*.last_successful_backup_size_manager
*.backup_monit.*.last_successful_backup_time_manager
*.backup_monit.*.last_backup_time_store
*.backup_monit.*.error_fetching_metrics
a9s Backup Manager Metrics
Metrics with information on the internal a9s Backup Manager state.
| Metric Id | Type | Description |
|---|---|---|
queued_backups | Float | Number of backups in the queue waiting to be executed. |
running_backups | Float | Number of backups that are currently running. |
done_backups | Float | Number of backups finished with success. |
deleted_backups | Float | Number of deleted backups. |
failed_backups | Float | Number of failed backups. |
queued_backup_fragments | Float | Number of backup fragments in the queue waiting to be executed. |
running_backup_fragments | Float | Number of backup fragments that are currently running. |
done_backup_fragments | Float | Number of backup fragments finished with success. |
deleted_backup_fragments | Float | Number of deleted backup fragments. |
failed_backup_fragments | Float | Number of failed backups. |
queues_name_backup_agent_backups | Float | Number of jobs in the backup queue. |
queues_name_backup_watcher_job | Float | Number of jobs in the backup watcher queue. |
queues_name_backup_fragments | Float | Number of backup fragment jobs in the queue. |
queues_name_backup_fragment_watcher_job | Float | Number of backup fragment watcher jobs in the queue. |
queues_name_restore_watcher_job | Float | Number of restore watcher jobs in the queue. |
queues_name_restore_fragment_job | Float | Number of restore fragment jobs in the queue. |
queues_name_restore_fragment_watcher_job | Float | Number of restore fragment watcher jobs in the queue. |
queues_name_update_instance_state_job | Float | Number of update instance state jobs in the queue. |
queues_name_initialize_backup_deletion_job | Float | Number of initialize backup deletion jobs in the queue. |
queues_name_backup_deleter_job | Float | Number of backup deleter jobs in the queue. |
queues_name_backup_all_job | Float | Number of jobs in the backup all queue. |
Format:
*.backup_manager.backup_monit.backup_manager.queued_backups
*.backup_manager.backup_monit.backup_manager.done_backups
*.backup_manager.backup_monit.backup_manager.running_backups
*.backup_manager.backup_monit.backup_manager.deleted_backups
*.backup_manager.backup_monit.backup_manager.failed_backups
*.backup_manager.backup_monit.backup_manager.queued_backup_fragments
*.backup_manager.backup_monit.backup_manager.running_backup_fragments
*.backup_manager.backup_monit.backup_manager.done_backup_fragments
*.backup_manager.backup_monit.backup_manager.deleted_backup_fragments
*.backup_manager.backup_monit.backup_manager.failed_backup_fragments
*.backup_manager.backup_monit.backup_manager.queues_name_backup_agent_backups
*.backup_manager.backup_monit.backup_manager.queues_name_backup_deleter_job
*.backup_manager.backup_monit.backup_manager.queues_name_backup_fragment_watcher_job
*.backup_manager.backup_monit.backup_manager.queues_name_initialize_backup_deletion_job
*.backup_manager.backup_monit.backup_manager.queues_name_restore_fragment_watcher_job
*.backup_manager.backup_monit.backup_manager.queues_name_update_instance_state_job
*.backup_manager.backup_monit.backup_manager.queues_name_backup_all_job
*.backup_manager.backup_monit.backup_manager.queues_name_backup_fragments
*.backup_manager.backup_monit.backup_manager.queues_name_backup_watcher_job
*.backup_manager.backup_monit.backup_manager.queues_name_restore_fragment_job
*.backup_manager.backup_monit.backup_manager.queues_name_restore_watcher_job
info
Backup fragments are pieces of incremental backups. For example, WAL archives are represented by backup fragments.
Metric Path
The path for the metrics has the structure <cf_service_guid>.backup_monit.<bosh_deployment_name>.<metric_name>.
| Key | Description |
|---|---|
| cf_service_guid | The GUID that Cloud Foundry assigns. Can be found with cf service <service_name> --guid |
| bosh_deployment_name | The name of the deployment inside bosh |
| metric_name | Name of the metric (See table Service Instance Metrics) |
a9s-pg
a9s-pg is not deployed through an a9s Service Broker. The postgresql-backup-endpoint is in place to enable the creation of backups via the a9s Backup Manager.
As a result the bosh_deployment_name is used for cf_service_guid. Therefore
the metric path is a9s-pg.backup_monit.a9s-pg.*.