Skip to content

Checkmk

xyva.ai integrates with Checkmk to correlate infrastructure monitoring data with test execution, helping you distinguish test failures caused by application bugs from those caused by environment issues.

API Connection Setup

Open Settings > Integrations > Checkmk and enter:

FieldExample
Checkmk URLhttps://monitor.example.com/mysite
Usernameautomation
API SecretSecret string from the automation user
Site Namemysite

TIP

Use a dedicated automation user rather than a personal account. Create one under Setup > Users in Checkmk with the automation role.

Service Health Status

The Checkmk panel displays monitored services relevant to your test environment:

StatusIconMeaning
OKGreenService is healthy
WARNYellowPerformance threshold exceeded
CRITRedService is down or failing
UNKNOWNGreyMonitoring data unavailable

Services are grouped by host. Click any service row to see the full check output, performance graphs, and recent state transitions.

Alert Correlation

When xyva detects test failures, it cross-references the failure timestamp against active Checkmk alerts:

text
Test Failed:   login.spec.ts > should redirect after login
Time:          2026-03-21 14:32:07
Checkmk Alert: Host web-app-01 / Service HTTPS
               CRIT since 14:30:55 — Connection refused
Correlation:   Environment issue (infrastructure)

INFO

Correlation uses a configurable time window (default: 5 minutes). Adjust this under Settings > Integrations > Checkmk > Correlation Window.

This helps teams triage faster by flagging failures that are likely caused by infrastructure problems rather than code defects.

Monitored Hosts

You can select which Checkmk hosts and services are relevant to your test environment. Only selected services participate in alert correlation:

  1. Open the Checkmk integration panel.
  2. Click Configure Hosts.
  3. Check the hosts and service groups you want to monitor.
  4. Save -- xyva polls these services on the same interval as your monitoring site.

WARNING

Polling frequency matches your Checkmk check interval (typically 60 seconds). xyva does not issue additional load beyond the standard REST API calls.

  • Ops Portal -- broader infrastructure health dashboard
  • Swarm QA -- automated scanning that benefits from alert correlation

Local-first QA orchestration.