APMサンプリングを構成するには、次の方法を使用できます:

• 単一ルール・プロパティ: すべてのトレースに適用可能な1つのルールを定義するための簡単な方法です。
• 構成ファイル: 分岐ルールや操作優先度ルールを含むサンプリングを定義するための包括的な方法です。

次の2つのサンプリング戦略があります:

• サンプリング: samplingエントリを使用し、トレース評価用のルール・ツリーを定義します。
• 操作優先度: operation_priorityエントリを使用します。これを定義すると、定義した名前とトレース・ルート・スパン操作名が一致した場合にサンプリングが上書きされます。定義された各操作名は、それぞれ独自の決定ルール・ツリーを持ちます。

• サービス・ノード(service:)が指定されていない場合、サンプリング構成は、専用のサンプリング構成なしですべてのサービスに適用されます。複数の構成が同じサービス名を持つ場合、そのサービス名を持つ最後の構成のみが使用されます。

  1つのファイルに、このサービス・ノードを使用する構成と使用しない構成がある場合、APMエージェントまたはAPMトレーサ・サービス名に一致するサービス名を持つ構成が優先されます。

• sampling (sampling:)ノードとoperation_priority (operation_priority:)ノードの両方が指定されている場合、operation_priorityが優先されます。トレース・ルート・スパン名がoperation_priorityノードの操作名と一致した場合、その操作名に関連付けられたルールを使用して評価されます。トレース・ルート・スパン名がoperation_priorityノードの操作名と一致しなかった場合は、サンプリング・ノードが評価されます。

• If sampling node (sampling:) is not specified, or no rule is specified, then the trace is not sampled when no operation_priority rule is applicable.

• operation_priorityノード(operation_priority:)が指定されている場合、トレース・ルート・スパンの操作名がいずれかのoperation_priority操作名と一致すると、ベース・サンプリング・ルールではなく一致名のルールが評価に使用されます。

• ルール・ノード
• ソース値

1. すべてのサービスに適用されるルール

   sampling_config:
     -
        sampling:
          # Every trace has 2% chance to be sampled.
          rule: probabilistic
          param: 0.02

2. probabilistic (最小件数あり)

   sampling_config:
     -
        sampling:
         # For every 60 seconds duration, 5 root spans of each operation name are sampled,
         # followed by 10% chance of sampling.
         rule: per-operation-rate
         param: 5/60
         true:
         false:
           rule: probabilistic
           param: 0.1

3. 指定した操作のみのサンプリング

   sampling_config:
     -
        service:
           - order_dept
           - shipping_dept
        operation_priority:
          # For /order operation trace root span, 1 of every 10 traces is sampled.
          - name: "/order"
            rule: constant
            param: 10
          # For /ship operation trace root span, 1 of every 50 traces is sampled.
          - name: "/ship"
            rule: constant
            param: 50
          # For /status_order or /status_ship operations, there is a 50% sampling chance.
          - regex: "/status_(order|ship)"
            rule: probabilistic
            param: 0.5

4. その他のサンプル例

   sampling_config:
     -
       # With service node, this config is only applied to service s1 and s2.
       service:
         - s1
         - s2
       sampling:
         # 5 root span of any operation name are sampled every 60 seconds. Starting from
         # the 6th span of an operation name, there is a 20% chance the span is sampled.
         rule: per-operation-rate
         param: 5/60
         false:
           rule: probabilistic
           param: 0.2
       operation_priority:
         # For /order operation, 1 of every 10 spans is sampled.
         - name: "/order"
           rule: constant
           param: 10
         # For /ship operation, first 3 are sampled per 60 seconds and then 10% chance after
         - name: "/ship"
           rule: limited-rate
           param: 3/60
           false:
             rule: probabilistic
             param: 0.01
     -
      # With service node, this config is only applied to service s3 and s4.
      service:
        - s3
        - s4
      sampling:
        # There is a 5% chance any trace is sampled.
        rule: probabilistic
        param: 0.05
     -
      # Without service node, this config is applied to any service except s1, s2, s3 and s4.
      sampling:
        # There is a 10% chance any trace is sampled.
        rule: probabilistic
        param: 0.1

評価に使用されるルール・ツリーの例を次に示します:

rule: per-operation-rate
param: 5/60
false:
     rule: probabilistic
     param: 0.2