vmlogs-cli
/vmlogs-cli
Use when нужно посмотреть логи в VictoriaLogs — «посмотри логи», «что было в X», «почему упал <pod>», разбор инцидента, post-mortem после релиза, посчитать ошибки за период, найти, какие поля есть у логов сервиса. Работает напрямую, через kubectl (в том числе на сервере по ssh) и через Grafana с SSO.
- Author
- gumayunov ↗
- Repository
- skill-vmlogs-cli ↗
- Licence
- MIT
- Last repository change
- 26.10.2026
Assessment and security
- Files in this package
- 6
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 1
No signals detected. Repository changed on 26.10.2026, without references to retired models or APIs.
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
- Порядок работы
- Окно времени
- LogsQL — шпаргалка
- Какие поля есть
- Вывод
- Если не получилось
- Пресеты проекта
- Чего не делать
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.