Execute a MetricsQL query at a single point in time. MetricsQL is a PromQL-compatible query language with additional functions and optimizations. Returns the current value of metrics matching the query. Use this for getting the latest state of metrics, checking current values, or evaluating expressions at a specific timestamp.

Execute a MetricsQL query over a range of time. Returns time series data over the specified time window with the given resolution step. Use this for plotting graphs, analyzing trends over time, or getting historical metric values. VictoriaMetrics optimizes range queries for better performance than Prometheus. Supports relative time ranges and automatic step adjustment.

Find the top K time series by value using VictoriaMetrics' optimized topk functions. Returns only the highest-value series, which is more efficient than fetching all series and sorting. Use this for identifying top consumers, finding anomalies, or focusing on the most important metrics. Supports both instant and range queries with topk operators.

Execute a MetricsQL query and get detailed execution trace information. Returns query results along with performance metrics and execution steps. Use this for debugging slow queries, understanding query execution, optimizing performance, or troubleshooting unexpected results. VictoriaMetrics provides enhanced tracing compared to Prometheus.

Find time series that match specific label selectors. Returns a list of label sets identifying each matching series. Use this to discover what metrics exist, find series with specific labels, or explore available time series data. VictoriaMetrics supports extended label matching with =, !=, =~, !~ operators and can handle high-cardinality series efficiently.

Get a list of all label names used across time series. Returns an array of label name strings. Use this to discover what labels are available, understand the labeling scheme, or build dynamic queries. VictoriaMetrics can efficiently handle databases with millions of unique labels. Supports filtering by time range and series matchers.

Get all values for a specific label name. Returns an array of strings representing all unique values that label has across time series. Use this to discover what instances, jobs, or other label values exist in your metrics. VictoriaMetrics can efficiently return values even for high-cardinality labels. Supports time range filtering.

Get metadata about metrics including type and help text. Returns information about what each metric measures and its type (counter, gauge, histogram, summary). Use this to understand available metrics and their purposes. Note: VictoriaMetrics may have limited metadata compared to Prometheus if metrics are imported without metadata.

Get cardinality statistics about the time series database. Returns information about the number of series, label names, label value pairs, and which labels have the highest cardinality. Use this to understand TSDB resource usage, identify high-cardinality labels causing performance or storage issues, plan capacity, or troubleshoot. VictoriaMetrics provides additional statistics compared to Prometheus.

Get a list of all metric names (time series names) available in VictoriaMetrics. Returns an array of __name__ label values, which are the metric names. Use this for discovering what metrics are being stored, building metric browsers, or validating metric ingestion. Can be filtered by time range and label matchers. This is a convenience wrapper around finding series and extracting __name__ labels.