Community코딩 & 개발github.com

grafana/promql

Prometheus 및 Grafana Cloud Metrics용 PromQL 쿼리를 작성, 검증 및 최적화합니다. 메트릭 조회, PromQL 표현식 작성, 비율 계산, 레이블 집계, 히스토그램 분위수 구성, 레코딩 규칙 생성, 쿼리 성능 디버깅 또는 메트릭 카디널리티 이해와 같은 작업에 사용합니다.

promql란 무엇인가요?

이 스킬은 Prometheus와 Grafana Cloud Metrics 환경에서 PromQL(Prometheus Query Language) 쿼리를 작성하고 검증하며 최적화하는 기능을 제공합니다. 사용자가 메트릭을 조회하거나 PromQL 표현식을 작성해야 할 때, 'rate', 'histogram_quantile', 'sum by' 같은 집계 연산, 'recording rule' 생성, 혹은 쿼리 성능 저하 및 메트릭 카디널리티 문제를 진단할 때 자동으로 트리거됩니다. 주요 트리거 구문으로는 "PromQL", "Prometheus query", "calculate rate", "histogram_quantile", "query is slow" 등이 있으며, 이를 바탕으로 AI 에이전트가 적절한 PromQL 쿼리를 생성하거나 기존 쿼리를 최적화합니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, Grafana Cloud Metrics에 특화된 쿼리도 지원합니다. 결과적으로 개발자와 SRE 팀이 Prometheus 기반 모니터링 시스템에서 더 정확하고 효율적인 메트릭 쿼리를 작성할 수 있도록 돕습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/grafana/skills/tree/main/skills/promql

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

promql은(는) 무엇을 하나요?

Prometheus 및 Grafana Cloud Metrics용 PromQL 쿼리를 작성, 검증 및 최적화합니다. 사용자가 메트릭을 조회하거나 PromQL 표현식을 작성하고, 비율을 계산하며, 레이블별로 집계하고, 히스토그램 분위수를 구축하고, 레코딩 규칙을 생성하거나, 쿼리 성능을 디버깅하거나, 메트릭 카디널리티를 이해하려고 할 때 사용하세요. "PromQL", "Prometheus query", "write a metric query", "calculate rate", "histogram_quantile", "recording rule", "metric cardinality", "sum by", "rate vs irate", "absent()", 또는 "query is slow"와 같은 구문에 트리거됩니다.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

grafana/dashboarding

Create, modify, and organise Grafana dashboards including panels, variables, transformations, and alerting. Use when the user asks to create a Grafana dashboard, add a panel, configure a time series or stat panel, add template variables, set up dashboard linking, use transformations, configure thresholds, build a dashboard for a service, or export dashboard JSON. Triggers on phrases like "create dashboard", "add panel", "time series panel", "Grafana dashboard JSON", "template variables", "dashboard variable", "panel transformation", "threshold", "stat panel", "table panel", "Grafana annotations", or "dashboard folder".

grafana/grafana-oss

Configure Grafana OSS — provisions dashboards from YAML, sets up data sources (Prometheus / Loki / Tempo / Pyroscope), writes dashboard JSON with template variables, builds panel queries, assigns built-in roles (Viewer / Editor / Admin / GrafanaAdmin), mints service-account tokens, edits grafana.ini server config, creates annotations, installs plugins via provisioning, and validates each step with a health-check curl. Use when building dashboards, configuring data sources, setting up provisioning YAML, picking a panel type, writing template variables, managing users and roles, configuring SMTP/OAuth in grafana.ini, creating annotations via API, troubleshooting why a provisioned dashboard isn't showing up, or running Grafana OSS locally — even when the user says "set up a Prometheus data source", "provision dashboards from git", "make a service account", or "configure SSO in OSS" without saying "Grafana OSS".

grafana/opentelemetry

OpenTelemetry with Grafana stack. Covers OTel SDK instrumentation for Go/Java/Python/Node.js/.NET, OTLP protocol and endpoint configuration, sending telemetry to Grafana Cloud via OTLP endpoint, Grafana Alloy as OTel collector, sampling strategies, Kubernetes OTel Operator, and migration from other observability tools. Use when instrumenting apps with OTel, configuring OTLP endpoints, setting up collectors, or migrating to OpenTelemetry.

grafana/prometheus

Prometheus and Grafana Cloud Metrics overview including PromQL query language, Metrics Drilldown, alerting, recording rules, and integration patterns. Use when working with Prometheus, writing PromQL queries, configuring alerting, or discussing metrics architecture and best practices.

관련 스킬