デプロイ実行ファセット

Docs > Continuous Delivery Visibility > Continuous Delivery Visibility Explorer > デプロイ実行ファセット

プレビューに参加!

CD Visibility はプレビュー中です。この機能に興味がある場合は、フォームに入力してアクセスをリクエストしてください。

概要

ファセットは、パイプラインから取得したユーザー定義のタグと属性です。定性と定量の両方のデータ分析に活用できます。ファセットを使うと、ダッシュボードやノートブックに表示される検索クエリ上で、デプロイを柔軟に操作できます。

ファセットの作成は、デプロイ実行を検索するうえで 必須ではありません。オートコンプリートは既存のファセットも利用しますが、受信しているデプロイ実行に一致する入力であれば、ファセットがなくても適用されます。

Deployment Executions ページには、Environment、Deployment Status、Deployment Provider など、標準で用意されたファセットが含まれています。CD Visibility Explorer では、ファセットを使って次のことができます:

デプロイ実行を検索してフィルタリングする
デプロイや環境の分析を行う
デプロイ完了後のトラブルシューティングを開始する

Software Delivery > CD Visibility > Executions に移動すると、デプロイ実行リストの左側に表示されるファセット一覧にアクセスできます。

定性ファセット

定性ファセットは、次のような場合に使用します:

値の相対的な傾向 を把握したい
ユニーク値を数えたい
特定の値に対してデプロイ実行を頻繁に フィルタ したいたとえば、環境タグのファセットを使えば、トラブルシューティングの対象を development、staging、production といった環境に絞り込めます。

注: タグでフィルタするだけならファセットは必須ではありません。ただし、調査でよく使うタグにファセットを定義しておくと、解決までの時間を短縮できます。

定量メジャー

定量メジャーは、次のような場合に使用します:

複数のデプロイ実行から値を集計したい
値の範囲でデプロイ実行を レンジフィルタ したい
その値でデプロイ実行を ソート したい

タイプ

メジャーは long (整数) または double (小数) のいずれかの型を取り、どちらの型でも同等の機能を利用できます。

単位

メジャーは、クエリ実行時と表示時に値の桁違いを扱えるよう、単位をサポートしています (秒単位の time、バイト単位の size)。単位はフィールドの性質ではなく、メジャー自体のプロパティです。

たとえば、ナノ秒で記録される duration メジャーを考えます。env:staging のデプロイでは duration:10000000 (10 ミリ秒)、env:qa のデプロイでは duration:5000000 (5 ミリ秒) という値だとします。duration:>2ms を使えば、両方の環境にまたがって、同じ条件でデプロイ実行タグをまとめてクエリできます。検索クエリの詳細は検索構文を参照してください。

ファセットパネル

検索バーは、データをフィルタリングしたりグループ化したりするための最も多機能な操作手段です。一方で、多くのケースでは、ファセットパネルの方がシンプルにデータをたどれます。ファセットを開くと、現在のクエリ範囲における内容のサマリーが表示されます。

検索バーと URL には、ファセットパネルでの選択内容が自動的に反映されます。

Facets (定性) には、ユニーク値の上位リストと、それぞれに一致するデプロイ実行数が表示されます。
Measures (定量) には、最小値と最大値を示すスライダーが表示されます。スライダーを動かすか数値を入力して、検索クエリの上下限を指定できます。

ファセットのグルーピング

ファセットは、ファセットリスト内で意味のあるテーマごとにグループ化されています。ファセットにグループを割り当てたり変更したりしても、影響するのはファセットリストの表示だけで、検索や分析には影響しません。

ファセットのフィルタリング

ファセットパネルの Search facets ボックスを使うと、ファセットリスト全体を絞り込み、操作したいファセットへ素早く移動できます。Search facets は、ファセットの表示名とフィールド名を使って結果を絞り込みます。

ファセットの作成

デプロイ実行の属性やタグに対してファセットを作成しなくても、デプロイ実行の検索はできます。ただし、特定のデプロイ実行属性に分かりやすい説明を付けたいときや、属性値を Facets リストに表示したいときにはファセットが役立ちます。

Deployment Details サイドパネルからファセットを作成する

Deployment Details サイドパネルから作成すると、ファセットの詳細の多くがあらかじめ入力された状態になります。

ファセット化したいフィールドを含むデプロイ実行を、Deployment Executions ページで開きます。
一覧から対象のデプロイ実行を選択して、Deployment Details サイドパネルを開きます。
目的のフィールドをクリックし、そこからファセットを作成します:
- フィールドが数値の場合は、ファセットまたはメジャーのどちらでも作成できます。
- フィールドが文字列の場合は、ファセットのみ作成できます。