Application Elemzések Profiler hibaelhárítása

Ez a cikk hibaelhárítási lépéseket és információkat tartalmaz az Alkalmazás Elemzések Profiler használatához.

A megfelelő Profiler-végpontot használja?

Jelenleg csak a 21Vianet által üzemeltetett Azure Government és Microsoft Azure igényel végpontmódosítást.

Alkalmazásbeállítás US Government Cloud China Cloud
Alkalmazás Elemzések ProfilerEndpoint https://profiler.monitor.azure.us https://profiler.monitor.azure.cn
Alkalmazás Elemzések Endpoint https://dc.applicationinsights.us https://dc.applicationinsights.azure.cn

Az alkalmazás a megfelelő verzióban fut?

A profilkészítő a .NET-keretrendszer 4.6.2-nél később támogatott.

Ha a webalkalmazás egy ASP.NET Core-alkalmazás, akkor a legújabb támogatott ASP.NET Core-futtatókörnyezetben kell futnia.

A megfelelő Azure-szolgáltatási csomagot használja?

A Profiler jelenleg nem támogatott ingyenes vagy megosztott App Service-csomagokban. Frissítsen a Profiler egyik alapcsomagjára a működés megkezdéséhez.

Megjegyzés:

Az Azure Functions használati csomagja nem támogatott. Tekintse meg a Profil élő Azure Functions-alkalmazást az Application Elemzések használatával.

Profiler-adatokat keres a megfelelő időkereten belül?

Ha a megtekinteni kívánt adatok két hétnél régebbiek, próbálja meg korlátozni az időszűrőt, és próbálkozzon újra. A nyomkövetés hét nap után törlődik.

Hozzáfér az átjáróhoz?

Ellenőrizze, hogy egy tűzfal vagy proxy nem blokkolja-e a weblaphoz való hozzáférést.

Időtúllépéseket lát, vagy ellenőriznie kell, hogy fut-e a Profiler?

A profilkészítési adatok csak akkor lesznek feltöltve, ha csatolhatók egy kérelemhez, amely a Profiler futtatása közben történt. A Profiler óránként két percig gyűjt adatokat. Profilkészítőt profilkészítési munkamenet elindításával is aktiválhat.

A Profiler nyomkövetési üzeneteket és egyéni eseményeket ír az alkalmazás Elemzések erőforrásba. Ezekkel az eseményekkel megtekintheti, hogyan fut a Profiler.

Keresse meg a Profiler által az alkalmazásnak Elemzések erőforrásnak küldött nyomkövetési üzeneteket és egyéni eseményeket.

  1. Az alkalmazás Elemzések erőforrásban válassza a Keresés lehetőséget a felső menüben.

    Screenshot that shows selecting the Search button from the Application Insights resource.

  2. A releváns adatok megkereséséhez használja a következő keresési sztringet:

    stopprofiler OR startprofiler OR upload OR ServiceProfilerSample
    

    Screenshot that shows the search results from aforementioned search string.

    Az előző keresési eredmények két AI-erőforrásból származó keresésekre mutatnak be két példát:

    • Ha az alkalmazás nem kap kéréseket a Profiler futtatása közben, az üzenet azt ismerteti, hogy a feltöltés tevékenység nélkül megszakadt.

    • A Profiler egyéni eseményeket indított el és küldött, amikor a Profiler futása közben történt kéréseket észlelt. Ha az ServiceProfilerSample egyéni esemény megjelenik, az azt jelenti, hogy egy profilt rögzítettek, és elérhető az Alkalmazás Elemzések Teljesítmény panelen.

    Ha nem jelennek meg rekordok, a Profiler nem fut, vagy időtúllépés történt. Győződjön meg arról, hogy engedélyezte a Profilert az Azure-szolgáltatásban.

Kettős számolás párhuzamos szálakban

Ha egy kérelemhez két vagy több párhuzamos szál van társítva, a veremmegjelenítő teljes időmetrikája meghaladhatja a kérés időtartamát. Ebben az esetben a teljes szálidő több, mint a tényleges eltelt idő.

Előfordulhat például, hogy az egyik szál a másikra vár, hogy befejeződjön. A néző megpróbálja észlelni ezt a helyzetet, és kihagyja az érdektelen várakozást. Ennek során a rendszer túl sok információt jelenít meg ahelyett, hogy kihagyja a kritikus fontosságú információkat.

Ha párhuzamos szálakat lát a nyomkövetésekben, állapítsa meg, hogy mely szálak várakoznak, hogy azonosítani tudja a kérés gyakori elérésű útvonalát. Általában az a szál, amely gyorsan várakozási állapotba kerül, a többi szálra vár. Koncentráljon a többi szálra, és hagyja figyelmen kívül a várakozási szálak idejét.

A Profiler hibaelhárítása az adott Azure-szolgáltatásban

Az alábbi szakaszok végigvezetik a Profiler Azure-alkalmazás Service-en vagy Azure Cloud Servicesen való használatával kapcsolatos hibaelhárítási lépéseken.

Azure App Service

Ahhoz, hogy a Profiler megfelelően működjön, győződjön meg arról, hogy:

  • A webalkalmazásban a megfelelő beállításokkal engedélyezve van az alkalmazás Elemzések.

  • Fut az alkalmazás Elemzések Profiler3 WebJob. A webfeladat ellenőrzése:

    1. Ugrás a Kudura. In the Azure portal:

      1. Az App Service-példányban válassza a Speciális eszközök lehetőséget a bal oldali panelen.
      2. Válassza az Ugrás lehetőséget.
    2. A felső menüben válassza az Eszközök>WebJobs irányítópultot. Megnyílik a WebJobs panel.

      Ha az Alkalmazás Elemzések Profiler3 nem jelenik meg, indítsa újra az App Service-alkalmazást.

      Screenshot that shows the WebJobs pane, which displays the name, status, and last runtime of jobs.

    3. A WebJob részleteinek megtekintéséhez, beleértve a naplót is, válassza az Alkalmazás Elemzések Profiler3 hivatkozást. Megnyílik a Folyamatos webfeladat részletei panel.

      Screenshot that shows the Continuous WebJob Details pane.

Ha a Profiler továbbra sem működik Önnek, töltse le a naplót, és küldjön be egy Azure-támogatás jegyet.

A Diagnosztikai szolgáltatások webhelybővítmény állapotlapjának ellenőrzése

Ha a Profiler engedélyezve lett a portál Alkalmazás Elemzések paneljén keresztül, a Diagnosztikai szolgáltatások webhelybővítmény engedélyezte. A bővítmény állapotlapját a következő lépéssel https://{site-name}.scm.azurewebsites.net/DiagnosticServicesellenőrizheti:

Megjegyzés:

Az állapotlap hivatkozásának tartománya a felhőtől függően változik. Ez a tartomány megegyezik az App Service Kudu felügyeleti webhelyével.

Az állapotlapon a Profiler és a Snapshot Debugger ügynökök telepítési állapota látható. Ha váratlan hiba történt, megjelenik a javítás lépéseivel együtt.

Az App Service Kudu felügyeleti webhelyével lekérheti az állapotlap alap URL-címét:

  1. Nyissa meg az App Service-alkalmazást az Azure Portalon.
  2. Válassza a Speciális eszközök lehetőséget.
  3. Válassza az Ugrás lehetőséget.
  4. A Kudu felügyeleti webhelyén:
    1. Fűzze hozzá az /DiagnosticServices elérés utat az URL-címhez.
    2. Nyomja le az Enter billentyűt.

Úgy végződik, mint https://<kudu-url>/DiagnosticServices.

Az állapotlap az alábbi példához hasonlóan jelenik meg.

Screenshot that shows the Diagnostic Services status page.

Megjegyzés:

Az Application Elemzések Profiler kód nélküli telepítése a .NET Core támogatási szabályzatát követi. A támogatott futtatókörnyezetekről további információt a .NET Core támogatási szabályzatában talál.

Manuális telepítés

A Profiler konfigurálásakor a rendszer frissíti a webalkalmazás beállításait. Szükség esetén manuálisan is alkalmazhatja a frissítéseket.

Túl sok aktív profilkészítési munkamenet

A Profiler legfeljebb négy olyan webalkalmazáson engedélyezhető, amelyek ugyanabban a szolgáltatási csomagban futnak. Ha négynél többel rendelkezik, a Profiler a következő hibát jelezheti:

Microsoft.ServiceProfiler.Exceptions.TooManyETWSessionException

A megoldáshoz helyezzen át néhány webalkalmazást egy másik szolgáltatáscsomagba.

Üzembe helyezési hiba: A címtár nem üres "D:\home\site\wwwroot\App_Data\jobs"

Ha újra üzembe helyezi a webalkalmazást egy Web Apps-erőforrásba, amelyen engedélyezve van a Profiler, a következő üzenet jelenhet meg:

"Directory Not Empty 'D:\home\site\wwwroot\App_Data\jobs'"

Ez a hiba akkor fordul elő, ha a Web Deploy parancsprogramból vagy az Azure Pipelinesból fut. A probléma megoldásához adja hozzá a következő üzembehelyezési paramétereket a Webes üzembe helyezés feladathoz:

-skip:Directory='.*\\App_Data\\jobs\\continuous\\ApplicationInsightsProfiler.*' -skip:skipAction=Delete,objectname='dirPath',absolutepath='.*\\App_Data\\jobs\\continuous$' -skip:skipAction=Delete,objectname='dirPath',absolutepath='.*\\App_Data\\jobs$'  -skip:skipAction=Delete,objectname='dirPath',absolutepath='.*\\App_Data$'

Ezek a paraméterek törlik az Application Elemzések Profiler által használt mappát, és feloldják az újratelepítési folyamat letiltását. Ezek nem érintik az éppen futó Profiler-példányt.

Fut az application Elemzések Profiler?

A Profiler folyamatos WebJob-feladatként fut a webalkalmazásban. A webalkalmazás-erőforrást az Azure Portalon nyithatja meg. A WebJobs panelen ellenőrizze az Application Elemzések Profiler állapotát. Ha nem fut, nyissa meg a Naplókat további információkért.

Virtuális gépek és Azure Cloud Services

Annak ellenőrzése, hogy a Profiler megfelelően van-e konfigurálva az Azure Diagnosticsban:

  1. Ellenőrizze, hogy az üzembe helyezett Azure Diagnostics-konfiguráció tartalma megfelel-e a vártnak.

  2. Győződjön meg arról, hogy az Azure Diagnostics átadja a profiler parancssorának megfelelő iKey-t.

  3. Ellenőrizze a Profiler naplófájljában, hogy a Profiler futott-e, de hibát adott vissza.

Az Azure Diagnostics konfigurálásához használt beállítások ellenőrzése:

  1. Jelentkezzen be a virtuális gépre.

  2. Nyissa meg a naplófájlt ezen a helyen. Előfordulhat, hogy a beépülő modul verziója újabb a számítógépen.

    Virtuális gépek esetén:

    c:\WindowsAzure\logs\Plugins\Microsoft.Azure.Diagnostics.PaaSDiagnostics\1.11.3.12\DiagnosticsPlugin.log
    

    Azure Cloud Services esetén:

    c:\logs\Plugins\Microsoft.Azure.Diagnostics.PaaSDiagnostics\1.11.3.12\DiagnosticsPlugin.log
    
  3. A fájlban keresse meg a sztringet WadCfg az Azure Diagnostics konfigurálásához a virtuális gépnek átadott beállítások megkereséséhez.

  4. Ellenőrizze, hogy a Profiler fogadó által használt iKey helyes-e.

  5. Ellenőrizze a Profiler indításához használt parancssort. A Profiler elindításához használt argumentumok a következő fájlban találhatók (a meghajtó lehet c: , vagy d: a könyvtár rejtett lehet):

    Virtuális gépek esetén:

    C:\ProgramData\ApplicationInsightsProfiler\config.json
    

    Azure Cloud Services esetén:

    D:\ProgramData\ApplicationInsightsProfiler\config.json
    
  6. Győződjön meg arról, hogy a Profiler parancssorában található iKey helyes.

  7. Az előző config.json fájlban található elérési út használatával ellenőrizze a Profiler naplófájlt, amelynek neve .BootstrapN.log A következőket jeleníti meg:

    • A Profiler által használt beállításokat jelző hibakeresési információk.
    • Állapot és hibaüzenetek a Profilertől.

    A fájl a következő:

    Virtuális gépek esetén:

    C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Diagnostics.IaaSDiagnostics\1.17.0.6\ApplicationInsightsProfiler
    

    Azure Cloud Services esetén:

    C:\Logs\Plugins\Microsoft.Azure.Diagnostics.IaaSDiagnostics\1.17.0.6\ApplicationInsightsProfiler
    
  8. Ha a Profiler fut, miközben az alkalmazás kéréseket fogad, a következő üzenet jelenik meg: "Tevékenység észlelhető az iKey-ből".

  9. A nyomkövetés feltöltésekor a következő üzenet jelenik meg: "Nyomkövetés feltöltésének megkezdése".

Hálózati proxy- vagy tűzfalszabályok szerkesztése

Ha az alkalmazás proxyn vagy tűzfalon keresztül csatlakozik az internethez, előfordulhat, hogy frissítenie kell a szabályokat a Profilerrel való kommunikációhoz.

Az Application Elemzések Profiler által használt IP-címek szerepelnek az Azure Monitor szolgáltatáscímkéjében. További információ: Szolgáltatáscímkék dokumentációja.

Support

Ha továbbra is segítségre van szüksége, küldjön támogatási jegyet az Azure Portalon. Adja meg a korrelációs azonosítót a hibaüzenetből.