ClickStack よくある質問

ClickStack は 2 種類のアラートをサポートしています。

• 検索アラート: 一定時間内に一致したログまたはトレースの件数がしきい値を上回る、または下回ると通知を送信します。
• ダッシュボードチャートアラート: ダッシュボードタイルにプロットされたメトリクスが定義したしきい値を超えると通知を送信します。

どちらのアラートタイプも、静的なしきい値条件を使用します。詳細については、アラート を参照してください。

2 つのメトリクスの比率、p95、p99 の値は、チャートビルダー UI を使ってダッシュボードタイルにプロットできます。続いて、それらのタイルにしきい値ベースのアラートを作成できます。

ただし、現時点で ClickStack は以下をサポートしていません。

• メトリクス向けのカスタム SQL クエリに対するアラート。
• 複数条件または複数メトリクスのアラートルールを 1 つのアラートにまとめること。
• 動的なアラート条件や異常検知ベースのアラート条件 (異常検知は今後対応予定です)。

複雑なメトリクスに対してアラートを設定する必要がある場合は、まず可視化をダッシュボードチャートとして作成し、そのチャートにしきい値アラートを追加する方法を推奨します。

materialized view は、該当する場合、ClickStack のアラートで自動的に使用されます。ただし、現時点では OpenTelemetry のメトリクスデータソースで materialized view はサポートされていません。メトリクスについては、ClickStack はデフォルトの ClickHouse OpenTelemetry metrics schema で最も適切に動作します。materialized view の詳細については、Materialized views を参照してください。

はい。ClickStack は、ClickHouse からクエリしたデータで値が設定される、カスタムフィルターおよび変数によってパラメータ化されたダッシュボードをサポートしています。これらのフィルターを使うと、ダッシュボード上の一部またはすべてのタイルを特定の値 (たとえば、サービス名、環境、ホスト) に動的に絞り込めます。

ダッシュボードの作成方法やフィルターの適用方法について詳しくは、ダッシュボード を参照してください。

ClickStack は、次のドリルダウンワークフローをサポートしています。

• ダッシュボードレベルのフィルタリング: ダッシュボードレベルで適用した Lucene または SQL のフィルターと時間範囲の調整は、すべてのタイルに反映されます。
• カスタムダッシュボードフィルター: カスタムダッシュボードでは、データ内の値が設定される明示的なフィルターコントロールをサポートしており、ユーザーは手動でクエリを書かなくても、すべてのタイルを絞り込めます。
• クリックしてイベントを表示: ダッシュボードタイル内のデータをクリックして View Events を選択すると、ログおよびトレースデータに関連するフィルターが適用された Search ページに移動します。
• テーブルの行クリックによるドリルダウン: テーブルタイルは、行をクリックすると Search ページまたは別のダッシュボードが開き、その行の値がフィルターとして引き継がれるよう設定できます。これにより、サービス一覧からサービスごとの詳細ダッシュボードにドリルダウンするといった、多段階のワークフローをサポートできます。
• 組み込みダッシュボードのドリルダウン: Services、ClickHouse、Kubernetes の各ダッシュボードには、タブをまたいで移動できる、より充実した組み込みのドリルダウンナビゲーションが含まれています。

メトリクス名は、チャートビルダー のメトリクス名ドロップダウンから確認できます。メトリクスを選択すると、Metric Attribute Explorer パネルに、そのメトリクスの説明、単位、利用可能な属性とその値が表示されます。これにより、属性を参照し、パネルから直接フィルターやグループ化フィールドとして追加できます。

現時点では、ログ検索のような専用のメトリクス検索ページはありません。メトリクス検出の改善は、現在も積極的に進められている開発分野です。

いいえ。現時点では SQL クエリを使ってメトリクスを検出できますが、これは長期的に想定されている方法ではありません。より優れたメトリクス検出ツールの開発が積極的に進められています。