Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Crea un resumen de las solicitudes que pasan por el proxy.
Sugerencia
Use un complemento de reportera en la configuración para guardar el resumen en un archivo.
Ejemplo de configuración
{
"$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v4.0.0/rc.schema.json",
"plugins": [
{
"name": "ExecutionSummaryPlugin",
"enabled": true,
"pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
"configSection": "executionSummaryPlugin"
}
],
"executionSummaryPlugin": {
"$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v4.0.0/executionsummaryplugin.schema.json",
"groupBy": "url"
}
}
Propiedades de configuración
| Propiedad | Descripción | Valor predeterminado |
|---|---|---|
groupBy |
Cómo el proxy debe agrupar la información en el resumen. Opciones disponibles: url, messageType. |
url |
Opciones de línea de comandos
| Nombre | Descripción | Valor predeterminado |
|---|---|---|
--summary-group-by |
Cómo el proxy debe agrupar la información en el resumen. Opciones disponibles: url, messageType. |
url |
Output
ExecutionSummaryPlugin crea su informe al detener la grabación. Para guardar el informe como JSON, agregue JsonReporter después de ExecutionSummaryPlugin en la configuración. JsonReporter escribe el informe en un archivo denominado ExecutionSummaryPlugin_JsonReporter.json en el directorio de trabajo actual. Si el archivo ya existe, dev Proxy anexa una marca de tiempo al nombre de archivo, por ejemplo ExecutionSummaryPlugin_JsonReporter_20261105104151.json.
El informe JSON es un objeto anidado de tres niveles en profundidad. Los valores del nivel más interno son números que muestran cuántas veces dev Proxy de desarrollo registró un mensaje. El significado de cada nivel depende de la groupBy configuración.
El proxy de desarrollo usa los siguientes nombres de categoría legibles en el informe:
| Category | Descripción |
|---|---|
Requests intercepted |
Solicita que el proxy de desarrollo intercepte. Solo se incluye cuando groupBy es messageType |
Requests passed through |
Solicitudes que el proxy de desarrollo pasó al servidor original |
Requests mocked |
Solicitudes para las que un complemento devolvió una respuesta ficticia |
Requests with chaos |
Solicitudes para las que un complemento simulaba un error o latencia |
Failures |
Solicitudes con error |
Tips |
Sugerencias que los complementos registrados para la solicitud |
Warnings |
Advertencias que los complementos registrados para la solicitud |
Unknown |
Otros mensajes registrados para la solicitud, como marcas de tiempo de solicitud y mensajes de complementos que omitieron la solicitud |
Agrupar por dirección URL
Cuando groupBy es url, el informe tiene la siguiente forma:
{
"<method> <url>": {
"<category>": {
"<message>": <count>
}
}
}
| Level | Descripción |
|---|---|
| 1 | El método HTTP y la dirección URL de cada solicitud interceptada, por ejemplo GET https://jsonplaceholder.typicode.com/users. Cada combinación de métodos y direcciones URL aparece una vez, independientemente de cuántas veces la aplicación la llame |
| 2 | Categoría de los mensajes que el proxy de desarrollo registró para la solicitud. |
| 3 | El mensaje que registró el proxy de desarrollo, asignado al número de veces que el proxy de desarrollo lo registró para el método y la dirección URL. |
En el ejemplo siguiente se muestra un informe de una aplicación a la que se llamó GET https://jsonplaceholder.typicode.com/users una vez, que el proxy de desarrollo simulaba y GET https://jsonplaceholder.typicode.com/posts dos veces, el proxy de desarrollo que pasó a través. Las Unknown entradas se acortan para mejorar la legibilidad.
{
"GET https://jsonplaceholder.typicode.com/users": {
"Unknown": {
"2026-11-05T10:41:13.1151430+00:00": 1,
"GET https://jsonplaceholder.typicode.com/users": 1
},
"Requests mocked": {
"200 https://jsonplaceholder.typicode.com/users": 1
}
},
"GET https://jsonplaceholder.typicode.com/posts": {
"Unknown": {
"No matching mock response found": 2,
"GET https://jsonplaceholder.typicode.com/posts": 2
},
"Requests passed through": {
"Passed through": 2
}
}
}
Agrupar por tipo de mensaje
Cuando groupBy es messageType, el informe tiene la siguiente forma:
{
"<category>": {
"<message>": {
"<method> <url>": <count>
}
}
}
| Level | Descripción |
|---|---|
| 1 | Categoría de los mensajes que registró el proxy de desarrollo. |
| 2 | Mensaje que registró el proxy de desarrollo. Para las Requests intercepted categorías y Requests passed through , este nivel repite el nombre de categoría. |
| 3 | El método HTTP y la dirección URL de la solicitud, asignados al número de veces que el proxy de desarrollo registró el mensaje para ese método y dirección URL. |
En el ejemplo siguiente se muestra el informe de las mismas solicitudes agrupadas por tipo de mensaje. La Unknown categoría se abre para mejorar la legibilidad.
{
"Requests intercepted": {
"Requests intercepted": {
"GET https://jsonplaceholder.typicode.com/users": 1,
"GET https://jsonplaceholder.typicode.com/posts": 2
}
},
"Unknown": {
"No matching mock response found": {
"GET https://jsonplaceholder.typicode.com/posts": 2
}
},
"Requests mocked": {
"200 https://jsonplaceholder.typicode.com/users": {
"GET https://jsonplaceholder.typicode.com/users": 1
}
},
"Requests passed through": {
"Requests passed through": {
"GET https://jsonplaceholder.typicode.com/posts": 2
}
}
}
Sugerencia
Para proteger una canalización de CI que solicita el proxy de desarrollo interceptado, use la messageType agrupación y lea las claves del ["Requests intercepted"]["Requests intercepted"] objeto. Con la url agrupación, lea las claves de nivel superior. Cada clave comienza con el método HTTP seguido de un espacio y la dirección URL. No confíe en el contenido de la Unknown categoría, ya que incluye marcas de tiempo y otros mensajes de diagnóstico.