Todos os produtos
Search

Este produto

    Application Real-Time Monitoring Service:Atributos e recursos de span para o agente 4.x

    Central de documentação

    Application Real-Time Monitoring Service:Atributos e recursos de span para o agente 4.x

    Última atualização: Jun 27, 2026

    O agente 4.x do Application Real-Time Monitoring Service (ARMS) captura atributos e recursos de span para cada framework instrumentado. Por padrão, o agente registra apenas um subconjunto dos atributos definidos nas Convenções Semânticas do OpenTelemetry para reduzir o volume de dados.

    Para registrar o conjunto completo de atributos padrão do OpenTelemetry, ative a opção Record OTel Spec conventional attributes na página Custom Configuration.

    As tabelas a seguir listam todos os atributos e recursos que o agente 4.x do ARMS anexa aos spans, organizados por framework.

    Atributos comuns de span

    Estes atributos estão presentes em todos os spans, independentemente do framework.

    Atributo

    Descrição

    Exemplo

    Observações

    rpc.type

    Tipo numérico da chamada do span.

    0, 40, 60

    Uso interno. Sujeito a alterações.

    serviceType

    Tipo numérico do serviço do span.

    1000, 1010

    Uso interno. Sujeito a alterações.

    ali.trace.flag

    Produto de observabilidade da Alibaba Cloud que coletou o trace. Valores válidos: arms (ARMS), x-trace (Managed Service for OpenTelemetry).

    arms

    Uso interno. Sujeito a alterações.

    component.name

    Framework ou componente que originou o span.

    mysql, http

    Para todos os valores válidos, consulte Métricas do Application Monitoring.

    hasInternalSpan

    Indica se o span contém um span filho com spanKind definido como Internal.

    1

    Presente apenas no LocalRootSpan.

    otel.scope.name

    Plugin de instrumentação que gerou o span.

    io.opentelemetry.jdbc

    -

    otel.scope.version

    Versão do plugin de instrumentação.

    1.28.0-SNAPSHOT

    -

    root.service.id

    ID da aplicação no ARMS referente ao primeiro serviço do trace.

    aokcd***@b57c445******

    -

    sample.service.id

    ID da aplicação no ARMS referente ao serviço que tomou a decisão de amostragem.

    aokcd***@b57c445******

    Nem sempre corresponde ao serviço de entrada. Para mais detalhes, consulte Modos de amostragem de trace (para versões do agente 3.2.8 e posteriores).

    sample.reason

    Política de amostragem correspondente no momento da decisão.

    s4

    Para mais detalhes, consulte Tags de amostragem.

    ppid

    ID da aplicação no ARMS referente ao serviço upstream (chamador).

    aokcd***@b57c445******

    -

    thread.name

    Nome da thread que executou a operação.

    http-nio-8080-exec-162

    -

    thread.id

    ID da thread que executou a operação.

    12783

    -

    trace.protocol.type

    Protocolo de propagação do contexto de trace.

    EagleEye, W3C

    Presente apenas no LocalRootSpan.

    Recursos comuns

    Os recursos descrevem o processo ou host que originou o span e permanecem constantes durante todo o ciclo de vida do agente.

    Recurso

    Descrição

    Exemplo

    Observações

    host.name

    Hostname da máquina onde a aplicação está em execução.

    mall-gateway-54c647a51d-db78a

    Adicionado na versão 4.5.0 do agente.

    agentVersion

    Versão do agente ARMS.

    4.5.0_3d5f5f7

    -

    acs.arms.service.id

    ID interno do serviço no ARMS.

    gauui7wh2@8a8763fbd23c898cd52***

    Uso interno. Sujeito a alterações.

    acs.arms.workspace

    Nome do workspace do ARMS.

    default-cms-1324351***-cn-hangzhou

    Uso interno. Sujeito a alterações.

    arms.appId

    ID da aplicação no ARMS.

    gauui7wh2@8a8763fbd23c898cd52***

    Uso interno. Sujeito a alterações.

    clusterId

    ID do cluster do Container Service for Kubernetes (ACK).

    c98cd52967df89a8e9***

    Exclusivo para Kubernetes. Obtido da variável de ambiente KUBERNETES_CLUSTER_ID.

    ipv4

    Endereço IP da aplicação.

    127.0.0.1

    -

    namespace

    Namespace do Kubernetes.

    default

    Exclusivo para Kubernetes. Obtido da variável de ambiente KUBERNETES_POD_NAMESPACE.

    workloadKind

    Tipo de workload do Kubernetes.

    Deployment

    Exclusivo para Kubernetes. Obtido da variável de ambiente ARMS_WORKLOADKIND.

    workloadName

    Nome do workload do Kubernetes.

    mall-gateway

    Exclusivo para Kubernetes. Obtido da variável de ambiente ARMS_WORKLOADNAME.

    Atributos de span HTTP

    Comuns

    Atributo

    Descrição

    Exemplo

    http.method

    Método da requisição HTTP.

    GET, POST

    http.status_code

    Código de status da resposta HTTP.

    200, 404, 500

    status

    Código de status HTTP consolidado. Códigos individuais 4xx e 5xx são agrupados em 4xx e 5xx.

    200, 4xx, 5xx

    Span de servidor

    Atributo

    Descrição

    Exemplo

    http.path

    Caminho URL real da requisição recebida.

    /api/v1/user

    http.route

    Modelo de rota registrado pelo framework.

    /api/v1/{userId}

    http.params

    Query string (parte da URL após o caractere ?).

    userId=123

    Nota: Os atributos http.route e http.path diferem quando o framework utiliza parâmetros de caminho. Por exemplo, se um controller Spring MVC declarar o caminho /api/v1/{userId}, o http.route registrará o modelo /api/v1/{userId}, enquanto o http.path registrará o caminho resolvido, como /api/v1/42.

    Span de cliente

    Atributo

    Descrição

    Exemplo

    destId

    Host e porta do serviço downstream.

    127.0.0.1

    endpoint

    Caminho URL da requisição enviada.

    /api/v1/user

    Atributos de span RPC

    Atributo

    Descrição

    Exemplo

    rpc.system

    Framework RPC utilizado.

    Dubbo, gRPC

    rpc.service

    Nome totalmente qualificado do serviço.

    com.test.TestService

    rpc.method

    Nome do método invocado.

    sayHello

    destId

    Endereço do par remoto.

    127.0.0.1:20880

    Atributos de span de tarefas agendadas

    Atributo

    Descrição

    Exemplo

    job.system

    Framework de agendamento.

    SchedulerX, XXLJob

    job.id

    ID da tarefa.

    2847

    job.name

    Nome da tarefa.

    testJob

    job.result.status

    Resultado da execução.

    success

    Atributos de span de mensageria

    Comuns

    Atributo

    Descrição

    Exemplo

    messaging.system

    Framework de mensageria.

    RocketMQ, Kafka

    messaging.operation

    Ação realizada na mensagem.

    publish, receive, process

    messaging.message.payload_size_bytes

    Tamanho do corpo da mensagem em bytes.

    137

    messaging.destination.name

    Nome do tópico.

    user_order

    destId

    Endereço do broker de mensagens.

    rmq-********-vpc.cn-beijing.rmq.aliyuncs.com:8080

    endpoint

    Endereço do broker combinado com o tópico, no formato ${destId}@${messaging.destination.name}.

    rmq-********-vpc.cn-beijing.rmq.aliyuncs.com:8080@user_order

    RocketMQ

    Atributo

    Descrição

    Exemplo

    messaging.consume.delay_ms

    Atraso de consumo em milissegundos.

    128

    Kafka

    Atributo

    Descrição

    Exemplo

    messaging.kafka.destination.partition

    Partição que contém a mensagem.

    5

    messaging.kafka.message.offset

    Offset da mensagem dentro da partição.

    42

    messaging.kafka.message.key

    Chave da mensagem.

    mykey

    Atributos de span de banco de dados e NoSQL

    Comuns

    Atributo

    Descrição

    Exemplo

    db.name

    Nome do banco de dados, extraído da string de conexão. Fica vazio se a string de conexão não incluir o nome do banco.

    test

    net.peer.name

    Host e porta obtidos da string de conexão do banco de dados.

    *****.mysql.rds.aliyuncs.com:3306

    sql

    Instrução do banco de dados. Valores parametrizados são substituídos por ?.

    SELECT * FROM user WHERE user_id=?

    db.statement.id

    ID codificado de 16 caracteres da instrução do banco de dados.

    5a620e8cf06156a5

    opType

    Tipo de operação executada.

    SELECT

    response.size

    Tamanho da resposta em bytes.

    54

    Atributos legados

    Os atributos abaixo são redundantes e mantidos apenas para compatibilidade com versões anteriores. Eles serão removidos em uma versão futura.

    Atributo

    Descrição

    Equivalente

    destId

    Nome do banco de dados.

    Equivale a db.name.

    endpoint

    String de conexão do banco de dados.

    Equivale a net.peer.name.

    out.ids

    String de conexão do banco de dados.

    Equivale a net.peer.name.

    MongoDB

    Atributo

    Descrição

    Exemplo

    db.mongodb.collection

    Nome da coleção de destino.

    user

    Redis

    Atributo

    Descrição

    Exemplo

    redis.command.key

    Chave acessada pelo comando.

    key