Végrehajtási összefoglaló bővítmény (ExecutionSummaryPlugin)

A proxyn áthaladó kérések összegzését hozza létre.

Tipp.

Az összegzés fájlba mentéséhez használjon egy riporter beépülő modult a konfigurációban.

Példa konfigurációra

{
  "$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"
  }
}

Konfigurációs tulajdonságok

Tulajdonság	Leírás	Alapértelmezett
groupBy	Hogyan csoportosítsa a proxy az információkat az összegzésben. Elérhető lehetőségek: url, messageType	url

Parancssori beállítások

Név	Leírás	Alapértelmezett
--summary-group-by	Hogyan csoportosítsa a proxy az információkat az összegzésben. Elérhető lehetőségek: url, messageType	url

Output

A ExecutionSummaryPlugin a rögzítés leállításakor hozza létre a jelentést. A jelentés JSON-ként való mentéséhez adja hozzá a JsonReportert a ExecutionSummaryPlugin után a konfigurációban. A JsonReporter egy, az aktuális munkakönyvtárban elnevezett ExecutionSummaryPlugin_JsonReporter.json fájlba írja a jelentést. Ha a fájl már létezik, a Dev Proxy például ExecutionSummaryPlugin_JsonReporter_20261105104151.jsonegy időbélyeget fűz a fájl nevéhez.

A JSON-jelentés egy három szint mélyen beágyazott objektum. A legbelső szinten lévő értékek olyan számok, amelyek azt mutatják, hogy a Dev Proxy hányszor naplózott üzenetet. Az egyes szintek jelentése a groupBy beállítástól függ.

A Dev Proxy a következő olvasható kategórianeveket használja a jelentésben:

Category	Leírás
Requests intercepted	A Dev Proxy által lehallgatott kérések. Csak akkor tartalmazza, ha groupBymessageType
Requests passed through	A Dev Proxy által az eredeti kiszolgálónak átadott kérések
Requests mocked	Olyan kérések, amelyekre egy beépülő modul utánzatválaszt adott vissza
Requests with chaos	Olyan kérelmek, amelyeknél egy beépülő modul hibát vagy késést szimulált
Failures	Sikertelen kérések
Tips	Tippek a kéréshez naplózott beépülő modulokhoz
Warnings	Figyelmeztetések a kéréshez naplózott beépülő modulokról
Unknown	A kéréshez naplózott egyéb üzenetek, például a kérés időbélyegei és a kérést kihagyó beépülő modulok üzenetei

Csoportosítás URL-cím szerint

Ha groupBy igen url, a jelentés a következő alakzatot tartalmazza:

{
  "<method> <url>": {
    "<category>": {
      "<message>": <count>
    }
  }
}

Level	Leírás
1	Az egyes lehallgatott kérések HTTP-metódusa és URL-címe, például GET https://jsonplaceholder.typicode.com/users. Minden metódus és URL-kombináció egyszer jelenik meg, függetlenül attól, hogy az alkalmazás hányszor nevezte el
2	A Dev Proxy által a kéréshez naplózott üzenetek kategóriája
3	Az üzenet, amelyet a Dev Proxy naplózott, megfeleltetve arra a hányszor, amikor a Dev Proxy naplózza a metódushoz és az URL-címhez

Az alábbi példa egy olyan alkalmazás jelentését mutatja be, amely egyszer hívott GET https://jsonplaceholder.typicode.com/users , amelyet a Dev Proxy kikanált, és GET https://jsonplaceholder.typicode.com/posts kétszer, amelyen a Dev Proxy áthaladt. A Unknown bejegyzések az olvashatóság érdekében rövidülnek.

{
  "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
    }
  }
}

Csoportosítás üzenettípus szerint

Ha groupBy igen messageType, a jelentés a következő alakzatot tartalmazza:

{
  "<category>": {
    "<message>": {
      "<method> <url>": <count>
    }
  }
}

Level	Leírás
1	A Dev Proxy által naplózott üzenetek kategóriája
2	A Dev Proxy által naplózott üzenet. A kategóriák esetében Requests passed through ez a Requests intercepted szint megismétli a kategória nevét
3	A kérés HTTP-metódusa és URL-címe, amellyel a Dev Proxy hányszor naplózott üzenetet az adott metódushoz és URL-címhez

Az alábbi példa ugyanazokat a kéréseket mutatja be üzenettípus szerint csoportosítva. A Unknown kategória rövidítve van az olvashatóság érdekében.

{
  "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
    }
  }
}

Tipp.

Ha olyan CI-folyamatot szeretne beadni, amely a Dev Proxy elfogását kéri, használja a messageType csoportosítást, és olvassa el az ["Requests intercepted"]["Requests intercepted"] objektum kulcsait. url A csoportosítás során olvassa el a legfelső szintű kulcsokat. Minden kulcs a HTTP-metódussal kezdődik, majd egy szóközzel és az URL-címmel. Ne támaszkodhat a kategória tartalmára Unknown , mert időbélyegeket és egyéb diagnosztikai üzeneteket is tartalmaz.

Lásd még

• Rekord szkriptekből és CI-ből
• Dev Proxy használata CI/CD-forgatókönyvekben
• Proxy API

Következő lépés

Proxytevékenység rögzítése és exportálása