Open System → Alerts and External Monitoring with system rights. Viewing and editing depend on your rights. Prepare the recipients and the addresses of the monitoring tools.
Opening and Saving
Choose Recipients and Thresholds, SNMP, or Prometheus / Grafana. The modified sections share Save and Cancel. Switching sections keeps your input; leaving the page prompts you to handle the changes. The result is indicated per section. A failure keeps the draft for correction.
Recipients and Thresholds
Enable the desired notifications and choose the administrator recipients. Select the severities and incident types; keep at least one required choice in each group. Thresholds notably cover disk space, certificate expiration, and trunk failures.
| Setting | Purpose | Possible Values | Example |
|---|---|---|---|
| Recipients | Administrators notified | Available accounts | On-call administrator |
| Severities / Types | Incidents to notify | Selection among available options | Critical incidents |
| Disk space | Usage threshold triggering the alert | 1 to 100% | 85% |
| Certificate | Advance notice before expiration | 1 to 365 days | 30 days |
| Trunk | Outage duration before notification | 0 to 1,440 minutes | 5 minutes |
| Backup failures | Number of failures before alert | 1 to 1,000 | 2 |
| Grouping | Notification grouping window | 0 to 60 minutes | 5 minutes |
| Reminder interval | Time between reminders | 5 to 10,080 minutes | 60 minutes |
| Resolution | Notifies of return to normal | Enabled or disabled | Enabled |
| Reminders | Repeats unacknowledged alert | Suggested interval | Organization's interval |
Save the valid and modified form. Test the sending to the intended recipient separately. Acknowledgment stops the related reminders; it does not fix the cause of the incident.
Disabling alerts stops automatic emails; thresholds remain visible in Services and Incidents. The test can be sent to an administrator even if automatic alerts are disabled. Choose its recipient from the test menu and verify receipt.
Configuring SNMP
SNMP allows an external tool to read the PBX's metrics. In SNMP, enable the service, choose its version, and fill in its access details.
| Field | Purpose | Possible Values | Example |
|---|---|---|---|
| Version | Collector protocol | SNMP v3 or v2c | v3 |
| User | v3 account | Account name | monitoring |
| Authentication | v3 protection | SHA-256 / AES or SHA / AES | SHA-256 / AES |
| Authentication / Encryption password | v3 secrets | Secrets required for initial configuration; leaving blank keeps an existing secret | Collector secrets |
| Community | v2c secret | Required for initial v2c configuration | Value provided by the administrator |
| Authorized sources | Limits collection machines | IP addresses or networks | 192.0.2.10 |
| Contact / Location | Server identification | Text | Technical room |
Save and then check the applied or pending status. The list of metric identifiers, called OID, indicates the values to read. The detailed monitoring guide keeps the details on secrets and the protocol.
Configuring Prometheus / Grafana
- Click Generate a new token.
- Click Copy before Close: the secret is shown only once.
- Configure the collector with this secret and the displayed metrics address.
- Enable collection with the switch.
- Restrict the authorized sources then click Save.
| Field | Purpose | Possible Values | Example |
|---|---|---|---|
| Authorized addresses (optional) | Limits collection sources | Up to 128 IP addresses or networks, separated by spaces or commas | 192.0.2.10 |
Token generation and activation are immediate. Activation remains unavailable without a configured token. A new token replaces the old one: update the collector. Addresses are a draft saved via the common button. Documentation opens the collection instructions. An unavailable metrics address requires checking the public name of the installation.
Verifying the Result
Check the receipt of the test alert and the reading of metrics in your external tool. A successful save does not prove their receipt.
If It Doesn't Work
Use Retry after a read error. Check the flagged fields, the authorized sources, and the collector's secret. Keep the displayed message without exposing the secrets.
