cx-observability-setup

---

name: cx-observability-setup description: > Use this skill when the user asks to "set up monitoring", "configure observability", "onboard new service", "create saved view", "set up notifications", "configure webhook", "set up Slack integration", "outgoing webhook", "automation action", "webhook for alerts", "create view", "saved view", "view folder", "organize dashboards", "install integration", "configure extension", "contextual data", "connect external service", "create notification connector", "set up email alerts", "configure PagerDuty", "notification routing", "deploy extension", "test webhook", "notification preset", "test notification", "webhook actions", or wants to set up, configure, or manage the observability stack for a service or team. metadata: version: "0.1.0"

Observability Setup Skill

Use this skill when setting up or configuring the observability stack - saved views, webhook integrations, notification channels, and external integrations. This is the "day 1 setup" skill for onboarding a new service or reconfiguring notification pipelines.

---

CLI Commands

Views

Command	Purpose
cx views list	List all saved views
cx views get <id>	Get a view definition
cx views create --from-file	Create a saved view
cx views update <id> --from-file	Update a saved view
cx views delete <id>	Delete a saved view
cx views folders list	List view folders
cx views folders get <id>	Get a folder
cx views folders create --from-file	Create a folder
cx views folders update <id> --from-file	Update a folder
cx views folders delete <id>	Delete a folder

Webhooks

Command	Purpose
cx webhooks list	List all outgoing webhooks
cx webhooks get <id>	Get webhook details
cx webhooks create --from-file	Create a webhook
cx webhooks update <id> --from-file	Update a webhook
cx webhooks delete <id>	Delete a webhook
cx webhooks test <id>	Test a webhook
cx webhooks types	List available webhook types
cx webhooks actions list	List automation actions
cx webhooks actions get <id>	Get action details
cx webhooks actions create --from-file	Create an action
cx webhooks actions update --from-file	Update an action
cx webhooks actions delete <id>	Delete an action
cx webhooks actions batch --from-file	Batch execute actions
cx webhooks actions reorder --from-file	Reorder actions

Notifications

Command	Purpose
cx notifications connectors list	List notification connectors
cx notifications connectors get <id>	Get connector details
cx notifications connectors create --from-file	Create a connector
cx notifications connectors update --from-file	Update a connector
cx notifications connectors delete <id>	Delete a connector
cx notifications connectors types	List connector types
cx notifications connectors entity-types	List entity types
cx notifications connectors entity-subtypes --type <type>	List entity subtypes
cx notifications routers list	List notification routers
cx notifications routers get <id>	Get router details
cx notifications routers create --from-file	Create a router
cx notifications routers update --from-file	Update a router
cx notifications routers delete <id>	Delete a router
cx notifications routers validate-matcher --from-file	Test entity label matcher
cx notifications presets list	List notification presets
cx notifications presets get <id>	Get preset details
cx notifications presets create --from-file	Create a custom preset
cx notifications presets update --from-file	Update a custom preset
cx notifications presets delete <id>	Delete a custom preset
cx notifications presets set-default <id>	Set default preset
cx notifications test connector --from-file	Test connector config
cx notifications test destination --from-file	Test destination
cx notifications test preset --from-file	Test preset config
cx notifications test routing-condition --from-file	Test routing condition
cx notifications test template-render --from-file	Test template rendering

Integrations

Command	Purpose
cx integrations list	List all integrations
cx integrations get <id>	Get integration details
cx integrations create --from-file	Create an integration
cx integrations update <id> --from-file	Update an integration
cx integrations delete <id>	Delete an integration
cx integrations test --from-file	Test integration config
cx integrations template	Get integration template
cx integrations definition <id>	Get integration definition
cx integrations deployed <id>	Get deployed integration
cx integrations extensions list	List available extensions
cx integrations extensions get <id>	Get extension details
cx integrations extensions deployed	List deployed extensions
cx integrations extensions deploy --from-file	Deploy an extension
cx integrations extensions update --from-file	Update deployed extension
cx integrations extensions undeploy --from-file	Undeploy an extension
cx integrations contextual-data list	List contextual data integrations
cx integrations contextual-data get <id>	Get contextual data details
cx integrations contextual-data create --from-file	Create contextual data integration
cx integrations contextual-data update <id> --from-file	Update contextual data integration
cx integrations contextual-data delete <id>	Delete contextual data integration
cx integrations contextual-data definition <id>	Get contextual data definition
cx integrations contextual-data test <id>	Test contextual data integration

All commands support -o json for structured output and -p <profile> for profile selection.

---

New Service Setup Workflow

When onboarding a new service, follow this checklist:

1. Create Saved Views

Set up views for the service's key log queries:

cx views folders create --from-file folder.json
cx views create --from-file view.json

2. Set Up Notification Connectors

Configure channels (Slack, PagerDuty, email):

cx notifications connectors types -o json
cx notifications connectors create --from-file slack-connector.json

3. Configure Notification Routing

Route alerts to the right channels:

cx notifications routers create --from-file router.json

4. Set Up Webhooks

Configure outgoing webhooks for external integrations:

cx webhooks types -o json
cx webhooks create --from-file webhook.json
cx webhooks test <webhook-id>

5. Install Integrations

Deploy relevant integrations and extensions:

cx integrations list -o json
cx integrations create --from-file integration.json
cx integrations extensions deploy --from-file extension.json

6. Create Dashboard

Use the cx-dashboards skill for the full dashboard creation workflow.

7. Create SLOs

Use the cx-slos skill for SLO creation and monitoring.

---

Notification Setup Workflow

Detailed notification channel configuration:

1. List Available Connector Types

cx notifications connectors types -o json

2. Create a Connector

cx notifications connectors create --from-file connector.json

3. Create a Router

cx notifications routers create --from-file router.json

4. Assign or Create a Preset

cx notifications presets list -o json
cx notifications presets create --from-file preset.json
cx notifications presets set-default <preset-id>

5. Test End-to-End

cx notifications test connector --from-file test-connector.json
cx notifications test destination --from-file test-destination.json
cx notifications test routing-condition --from-file test-condition.json

---

Webhook Setup

1. List Webhook Types

cx webhooks types -o json

2. Create Webhook

Template from an existing webhook if possible:

cx webhooks get <existing-id> -o json > webhook-template.json
cx webhooks create --from-file webhook.json

3. Test Webhook

cx webhooks test <webhook-id>

4. Create Automation Actions (Optional)

cx webhooks actions create --from-file action.json
cx webhooks actions reorder --from-file order.json

---

Key Principles

• Always test after setup - use cx notifications test, cx webhooks test, cx integrations test
• Use --from-file for complex JSON payloads - pipe from stdin or use a file
• Template from existing - cx <command> get <id> -o json > template.json before creating
• Check connector types first - cx notifications connectors types and cx webhooks types before creating

---

Related Skills

• cx-dashboards - dashboard creation and replace workflow
• cx-slos - SLO creation and error-budget monitoring
• cx-cases - triage the cases raised when alerts fire
• cx-alerts - alert definitions that trigger notifications
• cx-telemetry-querying - verify data flows after setup