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
Test
Autorización de RAM
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:
Nota
|
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:
Valores válidos:
|
200 |
| Success |
boolean |
Indica si la solicitud fue exitosa. Valores válidos:
Valores válidos:
|
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ón | JSONPath | Tipo | Descripción | Valor predeterminado |
| Política de muestreo | profiler.sampling.useSamplingStrategyV2 | boolean | Valores válidos: - true: muestreo adaptativo- false: muestreo de tasa fija | false |
| Tasa de muestreo | profiler.sampling.rate | double | De 0% a 100% Esta configuración surte efecto para el muestreo de tasa fija. | 10 |
| Endpoint de API para recopilación completa | profiler.sampling.v2config.spanNames4FullSampleStr | String | El endpoint de API cuyos datos de traza se recopilan. Separe múltiples valores con comas (,). | "" |
| Prefijo de endpoint de API para recopilación completa | profiler.sampling.v2config.spanNamePrefixes4FullSampleStr | String | El prefijo del endpoint de API cuyos datos de traza se recopilan. | "" |
| Sufijo de endpoint de API para recopilación completa | profiler.sampling.v2config.spanNameSuffixes4FullSampleStr | String | El sufijo del endpoint de API cuyos datos de traza se recopilan. | "" |
Configuración de interruptores de agente
| Configuración | JSONPath | Tipo | Descripción | Valor predeterminado |
| Interruptor de Application Monitoring | profiler.enable | boolean | Valores válidos: - true: habilita Application Monitoring- false: deshabilita Application Monitoring | true |
| Interruptor del complemento Dubbo | profiler.dubbo.enable | boolean | Valores válidos: - true: habilita el complemento Dubbo- false: deshabilita el complemento Dubbo | true |
| Interruptor del complemento MongoDB | profiler.mongodb.enable | boolean | Valores válidos: - true: habilita el complemento MongoDB- false: deshabilita el complemento MongoDB | true |
| Interruptor del complemento HSF | profiler.hsf.enable | boolean | Valores válidos: - true: habilita el complemento HSF- false: deshabilita el complemento HSF | true |
| Interruptor del complemento HttpClient 3 | profiler.httpclient3.enable | boolean | Valores válidos: - true: habilita el complemento HttpClient 3- false: deshabilita el complemento HttpClient 3 | true |
| Interruptor del complemento HttpClient 4 | profiler.httpclient4.enable | boolean | Valores válidos: - true: habilita el complemento HttpClient 4- false: deshabilita el complemento HttpClient 4 | true |
| Interruptor del complemento JDK HTTP | profiler.jdkhttp.enable | boolean | Valores válidos: - true: habilita el complemento JDK HTTP- false: deshabilita el complemento JDK HTTP | true |
| Interruptor del complemento Jetty | profiler.jetty.enable | boolean | Valores válidos: - true: habilita el complemento Jetty- false: deshabilita el complemento Jetty | true |
| Interruptor del complemento MyBatis | profiler.mybatis.enable | boolean | Valores válidos: - true: habilita el complemento MyBatis- false: deshabilita el complemento MyBatis | true |
| Interruptor del complemento MySQL | profiler.mysql.enable | boolean | Valores válidos: - true: habilita el complemento MySQL- false: deshabilita el complemento MySQL | true |
| Interruptor del complemento OkHttp | profiler.okhttp.enable | boolean | Valores válidos: - true: habilita el complemento OkHttp- false: deshabilita el complemento OkHttp | true |
| Interruptor del complemento Oracle | profiler.oracle.enable | boolean | Valores válidos: - true: habilita el complemento Oracle- false: deshabilita el complemento Oracle | true |
| Interruptor del complemento PostgreSQL | profiler.postgresql.enable | boolean | Valores válidos: - true: habilita el complemento PostgreSQL- false: deshabilita el complemento PostgreSQL | true |
| Interruptor del complemento Redis | profiler.redis.enable | boolean | Valores válidos: - true: habilita el complemento Redis- false: deshabilita el complemento Redis | true |
| Interruptor del complemento Spring | profiler.spring.enable | boolean | Valores válidos: - true: habilita el complemento Spring- false: deshabilita el complemento Spring | true |
| Interruptor del complemento Spring Boot | profiler.springboot.enable | boolean | Valores válidos: - true: habilita el complemento Spring Boot- false: deshabilita el complemento Spring Boot | true |
| Interruptor del complemento Tomcat | profiler.tomcat.enable | boolean | Valores válidos: - true: habilita el complemento Tomcat- false: deshabilita el complemento Tomcat | true |
| Interruptor del complemento Lettuce | profiler.lettuce.enable | boolean | Valores válidos: - true: habilita el complemento Lettuce- false: deshabilita el complemento Lettuce | true |
| Interruptor del complemento gRPC | profiler.grpc.enable | boolean | Valores válidos: - true: habilita el complemento gRPC- false: deshabilita el complemento gRPC | true |
| Interruptor del complemento Thrift | profiler.thrift.enable | boolean | Valores válidos: - true: habilita el complemento Thrift- false: deshabilita el complemento Thrift | true |
| Interruptor del complemento Hystrix | profiler.hystrix.enable | boolean | Valores válidos: - true: habilita el complemento Hystrix- false: deshabilita el complemento Hystrix | true |
| Interruptor del complemento RxJava | profiler.rxjava.enable | boolean | Valores válidos: - true: habilita el complemento RxJava- false: deshabilita el complemento RxJava | true |
| Interruptor del complemento Memcached | profiler.memcached.enable | boolean | Valores válidos: - true: habilita el complemento Memcached- false: deshabilita el complemento Memcached | true |
| Interruptor del complemento Druid | profiler.jdbc.druid.enable | boolean | Valores válidos: - true: habilita el complemento Druid- false: deshabilita el complemento Druid | true |
| Interruptor del complemento WebLogic | profiler.weblogic.enable | boolean | Valores válidos: - true: habilita el complemento WebLogic- false: deshabilita el complemento WebLogic | true |
| Interruptor del complemento ElasticJob | profiler.elasticjob.enable | boolean | Valores válidos: - true: habilita el complemento ElasticJob- false: deshabilita el complemento ElasticJob | true |
| Interruptor del complemento Elasticsearch | profiler.elasticsearch.enable | boolean | Valores válidos: - true: habilita el complemento Elasticsearch- false: deshabilita el complemento Elasticsearch | true |
| Interruptor del complemento HikariCP | profiler.jdbc.hikaricp.enable | boolean | Valores válidos: - true: habilita el complemento HikariCP- false: deshabilita el complemento HikariCP | true |
| Interruptor del complemento InfluxDB | profiler.influxdb.enable | boolean | Valores válidos: - true: habilita el complemento InfluxDB- false: deshabilita el complemento InfluxDB | true |
| Interruptor del complemento Kafka | profiler.kafka.enable | boolean | Valores válidos: - true: habilita el complemento Kafka- false: deshabilita el complemento Kafka | true |
| Interruptor del complemento Netty | profiler.netty.enable | boolean | Valores válidos: - true: habilita el complemento Netty- false: deshabilita el complemento Netty | true |
| Interruptor del complemento Play | profiler.play.enable | boolean | Valores válidos: - true: habilita el complemento Play- false: deshabilita el complemento Play | true |
| Interruptor del complemento Reactor | profiler.reactor.enable | boolean | Valores válidos: - true: habilita el complemento Reactor- false: deshabilita el complemento Reactor | true |
| Interruptor del complemento Redisson | profiler.redis.redisson.enable | boolean | Valores válidos: - true: habilita el complemento Redisson- false: deshabilita el complemento Redisson | true |
| Interruptor del complemento RabbitMQ | profiler.rabbitmq.client.enable | boolean | Valores válidos: - true: habilita el complemento RabbitMQ- false: deshabilita el complemento RabbitMQ | true |
| Interruptor del complemento SchedulerX | profiler.schedulerx.enable | boolean | Valores válidos: - true: habilita el complemento SchedulerX- false: deshabilita el complemento SchedulerX | true |
| Interruptor del complemento Undertow | profiler.undertow.enable | boolean | Valores válidos: - true: habilita el complemento Undertow- false: deshabilita el complemento Undertow | true |
| Interruptor del complemento Vert.x | profiler.vertx.enable | boolean | Valores válidos: - true: habilita el complemento Vert.x- false: deshabilita el complemento Vert.x | true |
| Interruptor del complemento XXL-JOB | profiler.xxljob.enable | boolean | Valores válidos: - true: habilita el complemento XXL-JOB- false: deshabilita el complemento XXL-JOB | true |
| Interruptor del complemento ONS Client | profiler.onsclient.enable | boolean | Valores válidos: - true: habilita el complemento ONS Client- false: deshabilita el complemento ONS Client | true |
| Interruptor del complemento Quartz | profiler.quartz.enable | boolean | Valores válidos: - true: habilita el complemento Quartz- false: deshabilita el complemento Quartz | true |
| Interruptor del complemento Servlet | profiler.servlet.enable | boolean | Valores válidos: - true: habilita el complemento Servlet- false: deshabilita el complemento Servlet | true |
| Interruptor del complemento Liberty | profiler.liberty.enable | boolean | Valores válidos: - true: habilita el complemento Liberty- false: deshabilita el complemento Liberty | true |
| Interruptor del complemento Akka | profiler.akka.enable | boolean | Valores válidos: - true: habilita el complemento Akka- false: deshabilita el complemento Akka | true |
| Interruptor del complemento Cassandra | profiler.cassandra.enable | boolean | Valores válidos: - true: habilita el complemento Cassandra- false: deshabilita el complemento Cassandra | true |
| Interruptor del complemento OpenTelemetry | profiler.opentelemetry.enable | boolean | Valores válidos: - true: habilita el complemento OpenTelemetry- false: deshabilita el complemento OpenTelemetry | true |
| Interruptor del complemento Google HTTP Client | profiler.googlehttpclient.enable | boolean | Valores válidos: - true: habilita el complemento Google HTTP Client- false: deshabilita el complemento Google HTTP Client | true |
| Interruptor del complemento Ning | profiler.ning.asynchttpclient.enable | boolean | Valores válidos: - true: habilita el complemento Ning- false: deshabilita el complemento Ning | true |
Configuración de perfilado de subprocesos
| Configuración | JSONPath | Tipo | Descripción | Valor predeterminado |
| Interruptor de perfilado de subprocesos | profiler.tprof.enableJvmThreadStatistic | boolean | Valores válidos: - true: habilita el perfilado de subprocesos- false: deshabilita el perfilado de subprocesos | true |
| Interruptor para guardar periódicamente pilas de métodos locales | profiler.tprof.enableThreadStackRecorder | boolean | Valores 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ón | profiler.tprof. threadProfilerSlowInteractionRt | int | Unidad: 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ón | JSONPath | Tipo | Descripción | Valor predeterminado |
| Origen de registro | profiler.logSource | String | Valores válidos: - sls: Simple Log Service | sls |
| Interruptor para asociar automáticamente registros de negocio con ID de traza | profiler.logging.enable | boolean | Valores 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 registros | profiler.logging.injectTraceId2Log.enable | boolean | Valores 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 registrosEsta configuración surte efecto para agentes de ARMS V4.1.6 o posteriores. | true |
| Interruptor para completar automáticamente ID de span en registros | profiler.logging.injectSpanId2Log.enable | boolean | Valores 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 registrosEsta configuración surte efecto para agentes de ARMS V4.1.6 o posteriores. | true |
| Asociar Simple Log Service - Región | profiler.SLS.regionId | String | La región donde reside el origen de registro asociado. | "" |
| Asociar Simple Log Service - Proyecto | profiler.SLS.project | String | El proyecto al que pertenece el origen de registro asociado. | "" |
| Asociar Simple Log Service - Logstore | profiler.SLS.logStore | String | El Logstore al que pertenece el origen de registro asociado. | "" |
| Asociar Simple Log Service - Índice asociado | profiler.SLS.index | String | El índice del origen de registro asociado. | "" |
Configuración de convergencia de URL
| Configuración | JSONPath | Tipo | Descripción | Valor predeterminado |
| URL de convergencia | profiler.convergence.enable | boolean | Valores válidos: - true: habilita la función de convergencia de URL- false: deshabilita la función de convergencia de URL | true |
| Umbral de convergencia | profiler.convergence.minServerSize | long | Las URL convergen cuando se alcanza el umbral. | 1000 |
| Regla de convergencia | profiler.convergence.pattern | String | Cada regla es una expresión regular. Ejemplo: /service/(.*?)/demo.Separe múltiples reglas con comas (,). | "" |
Configuración de Arthas
| Configuración | JSONPath | Tipo | Descripción | Valor predeterminado |
| Interruptor de Arthas | profiler.arthas.enable | boolean | Valores 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 real | profiler.arthas.enableIps | string | Las 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ón | JSONPath | Tipo | Descripción | Valor predeterminado |
| Interruptor | profiler.cp.enable | boolean | Valores 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 CPU | profiler.cp.cpuEnable | boolean | Valores 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 memoria | profiler.cp.allocEnable | boolean | Valores 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ódigo | profiler.cp.wallClockEnable | boolean | Valores 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 |
| Modo | Clave | Campo | Valor |
| Lista blanca de direcciones IP | cp.allowIPs | Lista blanca de direcciones IP | La 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.allowNetwork | Bloque CIDR | Especifique una cadena vacía. De lo contrario, esta función no funcionará correctamente. | |
| Bloque CIDR | cp.allowIPs | Lista blanca de direcciones IP | Especifique una cadena vacía. De lo contrario, esta función no funcionará correctamente. |
| cp.allowNetwork | Bloque CIDR | El 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ón | JSONPath | Tipo | Descripción | Valor predeterminado |
| Interruptor de enmascaramiento de datos | profiler.sanitizer.enable | boolean | Valores 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 datos | profiler.sanitizer.keys | String | Coincidencia 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ón | JSONPath | Tipo | Descripción | Valor predeterminado |
| Umbral de solicitud lenta | profiler.thresholds.interface | long | Unidad: ms. Si el tiempo de respuesta es mayor que este umbral, la solicitud se marca como lenta. | 500 |
| Lista blanca de excepciones | profiler.exception.whitelist | String | Especifique 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 padre | profiler.exception.filterByParentClass | boolean | Valores válidos: - true: habilita la función- false: deshabilita la funciónDespué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 HTTP | profiler.error.skip | String | Los códigos de estado HTTP que desea ignorar. Separe múltiples valores con comas (,). | "" |
| Filtrado de llamadas de API no válidas | profiler.defined.excludeurl | String | Las 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ón | JSONPath | Tipo | Descripción | Valor predeterminado |
| Umbral de consulta SQL lenta | profiler.thresholds.sql | long | Unidad: 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 SQL | profiler.callsql.maxLength | long | Si el valor de una sentencia SQL supera el umbral, la sentencia SQL se trunca. | 1024 |
| Interruptor para mostrar variables vinculadas en sentencias SQL | profiler.jdbc.tracesqlbindvalue | boolean | Valores válidos: - true: habilita la función- false: deshabilita la funciónSi 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 SQL | profiler.jdbc. tracesqlraw | boolean | Valores válidos: - true: habilita la función- false: deshabilita la funciónDespué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ón | JSONPath | Tipo | Descripción | Valor predeterminado |
| Protocolo de propagación de contexto | profiler.trace.protocol.name | String | Valores válidos: - Unset: no establecido- W3C: OpenTelemetry W3C- SkyWalking- Zipkin: Zipkin B3- Jaeger- EagleEye | Unset |
| Modo de propagación de contexto | profiler.trace.protocol. strategy | String | Valores válidos: - PriorityUse- ForceUse | PriorityUse |
Configuración avanzada
| Configuración | JSONPath | Tipo | Descripción | Valor predeterminado |
| Número máximo de trazas recopiladas por el agente por segundo | profiler.thresholds.limit | int | Una 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étodos | profiler.callstack.maxLength | int | Si 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 tipo | profiler.exception.stacktrace | int | La 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 solicitud | profiler.param.maxLength | int | La longitud máxima de visualización de los parámetros de solicitud. | 512 |
| Consumidor RabbitMQ personalizado | profiler.rabbitmq.client.consumer.classes | String | Los 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 personalizado | profiler.kafka.consumer.entryPoint | String | El 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 mensajes | profiler.kafka.enableInjectKafkaHeaders | boolean | Especifica 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íncrona | profiler.thread.match.package | String | Cuando 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 HTTP | profiler.responseInject.enable | boolean | Valores 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.