Todos los productos
Search
Centro de documentos

Application Real-Time Monitoring Service:GetTraceAppConfig

Última actualización: Sep 01, 2026

Consulta todas las configuraciones personalizadas de una aplicación monitoreada por Application Monitoring, como la configuración de muestreo de trazas y los interruptores de agentes. Esta operación solo es aplicable a aplicaciones monitoreadas por Application Monitoring. No es aplicable a aplicaciones monitoreadas por Managed Service for OpenTelemetry.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

No se requiere autorización para esta operación. Si experimenta problemas al ejecutarla, póngase en contacto con el soporte técnico.

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

Pid

string

Sí

El ID de proceso (PID) de la aplicación.

Puede utilizar uno de los siguientes métodos para obtener el PID:

  • API: Llame a la operación ListTraceApps.

  • Consola: Inicie sesión en la consola de Application Real-Time Monitoring Service (ARMS). En el panel de navegación izquierdo, seleccione Application Monitoring > Application List. En la página Application List, haga clic en el nombre de su aplicación. La URL en la barra de direcciones contiene el PID de la aplicación. El PID se indica en el formato pid=xxx. Por lo general, el PID está codificado en porcentaje como xxx%40xxx. Debe modificar este valor para eliminar la codificación de porcentaje. Por ejemplo, si el PID en la URL es xxx%4074xxx, debe reemplazar %40 con un signo de arroba (@) para obtener xxx@74xxx.

Nota
  • Para obtener el PID en la consola, su aplicación debe estar monitoreada por Application Monitoring y no por Managed Service for OpenTelemetry.

  • La operación GetTraceAppConfig solo puede consultar las configuraciones personalizadas de aplicaciones que están monitoreadas por Application Monitoring.

a2n80plglh@745eddxxx

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

Esquema de respuesta.

RequestId

string

El ID de la solicitud.

78901766-3806-4E96-8E47-CFEF59E4****

Data

string

La configuración personalizada de la aplicación, que es una cadena JSON. Para más información, consulte Descripción adicional de los parámetros de respuesta.

{"profiler":{"enable":true}}

Message

string

El mensaje devuelto.

查询应用配置成功

Code

integer

El código de estado HTTP.

Valores válidos:

  • 2xx: La solicitud fue exitosa.

  • 3xx: La solicitud fue redirigida.

  • 4xx: Ocurrió un error en la solicitud.

  • 5xx: Ocurrió un error del servidor.

Valores válidos:

  • 2xx :
  • 3xx :
  • 4xx :
  • 5xx :

200

Success

boolean

Indica si la solicitud fue exitosa.

Valores válidos:

  • true

  • false

Valores válidos:

  • true :
  • false :

true

Las siguientes tablas describen el parámetro JSONPath correspondiente a cada configuración personalizada. Nota: Es posible que algunas configuraciones personalizadas no se devuelvan en la respuesta porque se modifican en diferentes momentos. En este caso, los valores predeterminados surten efecto.

Configuración de muestreo

ConfiguraciónJSONPathTipoDescripciónValor predeterminado
Política de muestreoprofiler.sampling.useSamplingStrategyV2booleanValores válidos:
- true: muestreo adaptativo
- false: muestreo de tasa fija




false
Tasa de muestreoprofiler.sampling.ratedoubleDe 0% a 100%
Esta configuración surte efecto para el muestreo de tasa fija.

10
Endpoint de API para recopilación completaprofiler.sampling.v2config.spanNames4FullSampleStrStringEl endpoint de API cuyos datos de traza se recopilan. Separe múltiples valores con comas (,).""
Prefijo de endpoint de API para recopilación completaprofiler.sampling.v2config.spanNamePrefixes4FullSampleStrStringEl prefijo del endpoint de API cuyos datos de traza se recopilan.""
Sufijo de endpoint de API para recopilación completaprofiler.sampling.v2config.spanNameSuffixes4FullSampleStrStringEl sufijo del endpoint de API cuyos datos de traza se recopilan.""

Configuración de interruptores de agente

ConfiguraciónJSONPathTipoDescripciónValor predeterminado
Interruptor de Application Monitoringprofiler.enablebooleanValores válidos:
- true: habilita Application Monitoring
- false: deshabilita Application Monitoring




true
Interruptor del complemento Dubboprofiler.dubbo.enablebooleanValores válidos:
- true: habilita el complemento Dubbo
- false: deshabilita el complemento Dubbo




true
Interruptor del complemento MongoDBprofiler.mongodb.enablebooleanValores válidos:
- true: habilita el complemento MongoDB
- false: deshabilita el complemento MongoDB




true
Interruptor del complemento HSFprofiler.hsf.enablebooleanValores válidos:
- true: habilita el complemento HSF
- false: deshabilita el complemento HSF




true
Interruptor del complemento HttpClient 3profiler.httpclient3.enablebooleanValores válidos:
- true: habilita el complemento HttpClient 3
- false: deshabilita el complemento HttpClient 3




true
Interruptor del complemento HttpClient 4profiler.httpclient4.enablebooleanValores válidos:
- true: habilita el complemento HttpClient 4
- false: deshabilita el complemento HttpClient 4




true
Interruptor del complemento JDK HTTPprofiler.jdkhttp.enablebooleanValores válidos:
- true: habilita el complemento JDK HTTP
- false: deshabilita el complemento JDK HTTP




true
Interruptor del complemento Jettyprofiler.jetty.enablebooleanValores válidos:
- true: habilita el complemento Jetty
- false: deshabilita el complemento Jetty




true
Interruptor del complemento MyBatisprofiler.mybatis.enablebooleanValores válidos:
- true: habilita el complemento MyBatis
- false: deshabilita el complemento MyBatis




true
Interruptor del complemento MySQLprofiler.mysql.enablebooleanValores válidos:
- true: habilita el complemento MySQL
- false: deshabilita el complemento MySQL




true
Interruptor del complemento OkHttpprofiler.okhttp.enablebooleanValores válidos:
- true: habilita el complemento OkHttp
- false: deshabilita el complemento OkHttp




true
Interruptor del complemento Oracleprofiler.oracle.enablebooleanValores válidos:
- true: habilita el complemento Oracle
- false: deshabilita el complemento Oracle




true
Interruptor del complemento PostgreSQLprofiler.postgresql.enablebooleanValores válidos:
- true: habilita el complemento PostgreSQL
- false: deshabilita el complemento PostgreSQL




true
Interruptor del complemento Redisprofiler.redis.enablebooleanValores válidos:
- true: habilita el complemento Redis
- false: deshabilita el complemento Redis




true
Interruptor del complemento Springprofiler.spring.enablebooleanValores válidos:
- true: habilita el complemento Spring
- false: deshabilita el complemento Spring




true
Interruptor del complemento Spring Bootprofiler.springboot.enablebooleanValores válidos:
- true: habilita el complemento Spring Boot
- false: deshabilita el complemento Spring Boot




true
Interruptor del complemento Tomcatprofiler.tomcat.enablebooleanValores válidos:
- true: habilita el complemento Tomcat
- false: deshabilita el complemento Tomcat




true
Interruptor del complemento Lettuceprofiler.lettuce.enablebooleanValores válidos:
- true: habilita el complemento Lettuce
- false: deshabilita el complemento Lettuce




true
Interruptor del complemento gRPCprofiler.grpc.enablebooleanValores válidos:
- true: habilita el complemento gRPC
- false: deshabilita el complemento gRPC




true
Interruptor del complemento Thriftprofiler.thrift.enablebooleanValores válidos:
- true: habilita el complemento Thrift
- false: deshabilita el complemento Thrift




true
Interruptor del complemento Hystrixprofiler.hystrix.enablebooleanValores válidos:
- true: habilita el complemento Hystrix
- false: deshabilita el complemento Hystrix




true
Interruptor del complemento RxJavaprofiler.rxjava.enablebooleanValores válidos:
- true: habilita el complemento RxJava
- false: deshabilita el complemento RxJava




true
Interruptor del complemento Memcachedprofiler.memcached.enablebooleanValores válidos:
- true: habilita el complemento Memcached
- false: deshabilita el complemento Memcached




true
Interruptor del complemento Druidprofiler.jdbc.druid.enablebooleanValores válidos:
- true: habilita el complemento Druid
- false: deshabilita el complemento Druid




true
Interruptor del complemento WebLogicprofiler.weblogic.enablebooleanValores válidos:
- true: habilita el complemento WebLogic
- false: deshabilita el complemento WebLogic




true
Interruptor del complemento ElasticJobprofiler.elasticjob.enablebooleanValores válidos:
- true: habilita el complemento ElasticJob
- false: deshabilita el complemento ElasticJob




true
Interruptor del complemento Elasticsearchprofiler.elasticsearch.enablebooleanValores válidos:
- true: habilita el complemento Elasticsearch
- false: deshabilita el complemento Elasticsearch




true
Interruptor del complemento HikariCPprofiler.jdbc.hikaricp.enablebooleanValores válidos:
- true: habilita el complemento HikariCP
- false: deshabilita el complemento HikariCP




true
Interruptor del complemento InfluxDBprofiler.influxdb.enablebooleanValores válidos:
- true: habilita el complemento InfluxDB
- false: deshabilita el complemento InfluxDB




true
Interruptor del complemento Kafkaprofiler.kafka.enablebooleanValores válidos:
- true: habilita el complemento Kafka
- false: deshabilita el complemento Kafka




true
Interruptor del complemento Nettyprofiler.netty.enablebooleanValores válidos:
- true: habilita el complemento Netty
- false: deshabilita el complemento Netty




true
Interruptor del complemento Playprofiler.play.enablebooleanValores válidos:
- true: habilita el complemento Play
- false: deshabilita el complemento Play




true
Interruptor del complemento Reactorprofiler.reactor.enablebooleanValores válidos:
- true: habilita el complemento Reactor
- false: deshabilita el complemento Reactor




true
Interruptor del complemento Redissonprofiler.redis.redisson.enablebooleanValores válidos:
- true: habilita el complemento Redisson
- false: deshabilita el complemento Redisson




true
Interruptor del complemento RabbitMQprofiler.rabbitmq.client.enablebooleanValores válidos:
- true: habilita el complemento RabbitMQ
- false: deshabilita el complemento RabbitMQ




true
Interruptor del complemento SchedulerXprofiler.schedulerx.enablebooleanValores válidos:
- true: habilita el complemento SchedulerX
- false: deshabilita el complemento SchedulerX




true
Interruptor del complemento Undertowprofiler.undertow.enablebooleanValores válidos:
- true: habilita el complemento Undertow
- false: deshabilita el complemento Undertow




true
Interruptor del complemento Vert.xprofiler.vertx.enablebooleanValores válidos:
- true: habilita el complemento Vert.x
- false: deshabilita el complemento Vert.x




true
Interruptor del complemento XXL-JOBprofiler.xxljob.enablebooleanValores válidos:
- true: habilita el complemento XXL-JOB
- false: deshabilita el complemento XXL-JOB




true
Interruptor del complemento ONS Clientprofiler.onsclient.enablebooleanValores válidos:
- true: habilita el complemento ONS Client
- false: deshabilita el complemento ONS Client




true
Interruptor del complemento Quartzprofiler.quartz.enablebooleanValores válidos:
- true: habilita el complemento Quartz
- false: deshabilita el complemento Quartz




true
Interruptor del complemento Servletprofiler.servlet.enablebooleanValores válidos:
- true: habilita el complemento Servlet
- false: deshabilita el complemento Servlet




true
Interruptor del complemento Libertyprofiler.liberty.enablebooleanValores válidos:
- true: habilita el complemento Liberty
- false: deshabilita el complemento Liberty




true
Interruptor del complemento Akkaprofiler.akka.enablebooleanValores válidos:
- true: habilita el complemento Akka
- false: deshabilita el complemento Akka




true
Interruptor del complemento Cassandraprofiler.cassandra.enablebooleanValores válidos:
- true: habilita el complemento Cassandra
- false: deshabilita el complemento Cassandra




true
Interruptor del complemento OpenTelemetryprofiler.opentelemetry.enablebooleanValores válidos:
- true: habilita el complemento OpenTelemetry
- false: deshabilita el complemento OpenTelemetry




true
Interruptor del complemento Google HTTP Clientprofiler.googlehttpclient.enablebooleanValores válidos:
- true: habilita el complemento Google HTTP Client
- false: deshabilita el complemento Google HTTP Client




true
Interruptor del complemento Ningprofiler.ning.asynchttpclient.enablebooleanValores válidos:
- true: habilita el complemento Ning
- false: deshabilita el complemento Ning




true

Configuración de perfilado de subprocesos

ConfiguraciónJSONPathTipoDescripciónValor predeterminado
Interruptor de perfilado de subprocesosprofiler.tprof.enableJvmThreadStatisticbooleanValores válidos:
- true: habilita el perfilado de subprocesos
- false: deshabilita el perfilado de subprocesos




true
Interruptor para guardar periódicamente pilas de métodos localesprofiler.tprof.enableThreadStackRecorderbooleanValores válidos:
- true: habilita el almacenamiento periódico de pilas de métodos locales
- false: deshabilita el almacenamiento periódico de pilas de métodos locales




false
Umbral para llamadas de larga duraciónprofiler.tprof. threadProfilerSlowInteractionRtintUnidad: ms. Si la duración supera el umbral, la pila de métodos locales se guarda automáticamente.2000

Configuración de asociación de registros de aplicación

ConfiguraciónJSONPathTipoDescripciónValor predeterminado
Origen de registroprofiler.logSourceStringValores válidos:
- sls: Simple Log Service

sls
Interruptor para asociar automáticamente registros de negocio con ID de trazaprofiler.logging.enablebooleanValores válidos:
- true: habilita la asociación de registros de negocio con ID de traza
- false: deshabilita la asociación de registros de negocio con ID de traza




true
Interruptor para completar automáticamente ID de traza en registrosprofiler.logging.injectTraceId2Log.enablebooleanValores válidos:
- true: habilita el llenado automático de ID de span en registros
- false: deshabilita el llenado automático de ID de span en registros
Esta configuración surte efecto para agentes de ARMS V4.1.6 o posteriores.







true
Interruptor para completar automáticamente ID de span en registrosprofiler.logging.injectSpanId2Log.enablebooleanValores válidos:
- true: habilita el llenado automático de ID de span en registros
- false: deshabilita el llenado automático de ID de span en registros
Esta configuración surte efecto para agentes de ARMS V4.1.6 o posteriores.







true
Asociar Simple Log Service - Regiónprofiler.SLS.regionIdStringLa región donde reside el origen de registro asociado.""
Asociar Simple Log Service - Proyectoprofiler.SLS.projectStringEl proyecto al que pertenece el origen de registro asociado.""
Asociar Simple Log Service - Logstoreprofiler.SLS.logStoreStringEl Logstore al que pertenece el origen de registro asociado.""
Asociar Simple Log Service - Índice asociadoprofiler.SLS.indexStringEl índice del origen de registro asociado.""

Configuración de convergencia de URL

ConfiguraciónJSONPathTipoDescripciónValor predeterminado
URL de convergenciaprofiler.convergence.enablebooleanValores válidos:
- true: habilita la función de convergencia de URL
- false: deshabilita la función de convergencia de URL




true
Umbral de convergenciaprofiler.convergence.minServerSizelongLas URL convergen cuando se alcanza el umbral.1000
Regla de convergenciaprofiler.convergence.patternStringCada regla es una expresión regular.
Ejemplo: /service/(.*?)/demo.
Separe múltiples reglas con comas (,).




""

Configuración de Arthas

ConfiguraciónJSONPathTipoDescripciónValor predeterminado
Interruptor de Arthasprofiler.arthas.enablebooleanValores válidos:
- true: habilita la función de diagnóstico de Arthas
- false: deshabilita la función de diagnóstico de Arthas




false
Dirección IP efectiva en tiempo realprofiler.arthas.enableIpsstringLas direcciones IP para las cuales está habilitada la función de diagnóstico de Arthas. Separe múltiples direcciones IP con comas (,).
Una cadena vacía indica que la función de diagnóstico de Arthas está habilitada para todas las direcciones IP.

""

Configuración de perfilado continuo

ConfiguraciónJSONPathTipoDescripciónValor predeterminado
Interruptorprofiler.cp.enablebooleanValores válidos:
- true: habilita la función de perfilado continuo
- false: deshabilita la función de perfilado continuo
* Después de activar el interruptor, hay dos modos de configuración disponibles, como se muestra en la siguiente tabla.







false
Punto crítico de CPUprofiler.cp.cpuEnablebooleanValores válidos:
- true: habilita la función de punto crítico de CPU
- false: deshabilita la función de punto crítico de CPU




false
Punto crítico de memoriaprofiler.cp.allocEnablebooleanValores válidos:
- true: habilita la función de punto crítico de memoria
- false: deshabilita la función de punto crítico de memoria




false
Punto crítico de códigoprofiler.cp.wallClockEnablebooleanValores válidos:
- true: habilita la función de punto crítico de código
- false: deshabilita la función de punto crítico de código




false
ModoClaveCampoValor
Lista blanca de direcciones IPcp.allowIPsLista blanca de direcciones IPLa dirección IP de las instancias para las cuales está habilitado el perfilado continuo. Separe múltiples valores con comas (,).
Ejemplo: 192.168.0.1,192.168.0.2

cp.allowNetworkBloque CIDREspecifique una cadena vacía. De lo contrario, esta función no funcionará correctamente.
Bloque CIDRcp.allowIPsLista blanca de direcciones IPEspecifique una cadena vacía. De lo contrario, esta función no funcionará correctamente.
cp.allowNetworkBloque CIDREl bloque CIDR de las instancias para las cuales está habilitado el perfilado continuo.
Ejemplo: 192.168.2.0/24/24

Configuración de enmascaramiento de datos

ConfiguraciónJSONPathTipoDescripciónValor predeterminado
Interruptor de enmascaramiento de datosprofiler.sanitizer.enablebooleanValores válidos:
- true: habilita la función de enmascaramiento de datos
- false: deshabilita la función de enmascaramiento de datos




true
Regla de enmascaramiento de datosprofiler.sanitizer.keysStringCoincidencia sin distinción entre mayúsculas y minúsculas de claves sensibles que contienen términos especificados. Separe múltiples direcciones IP con comas (,).true

Configuración de llamadas de operación

ConfiguraciónJSONPathTipoDescripciónValor predeterminado
Umbral de solicitud lentaprofiler.thresholds.interfacelongUnidad: ms. Si el tiempo de respuesta es mayor que este umbral, la solicitud se marca como lenta.500
Lista blanca de excepcionesprofiler.exception.whitelistStringEspecifique expresiones regulares para nombres de excepciones, donde las excepciones coincidentes se excluyen de los gráficos estadísticos. Separe múltiples reglas con comas (,).""
Filtrado de excepciones mediante herencia de clase padreprofiler.exception.filterByParentClassbooleanValores válidos:
- true: habilita la función
- false: deshabilita la función
Después de habilitar la función, puede configurar excepciones principales en el filtrado de excepciones.
Esta configuración surte efecto para agentes de ARMS V4.1.6 o posteriores.










true
Lista blanca de códigos de estado HTTPprofiler.error.skipStringLos códigos de estado HTTP que desea ignorar. Separe múltiples valores con comas (,).""
Filtrado de llamadas de API no válidasprofiler.defined.excludeurlStringLas llamadas de API que se ignoran. Cada regla es una expresión regular. Separe múltiples valores con comas (,)./**/*.jpg,/**/*.png,/**/*.js,
/**/*.jpeg,/**/*.pdf,/**/*.xlsx,
/**/*.txt,/**/*.docs,/**/*.gif,
/**/*.csv







Configuración de llamadas a base de datos

ConfiguraciónJSONPathTipoDescripciónValor predeterminado
Umbral de consulta SQL lentaprofiler.thresholds.sqllongUnidad: ms. Si la duración de una consulta SQL supera el umbral, la consulta se marca como lenta.500
Longitud máxima de retención de captura SQLprofiler.callsql.maxLengthlongSi el valor de una sentencia SQL supera el umbral, la sentencia SQL se trunca.1024
Interruptor para mostrar variables vinculadas en sentencias SQLprofiler.jdbc.tracesqlbindvaluebooleanValores válidos:
- true: habilita la función
- false: deshabilita la función
Si activa este interruptor, los valores de variable vinculados al parámetro PrepareStatement se capturan y se muestran en la página. Solo se admite MySQL.







false
Interruptor para mostrar constantes en sentencias SQLprofiler.jdbc. tracesqlrawbooleanValores válidos:
- true: habilita la función
- false: deshabilita la función
Después de habilitar la función, se capturan las sentencias SQL sin procesar.







false

Configuración de protocolo de rastreo

Nota: La configuración del protocolo de propagación de contexto solo surte efecto para agentes de ARMS V4.1.x o posteriores.

ConfiguraciónJSONPathTipoDescripciónValor predeterminado
Protocolo de propagación de contextoprofiler.trace.protocol.nameStringValores válidos:
- Unset: no establecido
- W3C: OpenTelemetry W3C
- SkyWalking
- Zipkin: Zipkin B3
- Jaeger
- EagleEye
















Unset
Modo de propagación de contextoprofiler.trace.protocol. strategyStringValores válidos:
- PriorityUse
- ForceUse




PriorityUse

Configuración avanzada

ConfiguraciónJSONPathTipoDescripciónValor predeterminado
Número máximo de trazas recopiladas por el agente por segundoprofiler.thresholds.limitintUna medida de protección para garantizar que las operaciones comerciales no se vean afectadas por la recopilación de trazas en situaciones de alto tráfico.100
Límite de retención de pila de métodosprofiler.callstack.maxLengthintSi la longitud de una pila de métodos supera el umbral, la pila de métodos se trunca durante la recopilación.
Esta configuración está obsoleta para agentes de ARMS V4.0.0 o posteriores.

128
Profundidad de pila para excepciones del mismo tipoprofiler.exception.stacktraceintLa profundidad de pila en función de la cual el sistema identifica el mismo tipo de excepciones.2
Longitud máxima de visualización de parámetros de solicitudprofiler.param.maxLengthintLa longitud máxima de visualización de los parámetros de solicitud.512
Consumidor RabbitMQ personalizadoprofiler.rabbitmq.client.consumer.classesStringLos nombres de clase totalmente calificados de los consumidores RabbitMQ. Separe múltiples consumidores con comas (,).
Esta configuración está obsoleta para agentes de ARMS V4.0.0 o posteriores.

""
Método de consumo Kafka personalizadoprofiler.kafka.consumer.entryPointStringEl método de consumo del consumidor Kafka.
Esta configuración está obsoleta para agentes de ARMS V4.0.0 o posteriores.

""
Interruptor para propagar automáticamente el contexto cuando Kafka envía mensajesprofiler.kafka.enableInjectKafkaHeadersbooleanEspecifica si se deben inyectar automáticamente encabezados de rastreo en los mensajes de Kafka para asociar la traza de envío con la traza de consumo.
Esta configuración está obsoleta para agentes de ARMS V4.0.0 o posteriores.

false
Nombre de paquete para propagación asíncronaprofiler.thread.match.packageStringCuando se crea un Runnable, Callable o Supplier bajo el paquete especificado, el contexto de traza se captura automáticamente y se propaga al nuevo subproceso. Separe múltiples nombres de paquete con comas (,).
Esta configuración está obsoleta para agentes de ARMS V4.0.0 o posteriores.

""
Inclusión de ID de traza en una respuesta HTTPprofiler.responseInject.enablebooleanValores válidos:
- true: habilita la función
- false: deshabilita la función




false

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "78901766-3806-4E96-8E47-CFEF59E4****\n",
  "Data": "{\"profiler\":{\"enable\":true}}",
  "Message": "查询应用配置成功",
  "Code": 200,
  "Success": true
}

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

400 ParameterPidMissing You must specify pid. You must specify pid.
500 InternalError Internal error. Please try again. Contact the DingTalk service account if the issue persists after multiple retries. Internal error. Please try again. Contact the DingTalk service account if the issue persists after multiple retries.
404 AppNotExist The application does not exist. The application does not exist.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.