Monitoring & Alerts
Quazzar Space integrates with industry-standard monitoring tools to provide real-time visibility into your infrastructure. This guide covers connecting monitoring platforms, setting up alerts, and using agents for host-level metrics.
Monitoring features are available on Team plans and above.
Supported Monitoring Integrations
| Tool | What It Provides |
|---|---|
| Prometheus | Metrics collection and querying |
| Grafana | Dashboards and visualization |
| Zabbix | Host monitoring, triggers, and problem detection |
You can connect one or more of these tools to your Quazzar Space account. They work independently — use whichever combination fits your existing setup.
Connecting Monitoring Tools
Setup Steps
- Navigate to Settings > Integrations in your project
- Select the monitoring tool you want to connect (Prometheus, Grafana, or Zabbix)
- Enter the connection details:
- Server URL — The address of your monitoring instance
- API credentials — API key or username/password for authentication
- Click Test Connection to verify access. The check reports a list of steps rather than a pass/fail, so you can see exactly where it stopped — a blocked address, a rejected token, and a token that cannot list datasources are three different problems with three different fixes
- Save the integration
Once connected, Quazzar Space syncs data from your monitoring tools and surfaces relevant metrics alongside your infrastructure inventory.
Prometheus
Connect your Prometheus instance to pull metrics into Quazzar Space. The platform queries your Prometheus server to display metrics for services and servers that match your registered infrastructure.
Grafana
Link your Grafana instance to embed dashboards within Quazzar Space. This provides a unified view without switching between tools.
What the connection check tells you
Testing a Grafana connection runs a sequence of steps and returns all of them, with the ones it never reached marked as skipped:
| Step | What it checks |
|---|---|
url_provided | A URL is configured |
url_allowed | The address passes the outbound egress guard |
reachable | Grafana answers |
authenticated | Grafana accepts the service account token |
permitted | The token is permitted for this instance |
datasources | The token can list datasources |
alerting_scope | Whether the token may read alert rules |
The last three come from a single /api/datasources call, because Grafana’s own status codes already separate them.
alerting_scope is advisory, and unknown is not ok
alerting_scope never fails the connection. If you use Quazzar Space for metrics and not for alerts, there is no reason to grant a service account an alerting role, and a connection that works for metrics stays healthy either way.
It is asked because silence cannot answer the question. Grafana’s alerting API returns an empty rule list both for a token that can see your whole estate and finds nothing firing, and for a token whose permissions do not reach the folders where your rules live. Nothing in that response is wrong, and no exception is raised — so without asking separately, “nothing is firing” and “we cannot see your alerting” are the same sentence.
The step therefore reports one of three states:
| State | Meaning |
|---|---|
granted | The token may read alert rules. The detail also names how many folders are visible |
missing | The token may not read alert rules. Alert-based health cannot be reported for this connection until the service account is given an alerting role |
unknown | We could not establish what the token may read — for instance an instance too old for fine-grained access control, or one that did not answer the permissions query |
unknown is a third state, not a soft missing and not an ok. An empty rule list from a token whose scope is unknown is reported as unknown, because reporting it as healthy would be claiming an observation we do not hold.
A weaker signal is collected alongside it: the number of folders the token can see. A token can hold the alerting read permission and still be scoped to one folder out of forty, and that count is the only thing that moves when somebody narrows folder access without touching the role — the change that shrinks what is watched while every other check stays green.
Zabbix
Zabbix integration syncs automatically at regular intervals. After connecting:
- Zabbix hosts are mapped to your registered servers
- Zabbix triggers surface as alerts in the Quazzar Space dashboard
- Active problems are displayed alongside your infrastructure status
Creating Alert Rules
Alert rules let you define conditions that trigger notifications when metrics cross a threshold.
Setting Up an Alert
- Navigate to Monitoring > Alerts in your project or environment
- Click Create Alert Rule
- Configure the rule:
- Name — A descriptive label (e.g., “High CPU on API servers”)
- Metric — The metric to monitor (CPU usage, memory, disk, response time, etc.)
- Condition — The operator and threshold (e.g., greater than 85%)
- Duration — How long the condition must persist before firing (e.g., 5 minutes)
- Severity — Info, Warning, Critical, or Emergency
- Select one or more notification channels
- Save the rule
Severity Levels
| Level | When to Use | Typical Response |
|---|---|---|
| Info | Informational, no action needed | Logged for reference |
| Warning | Approaching a limit | Notification sent to team |
| Critical | Immediate action required | Notification with escalation |
| Emergency | Service outage or data loss risk | All channels notified |
Notification Channels
Configure where alerts are delivered. Quazzar Space supports the following channels:
| Channel | Description |
|---|---|
| Sends alerts to configured recipients | |
| Slack | Posts to a Slack channel via webhook |
| Discord | Posts to a Discord channel via webhook |
| Microsoft Teams | Posts to a Teams channel via webhook |
| Webhooks | Sends a JSON payload to any custom URL |
Set up notification channels under Settings > Notifications. You can assign different channels to different alert rules — for example, send warnings to Slack but emergencies to email and webhook.
Service Health Dashboards
Each environment includes a health overview showing:
- Service status — Up, degraded, or down for each registered service
- Recent alerts — Timeline of triggered alerts with severity indicators
- Resource utilization — CPU, memory, and disk usage summaries for monitored servers
- Top consumers — Services and servers using the most resources
This gives your team a single-pane view of infrastructure health without needing to check each monitoring tool individually.
Agent-Based Monitoring
Quazzar Space offers lightweight agents that run on your infrastructure to collect metrics and report health status.
VM Agent
Install the VM agent on your servers to collect:
- Heartbeat — Confirms the server is reachable and responsive
- CPU metrics — Usage percentage, load averages
- Memory metrics — Used, available, cached, and swap
- Disk metrics — Capacity, usage, and I/O statistics
- Service monitoring — HTTP and TCP health checks for services running on the host
- Log collection — Forward logs to Quazzar Space for centralized viewing
Kubernetes Agent
Deploy the Kubernetes agent in your clusters to monitor:
- Cluster health — Node status, pod scheduling, resource pressure
- Pod metrics — CPU and memory per pod
- Service discovery — Automatically detect services running in the cluster
- Event tracking — Kubernetes events surfaced in the Quazzar Space timeline
Agents are configured during installation and report to your Quazzar Space account automatically.
Alert Suppression Windows
During planned maintenance, you can suppress alerts to avoid noise:
- Navigate to Monitoring > Maintenance Windows
- Click Schedule Maintenance
- Select the affected servers, services, or entire environments
- Set the start and end time
- Optionally add a description (e.g., “Database upgrade — expected 30 min downtime”)
During the maintenance window, alerts for the selected resources are suppressed. They resume automatically when the window ends.
Plan Requirements
| Feature | Required Plan |
|---|---|
| Monitoring integrations (Prometheus, Grafana, Zabbix) | Team |
| Alert rules and notifications | Team |
| VM and Kubernetes agents | Team |
| Alert suppression windows | Team |
| Advanced dashboards | Business |
Next Steps
- Infrastructure Management — Organize the resources you are monitoring
- Ansible Automation — Automate remediation when alerts fire
- Cost Optimization — Use utilization data to right-size resources