Están disponibles los siguientes métodos para configurar el muestreo de APM:

• Propiedades de regla única: forma sencilla de definir una regla aplicable a todos los rastreos.
• Archivo de configuración: forma completa de definir muestreos, incluidas las reglas de bifurcación y las reglas de prioridad de operación.

Hay 2 estrategias de muestreo:

• Muestreo: utiliza la entrada sampling y define un árbol de reglas para la evaluación del rastreo.
• Prioridad de operación: utiliza la entrada operation_priority y, cuando se define, sustituye el muestreo si el nombre de operación del intervalo raíz de rastreo coincide con el nombre definido. Cada nombre de operación definido tiene su propio árbol de reglas de decisión.

• Si no se especifica el nodo de servicio (service:), la configuración de muestreo se aplica a todos los servicios sin una configuración de muestreo dedicada. Cuando varias configuraciones tienen el mismo nombre de servicio, solo se utiliza la última configuración con ese nombre de servicio.

  Si un archivo tiene configuraciones con y sin este nodo de servicio, se da prioridad a la configuración con el nombre de servicio que coincide con el nombre de servicio de agente de APM o de rastreador de APM.

• Si se han especificado tanto el nodo sampling (sampling:) como el nodo operation_priority (operation_priority:), se da prioridad a operation_priority. Si el nombre del período raíz de rastreo coincide con el nombre de operación del nodo operation_priority, este se evalúa con la regla asociada al nombre de operación. Si el nombre del período raíz de rastreo no coincide con ningún nombre de operación del nodo operation_priority, se evalúa el nodo sampling.

• Si no se especifica el nodo de muestreo (sampling:) o no se especifica ninguna regla, el rastreo no se muestra cuando no se aplica ninguna regla operation_priority.

• Si se ha especificado el nodo operation_priority (operation_priority:), si el nombre de operación del período raíz de rastreo coincide con cualquier nombre de operación de operation_priority, se utiliza la regla de nombre coincidente para la evaluación en lugar de la regla de muestreo base.

• Nodo de regla
• Valor de origen

1. Regla que se aplica a todos los servicios

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

2. Probabilístico con recuento mínimo

   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. Operaciones especificadas solo de muestreo

   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. Otro ejemplo de muestreo

   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

A continuación se muestra un ejemplo de un árbol de reglas utilizado para la evaluación:

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