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

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

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​

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

mv_refresh_total_success_jobs​

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

mv_refresh_total_failed_jobs​

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

mv_refresh_total_empty_jobs​

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

mv_refresh_total_retry_meta_count​

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

mv_query_total_count​

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

mv_query_total_hit_count​

  • タイプ: Counter
  • 説明: クエリプランでマテリアライズドビューがクエリを書き換え可能と判断された回数。この値は、最終的なクエリプランが高コストのため書き換えをスキップする場合があるため、より高く表示されることがあります。

mv_query_total_considered_count​

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

mv_query_total_matched_count​

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

mv_refresh_pending_jobs​

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

mv_refresh_running_jobs​

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

mv_row_count​

  • タイプ: Gauge
  • 説明: マテリアライズドビューの行数。

mv_storage_size​

  • タイプ: Gauge
  • 説明: マテリアライズドビューのサイズ。単位: バイト。

mv_inactive_state​

  • タイプ: Gauge
  • 説明: マテリアライズドビューのステータス。有効な値: 0（アクティブ）および1（非アクティブ）。

mv_partition_count​

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

mv_refresh_duration​

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