Configurar Rastreamentos Respostos no Agente de Dotnet do APM
Esse recurso foi projetado para eliminar casos de contagem excessiva de intervalos por rastreamento. Quando muitos intervalos são criados em uma única chamada, o agente pode causar uma sobrecarga maior do que a desejada, também pode aumentar a contagem de intervalos por hora, causando uma cobrança maior do que a esperada. Os casos em que isso pode ser um problema incluem chamadas recursivas (intencionais ou não), código gerado resultando em um alto número de SQLs executados por transação e outros.
- O recurso de abreviação permite que os usuários limitem o número máximo de intervalos por chamada. Ele também fornece uma maneira de excluir intervalos que podem ser considerados "não dignos" (por exemplo, alto volume de SQLs muito rápidos).
- Os limites de contagem específicos da sondagem, a exclusão baseada no nome do intervalo e o limite são configuráveis por chamada, conforme descrito na seção de configuração.
- A configuração padrão é limitar cada chamada a 100 intervalos.
- Estatísticas resumidas básicas sobre intervalos eliminados podem ser coletadas por chamada.
Veja a seguir um exemplo de configuração que limitará o número máximo de intervalos ODP por chamada a 50 e excluirá SQLs que são executados em menos de 2ms. Ao ativar a opção summarize
, o agente adicionará as seguintes métricas ao intervalo pai: dropped span count
, avg dropped span duration
, min dropped span time
, max dropped span time
, dropped span error count
.
OTEL_DOTNET_ABRIDGE_SUMMARIZE=true
OTEL_DOTNET_ABRIDGE_PROBE_SPAN_LIMIT_odp=50
OTEL_DOTNET_ABRIDGE_PROBE_THRESHOLD_DURATION_odp=2
Configuração
Variável de Ambiente | Descrição | Valor Padrão | Exemplo |
---|---|---|---|
OTEL_DOTNET_ABRIDGE_ENABLED |
Ative/desative o modo abridge. Por padrão, o modo abreviado está ativado. |
true | |
OTEL_DOTNET_ABRIDGE_SPAN_LIMIT |
O limite de intervalo após o qual as investigações em probes_list são resumidas. Esse limite é para o número total de intervalos de TODAS as investigações em probes_list. Não é por sonda. |
100 |
OTEL_DOTNET_ABRIDGE_SPAN_LIMIT=100 |
OTEL_DOTNET_ABRIDGE_PROBE_LIST |
A lista de sondas cujos intervalos contribuem para o span_limit e que se tornam abreviadas quando o span_limit é atingido. |
- |
OTEL_DOTNET_ABRIDGE_PROBE_LIST=Odp,httpclient |
OTEL_DOTNET_ABRIDGE_SUMMARIZE |
Sumário de intervalos eliminados. Definir como verdadeiro para ativá-lo. |
falso | |
OTEL_DOTNET_ABRIDGE_PROBE_SPAN_LIMIT_<probe_name> |
O limite de extensão após o qual os intervalos da sonda se tornam abreviados. |
- |
OTEL_DOTNET_ABRIDGE_PROBE_SPAN_LIMIT_odp=5 |
OTEL_DOTNET_ABRIDGE_PROBE_EXCLUDE_REGEX_<probe_name> |
Correspondência baseada em regex com base no nome da operação. Uma vez correspondido, o intervalo da sonda é eliminado. |
- |
OTEL_DOTNET_ABRIDGE_PROBE_EXCLUDE_REGEX_odp=.*selecionar.* |
OTEL_DOTNET_ABRIDGE_PROBE_THRESHOLD_DURATION_<probe_name> |
Limitação baseada na duração do intervalo. O valor está em milissegundos e indica que intervalos que levam menos do que o tempo configurado devem ser eliminados. |
- |
OTEL_DOTNET_ABRIDGE_PROBE_THRESHOLD_DURATION_odp=2 |
OTEL_DOTNET_ABRIDGE_PROBE_THRESHOLD_AFTER_SPANCOUNT_<probe_name> |
Limitação baseada na duração do intervalo. Indica o número de intervalos a serem capturados antes de iniciar o limite de intervalos rápidos. |
- |
OTEL_DOTNET_ABRIDGE_PROBE_THRESHOLD_AFTER_SPANCOUNT_odp=0 |