vibeMK

🔍 Check host downtime status - Distinguish between host-level and service-level downtimes

📖 CheckMK Rules Guide - Returns the complete guide for rule management, ordering pitfalls, and API tricks. Call this BEFORE creating/modifying rules when unsure about the correct approach.

🔁 Clone a host - copies the folder, tags and labels of a source host onto a new target host. A different IP address can optionally be given.

🔄 Compare host states - Compare current vs desired host configuration

🏷️ Create a new auxiliary tag.

🏢 Create cluster host - Create a cluster host with multiple nodes

➕ Create contact group - Add new contact group

🔧 Create a custom Nagios plugin check for a host. Runs any Nagios-compatible plugin.

🔎 Create a DNS check for a host. Tests whether a name resolves and whether the answer arrives in time.

➕ Create folder - Add new folder to the structure

📁 Create an FTP check for a host. Tests whether an FTP port is reachable.

➕ Create host(s) - Add one or multiple hosts to monitoring (automatically uses bulk API for multiple hosts)

📞 Create host contact group rule - Assign contact groups to hosts based on conditions

➕ Create host group - Add new host group

🏠 Create host group rule - Assign hosts to host groups based on conditions

🏷️ Create host tag - Add new host tag group

🌐 Create an HTTP/HTTPS check for a host (active_checks:http). Supports URL mode (content check, auth, timing) and certificate mode.

🏓 Create an ICMP/PING check for a host. Measures reachability, packet loss and round-trip time.

🔬 Create a HW/SW inventory check for a host. Triggers hardware and software inventory and reports changes since the last scan.

🗂️ Create an LDAP check for a host. Tests the LDAP service and its response time.

📋 Create an Event Console check for a host. Reports whether the Checkmk Event Console holds open events for it.

➕ Create notification rule - CheckMK requires the complete rule_config structure (properties, contact selection, conditions and notification_method), and nearly every field is mandatory. Read an existing rule with vibemk_get_notification_rule and adapt its rule_config rather than composing one from scratch. Activate changes afterwards.

🔐 Create password - Store new password securely

➕ Create rule - Add new monitoring rule

🔧 Create service group - Create a new service group for organizing services

🖥️ Create an SMB/CIFS share check for a host. Tests availability and used space of a Windows network share.

📧 Create an SMTP check for a host. Tests the SMTP service, optionally STARTTLS and certificate expiry.

🔌 Create a TCP port check for a host. Tests reachability, optionally the response content, and the SSL certificate.

⏰ Create time period - Add new time period

👤 Create user - Add new CheckMK user

➕ Create user role - Clone an existing role to create a new custom role

🔍 Debug API endpoints - Analyze available CheckMK API endpoints and their structure

🔍 CheckMK connection diagnostics - Test server connectivity and API access

🔐 Debug permissions - Check automation user permissions for API access

🔍 Debug URL detection - Show all tested URL patterns and results

🗑️ Delete an active check rule, either by rule_id (UUID) or by hostname plus an optional service_name, which finds and deletes the matching rules.

🗑️ Delete an auxiliary tag.

🗑️ Delete comment - Remove a host or service comment by ID or query

🗑️ Delete contact group - Remove contact group

🗑️ Delete downtime - Cancel a scheduled or active downtime by ID

🗑️ Delete Event Console events, either by a list of IDs or every event of one phase or host.

🗑️ Delete folder - Remove folder (with options for recursive deletion)

🗑️ Delete host - Remove host from monitoring

🗑️ Delete host group - Remove host group

🗑️ Delete host tag - Remove host tag group

🗑️ Delete notification rule - Remove a notification rule by ID. Activate changes afterwards.

🗑️ Delete password - Remove stored password

🗑️ Delete rule - Remove monitoring rule

🗑️ Delete service group - Remove a service group from CheckMK

🗑️ Delete a service parameter rule, such as a process threshold rule. Needs the rule ID from vibemk_list_process_rules.

🗑️ Delete time period - Remove time period

🗑️ Delete user - Remove CheckMK user

🗑️ Delete user role - Remove a custom user role (built-in roles cannot be deleted)

📦 Download agent - Get download URL for the agent package of a specific host Enterprise/Cloud only: a Raw site does not serve this endpoint and answers 404.

🔍 Find host grouping rulesets - Discover available rulesets for host group and contact group assignment

🔴 Get active downtimes - Show only currently active downtimes that are suppressing alerts

📋 Retrieve the audit log: Checkmk configuration changes such as hosts created or deleted, rules changed, and activations.

🏷️ List every configured auxiliary tag.

📊 Get bulk discovery status - Show progress of a bulk discovery job

🖥️ List hosts - Show all monitored hosts with optional folder filtering

🔧 List services - Show services with optional host filtering

📋 Get CheckMK version - Show version information and system details

💬 List comments - Show host/service comments

👥 List contact groups - Show contact groups

🚨 Get current problems - Show all hosts and services with problems

📊 Get custom graph - Retrieve predefined custom graph data Enterprise/Cloud only: a Raw site does not serve this endpoint and answers 404.

📋 Get discovery background job - Show last discovery job status on a host

📊 Get discovery status - Show current service discovery results for a host

⏰ List downtimes - Show scheduled downtimes

🗃️ Retrieve Event Console events. Shows open and acknowledged events, optionally filtered by host, state and phase.

📚 Get example rule structures - Show example JSON structures for host grouping rules

🖥️ Get folder hosts - List all hosts in a specific folder

📁 List folders - Show folder structure with optional parent filtering

⚙️ Get host configuration - Show host configuration with attributes

🔍 Host details - Get comprehensive host information

📋 Get effective host attributes - Show host attributes including inherited values

🏠 List host groups - Show all host groups

📊 Get host metrics - Extract performance data from CheckMK RRD databases

📊 Get host status - Show current monitoring status of a specific host

🏷️ List host tags - Show available host tag groups

🔍 Show notification rule - Return one rule including its full rule_config. Use this first to obtain a template before creating or updating a rule.

📢 List notification rules - Show all configured notification rules with their IDs

🔐 List passwords - Show stored passwords

📋 Get pending changes - Show uncommitted configuration changes

📋 List the rules of a ruleset, optionally filtered by host name. Shows the rule IDs vibemk_delete_rule needs.

📋 List rulesets - Show available rulesets

🔍 Get service group details - Show detailed information about a specific service group

🔧 List service groups - Show all service groups

📊 Get service metrics - Extract service performance data from CheckMK metrics API

📊 Get service status - Show current status of a service

🌐 List monitoring sites: every configured Checkmk instance in a distributed setup.

⏰ List time periods - Show all configured time periods

👥 List users - Show all CheckMK users

📋 List acknowledgements - Show all currently acknowledged host and service problems

🔍 List active check rules, optionally filtered by host or check type.

📋 List available metrics - Show all available metrics for host or service

📋 List downtimes - Show all scheduled downtimes with filtering options

🔍 List process monitoring rules (inventory_processes_rules): which processes are monitored on which hosts, and at what thresholds.

📋 List all rulesets - Show all available rulesets with basic information

📋 List service groups - Show all configured service groups

👥 List user roles - Show all available user roles (built-in and custom)

🔑 Log in to a remote site (distributed monitoring).

🚪 Log out of a remote site.

✏️ Modify downtime - Extend or shorten an active downtime's end time

📁 Move folder - Move folder to different parent

📁 Move host - Move host to different folder

🔄 Move rule - Change rule position in ruleset

🗑️ Remove acknowledgement - Delete by ID, by host/service, or by comment pattern

👥 Remove user from contact group - Remove user from contact group

✏️ Rename host - Rename a host in CheckMK (starts a background job)

⏰ Schedule downtime - Schedule maintenance downtime

🔧 Schedule host downtime - Schedule maintenance downtime for a host to suppress alerts

🔧 Schedule service downtime - Schedule maintenance downtime for specific services

🔍 Search metrics - Read one predefined graph (graph_id) or one metric (metric_id) across the hosts and services a filter matches. Exactly one of the two IDs is required; both are shown in the service view once 'Show internal IDs' is enabled in its display options. Enterprise/Cloud only: a Raw site does not serve this endpoint and answers 404.

🔍 Search rulesets - Find rulesets with filters (text, folder, name)

🌐 Override interface parameters for a Checkmk host (checkgroup_parameters:interfaces). Typically used to set the expected speed and clear an 'expected speed' WARN. Example: interface vmbr1 warns because 10 Gbit/s is expected and 1 Gbit/s is real; expected_speed_mbit=1000 sets the expectation to 1 Gbit/s. RULE ORDER: the new rule is created in the host's own folder, not in root, so that subfolder precedence applies. Only activate_changes is needed, no service discovery.

💾 Set memory thresholds for a host (checkgroup_parameters:memory_linux), creating a rule for RAM and/or swap usage. IMPORTANT, the memory keys are: RAM = levels_virtual (not 'levels'), swap = levels_swap, physical RAM = levels_ram, committed = levels_committed. RULE ORDER: the new rule is created in the host's own folder, not in root. Check with vibemk_get_ruleset whether a rule for this host already exists and update it with vibemk_update_rule rather than adding a second one. Only activate_changes is needed.

⚙️ Create process monitoring with thresholds for a host (inventory_processes_rules). The rule defines which processes are watched and how many instances trigger WARN and CRIT. A service discovery runs afterwards so the thresholds take effect immediately. Example: 'Process wnscli.exe' on host X should warn at >=10 instances and go critical at >=12.

📋 Show ruleset details - Display detailed information about a specific ruleset

🔍 Show user role details - Display detailed information about a specific user role

🔍 Start bulk discovery - Discover services on multiple hosts simultaneously

🔍 Start service discovery - Automatically detect services on a host

🧪 Test all API endpoints - Comprehensive endpoint availability check

🧪 Test direct URL - Send a GET to a URL under the configured CheckMK API and show the raw response. URLs on other hosts or outside the API path are refused.

🏷️ Update an auxiliary tag.

📝 Update contact group - Modify contact group properties

📝 Update folder - Modify folder properties

📝 Update host - Modify host configuration with flexible attribute management

📝 Update host group - Modify host group properties

📝 Update host tag - Modify host tag group

✏️ Update notification rule - Replaces the rule's configuration. Send the complete rule_config, not just the fields you want changed; read the current one first. Activate changes afterwards.

📝 Update password - Modify stored password

📝 Update rule - Modify existing monitoring rule

📝 Update service group - Modify an existing service group's alias

📝 Update time period - Modify time period configuration

📝 Update user - Modify user properties

✏️ Update user role - Modify an existing user role's alias or permissions

✅ Validate host config - Validate host configuration before applying changes

⏳ Wait for discovery completion - Wait until service discovery finishes on a host