跳到主要内容
版本: 最新版本-3.5

异步物化视图的监控指标

自 v3.1 起，StarRocks 支持异步物化视图的监控指标。

要允许 Prometheus 访问集群中的物化视图元数据，您必须在 Prometheus 配置文件 prometheus/prometheus.yml 中添加以下配置

global:
....
scrape_configs:

  - job_name: 'dev' 
    metrics_path: '/metrics'    
    # Add the following configurations.
    basic_auth:
      username: 'root'
      password: ''
    params:
      'with_materialized_view_metrics' : ['all']   
....
  • username：用于登录 StarRocks 集群的用户名。 必须为此用户授予 user_admin 角色。
  • password：用于登录 StarRocks 集群的密码。
  • 'with_materialized_view_metrics'：要收集的指标范围。 有效值
    • 'all'：收集与物化视图相关的所有指标。
    • 'minified'：不会收集 Gauge 指标和值为 0 的指标。

指标项​

mv_refresh_jobs​

  • 类型：计数器
  • 描述：物化视图的刷新任务总数。

mv_refresh_total_success_jobs​

  • 类型：计数器
  • 描述：物化视图的成功刷新任务数。

mv_refresh_total_failed_jobs​

  • 类型：计数器
  • 描述：物化视图的失败刷新任务数。

mv_refresh_total_empty_jobs​

  • 类型：计数器
  • 描述：由于要刷新的数据为空而取消的物化视图的刷新任务数。

mv_refresh_total_retry_meta_count​

  • 类型：计数器
  • 描述：物化视图刷新任务检查基础表是否更新的次数。

mv_query_total_count​

  • 类型：计数器
  • 描述：在查询的预处理中使用物化视图的次数。

mv_query_total_hit_count​

  • 类型：计数器
  • 描述：认为物化视图能够重写查询计划中的查询的次数。 此值可能会显得较高，因为最终的查询计划可能会由于高成本而跳过重写。

mv_query_total_considered_count​

  • 类型：计数器
  • 描述：物化视图重写查询的次数（不包括针对物化视图的直接查询）。

mv_query_total_matched_count​

  • 类型：计数器
  • 描述：物化视图参与查询的最终计划的次数（包括针对物化视图的直接查询）。

mv_refresh_pending_jobs​

  • 类型：计量器
  • 描述：| 物化视图当前待处理的刷新任务数。

mv_refresh_running_jobs​

  • 类型：计量器
  • 描述：| 物化视图当前正在运行的刷新任务数。

mv_row_count​

  • 类型：计量器
  • 描述：| 物化视图的行数。

mv_storage_size​

  • 类型：计量器
  • 描述：| 物化视图的大小。 单位：字节。

mv_inactive_state​

  • 类型：计量器
  • 描述：| 物化视图的状态。 有效值：0（活动）和 1（非活动）。

mv_partition_count​

  • 类型：计量器
  • 描述：| 物化视图中的分区数。 如果物化视图未分区，则值为 0。

mv_refresh_duration​

  • 类型：直方图
  • 描述：成功物化视图刷新任务的持续时间。