Overview
XIMP scrapes metrics from standardized metric endpoints exposed by services across the infrastructure. Most infrastructure services are auto-detected via agent registration. This page covers configuring additional endpoints for application-specific exporters and managing the namespace organization of collected metrics.Prerequisites
- Administrator credentials with the
adminrole - Target endpoints must be reachable from the XIMP collector nodes
Viewing Configured Targets
- Dashboard
- CLI
Navigate to Monitoring → Administration → Scrape Targets. Each entry shows:
- URL: The endpoint being scraped
- Status:
UP(healthy) orDOWN(not reachable) - Last Scrape: Timestamp of the most recent successful scrape
- Labels: Metadata tags applied to all metrics from this target
Adding Custom Metric Endpoints
- Dashboard
- CLI
Navigate to Monitoring → Administration → Scrape Targets → Add Target:
| Field | Description |
|---|---|
| URL | Full endpoint URL (e.g., http://10.0.1.71:9399/metrics) |
| Scrape Interval | How often to collect (default: 30s) |
| Labels | Key-value metadata tags for the target (e.g., service=xloud-filefs) |
| TLS Config | CA certificate path for HTTPS endpoints |
| Auth | Basic auth credentials or bearer token for secured endpoints |
Metric Namespaces
XIMP organizes metrics by namespace. Use the namespace prefix when writing alert rules and dashboard queries:| Namespace | Source | Example Metrics |
|---|---|---|
xloud_compute | Compute node agents | cpu_utilization, memory_used_bytes |
xloud_storage | XSDS cluster | pool_used_bytes, osd_latency_ms |
xloud_network | Network agents | interface_rx_bytes, packet_loss_pct |
xloud_vm | XAVS Guest Agent | vm_cpu_usage, vm_memory_rss |
xloud_filefs | File FS service | requests_total, guestfs_handles_active |
xdr | Disaster recovery agent | replication_lag_seconds, site_health |
Firewall Requirements
Metric endpoints must be accessible from the XIMP collector nodes. Configure security groups or firewall rules to permit:| Source | Destination | Port | Protocol |
|---|---|---|---|
| XIMP collector IP | Target node | Configured scrape port | TCP |
| XIMP collector IP | 9100 (node exporter default) | All nodes | TCP |
| XIMP collector IP | 9283 (XSDS metrics) | Storage nodes | TCP |
XIMP collector IPs are listed under Monitoring → Administration → Collector Nodes.
Update security group rules to include all collector IPs when adding new collectors
during scale-out.
Next Steps
Agent Configuration
Configure agents and their default scrape targets on managed nodes
Alert Channels
Configure notification channels using the metric namespaces defined here
Retention Policies
Configure how long metric data from each namespace is retained
Troubleshooting
Diagnose targets in DOWN state and missing metric series