SkillFoxx
Telegram

VictoriaMetrics skills — метрики, логи и трейсы

VictoriaMetrics skills

Четырнадцать скиллов VictoriaMetrics: PromQL и LogsQL, трейсы, кардинальность, аномалии и поиск флагов в документации

  • 63 ★ репозитория
  • Последний коммит
  • Apache-2.0
СкиллОфициальный

Расширенный доступ

Почему такой уровень

  • Агент ходит в API мониторинга через curl и может читать метрики, логи и трейсы вашей инфраструктуры
  • Скилл alertmanager-query создает и снимает заглушки, поэтому токен с правом записи позволяет заглушить боевой алерт
Все причины и проверки

victoriametrics/skillsАвтор:VictoriaMetrics

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/victoriametrics-skills

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Агент ходит в API мониторинга через curl и может читать метрики, логи и трейсы вашей инфраструктуры
  • Скилл alertmanager-query создает и снимает заглушки, поэтому токен с правом записи позволяет заглушить боевой алерт

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Официальный набор от команды VictoriaMetrics делится на четыре плагина. Плагин query отправляет запросы к VictoriaMetrics на PromQL и MetricsQL, к VictoriaLogs на LogsQL и к VictoriaTraces, а также читает состояние Alertmanager и управляет заглушками уведомлений. Плагин diagnostics разбирает JSON-трассировку медленного запроса, ищет метрики с высокой кардинальностью и неиспользуемые метрики, подсказывает правила сброса и помогает составить правила потоковой агрегации для vmagent. Он же ведет расследование сразу по метрикам, логам и трейсам. Плагин vmanomaly работает с сервисом поиска аномалий: проверяет совместимость, подбирает модель по реальным рядам, проверяет готовую конфигурацию и оценивает ресурсы. Плагин docs сверяет флаг командной строки, путь HTTP API или конструкцию языка запросов с опубликованной документацией, прежде чем агент назовет их в ответе. Скиллы ходят в API через curl. Адреса сервисов агент берет из переменных окружения, а токен читает из файла настроек curl, чтобы он не попал в историю оболочки и в лог агента.

Для кого. SRE и DevOps-инженерам, которые держат мониторинг на VictoriaMetrics и хотят разбирать метрики, логи и трейсы вместе с агентом.

Подходит, если

  • Под вечер запрос к метрикам стал тормозить, и JSON его трассировки надо превратить в понятный отчет
  • Счет за хранилище вырос, а команда не знает, какие метрики никто не читает
  • Под в Kubernetes падает в цикле, и причину хочется искать сразу по метрикам, логам и трейсам
  • Метрика с лишними метками раздувает базу, и для нее нужны правила потоковой агрегации в vmagent
  • Есть сомнение, что флаг хранения или путь API существует в вашей версии, и агент проверяет его по документации

Не подходит, если

  • Мониторинг построен на другой системе, например на Datadog или Elastic: скиллы знают только API VictoriaMetrics
  • Нужны дашборды Grafana, а не запросы к хранилищу
  • Агенту запрещено ходить в боевой Alertmanager: скилл умеет создавать и снимать заглушки
  • Версия vmanomaly старше 1.30: скилл работы с API рассчитан на 1.30 и новее

Пример запроса к агенту

Покажи, какие алерты сейчас горят, и найди метрики с самой высокой кардинальностью за последний час.

Ограничения

Адреса сервисов задаются переменными VM_METRICS_URL, VM_LOGS_URL, VM_TRACES_URL, VM_ALERTMANAGER_URL и VM_ANOMALY_URL. Скиллы ходят в API через curl и jq, обе утилиты должны быть в системе. Для защищенных установок нужен файл настроек curl с правами 0600 и переменная VM_CURL_CONFIG, старая VM_AUTH_HEADER больше не читается. Скилл оценки ресурсов vmanomaly помечен экспериментальным и требует версии 1.31.0.

Как отключить. Команда /plugin uninstall query@victoriametrics-tools снимает плагин, а для остальных меняется только его имя. Скиллы, поставленные через skills, удаляет команда npx skills remove с именем скилла.

Частые вопросы

Как поставить скиллы VictoriaMetrics в Claude Code?

Добавьте маркетплейс командой /plugin marketplace add VictoriaMetrics/skills и поставьте нужный плагин, например /plugin install query@victoriametrics-tools. Другой путь: npx skills add VictoriaMetrics/skills ставит все четырнадцать скиллов сразу.

Как передать токен, чтобы он не попал в историю?

Положите заголовок Authorization в файл настроек curl с правами 0600 и укажите его путь в VM_CURL_CONFIG. Скиллы читают файл через curl --config, поэтому токен не виден в списке процессов и в журнале агента.

Какие скиллы нужны, чтобы разобрать медленный запрос?

Достаточно vm-trace-analyzer из плагина diagnostics: он разбирает JSON-трассировку запроса и собирает отчет о производительности. Трассировку берут из запроса с параметром trace.

Умеет ли агент менять данные в Alertmanager?

Да, скилл alertmanager-query создает и снимает заглушки уведомлений и смотрит состояние подавления. Если доступ нужен только на чтение, ограничьте токен на стороне Alertmanager.

Нужно ли ставить все плагины сразу?

Нет, каждый плагин и каждый скилл ставятся отдельно. Командой npx skills add VictoriaMetrics/skills --skill victorialogs-query берется один скилл, а командой /plugin install diagnostics@victoriametrics-tools один плагин.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы
Официальный

Официальный MCP-сервер VictoriaMetrics: запросы метрик, правила и алерты, кардинальность и встроенная документация для агента

MCP-серверРасширенный доступ244
Официальный

Официальный MCP-сервер VictoriaLogs: агент выполняет запросы LogsQL, смотрит потоки и поля и ищет по встроенной документации.

MCP-серверРасширенный доступ111
Официальный

Официальный набор скиллов Grafana: PromQL, Loki, Tempo, Alloy, k6, дашборды и алертинг для Claude Code, Cursor и Codex

СкиллРасширенный доступ309
Выбор редакции

Официальный набор скиллов Datadog: мониторы, логи, APM, интеграции с облаками, RUM и наблюдаемость LLM из агента

СкиллШирокий доступ185

Официальные скиллы Dynatrace для агентов: DQL, трейсы, логи, Kubernetes, облака и безопасность в Claude Code и Cursor.

СкиллРасширенный доступ179

Скилл настраивает OpenTelemetry: коллектор, выборку, безопасность и поток телеметрии из ИИ-агентов, не засоряя контекст.

СкиллМинимальный доступ55

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
VictoriaMetrics skills — метрики, логи и трейсы (эта карточка)да63
Grafana Skillsда309набор Grafana для дашбордов, Loki, Tempo и k6, а не для хранилища VictoriaMetrics
Prometheus MCP Serverнетне нужна525MCP-сервер с PromQL-запросами к Prometheus, без логов, трейсов и аномалий

Коротко о README

README перечисляет четыре плагина с их скиллами, два способа установки, примеры запросов к агенту и список переменных окружения. Отдельный раздел объясняет, как токен передается через файл настроек curl и как перейти со старой переменной.

Бейдж для README

Исходный SKILL.md

---
name: victoriametrics-query
description: >
  Query VictoriaMetrics metrics via curl. Use when running PromQL/MetricsQL queries, discovering metrics/labels,
  checking alerts and rules, inspecting TSDB status, exporting raw data, checking metric usage statistics,
  or debugging relabeling/downsampling/retention configs. Triggers on: metric queries, PromQL, MetricsQL,
  label discovery, series exploration, cardinality checks, alert status, recording rules, active/top queries,
  export data, metric statistics, relabel debug, downsampling debug, retention debug, flags.
allowed-tools: Bash(curl:*), Bash(jq:*), Bash(head:*)
---

# VictoriaMetrics Metrics Query

Query VictoriaMetrics HTTP API directly via curl. Covers instant/range queries, label/series discovery, alerts, rules, instance diagnostics, raw data export, metric usage statistics, and config debugging tools.

## Environment

```bash
# $VM_METRICS_URL - base URL
#   cluster: export VM_METRICS_URL="https://vmselect.example.com/select/0/prometheus"
#   single: export VM_METRICS_URL="http://localhost:8428"
# $VM_CURL_CONFIG - curl config file with auth header (set for remote, unset for local)
#   Remote: export VM_CURL_CONFIG="$HOME/.config/victoriametrics/curl.conf"
#   Local:  leave unset (defaults to /dev/null - no auth)
```

## Auth Pattern

All curl commands load auth from a curl config file - works for both remote and local:

```bash
curl -q --config "${VM_CURL_CONFIG:-/dev/null}" -s "$VM_METRICS_URL/api/v1/query?query=up" | jq .
```

When `VM_CURL_CONFIG` is unset, curl reads `/dev/null` and sends no auth header. When set, it must point to a mode-0600 curl config file containing `header = "Authorization: Bearer <token>"`. Never print its contents.

## Core Endpoints

### Instant Query

```bash
# Query at current time
curl -q --config "${VM_CURL_CONFIG:-/dev/null}" -s \
  "$VM_METRICS_URL/api/v1/query?query=up" | jq .

Сообщить о проблеме