よくある質問¶
メトリクス収集関連¶
メトリクスが正常に報告されたかどうかを確認する方法は？
以下の方法で確認できます。
- コンソール：メトリクス > メトリクス管理に移動し、対応するメジャーメントが存在するかを確認します。
- コマンドライン：
datakit monitorを実行してコレクターの動作状態を確認します。 - ログ：DataKit ログ
tail -f /var/log/datakit/logを確認します。
メトリクスデータが収集されない場合の対処方法は？
- DataKit の動作状態を確認：
systemctl status datakit - コレクターの設定が正しいか確認：
/usr/local/datakit/conf.d/ディレクトリ内の該当コレクター設定ファイル - ネットワーク接続を確認：DataKit がデータソースに正常にアクセスできるか
- DataKit のログを確認してエラーを特定
Prometheus メトリクスを Guance に接続する方法は？
次の3つの方法をサポートしています。
- Prometheus Remote Write を使用して DataKit に直接プッシュ
- Prometheus Push Gateway 経由でプッシュ
- Kubernetes に Prometheus Exporter をデプロイし、DataKit が自動収集
メトリクス管理関連¶
時系列数が多すぎるとどのような影響がありますか？
時系列数は次の項目に直接影響します。
- ストレージコスト：時系列数が多いほど、ストレージ費用が増加します。
- クエリパフォーマンス：時系列数が多いと、クエリが遅くなる可能性があります。
タグ設計を最適化し、user_id、ip などの高基数タグ（動的な値）の使用を避けることを推奨します。公式のタグ仕様では、動的タグは禁止されており、env、project などの静的なビジネスタグのみを使用してください。
メトリクスの保存期間を変更する方法は？
- グローバル設定：管理 > ワークスペース設定 > 危険な操作 > データ保存ポリシーを変更 > メトリクス
- 単一メジャーメント設定：メトリクス > メトリクス管理 > メジャーメント右側の保存ポリシーアイコンをクリック
ポリシーを変更するたびに、データの即時削除がトリガーされます。以前のポリシー下の該当メジャーメントのデータは完全に削除され、復元できません。メジャーメントのカスタム設定は、ワークスペースのグローバル設定よりも優先されます。
メトリクスの単位と説明を変更する方法は？
メトリクス > メトリクス管理に移動し、メジャーメント名をクリックしてメトリクス一覧を展開し、操作列の編集ボタンをクリックすると単位と説明を変更できます。メトリクス管理でカスタム設定した単位と説明は、デフォルトの収集データよりも優先されます。
メトリクスを生成関連¶
メトリクスを生成した後、データがクエリできないのはなぜですか？
考えられる原因：
- 生成ルールが有効になっていない
- データソースにクエリ時間範囲内のデータがない
- データの遅延が1分を超えている（生成メトリクスは1分を超える遅延のデータを統計しません）
- 「生成メトリクス設定管理権限」がない
メトリクス生成の頻度はどのように選択しますか？
- 1分：リアルタイム性が重要なユースケースに適しています（デフォルト）
- 5分：基本オブジェクトとリソースカタログに適しています（デフォルト）
- 15分：トレンド分析など、リアルタイム性が重要でないユースケースに適しています
頻度が低いほど、時系列数が少なくなり、ストレージコストも低くなります。
メトリクス生成はどのデータソースをサポートしていますか？
以下のデータソースからのメトリクス生成をサポートしています。
- ログ
- APM
- RUM
- メトリクス（既存のメトリクスに基づく新しいメトリクスの計算）
- Synthetic モニタリング
- 基本オブジェクト（ホスト、コンテナなど）
- リソースカタログ
一般質問¶
メトリクスデータはどのくらいの期間保持されますか？
デフォルトでは7日間保持され、カスタマイズが可能です。
- 商用プラン：3日、7日、14日、30日、180日、360日、720日、1080日
- デプロイメントプラン：1～1800日の任意の整数をサポート
メトリクスストレージコストを最適化する方法は？
- 保存ポリシーを適切に設定し、非核心メトリクスは保持期間を短縮する
- タグ設計を最適化し、高基数タグを避ける（動的タグ禁止のルールに従う）
- 生成メトリクスを使用して元のデータを集約し、時系列数を減らす
- 不要なメジャーメントを定期的に削除する
DQL と PromQL の違いは何ですか？
- DQL：Guance 自社開発のクエリ言語。シンプルなクエリ、式クエリをサポートし、構文は簡潔です。
- PromQL：Prometheus ネイティブのクエリ言語。メトリクスデータに対して追加でサポートされます。
どちらもメトリクス分析や可視化グラフで使用できます。