# Whizard Telemetry Ruler

Use when working with WizTelemetry Ruler extension for KubeSphere, including...

- Repository: https://github.com/kubesphere/kubesphere (17074 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-07-15
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add kubesphere/kubesphere --skill whizard-telemetry-ruler -g -a claude-code -y`
Codex: `npx skills add kubesphere/kubesphere --skill whizard-telemetry-ruler -g -a codex -y`
Cursor: `npx skills add kubesphere/kubesphere --skill whizard-telemetry-ruler -g -a cursor -y`
Gemini CLI: `npx skills add kubesphere/kubesphere --skill whizard-telemetry-ruler -g -a gemini-cli -y`

## Description

Use when working with WizTelemetry Ruler extension for KubeSphere, including installation, configuration, alerting rules management

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# WizTelemetry Ruler

## Overview

WizTelemetry Ruler is an extension component in the KubeSphere Observability Platform that provides event alerting and log alerting capabilities. It can define alerting rules for K8s native events, K8s/KubeSphere auditing events, and K8s logs, evaluate incoming event data and log data, and send alerts to specified receivers such as alertmanager, etc.

## When to Use

- Installing or configuring the WizTelemetry Ruler extension
- Creating, updating, or deleting alerting rules (RuleGroup/ClusterRuleGroup)
- Managing alerting configurations
- Using the ruler API to manage alerting rules

## Components

| Component | Description | Default Enabled |
|-----------|-------------|-----------------|
| whizard-telemetry-ruler | Core ruler component for alerting | true |

## Dependencies

- **WizTelemetry Platform Service** (whizard-telemetry): Required
- **WizTelemetry Events** (whizard-events): Required if event alerting is enabled
- **WizTelemetry Auditing** (whizard-auditing): Required if auditing alerting is enabled
- **WizTelemetry Logging** (whizard-logging): Required if logging alerting is enabled
- **WizTelemetry Notification** (whizard-notification): Optional (for alert notification)
- **WizTelemetry Data Pipeline** (vector): Required if alerting persistence is enabled
- **OpenSearch** (opensearch): Required if alerting persistence is enabled
- 
## Installation

### Prerequisites

**REQUIRED: Complete all steps in order before generating InstallPlan.**

#### Step 1: Get Available Clusters and Confirm Target

**⚠️ CRITICAL: DO NOT proceed until target clusters are determined.**

**Step 1.1: Get available clusters**

```bash
kubectl get clusters -o jsonpath='{.items[*].metadata.name}'
```

**Step 1.2: Determine target clusters**

The rest: https://github.com/kubesphere/kubesphere/blob/HEAD/skills/whizard-telemetry-ruler/SKILL.md