← Back to Integration
BACKUP & RECOVERY

Integration with Commvault Integration with SPOG.AI

SPOG.AI integrates with Commvault Backup & Recovery to provide centralized visibility into backup posture, policy compliance, job health, and asset protection coverage. By ingesting Commvault backup metadata and alerts through the Commvault REST APIs, the integration enriches the SPOG.AI CMDB and supports risk analysis, incident management, and compliance reporting. Optional webhooks allow Commvault to push alerts to SPOG.AI for real-time incident creation. The integration connects using a dedicated Commvault service user or API key, and read-only permissions are sufficient for data collection.

Key Features

CapabilityDescription
Backup Job MonitoringFetches job status, SLA compliance, failures, and trends.
Asset & Client InventorySyncs backup clients, agents, subclients, and VM/OS metadata.
Policy & SLA CoverageRetrieves storage policies, schedules, and protection groups.
Alert & Anomaly IngestionCaptures job failure alerts, SLA breaches, and anomaly detections.
Real-Time Webhook AlertsOptionally receives alerts pushed from Commvault to create incidents in real time.
CMDB EnrichmentMaps backup posture and asset health to CMDB records.
Risk & Compliance ReportingSupports risk scoring, trend analysis, and backup compliance reporting.

How the Integration Works

SPOG.AI connects to Commvault over HTTPS using the Commvault REST APIs. Authentication is performed with a dedicated Commvault service user, using either Basic Auth or an API key, and read-only privileges are sufficient. SPOG.AI supports two ingestion modes. In Polling API mode, SPOG.AI periodically fetches backup job metadata, client inventory, policies, and SLA data. In Webhook mode (optional), Commvault pushes alert notifications to SPOG.AI so that incidents can be created in real time. The collected data is mapped to CMDB records in SPOG.AI, where it powers backup health indicators, risk scoring, incident workflows, and compliance reporting.

Data Collected

CategoryData CollectedDescription
Asset & Client DataClient name, type, and operating system; virtual machine metadata; agent and subclient configurationInventory of protected assets and their backup configuration.
Backup Job DetailsJob status (success, failed, killed, completed with errors); job duration and throughput; SLA compliance data; storage policy and schedule mappingBackup job health, performance, and policy coverage.
Alerts & AnomaliesBackup job failure alerts; missed backups; ransomware or anomaly alerts (Commvault Activate)Alert and anomaly records used for incident creation.
CMDB EnrichmentBackup health indicators; protection coverage metrics; risk scoring; trends and historical patternsBackup posture mapped to CMDB records.

Prerequisites

Before configuring the integration, ensure the following prerequisites are met:

  • Admin access to Commvault Command Center or Web Console.
  • A Commvault service user or API key with at least read-only privileges.
  • Commvault v11.20 or later (recommended for a stable REST API).
  • Backup jobs and clients actively reporting, and alert rules configured if using webhooks.
  • Integration and CMDB permissions in SPOG.AI.
  • HTTPS (443) connectivity from SPOG.AI to the Commvault API, with TLS 1.2 or later.

Configuration

1. Create a Commvault Service User

Create or select a dedicated service user that SPOG.AI will use to read backup data. Admin access to Commvault Command Center or Web Console is required.

  • Log in to Commvault Command Center.
  • Navigate to Security → Users and Groups.
  • Create a new service user or select an existing one.
  • Assign the following privileges, keeping the user restricted to read-only access:
Commvault PrivilegePurpose
View ClientsRead client, agent, and subclient inventory.
View Job ControllerRead backup job status and history.
View AlertsRead job failure, SLA breach, and anomaly alerts.
View Backup/SLA PoliciesRead storage policies, schedules, and SLA coverage.
  • Capture the username and password, or generate an API key if your Commvault version supports it. Store the credentials securely.

2. Allow Network Access

Ensure the network path between SPOG.AI and Commvault is open.

  • Allow outbound HTTPS (443) traffic from SPOG.AI to the Commvault Web Console/API host.
  • If using webhooks, allow outbound traffic from Commvault to the SPOG.AI webhook endpoint.
  • Ensure TLS 1.2 or later is enabled, as it is mandatory.

3. Configure Webhook Alerts (Optional)

Configure webhooks if you want Commvault alerts to create incidents in SPOG.AI in real time. Skip this step to use polling only.

  • In Commvault, go to Events & Alerts → Alert Rules.
  • Create a new alert rule or edit an existing one.
  • Select events such as Backup Job Failure, SLA Breach, and Anomaly Detected.
  • Under Notification Settings → Webhook, set the destination URL to the SPOG.AI webhook endpoint and set the format to JSON.
  • Save the rule and test the webhook using the alert Test Notification feature.
  • Restrict webhook access so only Commvault servers can reach the SPOG.AI endpoint, and disable SSL inspection for webhook traffic to avoid payload tampering.

4. Configure Commvault in SPOG.AI

  • Log in to SPOG.AI.
  • Navigate to Settings → Integrations → Add Integration.
  • Select Commvault.
  • Enter the following details:
FieldDescription
Commvault HostIP address or FQDN of the Commvault Web Console/API.
Username / API KeyThe credentials created in the earlier step.
Authentication TypeBasic Auth or API Key.
Webhook URL (Optional)Used only if Commvault pushes alerts to SPOG.AI.
  • Click Save & Sync.

After saving, SPOG.AI begins retrieving backup job history, asset metadata, SLA compliance data, and alert logs (if webhooks are enabled).

5. Validate the Integration

In SPOG.AI

  • Verify the initial sync under Integration Logs.
  • Confirm that assets appear in the CMDB.
  • Check backup job metadata under Backup Insights / Monitoring.
  • Validate that incidents are created for failed backup jobs (if using webhook alerts).

In Commvault

  • Use the built-in alert Test Notification feature.
  • Validate API responses by testing https://<commvault-host>/webconsole/api/BackupJobs.
  • Ensure the service user has the correct privileges.
  • Confirm that backup jobs and SLA data appear in the monitoring dashboards.
Frequently Asked Questions