Plugin de Resumen de Ejecución

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.

Captura de pantalla de un símbolo del sistema con el resumen de ejecución del proxy de desarrollo con información sobre las solicitudes interceptadas.

Captura de pantalla de un símbolo del sistema con el resumen de las solicitudes interceptadas por el proxy de desarrollo.

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.

Consulte también

Paso siguiente