Per configurare il campionamento APM sono disponibili i metodi riportati di seguito.

• Proprietà regola singola: un modo semplice per definire una regola applicabile a tutti i trace.
• File di configurazione: un modo completo per definire i campionamenti, incluse le regole di diramazione e le regole di priorità delle operazioni.

Ci sono 2 strategie di campionamento:

• Campionatura: utilizza la voce sampling e definisce una struttura di regole per la valutazione del trace.
• Priorità operazione: utilizza la voce operation_priority e, quando viene definita, sostituisce la campionatura se il nome dell'operazione dell'intervallo radice di trace corrisponde al nome definito. Ogni nome operazione definito ha una propria struttura di regole di decisione.

• Se il nodo del servizio (service:) non viene specificato, la configurazione di campionamento viene applicata a tutti i servizi senza una configurazione di campionamento dedicata. Quando più configurazioni hanno lo stesso nome di servizio, viene utilizzata solo l'ultima configurazione con tale nome di servizio.

  Se un file dispone di configurazioni con e senza questo nodo del servizio, viene assegnata la priorità alla configurazione con il nome del servizio corrispondente all'agente APM o al nome del servizio APM Tracer.

• Quando i nodi di campionamento (sampling:) e operation_priority (operation_priority:) sono entrambi specificati, viene assegnata la priorità a operation_priority. Se il nome dell'intervallo radice traccia corrisponde al nome dell'operazione dal nodo operation_priority, viene valutato con la regola associata al nome dell'operazione. Se il nome dell'intervallo radice traccia non corrisponde ad alcun nome operazione dal nodo operation_priority, viene valutato il nodo di campionamento.

• Se il nodo di campionamento (sampling:) non viene specificato o non viene specificata alcuna regola, il trace non viene campionato se non è applicabile alcuna regola operation_priority.

• Se si specifica il nodo operation_priority (operation_priority:), se il nome dell'operazione dell'intervallo radice di trace corrisponde a qualsiasi nome di operazione operation_priority, per la valutazione viene utilizzata la regola del nome corrispondente anziché la regola di campionamento di base.

• Nodo regola
• Valore di origine

1. Regola applicabile a tutti i servizi

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

2. Probabile con conteggio minimo

   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. Operazioni specificate solo campione

   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. Altro esempio

   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

Di seguito è riportato un esempio di struttura di regole utilizzata per la valutazione.

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