Die folgenden Methoden sind zur Konfiguration des APM-Samplings verfügbar:

• Eigenschaften einer einzelnen Regel: Eine einfache Möglichkeit, eine Regel für alle Traces zu definieren.
• Konfigurationsdatei: Eine umfassende Methode zur Definition von Samplings einschließlich Verzweigungsregeln und Prioritätsregeln für Vorgänge.

Es gibt zwei Samplingstrategien:

• Sampling: Dabei werden der sampling-Eintrag verwendet und ein Regelbaum für die Traceauswertung definiert.
• Vorgangspriorität: Dabei werden der operation_priority-Eintrag verwendet und bei Definition das Sampling überschrieben, wenn der Name des Trace-Root-Span-Vorgangs mit dem definierten Namen übereinstimmt. Jeder definierte Vorgangsname hat einen eigenen Entscheidungsregelbaum.

• Wenn der Serviceknoten (service:) nicht angegeben ist, wird die Samplingkonfiguration auf alle Services ohne dedizierte Samplingkonfiguration angewendet. Wenn mehrere Konfigurationen denselben Servicenamen haben, wird nur die letzte Konfiguration mit diesem Servicenamen verwendet.

  Wenn eine Datei Konfigurationen mit diesem Serviceknoten und ohne ihn hat, wird die Konfiguration mit dem Servicenamen priorisiert, der mit dem Servicenamen des APM-Agent oder APM-Tracers übereinstimmt.

• Wenn die Knoten sampling (sampling:) und operation_priority (operation_priority:) angegeben werden, wird operation_priority priorisiert. Wenn der Name des Trace-Root-Spans mit dem Vorgangsnamen des Knotens operation_priority übereinstimmt, wird er mit der mit dem Vorgangsnamen verknüpften Regel ausgewertet. Wenn der Name des Trace-Root-Spans mit keinen Vorgangsnamen des Knotens operation_priority übereinstimmt, wird der Knoten sampling ausgewertet.

• Wenn kein Sampling-Knoten (sampling:) angegeben ist oder keine Regel angegeben ist, wird der Trace nicht in die Stichprobe einbezogen, wenn keine operation_priority-Regel angewendet wird.

• Wenn der Knoten operation_priority (operation_priority:) angegeben ist und der Name des Trace-Root-Span-Vorgangs mit einem operation_priority-Vorgangsnamen übereinstimmt, wird die Regel des übereinstimmenden Namens anstelle der Basissamplingregel für die Auswertung verwendet.

• Regelknoten
• Quellwert

1. Regel, die auf alle Services angewendet wird

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

2. Probabilistisch mit Mindestanzahl

   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. Nur angegebene Vorgänge sampeln

   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. Beispiel für ein weiteres Sampling

   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

Nachfolgend finden Sie ein Beispiel für einen Regelbaum für die Auswertung:

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