kb-dashboard-lint 0.2.0

Linting rules for dashboard YAML configurations

kb-dashboard-lint

Linting rules for Kibana dashboard YAML configurations.

Overview

This package provides a configurable linting system that flags potentially problematic dashboard configurations based on best practices and style guidelines. It works with validated Pydantic models from kb-dashboard-core.

Installation

pip install kb-dashboard-lint

Or with uv:

uv add kb-dashboard-lint

Usage

CLI

# Check dashboards in a directory
kb-dashboard-lint check --input-dir ./inputs

# Check a single file
kb-dashboard-lint check --input-file dashboard.yaml

# Use custom configuration
kb-dashboard-lint check --config .dashboard-lint.yaml

# Only fail on errors (not warnings)
kb-dashboard-lint check --severity-threshold error

Programmatic API

from kb_dashboard_lint import check_dashboards
from kb_dashboard_core import load

# Load dashboards
dashboards = load('inputs/')

# Run linting
violations = check_dashboards(dashboards)

for violation in violations:
    print(f"{violation.severity}: {violation.rule_id} - {violation.message}")

Built-in Rules

Rule ID	Description	Default
dashboard-dataset-filter	Dashboard should have a data_stream.dataset filter	warning
datatable-row-density	Large datatables should consider compact density	info
dimension-missing-label	Dimensions should have explicit labels	info
esql-where-clause	ES|QL queries should include a WHERE clause	info
gauge-goal-without-max	Gauges with goals should define maximum values	warning
markdown-header-height	Markdown panels with headers must have height >= 3	warning
metric-multiple-metrics-width	Multi-metric panels need adequate width	warning
metric-redundant-label	Metric primary label matching title should use hide_title: true	warning
panel-description-recommended	Panels should have descriptions for accessibility	info
panel-height-for-content	Chart types have appropriate minimum heights	warning
panel-min-width	Panels should have minimum width for readability	warning
pie-chart-dimension-count	Multi-level pie charts may be hard to read	info

Configuration

Create a .dashboard-lint.yaml file:

extends: default

rules:
  markdown-header-height:
    severity: error
  esql-where-clause:
    enabled: false

Development

# Install dependencies
make install

# Run CI checks
make ci

# Run tests
make test

License

MIT