メインコンテンツまでスキップ
バージョン: Latest-3.4

非同期マテリアライズドビューの監視メトリクス

v3.1以降、StarRocksは非同期マテリアライズドビューのメトリクスをサポートしています。

Prometheusがクラスター内のマテリアライズドビューのメタデータにアクセスできるようにするためには、Prometheusの設定ファイル prometheus/prometheus.yml に以下の設定を追加する必要があります。

global:
....
scrape_configs:

  - job_name: 'dev' 
    metrics_path: '/metrics'    
    # 以下の設定を追加してください。
    basic_auth:
      username: 'root'
      password: ''
    params:
      'with_materialized_view_metrics' : ['all']   
....
  • username: StarRocksクラスターにログインするためのユーザー名。このユーザーにはuser_adminロールが付与されている必要があります。
  • password: StarRocksクラスターにログインするためのパスワード。
  • 'with_materialized_view_metrics': 収集するメトリクスの範囲。有効な値:
    • 'all': マテリアライズドビューに関連するすべてのメトリクスが収集されます。
    • 'minified': ゲージメトリクスと値が0のメトリクスは収集されません。

メトリクス項目​

mv_refresh_jobs​

  • Type: Counter
  • Description: マテリアライズドビューのリフレッシュジョブの総数。

mv_refresh_total_success_jobs​

  • Type: Counter
  • Description: マテリアライズドビューの成功したリフレッシュジョブの数。

mv_refresh_total_failed_jobs​

  • Type: Counter
  • Description: マテリアライズドビューの失敗したリフレッシュジョブの数。

mv_refresh_total_empty_jobs​

  • Type: Counter
  • Description: リフレッシュするデータが空のためキャンセルされたマテリアライズドビューのリフレッシュジョブの数。

mv_refresh_total_retry_meta_count​

  • Type: Counter
  • Description: マテリアライズドビューのリフレッシュジョブがベーステーブルの更新を確認する回数。

mv_query_total_count​

  • Type: Counter
  • Description: クエリの前処理でマテリアライズドビューが使用された回数。

mv_query_total_hit_count​

  • Type: Counter
  • Description: クエリプランでマテリアライズドビューがクエリを書き換えることができると考えられた回数。この値は、最終的なクエリプランが高コストのため書き換えをスキップする場合があるため、高く見えることがあります。

mv_query_total_considered_count​

  • Type: Counter
  • Description: マテリアライズドビューがクエリを書き換えた回数（マテリアライズドビューに対する直接クエリを除く）。

mv_query_total_matched_count​

  • Type: Counter
  • Description: クエリの最終プランにマテリアライズドビューが関与した回数（マテリアライズドビューに対する直接クエリを含む）。

mv_refresh_pending_jobs​

  • Type: Gauge
  • Description: 現在保留中のマテリアライズドビューのリフレッシュジョブの数。

mv_refresh_running_jobs​

  • Type: Gauge
  • Description: 現在実行中のマテリアライズドビューのリフレッシュジョブの数。

mv_row_count​

  • Type: Gauge
  • Description: マテリアライズドビューの行数。

mv_storage_size​

  • Type: Gauge
  • Description: マテリアライズドビューのサイズ。単位: バイト。

mv_inactive_state​

  • Type: Gauge
  • Description: マテリアライズドビューのステータス。有効な値: 0(アクティブ) と 1(非アクティブ)。

mv_partition_count​

  • Type: Gauge
  • Description: マテリアライズドビューのパーティション数。マテリアライズドビューがパーティション化されていない場合、この値は0です。

mv_refresh_duration​

  • Type: Histogram
  • Description: 成功したマテリアライズドビューのリフレッシュジョブの期間。