Coralogix
Access
- URL: https://rhapsody.app.cx498.coralogix.com/#/dashboard
- Access: Request via IT — ask to be added to the correct Coralogix group for your team (Global Ops / SRE)
Overview
Coralogix is the primary observability platform for RaaS. It collects logs, metrics, and traces from all RaaS environments and provides alerting, dashboards, and ad-hoc querying.
Key Sections
Custom Dashboards
Team-organised dashboards showing key RaaS metrics:
- Navigate to Custom Dashboards in the left sidebar
- Dashboards are organised into folders per team
- Look for the Global Ops and SRE folders for RaaS-specific dashboards
Alerts
Access via Alerts in the left sidebar:
| Section | Purpose |
|---|---|
| Management | Configure and view alert rules |
| Incidents | Active and recent incidents triggered by alerts |
| Suppression Rules | Mute alerts during maintenance windows |
Visual Explorer
Ad-hoc querying using PromQL (for metrics) or Lucene (for logs):
- Useful for investigating specific metrics or log patterns during incident response
- Supports custom time ranges and filtering by application/subsystem
Log Explorer
Full-text log search with filtering:
- Filter by Application (e.g., customer code) and Subsystem (e.g.,
rhapsody,proxy) - Supports Lucene query syntax
- Useful for diagnosing Rhapsody errors or bootstrap failures
Alerting Integration
Coralogix alerts feed into the broader alerting chain:
- Critical alerts trigger PagerDuty via webhook integration
- See PagerDuty for the on-call process
Training Resources
- Rhapsody Coralogix Training Session — recording available on SharePoint
- Coralogix RaaS Training — Thursday March 27 session recording (Teams meeting recap available)
- Official docs: coralogix.com/docs/opentelemetry/
Custom RaaS Metrics
RaaS exports the following custom metrics via the OpenTelemetry (OTEL) Collector running on each instance.
System Metrics
| Metric | Description |
|---|---|
raas.cpu_usage |
CPU utilisation percentage |
raas.mem_usage |
Memory utilisation percentage |
rhapsody.root_disk_used |
Root (/) disk utilisation percentage |
rhapsody.log_disk_used |
Log disk utilisation percentage |
rhapsody.data_disk_used |
Data disk (/data/orionhealth) utilisation percentage |
Rhapsody Application Metrics
| Metric | Description |
|---|---|
rhapsody.memory_in_use |
Rhapsody total memory in use (MB) |
rhapsody.memory_jvm_in_use |
JVM heap memory in use (MB) |
rhapsody.total_received |
Messages received (cumulative) |
rhapsody.total_processed |
Messages processed (cumulative) |
rhapsody.total_sent |
Messages sent (cumulative) |
rhapsody.sec_obj_expire_soon |
Security objects (certs/keys) expiring within 30 days |
rhapsody.uptime_seconds |
Rhapsody service uptime in seconds |
Network Metrics
| Metric | Description |
|---|---|
rhapsody.dns_resolve |
DNS resolution success (1 = ok, 0 = fail) |
rhapsody.dns_ipaddress |
Primary IP address used for DNS checks |
rhapsody.second_ipaddress |
Secondary IP address used for DNS checks |
raas.bgpd_route |
BGP route count (HSCN customers — should be >0) |
Custom Check Metrics
| Metric | Description |
|---|---|
rhapsody.comm_pt_count |
Number of configured communication points |
rhapsody.host_mount_volumes |
Volume mount health check |
rhapsody.bootstrap_error |
Bootstrap error flag (0 = ok, >0 = error) |
Coralogix Setup for a New Account (AWS)
Step 1: Apply Coralogix Stack
Run the Ansible Tower job template: Apply Coralogix Stack
This installs and starts the OTEL collector on the instance.
Step 2: Add CloudWatch Integration
In the Coralogix console: 1. Go to Data Flow → Integrations → AWS → CloudWatch Metrics 2. Create a new integration:
| Field | Value |
|---|---|
| Integration name | <customer_code>-<region> (e.g. uk-hscn-eu-west-2) |
| Application name | <customer_code> |
| Subsystem name | <region> |
| AWS Account ID | Customer's account ID |
| Role ARN | arn:aws:iam::<account_id>:role/CoralogixAWSMetricsRole-<customer_code> |
| ExternalId | Coralogix account ID + @7000774 (e.g. 12345678@7000774) |
OTEL Collector Config Reference
The OTEL collector on each RaaS instance uses:
| Setting | Value |
|---|---|
| Collection endpoint | localhost:4317 |
| Outbound proxy | proxy.service:3128 |
| Coralogix domain | cx498.coralogix.com |
| Service file | /etc/systemd/system/otel-collector.service |
DataDog → Coralogix Migration Status
As of early 2025, all alerting has been migrated from DataDog to Coralogix. The following alert equivalents exist:
| Alert | DataDog Monitor | Coralogix |
|---|---|---|
| CPU High | raas-cpu-high |
vm_cpu_high |
| Memory High | raas-mem-high |
vm_memory_low |
| Disk Space | raas-disk-low |
diskspace_root_low, diskspace_data_low |
| Rhapsody Down | raas-rhapsody-down |
application_downtime |
| Bootstrap Error | raas-bootstrap-error |
application_bootstrap_error |
| DNS Failure | raas-dns-fail |
network_dns_resolution |
| SMTP Failure | raas-smtp-fail |
network_smtp_connectivity |