ブレークダウンソースのバケットグループ

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:5分
  • バケットグループ たとえば、値の範囲を個別のバケットにグループ化することで、データを分類してブレークダウンとして使用できるようにするために使用されます。

    データアーキテクチャでは、バケットグループはバケットグループ [pa_bucket_groups] レコードで、バケットはバケット [pa_buckets] レコードで定義されます。各バケット [pa_buckets] レコードには、バケット グループ [pa_bucket_groups] レコードへの参照であるバケットグループフィールドが含まれています。

    バケットグループを操作するには、バケット [pa_buckets] をファクトテーブルとして使用し、条件でバケットグループを指定するブレークダウンソースを作成します。このソースに基づいて構築されたブレークダウンがスクリプトを含むブレークダウンマッピングを使用する場合、ブレークダウンはスクリプトが返す値をバケットにグループ化します。ブレークダウンマッピングでスクリプトを使用する代わりにフィールドを指定すると、ブレークダウンはマッピングされたフィールドの値をバケットにグループ化します。

    フィールド値のバケットへのグループ化

    スクリプトを使用しないブレークダウンマッピングでバケットグループを使用して、バケットにマップされたフィールドの値をグループ化できます。

    ユースケースは、ブール値の true 値と false 値を意味のあるラベルを持つ 2 つのバケットに変換するのと同じくらい簡単です。

    ブール値のバケットへのソート

    基本 パフォーマンスアナリティクス インストールには、アナリティクス使用率の概要の一部としてアクティブブレークダウンが含まれています。このブレークダウンでは、ジョブログ [pa_jobs_logs] テーブルの job.active ブールフィールドへのマッピングを使用します。ブレークダウンソースは、job.active の true 値はアクティブなバケットにソートされ、 false の値は非アクティブなバケットにソートされるバケットグループを使用します。false 値は数値的には 1 未満の値と見なされますが、true 値は数値的には 1 以上であることに注意してください。

    非アクティブバケットとアクティブバケット、およびその範囲を示すバケットグループフォーム

    スクリプトの結果をバケットにグループ化

    値の範囲を収集するブレークダウンマッピングスクリプトがある場合は、それらの値を個別のバケットに分割するバケットグループを定義できます。

    バケットグループを作成したら、バケットグループに基づいてブレークダウンソースを作成します。次に、そのブレークダウンソースを使用するブレークダウンを作成します。ブレークダウンのブレークダウンマッピングを作成するときは、マッピングのスクリプトを定義または選択します。ブレークダウンは、スクリプトが返す結果をバケットグループのバケットにグループ化します。例については、「例:スクリプト マッピング」を参照してください。

    既存のスクリプトのバケットグループを記述することも、最初にバケットグループを作成してからスクリプトを作成することもできます。ブレークダウンを作成するには、両方が存在する必要があります。

    注:
    同じスクリプトを任意の数のバケットグループで使用できます。また、原則として、同じ種類のデータを返すスクリプトを同じバケットグループで使用できます。

    バケット グループの作成

    データを再分類するバケットのグループを指定します。

    始める前に

    必要なロール:pa_data_collector または admin

    手順

    1. 次のように移動する。 All (すべて) > ブレークダウン > バケットグループ.
    2. [New] をクリックします。
    3. バケット グループを明確に特定する名前 (経過範囲 (日数) など) を入力します。
    4. [新規行を挿入] をダブルクリックし、新しいバケットを追加します。
    5. 最初のバケットに名前を入力し、Enter キーを押すか、緑のチェック アイコンをクリックします。
    6. [開始] および [終了] 列をダブルクリックし、開始値と終了値を入力します。
      終了値と一致するレコードはバケットから除外されます。したがって、1 つのバケットの終了値と次のバケットの開始値を同じ値に設定します。その値と完全に一致するレコードは、その値を開始値として持つバケットにソートされます。
      警告:
      1 つのバケットの終了値が次のバケットの開始値と一致しない場合、レコードがどのバケットにもソートされない「ホール」が発生します。たとえば、終了が 20 のバケットがあり、次のバケットが 21 で開始する場合、スクリプトが 20.0000~ から 20.9999~ の値を返すレコードは、どのバケットにもソートされません。
    7. すべてのバケット範囲を定義した後、[送信] をクリックします。

    インシデント経過時間範囲バケットグループ

    次のように、インシデントを経過時間別にグループ化する場合を考えてみましょう。
    • 1 日未満
    • 1 〜 5 日
    • 6 〜 30 日
    • 31 〜 90 日
    • 90 日を超える
    メンテナンス パフォーマンスアナリティクス > スクリプトの場合、Incident.Age.Days という名前のスクリプトが既に存在します。このスクリプトは、インシデントの開始日とスコアが収集された最新の日付から、インシデントの経過時間 (日数) を導き出します。
    var diff=function(x,y){return y.dateNumericValue() - x.dateNumericValue();};
    var days=function(x,y){return diff(x,y)/(24*60*60*1000);};
    days(current.opened_at, score_end);
    「インシデント経過時間範囲 (日数)」という名前の新しいバケットグループを作成します。このバケットグループでは、希望の日付に開始し、次のバケットの開始時に終了する一連のバケットを定義します。たとえば、6 〜 30 日のバケットは 6 から始まり、31 日に終了します。これは 6
    〜 30 日のバケットです

    このバケットには、正確な 6 日から 30 日と 23 時間 59 分 59 秒までのインシデントが含まれます。

    最後に、インシデントを分割する経過時間範囲に対応する 5 つのバケットを含むバケットグループが作成されます。

    バケット グループ

    スクリプトマッピングの例は、このバケットグループとスクリプトを使用するブレークダウンを示しています。

    次のタスク

    バケット [pa_buckets] ファクトテーブル、Sys ID フィールド、および条件 [バケットグループ][次の値に等しい][<作成したバケットグループの名前>] を使用するブレークダウンソースを作成します。次に、このブレークダウンソースを使用し、ブレークダウンマッピングに関連するスクリプトを使用するブレークダウンを作成します。