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

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

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

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

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

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

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

    ブール値をバケットにソートする

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

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

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

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

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

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

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

    バケット グループの作成

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

    始める前に

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

    手順

    1. 移動先 すべて > ブレークダウン > バケットグループ.
    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);
    [インシデント経過時間範囲 (日数)] という名前の新しいバケットグループを作成します。このバケットグループでは、希望の日付に開始し、次のバケットの開始時に終了するバケットのセットを定義します。たとえば、06 〜 30 日のバケットは 6 日に始まり、31 で終了します。つまり、
    06 〜 30 日のバケット
    です

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

    最後に、インシデントを分割する年齢範囲に対応する 5 つのバケットを持つバケットグループが作成されます。

    バケット グループ

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

    次のタスク

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