メトリクス
VeloDB Cloudは、コンソール内に組み込みメトリクスを提供し、Metrics APIを通じて生のメトリクスを公開します。コンソールを使用してwarehouseとclusterの健全性をインタラクティブに検査したり、Metrics APIを独自のPrometheusとGrafanaスタックに接続して一元的な可観測性を実現したりできます。
コンソールでメトリクスを表示する
Metricsページでは以下が可能です：
- warehouseまたはcluster別にメトリクスを表示する
- Starredを使用して、warehouseとcluster全体で気になるメトリクスをピン留めし、一緒に表示する
- 時間セレクターを調整して、過去30日までの履歴データを確認する
- ほぼリアルタイムの更新（5秒間隔）のために自動更新を有効にする
メトリクスは2つのカテゴリに分かれています：Resource Metrics（物理的なリソース使用率）とService Metrics（クエリとワークロードのパフォーマンス）です。
Resource Metrics
Resource metricsは、warehouseとclusterノード全体の物理的な使用率を追跡します。これらは、特定の時間範囲でwarehouseまたはclusterが健全かどうかを判断し、履歴または現在のクエリがパフォーマンスに影響しているかどうかを判断するのに役立ちます。これは、スケールアップ、スケールダウン、またはSQLの最適化を計画する際の有用な入力となります。
Scope列は、メトリクスがwarehouseレベル、clusterレベル、またはその両方で適用されるかを示します。Available from列は、必要な最小エンジン（core）バージョンを示します。空白のセルは、最初のリリースからメトリクスが利用可能であったことを意味します。
| Metric | Scope | Unit | Available from | What it shows |
|---|---|---|---|---|
| CPU Utilization | Warehouse, Cluster | % | 全ノード全体のCPU使用率。スケーリングやその他のリソース集約型操作の静かな時間を見つけるのに有用。 | |
| Memory Usage | Warehouse, Cluster | GB | 全ノード全体で消費されるメモリ。持続的な高使用率は、スケールまたはワークロード調整の必要性を示す。 | |
| Memory Utilization | Warehouse, Cluster | % | 全ノード全体のメモリ使用率。持続的なメモリ圧迫を検出するのに役立つ。 | |
| I/O Utilization | Warehouse, Cluster | % | ノード全体のディスクI/O使用率。持続的な高い値は、ストレージのボトルネックを示唆する。 | |
| Disk Cache Utilization | Cluster | % | 4.0.4 | ローカルキャッシュ容量の使用率。キャッシュ容量が十分かどうかを評価するのに役立つ。 |
| Disk Cache Hit Rate | Cluster | % | ローカルキャッシュから提供された読み取りの割合。低い値は、キャッシュサイズまたはポリシーの見直しを示唆する。 | |
| Disk Cache Read/Write IOPS | Cluster | IOPS | ローカルキャッシュの読み取りおよび書き込みIOPS。キャッシュ層のリクエスト負荷を反映する。 | |
| Disk Cache Read/Write Throughput | Cluster | MB/s | ローカルキャッシュの読み取りおよび書き込みスループット。キャッシュ層のデータ転送を反映する。 | |
| Remote Storage Read/Write IOPS | Cluster | IOPS | 4.0.4 | オブジェクトストレージの読み取りおよび書き込みIOPS。リモートストレージのリクエスト負荷を反映する。 |
| Remote Storage Read/Write Throughput | Cluster | MB/s | 4.0.4 | オブジェクトストレージの読み取りおよび書き込みスループット。 |
| Network Inbound/Outbound Throughput | Warehouse, Cluster | MB/s | インバウンドおよびアウトバウンドネットワークスループット。帯域幅のボトルネックを特定するのに役立つ。 | |
| Unreachable Node Count | Warehouse, Cluster | ホスト可用性チェックに基づく、ホストレベルの到達不可能ノード。 | ||
| Inactive FE Service Node Count | Warehouse | サービスプロセスがアクティブでないFEノード。systemdまたはプロセス障害を表面化する。 |
Service Metrics
Service metricsは、クエリとワークロードの動作を追跡します：クエリの実行速度、成功数、および書き込みパスの動作です。
| Metric | Scope | Unit | Available from | What it shows |
|---|---|---|---|---|
| Queries per Second | Warehouse, Cluster | QPS | 1秒あたりに処理されるクエリリクエスト。ピークQPSは、clusterのサイジング時の有用な入力。 | |
| Query Success Rate | Warehouse, Cluster | % | 成功したクエリの割合。異常な低下は、clusterまたはノード障害を示す可能性がある。 | |
| Average Query Latency | Cluster | ms | 平均クエリレイテンシ。上昇は、調査すべきcluster全体の減速を示す。 | |
| P99 Query Latency | Cluster | ms | 99パーセンタイルのクエリレイテンシ。テールレイテンシと低速クエリのリスクを反映する。 | |
| Rows Loaded per Second | Warehouse, Cluster | Row/s | ロードジョブによって1秒あたりに書き込まれる行数。取り込みスループットを追跡する。 | |
| Load Throughput | Warehouse, Cluster | MB/s | ロードジョブによって1秒あたりに書き込まれるデータ。取り込み帯域幅を追跡する。 | |
| Active Connections | Warehouse | 全cluster全体のwarehouseへのアクティブ接続。 | ||
| Finished Load Job Rate | Warehouse | ロードジョブの最近の完了率。急激な変化は、ワークロードの変化を示す可能性がある。 | ||
| Average Load Job Latency | Warehouse | ms | ロードジョブの平均実行レイテンシ。低いほど、データがより早くクエリ可能になることを意味する。 | |
| Stream Load Request Rate | Warehouse | Stream Loadリクエスト率。リアルタイム取り込みトラフィックを反映する。 | ||
| Broker Load Job Rate | Warehouse | Broker Loadジョブ率。バッチ取り込みトラフィックを反映する。 | ||
| Insert Into Job Rate | Warehouse | Insert Into書き込み率。SQLベースの取り込みトラフィックを反映する。 | ||
| Routine Load Jobs by Status | Warehouse | 各ステータスのRoutine Loadジョブ数。継続的取り込みの健全性を追跡する。 | ||
| Compaction Score | Cluster | データファイルのマージ圧力。高いスコアは、書き込みまたはクエリパフォーマンスに影響する可能性がある。 | ||
| Routine Load Lag | Warehouse | 4.0.5 | 例えばKafkaからのRoutine Load消費ラグ。データの新鮮さを反映する。 | |
| Routine Load Aborted Transactions | Warehouse | 4.0.5 | 過去5分間で中止されたRoutine Loadトランザクション。増加は取り込み失敗を示す。 | |
| Routine Load Jobs in ABNORMAL_PAUSED State | Warehouse | 4.0.5 | 異常に一時停止されたRoutine Loadジョブ。通常、調査と手動再開が必要。 | |
| Virtual Cluster Active-Standby Switches | Warehouse | 4.1.7 | 仮想clusterのアクティブスタンバイ切り替えイベント、少なくとも10分間のウィンドウにわたる。 | |
| Data Size | Warehouse | GB | warehouseのデータサイズの履歴トレンド。 | |
| MV Refresh Skipped Tasks | Warehouse | tasks | 4.1.8 | ウィンドウ内でスキップされたマテリアライズドビューリフレッシュタスク。スケジューリング遅延またはバックログを表面化する。 |
| MV Refresh Queue Length | Warehouse | tasks | 4.1.8 | 実行中および待機中のマテリアライズドビューリフレッシュタスク。リフレッシュバックログを追跡する。 |
| MV Refresh Success Rate | Warehouse | % | 4.1.8 | 成功したマテリアライズドビューリフレッシュの割合。リフレッシュがないウィンドウは100%を示す。 |
| MV Refresh Duration | Warehouse | ms | 4.1.8 | P75およびP95のマテリアライズドビューリフレッシュ期間。 |
個別のRoutine LoadおよびWarmupジョブのジョブレベルメトリクスは、ここではなく各ジョブ自身のページに表示されます。これらにアラートを設定するには、Alertsを参照してください。
次のステップ
- Metrics API：これらのメトリクスを独自のPrometheusまたはGrafanaスタックに取り込む
- Alerts：メトリクスが閾値を超えたときに通知を受け取る