よくある質問¶
ダッシュボード¶
Guance が提供する Grafana dashboard json template を Guance ダッシュボード JSON テンプレートに変換する Node スクリプトはありますか？
npm ダウンロード：
使用方法：
$ npm install -g @cloudcare/guance-front-tools
# 使用方法を表示
$ grafanaCovertToGuance
# タスクを実行
$ grafanaCovertToGuance -d examples/grafana.json -o examples/guance.json
Keywords：
none
エクスプローラー¶
エクスプローラーの検索バーで JSON 形式が使用できないのはなぜですか？
JSON 検索を使用するには、次の 3 つの条件を満たす必要があります。
- サイトが「中国リージョン1（杭州）」、「中国リージョン3（張家口）」、または「中国リージョン4（広州）」であること
- ワークスペースが
2022年6月23日以降に作成されていること - ログエクスプローラーでのみ使用可能です
定期レポート¶
定期レポートのメールでエラー 414 が発生するのはなぜですか？
送信先のメールボックスに最終的に送信される定期レポートでは、画像リンクは、ダッシュボードの対応するチャートのビュー変数などのパラメータを繰り返し結合して生成されます。ビュー変数の内容が長すぎる場合、生成される画像リンクが長くなり、414 エラーが発生する可能性があります。
組み込みビュー¶
バインドしたのに詳細ページに表示されないのはなぜですか？
以下を確認してください：
- バインドしているのがユーザービューであることを確認してください（システムビューの場合は、先にクローンが必要です）
- フィールド名と
valueの値がエクスプローラーのデータと一致していることを確認してください valueのマッチングパターンが正しいか確認してください（ワイルドカード*と具体的な値の比較）
1 つのエクスプローラーに複数のビューをバインドできますか？
はい。複数のフィールドが異なるビューにマッチした場合、優先順位に従って表示されます。同じフィールドが複数のビューにマッチした場合、最初のビューのみが表示されます。
チャートに「データがありません」と表示されるのはなぜですか？
考えられる原因：
- 時間範囲の選択が適切でない。時間範囲を広げてみてください
- フィルター条件が厳しすぎる。タグとキーワードが正しいか確認してください
- データがまだ報告されていない。DataKit 収集機能が正常に動作しているか確認してください
チャートの「時間を固定」とはどういう意味ですか？
時間を固定とは、そのチャートが特定の時間帯のデータを固定的にクエリすることを意味し、ダッシュボード上部の時間選択器の変更に影響を受けません。過去のベースラインデータとの比較に適しています。
複合チャートと単一チャートの違いは何ですか？
複合チャートは、複数のチャートを 1 つのカード内に配置し、タブで切り替えて表示するため、スペースを節約し、関連分析を容易にします。同じ指標の異なる次元の比較（例：CPU 使用率の TOP10 コンテナと TOP10 プロセス）に適しています。
ビュー変数はどのように設定すれば有効になりますか？
ビュー変数を作成した後、チャートクエリでその変数を参照（例：host::tag）する必要があります。そうすることで、チャートの右上隅にフィルタリングドロップダウンボックスが表示されます。
共有したチャートリンクを他の人が開けない場合はどうすればいいですか？
共有設定を確認してください：
- 「公開共有」が選択されていることを確認し、「暗号化共有」ではないことを確認してください
- リンクが有効期限内であるか確認してください
- 相手のネットワークがコンソールにアクセスできるか確認してください
エクスプローラー¶
エクスプローラーの検索バーで JSON 形式が使用できないのはなぜですか？
JSON 検索を使用するには、次の 3 つの条件を満たす必要があります。
- サイトが「中国リージョン1（杭州）」、「中国リージョン3（張家口）」、または「中国リージョン4（広州）」であること
- ワークスペースが
2022年6月23日以降に作成されていること - ログエクスプローラーでのみ使用可能です
エクスプローラーとダッシュボードのユースケースの違いは何ですか？
| 次元 | ダッシュボード | エクスプローラー |
|---|---|---|
| データ粒度 | 集計データ（トレンド、統計値） | 明細データ（個別ログ、個別トレース） |
| 主な用途 | 監視概要、トレンド分析、レポート表示など | 障害調査、セキュリティ監査、データ探索など |
| 対話モード | 可視化チャート、変数フィルタリングなど | 検索フィルタリング、ハイライト、コンテキスト展開など |
エクスプローラーのフィルター条件とダッシュボードのフィルター条件が連携しないのはなぜですか？
エクスプローラーのフィルタリングは、現在のエクスプローラーページにのみ作用します。ダッシュボードのフィルタリング（ビュー変数）は、そのダッシュボード内のすべてのチャートに作用します。両者は独立しています。
チャートに「データがありません」と表示されるのはなぜですか？
考えられる原因：
- 時間範囲の選択が適切でない。時間範囲を広げてみてください
- フィルター条件が厳しすぎる。タグとキーワードが正しいか確認してください
- データがまだ報告されていない。DataKit 収集機能が正常に動作しているか確認してください
チャートの「時間を固定」とはどういう意味ですか？
時間を固定とは、そのチャートが特定の時間帯のデータを固定的にクエリすることを意味し、ダッシュボード上部の時間選択器の変更に影響を受けません。過去のベースラインデータとの比較に適しています。
複合チャートと単一チャートの違いは何ですか？
複合チャートは、複数のチャートを 1 つのカード内に配置し、タブで切り替えて表示するため、スペースを節約し、関連分析を容易にします。同じ指標の異なる次元の比較（例：CPU 使用率の TOP10 コンテナと TOP10 プロセス）に適しています。
ビュー変数はどのように設定すれば有効になりますか？
ビュー変数を作成した後、チャートクエリでその変数を参照（例：host::tag）する必要があります。そうすることで、チャートの右上隅にフィルタリングドロップダウンボックスが表示されます。
共有したチャートリンクを他の人が開けない場合はどうすればいいですか？
共有設定を確認してください：
- 「公開共有」が選択されていることを確認し、「暗号化共有」ではないことを確認してください
- リンクが有効期限内であるか確認してください
- 相手のネットワークがコンソールにアクセスできるか確認してください
エクスプローラー¶
エクスプローラーの検索バーで JSON 形式が使用できないのはなぜですか？
JSON 検索を使用するには、次の 3 つの条件を満たす必要があります。
- サイトが「中国リージョン1（杭州）」、「中国リージョン3（張家口）」、または「中国リージョン4（広州）」であること
- ワークスペースが
2022年6月23日以降に作成されていること - ログエクスプローラーでのみ使用可能です
エクスプローラーとダッシュボードのユースケースの違いは何ですか？
| 次元 | ダッシュボード | エクスプローラー |
|---|---|---|
| データ粒度 | 集計データ（トレンド、統計値） | 明細データ（個別ログ、個別トレース） |
| 主な用途 | 監視概要、トレンド分析、レポート表示など | 障害調査、セキュリティ監査、データ探索など |
| 対話モード | 可視化チャート、変数フィルタリングなど | 検索フィルタリング、ハイライト、コンテキスト展開など |
エクスプローラーのフィルター条件とダッシュボードのフィルター条件が連携しないのはなぜですか？
エクスプローラーのフィルタリングは、現在のエクスプローラーページにのみ作用します。ダッシュボードのフィルタリング（ビュー変数）は、そのダッシュボード内のすべてのチャートに作用します。両者は独立しています。
特定のホストのすべてのログを素早く見つけるにはどうすればいいですか？
ログエクスプローラーの検索ボックスに host:ホスト名 と入力するか、ホストリストの「ログを表示」ショートカットをクリックしてください。
定期レポート¶
定期レポートのメールでエラー 414 が発生するのはなぜですか？
送信先のメールボックスに最終的に送信される定期レポートでは、画像リンクは、ダッシュボードの対応するチャートのビュー変数などのパラメータを繰り返し結合して生成されます。ビュー変数の内容が長すぎる場合、生成される画像リンクが長くなり、414 エラーが発生する可能性があります。
レポートを送信したのにメールが届かない場合はどうすればいいですか？
以下を確認してください：
- 通知先のメールアドレスが正しいかどうか
- メールがスパムフォルダに振り分けられていないかどうか
- ダッシュボード内にデータ量が多すぎるチャートが含まれていて、生成に失敗していないかどうか
レポート内のチャートが空白で表示されるのはなぜですか？
通常、データクエリの時間範囲が長すぎるか、チャートの計算が複雑で生成がタイムアウトしたことが原因です。時間範囲を狭めるか、クエリ条件を簡略化することをお勧めします。
組み込みビュー¶
バインドしたのに詳細ページに表示されないのはなぜですか？
以下を確認してください：
- バインドしているのがユーザービューであることを確認してください（システムビューの場合は、先にクローンが必要です）
- フィールド名と
valueの値がエクスプローラーのデータと一致していることを確認してください valueのマッチングパターンが正しいか確認してください（ワイルドカード*と具体的な値の比較）
1 つのエクスプローラーに複数のビューをバインドできますか？
はい。複数のフィールドが異なるビューにマッチした場合、優先順位に従って表示されます。同じフィールドが複数のビューにマッチした場合、最初のビューのみが表示されます。
バインド後のビューの時間範囲は調整できますか？
ビューはデフォルトで「最近 15 分」を表示しますが、ビュー内で手動で時間範囲を調整できます。調整は現在の表示にのみ影響し、保存はされません。
ノート¶
ノートに挿入したチャートのデータはリアルタイムで更新されますか？
いいえ。ノートに挿入する時点でチャートはクエリ結果を保存し、その後のデータ変更は自動的に同期されません。最新のデータが必要な場合は、チャートを再挿入する必要があります。
エクスポートしたノートの JSON は他のワークスペースで使用できますか？
はい。「ノート JSON をインポート」機能を使用して、ノートを他のワークスペースに移行できますが、関連するデータソースは再設定する必要があります。
その他¶
P99 のピーク値計算ロジックの説明
Guance は、一定期間内の特定の指標のすべての値を取得し、これらの値を小さい順に並べ替え、データポイント数 * 99% に基づいて P99 に対応するデータポイントの位置を特定し、その位置の値を返します。ここでいう「すべての値」とは、データベースに保存されている元のデータポイントを指します。
指標データのパーセンタイルクエリについて、Guance の処理方法は使用するデータエンジンによって異なります。データベース自体がパーセンタイルクエリ機能をサポートしていない場合、Guance はコードを使用してデータをローカルに取得し、追加処理を行うことでこの機能を実現します。一方、指標以外のデータ（ログ、APM、RUM など）のパーセンタイルクエリは、データベースのネイティブ機能によってサポートされています。
スナップショットとスクリーンショットの違いは何ですか？
スナップショットは操作可能なデータ状態（時間の切り替え、ドリルダウン分析をサポート）を保存しますが、スクリーンショットは静的画像にすぎません。問題を共有して調査する場合は、スナップショットを使用することをお勧めします。