トレースオブザーバーは、デュレーションフィルタやランダムフィルタに加えて、スパン属性のトレースフィルタを使用して有用なトレースを見つけます。特定の属性を持つスパンを持つトレースを保持または破棄するように、フィルタルールをカスタマイズすることができます。
概要
フィルタルールは、個々のトレースオブザーバーに固有のキーと値のペアです。無限トレース設定アプリを使用して、それらを定義および表示します。
スパン属性のトレースフィルタでは、合計3つのルールを設定することができますが、デフォルトでは、エラーを捕捉するために2つのルールが用意されています。デフォルトの2つのエラールールを削除することもできますが、デフォルトの2つのエラールールを維持し、必要に応じて追加のルールを追加することをお勧めします。
カスタムルールの追加
これは、ユーザーsally@some_company.comを含む属性を持つスパンを持つすべてのトレースを保持するルールを追加する方法の例です。
one.newrelic.com > All capabilities > Apps > Your apps > Infinite Tracing settingsに移動します。
変更したいトレースオブザーバーについて、歯車のアイコンをクリックしてフィルターを開きます。
Create new ruleの下で、 Span keyの下に
userを入力し、 Key operatorドロップダウンで値Equalsを選択します。Span valueの下に
sally@some_company.comと入力し、 Value operatorドロップダウンでEqualsを選択します。Observer actionドロップダウンで、 Keepを選択します。
ヒント
このルールにマッチするトレースがあれば、ルールの下にリストアップされています。
カスタムルールを保存するには、 Add ruleクリックします。
カスタムルールを追加すると、そのトレースオブザーバーに対して直ちに有効になります。
ルールの優先順位
各ルールは個別に評価されます。 いずれかのルールが一致すると、そのオブザーバーアクションKeepまたはDiscardが実行されます。 トレースに、 KeepとDiscard両方のフィルター ルールに一致する属性を持つスパンが含まれる場合、トレースは破棄されます。
たとえば、エラーメッセージに特定のフレーズが含まれている一部の想定エラーを保存したくないとします。 エラーメッセージのみをターゲットにし、エラーのある他のすべてのトレースを保持するDiscardフィルター ルールを作成できます。