synth-manage-checks

Create, update, pull, push, and delete Grafana Synthetic Monitoring checks using gcx commands.

1|Updated May 25, 2020
One-click install
npx skills add https://github.com/titaneric/dotfiles --skill synth-manage-checks-titaneric
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: synth-manage-checks
Source: https://github.com/titaneric/dotfiles/tree/main/dot_agents/skills/synth-manage-checks
Command: npx skills add https://github.com/titaneric/dotfiles --skill synth-manage-checks-titaneric

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Managing Grafana Synthetic Monitoring checks manually through the UI or raw API calls is slow and error-prone. This Skill streamlines the full lifecycle of SM checks—creation, updates, GitOps-style sync, and deletion—through the gcx CLI with validated YAML definitions. ## Core Features & Use Cases - Check Lifecycle Management: Create, update, and delete HTTP, Ping, DNS, TCP, and Traceroute checks from YAML definitions with dry-run validation before pushing. - GitOps Workflow: Pull existing checks to YAML files, edit them in source control, and push changes back for version-controlled monitoring configuration. - Probe Selection Guidance: Recommends geographically distributed probes and enforces case-sensitive probe naming to avoid deployment errors. - Use Case: You need to monitor a new API endpoint. Provide the URL, and the Skill selects the HTTP check type, picks probes across three continents, scaffolds the YAML, and creates the check with a single gcx command. ## Quick Start Ask the assistant to create a synthetic monitoring check for your target URL or hostname using gcx.

Frequently Asked Questions about synth-manage-checks

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Grafana Synthetic Monitoring check from the command line?

Define the check as a YAML manifest with apiVersion syntheticmonitoring.ext.grafana.app/v1alpha1, then run gcx synthetic-monitoring checks create -f <file.yaml>. Choose the check type based on your target: HTTP for URLs, Ping for hosts, DNS for domains, TCP for host:port.

How do I update an existing synthetic monitoring check?

Pull the current definition with gcx synthetic-monitoring checks get <ID> -o yaml, edit the YAML file, then apply changes with gcx synthetic-monitoring checks update <ID> -f <file>. The metadata.name will contain the numeric check ID.

Why does my synthetic monitoring check fail with probe not found?

Probe names are case-sensitive and must match exactly. Run gcx synthetic-monitoring probes list and copy the probe names verbatim into your YAML definition rather than typing them manually.

What check types does Grafana Synthetic Monitoring support?

This Skill covers HTTP, Ping, DNS, TCP, and Traceroute checks with full YAML templates. Complex types like MultiHTTP, Browser, and Scripted checks are not fully documented; pull an existing check of that type as a template instead.

Why does my check push fail with a timeout validation error?

The timeout value must be strictly less than the frequency value, and frequency must be between 10,000ms and 120,000ms. Reduce the timeout or increase the frequency in your YAML, then retry the push.