Skip to content
Skills Library
DevOps & cloud · Analysis

vmlogs-cli

/vmlogs-cli

Use when нужно посмотреть логи в VictoriaLogs — «посмотри логи», «что было в X», «почему упал <pod>», разбор инцидента, post-mortem после релиза, посчитать ошибки за период, найти, какие поля есть у логов сервиса. Работает напрямую, через kubectl (в том числе на сервере по ssh) и через Grafana с SSO.

Licence
MIT
Last repository change
26.10.2026

Assessment and security

95/ 100Class: good
Format20 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
6
Scripts
0
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 26.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Use when нужно посмотреть логи в VictoriaLogs — «посмотри логи», «что было в X», «почему упал <pod>», разбор инцидента, post-mortem после релиза, посчитать ошибки за период, найти, какие поля есть у логов сервиса. Работает напрямую, через kubectl (в том числе на сервере по ssh) и через Grafana с SSO.

Original author description

Use when нужно посмотреть логи в VictoriaLogs — «посмотри логи», «что было в X», «почему упал <pod>», разбор инцидента, post-mortem после релиза, посчитать ошибки за период, найти, какие поля есть у логов сервиса. Работает напрямую, через kubectl (в том числе на сервере по ssh) и через Grafana с SSO.

How it works

  1. Порядок работы
  2. Окно времени
  3. LogsQL — шпаргалка
  4. Какие поля есть
  5. Вывод
  6. Если не получилось
  7. Пресеты проекта
  8. Чего не делать
Original SKILL.md headings · 120 lines, 885 words
SKILL.md preview
---
name: vmlogs-cli
description: Use when нужно посмотреть логи в VictoriaLogs — «посмотри логи», «что было в X», «почему упал <pod>», разбор инцидента, post-mortem после релиза, посчитать ошибки за период, найти, какие поля есть у логов сервиса. Работает напрямую, через kubectl (в том числе на сервере по ssh) и через Grafana с SSO.
---

# vmlogs-cli

Поиск логов в VictoriaLogs. Запрос — LogsQL как есть, вывод — одна строка на запись.
Команда — `vmlogs-cli`; если её нет в PATH — `bin/vmlogs-cli` в каталоге этого скила.

Куда ходить, задаёт профиль — env-файл без секретов. Первый найденный побеждает:
`--env <файл>` → `$VMLOGS_ENV` → `.vmlogs-cli/env` вверх от текущего каталога → `~/.config/vmlogs-cli/env`.
Профиля нет (`нет профиля`) — попроси пользователя создать его по `README.md` рядом.

## Порядок работы

1. Проверить профиль и доступ:
   ```bash
   vmlogs-cli check
   ```
   Успех — путь к профилю, транспорт и `записей за 5 минут: N`.
2. Посчитать, сколько строк подходит, до того как смотреть сами строки:
   ```bash
   vmlogs-cli query '<фильтр> | stats count() c' --since 1h
   ```
3. Если строк не больше сотни — вывести их:
   ```bash
   vmlogs-cli query '<фильтр>' --since 1h --limit 100
   ```
   Больше — сузить фильтр или окно, разложить через `| stats by (<поле>) count()`, или
   выгрузить `--limit 5000 --out /tmp/<имя>.jsonl` и разбирать файл скриптом. На экран `--out`
печатает `N строк → <файл>` и `поля: …` — по списку полей видно, что искать в файле.
4. Строка обрезана — `vmlogs-cli get <stream_id>/<time>` из маркера.
5. Пусто или ошибка — таблица «Если не получилось».

`<фильтр>` начинай с namespace и контейнера: `kubernetes.pod_namespace:=<ns>
kubernetes.container_name:=<контейнер>`. Какой namespace у проекта — в его `CLAUDE.md`.
Если сборщик пишет поля иначе (`k8s.namespace`, `k8s.container_name`) — посмотри
`vmlogs-cli fields '*' --since 15m`.

## Окно времени

`--since 1h` (по умолчанию), `30m`, `6h`, `2d`, `1w`. Точное окно — `--start` и `--end`
(длительность или RFC3339 с зоной: `2026-04-19T10:30:00Z`). Можно и в самом запросе:
`_time:[2026-04-19T10:30:00Z, 2026-04-19T11:00:00Z]`.

## LogsQL — шпаргалка

| Нужно | Запрос |
|---|---|
| Точное значение поля | `kubernetes.container_name:=api` |
| Слово в сообщении | `error` — только **целое слово** |
| Начало слова | `timeout*` |
| Подстрока | `~"bulk_oper"` |
| Фраза | `"connection refused"` |
| Исключить | `-"health check"`, `-kubernetes.container_name:=sidecar` |
| Регулярка по полю | `kubernetes.pod_name:~"api-.*"` |
| Сравнение чисел | `status:>=500`, `duration_ms:>1000` |
| Посчитать по полю | `\| stats by (level) count() c` |
| По времени | `\| stats by (_time:5m) count() c` |
| Самые частые сообщения | `\| stats by (_msg) count() c \| sort by (c) desc \| limit 10` |
| Оставить поля | `\| fields _time, kubernetes.pod_name, _msg` |

Документация языка: https://docs.victoriametrics.com/victorialogs/logsql/

## Какие поля есть

```bash
vmlogs-cli fields '<фильтр>' --since 1h          # имена полей с числом строк
vmlogs-cli values '<фильтр>' level --since 1h    # значения поля с числом строк
```

Служебные поля (метки и аннотации пода, `_stream`, ip, нода …) скрыты; `--all-fields`
показывает всё.

## Вывод

`short` (по умолчанию): `<время> <контейнер> <УРОВЕНЬ> <сообщение>  k=v …`, записи по
возрастанию времени, переводы строк — `⏎`. Строки `| stats` — `k=v`. `-o json` — JSONL в
порядке VictoriaLogs (от новых к старым); с `-o json` поле `_stream_id` скрыто — для `get`
добавь `--all-fields`.

Маркеры и подсказки `[...]` печатаются в stderr — не отбрасывай его (`2>/dev/null`):

- `… [truncated: N/M chars, get <stream_id>/<time>]` — строка обрезана до `--width` (1000
  символов). Полная запись: `vmlogs-cli get <stream_id>/<time>`. Формат маркера — контракт,
  не перефразируй его в скриптах.
- `[показаны последние N строк окна — есть ещё …]` — вернулись не все записи: VictoriaLogs
  отдаёт последние N. Сузь фильтр или посчитай через `| stats`.
- `[0 строк …]` — по фильтру ничего нет: см. таблицу ниже.

## Если не получилось

| Признак | Причина | Действие |
|---|---|---|
| `0 строк`, хотя событие было | Слово ищется целиком: `bulk` не найдёт `bulk_operations` | `bulk*` или `~"bulk"` |
| `0 строк` по сервису вообще | Не то окно, не тот namespace или другие имена полей | `--since` шире; `vmlogs-cli fields '*'` |
| `VictoriaLogs не принял запрос: cannot parse …` | Синтаксис LogsQL | Исправить место из `context:` |
| `нет входа …` / `Сессия Grafana не продлевается` | Транспорт grafana, сессия истекла | Попроси пользователя выполнить `vmlogs-cli login` (может открыться окно браузера для SSO) и повтори |
| `отвечает 302 на …` | Grafana просит вход или переехала | `vmlogs-cli login`; если хост другой — поправить профиль |
| `ssh <host>: …` | Нет доступа по ssh | Проверить `ssh <host> true` |
| `kubectl: …` | kubeconfig, контекст или права | `kubectl config current-context`, профиль |
| `не ответил … VPN` | Нет сети до сервиса | VPN, адрес в профиле |
| `нет профиля` | Профиль не создан | `README.md`, раздел «Профили» |
| `не удалось записать <путь>: …` | Нет каталога или прав на запись для `--out` | Указать путь в каталоге, куда можно писать, и повторить |
| `ответ не похож на ответ VictoriaLogs (…)` | Адрес ведёт не на VictoriaLogs: другой сервис, прокси или датасорс Grafana | `vmlogs-cli check`; проверить адрес и датасорс в профиле |

## Пресеты проекта

Повторяющийся фильтр можно зашить в скрипт `.vmlogs-cli/<имя>.sh` проекта. Перед ручным
подбором фильтра проверь `ls .vmlogs-cli/*.sh`. Если пресета нет, а одна и та же комбинация
повторяется — предложи пользователю пресет (имя и что он зашьёт). После согласия:

1. Скопируй `presets/TEMPLATE.sh` из каталога скила в `.vmlogs-cli/<имя>.sh` проекта и
   замени `CHANGE-ME`.
2. `chmod +x`, проверь: `.vmlogs-cli/<имя>.sh '' --since 15m --limit 3`.

## Чего не делать

- Не ставь `--limit 10000` «на всякий случай» — вывод больше контекста. Сначала `| stats`.
- Не смотри строки до подсчёта, если окно большое.
- Не додумывай конец обрезанной строки — `vmlogs-cli get`.
- Не используй `-o json` для массового просмотра — он длиннее `short`.
Files in this package (6)
  • .gitignore 1 KB
  • LICENSE 1 KB
  • README.md 7 KB
  • SKILL.md 9 KB
  • pyproject.toml 1 KB
  • uv.lock 6 KB

Versions

The database has no other skills named vmlogs-cli.

Database snapshot: 13.11.2026 · package version b7e4a51b2853 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100docker
    Docker и Docker Compose на удалённом сервере через remote_exec: состояние контейнеров, логи, рестарт, обновление образов, место на диске, compose-стеки. Use when the task mentions docker, контейнер, compose, образ, volume.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.