cx-alerts
This skill should be used when the user asks to "manage alerts", "create alert", "list alerts", "delete alert", "check alert status", "enable alert", "disable alert", "investigate firing alerts", "check which alerts are active", "find alerting rules", "set up an alert", "configure alerting", "mute a
By coralogix · 2,384 installs
npx skills add coralogix/cx-cli --skill cx-alerts
Source repository · Upstream listing
Alert Management Skill
Use this skill to list, inspect, create, delete, enable, and disable Coralogix alert definitions using the cx alerts CLI commands.
CLI Commands
Command Purpose Key flags
cx alerts list List all alert definitions name <filter
cx alerts get <id Get a single alert definition by ID
cx alerts create Create an alert from a JSON definition from file <path (default: stdin)
cx alerts delete <id Delete an alert
cx alerts enable <id Enable an alert
cx alerts disable <id Disable an alert
cx alerts events List events; use alert version scoped endpoint when filtering alert version id , start , end
cx alerts event stats Get alert event statistics
cx alerts suppression rules list List suppression rules
cx alerts suppression rules get <id Get a suppression rule
cx alerts suppression rules create Create a suppression rule from file <path
cx alerts suppression rules update Update a suppression rule from file <path
cx alerts suppression rules delete <id Delete a suppression rule
Output format: append o json or o toon to list , get , and create commands for machine readable output.
Multi profile: use p <profile (repeatable) to target multiple profiles simultaneously.
Alert Types Reference
Coralogix supports 12 alert types:
Type enum Human name Description
ALERT DEF TYPE LOGS IMMEDIATE Logs Immediate Trigger on every matching log entry
ALERT DEF TYPE LOGS THRESHOLD Logs Threshold Trigger when log count exceeds a threshold in a time window
ALERT DEF TYPE LOGS ANOMALY Logs Anomaly ML based anomaly detection on log volume
ALERT DEF TYPE LOGS RATIO THRESHOLD Logs Ratio Threshold Trigger on ratio between two log queries
ALERT DEF TYPE LOGS NEW VALUE Logs New Value Trigger when a new value appears in a field
ALERT DEF TYPE LOGS UNIQUE COUNT Logs Unique Count Trigger on unique value count threshold
ALERT DEF TYPE LOGS TIME RELATIVE THRESHOLD Logs Time Relative Compare current vs past time window
ALERT DEF TYPE METRIC THRESHOLD Metric Threshold Trigger when a PromQL expression crosses a threshold
ALERT DEF TYPE METRIC ANOMALY Metric Anomaly ML based anomaly detection on metrics
ALERT DEF TYPE TRACING IMMEDIATE Tracing Immediate Trigger on every matching span
ALERT DEF TYPE TRACING THRESHOLD Tracing Threshold Trigger when span count exceeds a threshold
ALERT DEF TYPE FLOW Flow Sequence based alert combining multiple conditions
Priority Levels
Always ask the user what priority to use when creating alerts:
Priority Use case
P1 Critical pages on call immediately
P2 High needs attention within the hour
P3 Medium investigate during business hours
P4 Low informational, check when convenient
P5 Info logging/tracking only
Create Workflow
1. Ask the user what they want to alert on (logs, metrics, traces)
2. Ask for priority (P1–P5)
3. Build the JSON payload with alertDefProperties use the API wire format (see references/alert schemas.md for all enum values)
4. Tip: use cx alerts get <existing id o json to get a working template, modify it, and pipe into create
5. Create using: echo '<json ' cx alerts create or cx alerts create from file alert.json
6. Verify with cx alerts list name "<alert name "
Important structural note: The type field is a string enum (e.g. "ALERT DEF TYPE LOGS THRESHOLD" ), and the alert type config (e.g. "logsThreshold": {...} ) is a sibling field at the same level NOT nested inside type .
Example: Logs Threshold Alert
Example: Metric Threshold Alert
Example: Logs Immediate Alert
Investigation Workflow
Find firing alerts
Inspect a specific alert
Disable a noisy alert (temporary mute)
Suppression Rules
Manage alert suppression rules that mute alerts during maintenance windows or known noisy periods.
Command Purpose
cx alerts suppression rules list List all suppression rules
cx alerts suppression rules get <id Get a suppression rule by ID
cx alerts suppression rules create from file Create a suppression rule
cx alerts suppression rules update from file Update a suppression rule
cx alerts suppression rules delete <id Delete a suppression rule
Key Principles
Always ask for priority (P1–P5) when creating alerts never assume
Use name filter for large accounts with many alerts
Use o json with jq for filtering and transformation
Use from file to pipe JSON from stdin when constructing alerts programmatically
Verify after create always list or get the alert after creation to confirm
Disable, don't delete prefer disabling alerts over deletion for auditability
Link to a specific alert cx alerts list prints only one "View in
Coralogix" link, to the alerts overview page, not a per alert link. To
link a user to one specific alert, build <base /alerts/<alert id ,
where <base is the console URL already seen in a View in Coralogix:
<base /... line printed by any cx alerts command this session never
fabricate <base yourself.
Additional Resources
Reference Files
[ references/alert schemas.md ](references/alert schemas.md) Complete JSON schema reference for all 12 alert types: field names, enum values (condition types, time windows, filter operations), common sub objects (logs filter, tracing filter, notification groups, activity schedules), and important gotchas
[ references/dataprime reference.md ](references/dataprime reference.md) DataPrime query language reference for log based and span based alert conditions (filter syntax, operators, severity values)
[ references/logs querying.md ](references/logs querying.md) Log data model, field discovery, and query patterns for building log alert conditions
[ references/promql guidelines.md ](references/promql guidelines.md) PromQL reference for metric based alert conditions (counters, gauges, histograms, threshold patterns)
[ references/spans querying.md ](references/spans querying.md) Span data model, duration units, and query patterns for building tracing alert conditions
Related Skills
cx cases triage the cases that group alert events into investigations
cx slos the SLO definitions whose error budget burn raises alerts
cx observability setup setting up notification routing and webhook integrations for alerts
cx telemetry querying investigate the telemetry behind a firing alert