Os seguintes métodos estão disponíveis para configurar a amostragem do APM:

• Propriedades de Regra Única: Uma maneira fácil de definir uma regra aplicável a todos os rastreamentos.
• Arquivo de Configuração: Uma forma abrangente de definir amostragens, incluindo regras de ramificação e regras de prioridade da operação.

Há 2 estratégias de amostragem:

• Amostragem: Usa a entrada sampling e define uma árvore de regras para avaliação de rastreamento.
• Prioridade da Operação: Usa a entrada operation_priority e, quando é definida, substitui a amostragem se o nome da operação do intervalo raiz de rastreamento corresponder ao nome definido. Cada nome de operação definido tem sua própria árvore de regras de decisão.

• Se o nó de serviço (service:) não for especificado, a configuração de amostragem será aplicada a todos os serviços sem configuração de amostragem dedicada. Quando várias configurações têm o mesmo nome de serviço, somente a última configuração com esse nome de serviço é usada.

  Se um arquivo tiver configurações com e sem esse nó de serviço, a configuração com o nome de serviço correspondente ao nome de serviço do Agente do APM ou Rastreador do APM será priorizada.

• Quando os nós de amostragem (sampling:) e operation_priority (operation_priority:) são especificados, o operation_priority é priorizado. Se o nome do intervalo raiz de rastreamento corresponder ao nome da operação do nó operation_priority, ele será avaliado com a regra associada ao nome da operação. Se o nome do intervalo raiz de rastreamento não corresponder a nenhum nome de operação do nó operation_priority, o nó de amostragem será avaliado.

• Se o nó de amostragem (sampling:) não for especificado ou nenhuma regra for especificada, o rastreamento não será amostrado quando nenhuma regra operation_priority for aplicável.

• Quando o nó operation_priority (operation_priority:) for especificado, se o nome da operação do intervalo raiz de rastreamento corresponder a qualquer nome de operação operation_priority, a regra de nome correspondente será usada para avaliação, em vez da regra de amostragem base.

• Nó da Regra
• Valor de Origem

1. Regra que se aplica a todos os serviços

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

2. Probabilística com contagem mínima

   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. Amostra apenas operações especificadas

   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. Outro exemplo de amostra

   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

Veja abaixo um exemplo de uma árvore de regras usada para avaliação:

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