Filter by name

Тема дорожной карты · Grafana

Трансформация Filter by name в Grafana позволяет включать или исключать конкретные поля (столбцы) из результата запроса до того, как он поступит на визуализацию, сохраняя панели чистыми и сфокусированными на важных сигналах. Вы настраиваете эту трансформацию, вводя имя поля или шаблон регулярного выражения в поле фильтра, а Grafana сразу же предварительно показывает результирующий набор данных на вкладке Transform, чтобы вы могли убедиться, что нужные поля сохранены. Filter by name особенно полезна, когда источник данных возвращает больше столбцов, чем нужно: например, векторный запрос Prometheus может возвращать десятки полей меток, и фильтрация до только instance и value делает панель Table значительно удобнее для чтения. Эту трансформацию можно комбинировать с другими шагами конвейера, такими как Rename fields или Add field from calculation, для постепенной очистки и обогащения данных в редакторе панели без изменения основного запроса. При изменении запроса и появлении новых полей выше по цепочке трансформация Filter by name автоматически обрабатывает неизвестные поля, так что дашборды остаются стабильными при эволюции схем данных.

Как это работает

Filter by name работают после запроса, до визуализации: Join by field, Reduce (агрегация per series), Filter by name/value, Rename fields, Concatenate fields, Calculate (математика между series). Полезны для: комбинирования запросов из разных источников, вычисления ratio, переименования generic-labels, нормализации между data sources. Применяются в Transform-вкладке панели; порядок трансформаций важен.

Когда применять

Трансформации — когда query language не может сделать нужное (например, join метрики с CMDB-lookup таблицей из SQL-datasource). Reduce — для коллапса длинного time-series в одно число для Stat-панели. Лимит цепочки трансформаций 2-3 шага; больше — переструктурируйте запрос.

Типичные ошибки

Ловушки Filter by name: огромные цепочки трансформаций прячут, что показывается (отладочный кошмар); трансформации на больших series (медленная client-side обработка); трансформации для фикса плохих данных вместо фикса на источнике.

Связанные понятия

Полезные ресурсы