Splunk RUM での URL グループ化のカスタムルールの作成

Splunk RUM のカスタムルールとは？

仕様に基づいて、共通のコンポーネントを含む URL をグループ化するカスタムルールを記述します。ルールをカスタマイズすることで、お客様と組織が最も意味をなす方法で Splunk RUM 内のデータを合理化できます。パスとドメインの両方で URL をグループ化できます。

また、Splunk RUM でページレベルのメトリック（rum.node.*）を生成するためのカスタム URL グループ化ルールも必要です。

カスタムルールの作成

カスタムルールを作成するには、次の手順を実行します。

1. URL について確認してください。コンポーネントとトークンを識別します。

2. どのような結果が表示されるかを把握します。

3. パターンの構文と例を確認し、データに対して機能するルールの作成方法を理解してください。

4. デフォルトのルールを参照し、ルールを機能させるためにいずれかを非アクティブ化する必要があるかどうかを確認します。

URL のコンポーネントの識別方法

Splunk RUM の範囲内では、URL に次のコンポーネントがあります。

• scheme

• ドメイン

• path

• fragment

例

URL （https://example.com/path/page#title）について考えてみましょう。

この URL をコンポーネントに分割する方法は次のとおりです。

トークンの識別方法

Splunk RUM でのルールの記述に関して言えば、URL はドメインとパスの 2 つの部分で構成されます。トークンは、パスを示すスラッシュ（/）またはドメインを示すピリオド（.）のいずれかで区切られた、正確に 1 つの単語です。次の定義と例は、ユースケースに最適なルールを作成できるように、URL のトークンを識別する方法を示しています。

ドメイン

ドメインは、最上位ドメインとそのプレフィックス付きのサブドメインで構成されます。ホストトークンは、ピリオド記号（）で区切ります。）たとえば、 subdomain.domain.com は、 subdomain、 domain、 com の各トークンに分割されます。

パス

パスのコンポーネントは、スラッシュ記号（/）で区切ります。たとえば、 https://example.com/documentation/section/topic は 次のトークンに分割されます。Documentation 、section、 topic。

URL でのハッシュトークン（#）のサポート

単一ページアプリケーションでは、URL パスの最後にハッシュトークン（#）を使用してフラグメントを追加します。次の URL は、ハッシュ記号の後に単一ページ アプリケーションからのブログ投稿がどのようにリストされるかを示しています。https ://example.com/#/ブログpost。デフォルトでは、ハッシュ後のフラグメントは、ルールに含める指定がない限り、Splunk RUM によって無視されます。たとえば、フラグメント #title は 、https: //example.com/path/page.html#titleのパスから除外されます。

パターン構文

次の表に、パターン、このパターンに一致する URL の例、パターンに一致しない URL の例を示します。

ルールとは

ルールでは、共通の特性に基づいて URL をグループ化する方法を定義します。開始するには、最初にドメインルールを追加してから、パスルールを追加します。

パターンとは何か？

パターンは、ルールの最も重要なコンポーネントです。パターンは、ルールに一致するすべての URL によって共有される、パスまたはドメインの共通部分を定義します。パターンは、URL のドメインとパスのようなトークンでも構成されます。パターン内のワイルドカードは、URL のパスまたはドメインの実際のトークンに一致します。ワイルドカードをパターンに適用して、1 つ以上のトークンに一致させることができます。

<?>単一トークンのワイルドカード

この例は、 を使用する方法を示しています。<?>記号を使用して、パスごとに URL をグループ化する単一のトークン ワイルドカードを適用できます。

<??>1 つ以上の末尾のトークンのワイルドカード

この例は、 を使用する方法を示しています。<??>ワイルドカードを使用して、1 つまたは複数のトークンで URL をグループ化できます。、<??>ワイルドカードは、現時点ではパターンの最後のワイルドカードとしてのみサポートされています。

組み合わせパターン

次に、ワイルドカードの組み合わせを使用して複数のトークンのパターンで URL をグループ化する例を示します。

無効な構文

次の構文は無効です。

デフォルトルール

RUM には 、 [データ管理（Data Management）] の [RUM URL グループ化（RUM URL grouping）]タブにあるいくつかのデフォルトルールがあります。デフォルトルールと競合するルールを作成する場合は、デフォルトルールをグローバルに、またはアプリケーションごとに非アクティブにできます。

例

このアスタリスク ワイルドカード（ * ） は、/app/で始まるすべてのパスと一致します。

例

ワイルドカード W* は、 数字が含まれていないトークンに適用されます。このパターンは 、/app/ で始まり、数字のないトークンが続くすべてのパスと一致します。

ユースケース

次の例は、解決するユースケースに応じて URL をグループ化するためにルールを適用する方法の概要を示しています。

を使用します<?>製品 ID 別に URL をグループ化するワイルドカード

オンライン小売業者が、製品 ID によって URL をグループ化するとします。この例では、製品 ID は、URL のパスの /merchance/ の 後の文字と数字の組み合わせです。

この例では、まず次のようなドメインルールを作成する必要があります。

次に、パスルールを作成します。

を使用します<?>サブドメインでグループ化するワイルドカード

この例は、 を使用する方法を示しています。<?>同じサブドメインで URL をグループ化するためのワイルドカード。

たとえば、次のルールを作成する方法を示します。

を使用します<??>文字列でグループ化するワイルドカード

任意の関数について、v1 および v2 API 全体のパフォーマンスを測定するとします。このルールでは、<??>パスの残りの部分をワイルドカード化します。

たとえば、次のルールを作成する方法を示します。

URL グループ化ルールの管理

UI では、ホストルールとパスルールを組み合わせて URL 名が作成されます。スパンは Splunk RUM で 8 日間保持されます。詳細については、 「Splunk Observability Cloud でのデータ保持」を参照してください。ルールの変更は、着信データにのみ適用されます。

新規ルールを作成

新しい規則を作成するには、次の手順を実行します。

1. Splunk RUM URL ルールマネージャにアクセスするには、次の 4 つの方法があります。

   1. 左側のナビゲーションパネルから、[Application Summary] ダッシュボードで [RUM > Configuration > ] [RUM URL Grouping Rules] を選択します。

   2. 左側のナビゲーションパネルから、[データ構成（Data Configuration）] で [設定（Settings）] > [RUM URLグループ化ルール（RUM URL grouping Rules）] を選択します。

   3. [RUM Overview] ダッシュボードから、 [RUM Configuration] > [RUM URL Grouping Rules]を選択します。

   4. [RUM Tag] スポットライトビューから、3 点ドットの設定ボタンを選択した後、 [RUM] [URL Grouping Rules] を選択します。

2. [新しいルール（New Rule）]を選択します。

3. ルールを作成する URL トークンを選択します。

4. モニターするアプリケーションを選択します。アプリケーションを選択しない場合、ルールはすべてに適用されます。

5. URL をグループ化するパターンを記述します。

6. [作成（Create）] を選択します。

既存のルールの編集

既存のルールを編集するには、次の手順を実行します。

1. RUM URL ルールマネージャに移動します。

2. 3 つのドット記号を選択し、 [編集（Edit）] を選択します。

3. 変更を加えてから、 [更新（Update）]を選択します。

ルールの非アクティブ化または再アクティブ化

既存のルールを非アクティブ化または再アクティブ化するには、次の手順に従います。ルールを非アクティブ化すると、Splunk RUM はこのルールに従って着信データの処理を停止します。ルールを非アクティブ化し、将来再度アクティブ化することを選択した場合、ルールは Splunk RUM によってすでに取り込まれているデータには適用されません。

1. RUM URL ルールマネージャに移動します。

2. 3 つのドット記号を選択し、 [編集（Edit）] を選択します。

   1. ルールをアクティブ化するには、 [アクティブ化（Activate）]を選択します。

   2. ルールを非アクティブ化するには、 [はい、このルールを非アクティブ化します（Yes, deactivate this rule）]を選択します。

削除

ルールを削除するには、次の手順を実行します。

1. RUM URL ルールマネージャに移動します。

2. 3 つのドット記号を選択し、 [編集（Edit）] > [削除（Delete）] > [はい、このルールを削除します（Yes, delete this rule）]を選択します。