UI components¶

Percona Monitoring and Management (PMM) provides a web-based user interface (UI), built on Grafana, for monitoring and managing your database environments.

Here’s how the UI is laid out, and what the controls do:

PMM Interface with numbered components

Main menu (also called Grafana menu or side menu)
Top navigation bar
View controls
View selectors
Shortcut menu

You’ll find these options in the left-side menu:

Icon	Name	What you can do
	Home	Access the main dashboard with overview panels for database connections, queries, anomaly detection, and upgrade status.
	Bookmarks	Create personal navigation shortcuts to any page in PMM. Bookmarks are private to your account and can include dashboards, settings pages, or any other PMM page for quick access.
	Starred	Mark important dashboards as favorites. Starred dashboards can be set as your home page and are visible to all users, helping teams identify important monitoring views.
	Dashboards	Create and organize dashboards, create folders, import dashboards, create playlists, and manage snapshots.
	Operating System (OS)	Monitor server-level metrics including CPU, memory, disk, and network performance.
	MySQL	View specialized dashboards for MySQL database performance monitoring.
	PostgreSQL	Access PostgreSQL-specific monitoring dashboards and metrics.
	Query Analytics (QAN)	Analyze database queries over time, identify slow queries, optimize performance, and troubleshoot issues.
	Explore	Run ad-hoc queries with PromQL to investigate specific metrics without creating dashboards.
	Drilldown	Run detailed analysis with specialized views for database metrics. This enables you to dive deeper into specific metrics by clicking through related data points and exploring underlying patterns. Learn more about drilling down into metrics in the Grafana documentation.
	Backup	Configure and manage your database backups and storage locations.
	Advisors	Run health assessment checks on your databases and view recommendations for improving performance.
	Alerting	Create and manage alerts that notify you when metrics exceed thresholds.
	PMM Configuration	Configure PMM-specific settings and manage your monitored database inventory.
	Connections	Set up and manage data sources to integrate additional metrics into PMM.
	Administration	Access Grafana-specific settings for users, permissions, plugins, and system maintenance.

The top bar helps you navigate and understand your current location:

Dashboard title and breadcrumbs: Shows your current location and navigation path
Search: Quickly find any dashboard by name
Keyboard shortcuts: Access frequently used commands
Help: Find documentation and support resources
User profile: Manage your account settings and preferences

3. View controls¶

Customize how you view your dashboard data:

Time range selector: Focus on specific time periods (last hour, day, week)
Refresh button: Manually update dashboard data or set automatic refresh intervals
View mode: Toggle between different display modes (fullscreen, TV mode)
Dashboard settings: Access configuration options for the current dashboard

4. View selectors¶

Filter your monitoring data using these contextual options:

Interval: Control the data granularity (Auto, 1m, 5m, etc.)
Environment: Focus on specific deployment environments
Node Names: Filter metrics to specific servers
Service Names: View data for particular database instances
PMM Annotations: Toggle visibility of important events on your timelines

These selectors change based on the dashboard you’re viewing, showing only relevant options.

Quick links to related dashboards and features:

Home: Return to the main dashboard
Query Analytics: Jump to query performance analysis
Services: Access service-specific dashboards
Compare: View side-by-side metrics for different nodes
Additional shortcuts: Based on your current context

UI components¶

1. Main menu¶

2. Top navigation bar¶

3. View controls¶

4. View selectors¶

5. Shortcut menu¶