ビジネスワークフロールールの設定 🔗
Enterprise Editionで利用できる機能です
ビジネスワークフロールールでは、トランザクション処理におけるトレースの動作を明示的かつ透過的にするために、スパンタグを使用します。特定のサービスからのトレース、または同一のグローバルスパンタグを含む複数のサービスからのトレースを関連付けるルールを作成できます。
[ビジネスワークフロー]ページには、「すべてのトレースは、そのトレースの開始操作によって識別されるワークフローに関連付けられる」という、システムが生成したルールがデフォルトで含まれています。これは唯一のデフォルトルールです。このデフォルトルールを編集することはできませんが、無効にすることはできます。
前提条件 🔗
ビジネスワークフロールールを設定するには、adminロールが必要です。
スパンタグを使用するビジネスワークフロールールを作成するには、最初にタグをインデックス化する必要があります。スパンタグをインデックス化する手順については、スパンタグをインデックス化してTroubleshooting MetricSetsを作成する を参照してください。
ルールを設定する 🔗
Splunk APMから新しいルールを設定するには、以下の手順に従ってください。ルールの有効化と適用には違いがあります。有効化/無効化スイッチは、オンオフを切り替えることで、個々のルールのオン/オフに影響します。1つまたは複数のルールを変更したら、ルールセット全体に作用するボタンを使用して変更を保存または破棄します。保存しない限り、変更は適用されません。
Data Configuration、Business Workflow の順に移動します。
新規ルール を選択します。
ルールタイプ のメニューから、以下のいずれかのオプションを選択します：
オプション
説明
グローバルタグ
トレースに関連付けられたスパンのグローバルタグの値に基づいてワークフローを定義します。これにより、そのグローバルタグを持つスパンを含むトレースが関連付けられます。
サービス
選択したサービスを含むトレースに基づいてワークフローを定義します。トレースがルールに一致すると、指定したタグ値またはそのサービスのトレースに関連付けられているエンドポイントも表示されます。
選択した Target Global Tag にしたがって、Target Service または Rule Type を選択します。
ターゲットグローバルタグ の場合、インデックス済みのグローバルタグを選択するように促すプロンプトが表示されます。タグを選択すると、そのグローバルタグを持つすべてのトレースがルールによって関連付けられます。スパンタグを使用するビジネスワークフロールールを作成するには、最初にタグをインデックス化する必要があります。スパンタグをインデックス化する手順については、スパンタグをインデックス化してTroubleshooting MetricSetsを作成する を参照してください。
ターゲットサービス の場合、サービスの選択と、このワークフローに関して確認する追加のメタデータである ワークフローのソース名 の入力を促すプロンプトが表示されます。開始スパンのエンドポイントまたはスパンタグ値によるサービスのトレースの関連付けを選択できます。スパンタグを使用するビジネスワークフロールールを作成するには、最初にタグをインデックス化する必要があります。スパンタグをインデックス化する手順については、スパンタグをインデックス化してTroubleshooting MetricSetsを作成する を参照してください。
作成 を選択して変更を保存し、ルールを作成します。
ルールのリストを表示して、作成したルールが有効になっていることを確認します。
デフォルトでは、最も新しいルールの優先度が最も高くなります。これは、Splunk APMが他のルールを適用する前に新しいルールを適用するということです。他に先に適用したいルールがある場合は、新しいルールの優先度を調整してください。
変更を保存 を選択し、新しいルールと優先度リストを適用します。
デフォルトルールを使用するタイミング 🔗
トレースの開始操作が、例えばAPIコールを使ったワークフローのような意味のあるワークフローをキャプチャするのに十分な粒度である場合、デフォルトルールを使うと、他の開始操作とは異なるそのトレースの開始操作によって関連トレースをグループ化するので便利です。
ゲートウェイが存在するなどの理由により、多くのトレースが同じ開始操作を持つシステムでは、その開始操作以外のサービスからビジネスワークフロー名を抽出した方が良いでしょう。この場合、service: endpoint または service name のどちらかをビジネスワークフローに使用することができます。
ルールの動作と制限 🔗
ルールの部分的な変更が予期せぬ結果を生む可能性を減らすため、ルールに対する変更は1回のコンピューティングセッションを通じて蓄積され、変更を適用 を選択したときに一括して適用されます。変更には以下のすべてが含まれます：
ルールの作成
ルールの編集
ルールの削除または無効化
ビジネスワークフローの設定UIは、ルールがアクティブであるかどうかに関係なく、1から n までの連続した順序で番号付けされたルールを表示します。各トレースは1つのワークフロールールにのみ属するため、優先度が重要になります。複数のルールが同じトレースに適用可能な場合、そのトレースは最も優先度の高いルールに適合させられます。ルールの作成と設定は、以下のプロパティによって支配されます：
ルール数の上限は99です。
ルールの内容に影響を与えることなく、トグルスイッチを使ってルールのオン/オフを切り替えることができます。
UIで上下矢印を使用して、ルールをリスト内で上下に移動すると、他のルールとの相対的なルール優先度が変更されます。リストの先頭にあるルールの優先度が、リストの末尾にあるルールよりも高くなります。
Matched service:endpointの命名規則について、トレースにサービスの複数のエンドポイントが含まれる場合は、最も古いサービスエンドポイントスパンがワークフロー名に使用されます。Tag valueの命名規則について、サービスが、トレース内の複数のスパンで、選択したタグにさまざまな値をもって出現する場合、最も古い出現がワークフロー名に使用されます。