メトリクス¶

メトリクスは、Guanceシステムにおいてシステム状態を継続的に追跡するための核となるデータユニットであり、数値、タイムスタンプ、ディメンションタグの3つの要素で構成されます。時系列データとして、定量化可能なシステム特性（リソース使用率、ビジネススループットなど）を記録し、タグ（ホスト、サービス、地域など）による多角的な分析を実現することで、リアルタイムモニタリング、パフォーマンス最適化、トレンド予測に正確なデータ基盤を提供します。

データアーキテクチャ¶

Guanceのメトリクスデータ処理は、以下の3つのレイヤーで構成されます。

1. 収集層: DataKit（ユーザー環境にデプロイされる軽量エージェント、Prometheus の Exporter に類似）が担当し、データソースから直接メトリクスを取得します。収集、前処理、安全な転送の主要な責務を担います。

2. 転送層: DataKit はデータを暗号化し、HTTP/HTTPS 経由で Guanceのデータセンターに送信します。

3. ストレージ・分析層: Guanceがデータのクリーニング、保存、可視化分析機能を提供します。

メトリクスデータの構成¶

完全なメトリクスデータユニットは、以下の3つの核心要素で構成されます。

例：

cpu,host=server01,core=0 usage_user=12.3,usage_system=5.7 1690524000000000000

• メジャーメント：cpu

• タグ：host=server01, core=0（データの取得元であるサーバーとCPUコアを識別）

• フィールド：usage_user=12.3（ユーザー空間のCPU使用率）、usage_system=5.7（システム空間の使用率）

• タイムスタンプ：1690524000000000000（2023-07-28 12:00:00 UTC）

核心概念¶

メジャーメント（Measurement）¶

メジャーメントは、同種のメトリクスの集合であり、複数のメトリクスとタグを含みます。例えば、cpu メジャーメントには usage_user、usage_system などのCPU関連メトリクスが含まれます。

メトリクス（Metric）¶

メトリクスは、システムの動作状態（CPU使用率、ページロード時間など）を反映し、メトリクス名（識別子）とメトリクス値（具体的な数値）で構成されます。

タグ（Tag）¶

データポイントの取得対象となる属性は、タグによって識別されます。タグはキーと値のペアで表現され、タグ名とタグ値から構成されます。1つのデータポイントに複数のタグを付与でき、データのフィルタリングやグループ化に使用されます。

時系列（Time Series）¶

時系列は、メトリクス名 + タグの組み合わせによって一意に識別されます。同じ時系列内では、メトリクス値（フィールド）がタイムスタンプ順に並び、系列を形成します。

時系列の数は、メトリクス名とタグの組み合わせの数に依存します。タグの新しい値が1つ増えるごとに、組み合わせの数は指数的に増加します。タグの値が多すぎると時系列が膨張し、ストレージコストとクエリパフォーマンスに直接影響を与えます。ユーザーIDやリクエストパスなどの高基数タグの使用は適切に制御することを推奨します。

フィールド（Field）¶

フィールドは、usage=58.3 のような具体的な数値メトリクスです。メトリクス値は時間とともに変化し、時系列データを形成します。

データ表示¶

メトリクスデータは、以下の形式で可視化表示されます。

• メトリクス分析：DQL、PromQL など複数のクエリ方式に基づいて、メトリクスのクエリと分析を実行します。
• メトリクス管理：メジャーメント、メトリクス、タグ、時系列の統計情報をリスト形式で表示します。
• 可視化チャート：ダッシュボードでの使用メトリクスデータを使用して、時系列グラフ、棒グラフ、円グラフなどを作成します。

はじめに¶

関連機能¶