Workspace-based Application Insights resources

Az Azure Monitoralkalmazás Elemzések munkaterület-alapú erőforrások integrálják az Alkalmazás Elemzések és a Log Analytics szolgáltatást.

Munkaterület-alapú erőforrások esetén az alkalmazás Elemzések telemetriát küld egy közös Log Analytics-munkaterületre, amely teljes hozzáférést biztosít a Log Analytics összes funkciójához, miközben az alkalmazás, az infrastruktúra és a platformnaplók egyetlen összevont helyen maradnak. Ez az integráció lehetővé teszi az azure-beli szerepköralapú hozzáférés-vezérlést az erőforrások között, és szükségtelenné teszi az alkalmazások és munkaterületek közötti lekérdezéseket.

Megjegyzés:

A munkaterület-alapú alkalmazás-Elemzések-erőforrások adatbetöltése és megőrzése azon a Log Analytics-munkaterületen keresztül történik, ahol az adatok találhatók. A munkaterület-alapú alkalmazás-Elemzések-erőforrások számlázásával kapcsolatos további információkért tekintse meg az Azure Monitor-naplók díjszabásának részleteit.

Új képességek

A munkaterület-alapú alkalmazás Elemzések kihasználhatja az Azure Monitor és a Log Analytics legújabb képességeit. Például:

Munkaterület-alapú erőforrás létrehozása

Jelentkezzen be az Azure Portalra, és hozzon létre egy alkalmazás Elemzések erőforrást.

Screenshot that shows a workspace-based Application Insights resource.

Ha nincs meglévő Log Analytics-munkaterülete, tekintse meg a Log Analytics-munkaterület létrehozási dokumentációját.

A munkaterület-alapú erőforrások jelenleg minden kereskedelmi régióban és az Azure Governmentben elérhetők. Ha az Application Elemzések és a Log Analytics két különböző régióban van, az hatással lehet a késésre, és csökkentheti a monitorozási megoldás általános megbízhatóságát.

Az erőforrás létrehozása után a megfelelő munkaterület-információk megjelennek az Áttekintés panelen.

Screenshot that shows a workspace name.

A kék hivatkozás szövegére kattintva lépjen a társított Log Analytics-munkaterületre, ahol kihasználhatja az új egyesített munkaterület lekérdezési környezetét.

Megjegyzés:

Továbbra is teljes kompatibilitást biztosítunk az alkalmazáshoz Elemzések klasszikus erőforrás-lekérdezésekhez, munkafüzetekhez és naplóalapú riasztásokhoz. Az új munkaterület-alapú táblaszerkezet vagy -séma lekérdezéséhez vagy megtekintéséhez először a Log Analytics-munkaterületre kell lépnie. Az Alkalmazás Elemzések paneleken válassza a Naplók (Elemzés) lehetőséget a klasszikus alkalmazás Elemzések lekérdezési felülethez való hozzáféréshez.

A kapcsolati sztring másolása

A kapcsolati sztring azonosítja azt az erőforrást, amelyhez a telemetriai adatokat társítani szeretné. Azt is használhatja, hogy módosítsa azokat a végpontokat, amelyet az erőforrás a telemetria célhelyeként használ. Másolja a kapcsolati sztring, és adja hozzá az alkalmazás kódjához vagy egy környezeti változóhoz.

Figyelés konfigurálása

Miután létrehozott egy munkaterület-alapú alkalmazást Elemzések erőforrást, konfigurálja a figyelést.

Kódalapú alkalmazásfigyelés

Kódalapú alkalmazásfigyeléshez telepítse a megfelelő alkalmazás Elemzések SDK-t, és a kapcsolati sztring az újonnan létrehozott erőforrásra irányítsa.

Az alkalmazás Elemzések SDK kódalapú monitorozáshoz való beállításáról a nyelvre vagy keretrendszerre vonatkozó alábbi dokumentációban talál további információt:

Kód nélküli monitorozás és Visual Studio-erőforrás létrehozása

Az olyan szolgáltatások kód nélküli monitorozásához, mint az Azure Functions és a Azure-alkalmazás Services, először létre kell hoznia a munkaterület-alapú alkalmazás-Elemzések erőforrást. Ezután a figyelés konfigurálásakor erre az erőforrásra mutat.

Ezek a szolgáltatások lehetőséget kínálnak egy új alkalmazás Elemzések erőforrás létrehozására a saját erőforrás-létrehozási folyamatukon belül. Az ezeken a felhasználói felületen létrehozott erőforrások azonban jelenleg a klasszikus alkalmazás Elemzések felületre korlátozódnak.

Ugyanez a korlátozás vonatkozik a Visual Studio ASP.NET és ASP.NET Core alkalmazás Elemzések erőforrás-létrehozási felületére is. Ki kell választania egy meglévő munkaterület-alapú erőforrást a Visual Studio felhasználói felületén, ahol engedélyezi a figyelést. Ha az Új erőforrás létrehozása lehetőséget választja a Visual Studióban, akkor a klasszikus alkalmazás Elemzések erőforrást kell létrehoznia.

Erőforrás automatikus létrehozása

Azure CLI

Az előzetes verziójú alkalmazás Elemzések Azure CLI-parancsok eléréséhez először a következőt kell futtatnia:

 az extension add -n application-insights

Ha nem futtatja a az extension add parancsot, egy hibaüzenet jelenik meg, amely azt jelzi az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help', hogy .

Most futtathatja az alábbi kódot az alkalmazás Elemzések erőforrás létrehozásához:

az monitor app-insights component create --app
                                         --location
                                         --resource-group
                                         [--application-type]
                                         [--ingestion-access {Disabled, Enabled}]
                                         [--kind]
                                         [--only-show-errors]
                                         [--query-access {Disabled, Enabled}]
                                         [--tags]
                                         [--workspace]

Példa

az monitor app-insights component create --app demoApp --location eastus --kind web -g my_resource_group --workspace "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/test1234/providers/microsoft.operationalinsights/workspaces/test1234555"

A parancs teljes Azure CLI-dokumentációját az Azure CLI dokumentációjában találja.

Azure PowerShell

Hozzon létre egy új munkaterület-alapú alkalmazást Elemzések erőforrást.

New-AzApplicationInsights -Name <String> -ResourceGroupName <String> -Location <String> -WorkspaceResourceId <String>
   [-SubscriptionId <String>]
   [-ApplicationType <ApplicationType>]
   [-DisableIPMasking]
   [-DisableLocalAuth]
   [-Etag <String>]
   [-FlowType <FlowType>]
   [-ForceCustomerStorageForProfiler]
   [-HockeyAppId <String>]
   [-ImmediatePurgeDataOn30Day]
   [-IngestionMode <IngestionMode>]
   [-Kind <String>]
   [-PublicNetworkAccessForIngestion <PublicNetworkAccessType>]
   [-PublicNetworkAccessForQuery <PublicNetworkAccessType>]
   [-RequestSource <RequestSource>]
   [-RetentionInDays <Int32>]
   [-SamplingPercentage <Double>]
   [-Tag <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Példa

New-AzApplicationInsights -Kind java -ResourceGroupName testgroup -Name test1027 -location eastus -WorkspaceResourceId "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/test1234/providers/microsoft.operationalinsights/workspaces/test1234555"

A parancsmag teljes PowerShell-dokumentációját és a kapcsolati sztring lekérését az Azure PowerShell dokumentációjában találja.

Azure Resource Manager-sablonok

Munkaterület-alapú erőforrás létrehozásához használja az alábbi Azure Resource Manager-sablonokat, és telepítse őket a PowerShell-lel.

Sablonfájl

{
    "$schema": "http://schema.management.azure.com/schemas/2014-04-01-preview/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "name": {
            "type": "string"
        },
        "type": {
            "type": "string"
        },
        "regionId": {
            "type": "string"
        },
        "tagsArray": {
            "type": "object"
        },
        "requestSource": {
            "type": "string"
        },
        "workspaceResourceId": {
            "type": "string"
        }
    },
    "resources": [
        {
            "name": "[parameters('name')]",
            "type": "microsoft.insights/components",
            "location": "[parameters('regionId')]",
            "tags": "[parameters('tagsArray')]",
            "apiVersion": "2020-02-02-preview",
            "properties": {
                "ApplicationId": "[parameters('name')]",
                "Application_Type": "[parameters('type')]",
                "Flow_Type": "Bluefield",
                "Request_Source": "[parameters('requestSource')]",
                "WorkspaceResourceId": "[parameters('workspaceResourceId')]"
            }
        }
    ]
}

Megjegyzés:

Az erőforrástulajdonságokról további információt a Tulajdonságértékek című témakörben talál. Flow_Type és Request_Source nem használják, de a teljesség érdekében ebben a mintában szerepelnek.

Paraméterfájl

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "type": {
            "value": "web"
        },
        "name": {
            "value": "customresourcename"
        },
        "regionId": {
            "value": "eastus"
        },
        "tagsArray": {
            "value": {}
        },
        "requestSource": {
            "value": "Custom"
        },
        "workspaceResourceId": {
            "value": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my_resource_group/providers/microsoft.operationalinsights/workspaces/myworkspacename"
        }
    }
}

A társított munkaterület módosítása

Miután létrehozott egy munkaterület-alapú alkalmazás-Elemzések erőforrást, módosíthatja a társított Log Analytics-munkaterületet.

Az Alkalmazás Elemzések erőforráspanelen válassza a Tulajdonságok>módosítása munkaterület Log Analytics-munkaterületeit.>

Telemetria exportálása

A munkaterület-alapú erőforrások esetében az örökölt folyamatos exportálási funkció nem támogatott. Ehelyett válassza a Diagnosztikai beállítások>: Diagnosztikai beállítás hozzáadása az alkalmazás Elemzések erőforrásban lehetőséget. A tárfiókba való archiváláshoz kijelölheti az összes táblát vagy a táblák egy részhalmazát. Streamelhet egy Azure-eseményközpontba is.

Megjegyzés:

A diagnosztikai beállítások exportálása növelheti a költségeket. További információ: Telemetriai adatok exportálása az Alkalmazás Elemzések. A szolgáltatás díjszabásával kapcsolatos információkért tekintse meg az Azure Monitor díjszabási oldalát. A számlázás megkezdése előtt a rendszer értesítéseket küld. Ha a értesítési időszak után is telemetriaexportálást használ, akkor a számlázás a vonatkozó díjszabás szerint történik.

Hány alkalmazás-Elemzések erőforrást kell üzembe helyeznem?

Amikor egy webalkalmazás következő verzióját fejleszti, nem szeretné összekeverni az alkalmazás Elemzések telemetriát az új verzióból és a már kiadott verzióból.

A félreértések elkerülése érdekében küldje el a telemetriát a különböző fejlesztési szakaszokból, hogy elkülönítse az alkalmazás Elemzések erőforrásokat külön kapcsolati sztring.

Ha a rendszer az Azure Cloud Services egy példánya, van egy másik módszer a különálló kapcsolati sztring beállítására.

Az erőforrások és kapcsolati sztring ismertetése

Amikor beállítja az Alkalmazás Elemzések monitorozást a webalkalmazáshoz, létrehoz egy alkalmazás-Elemzések erőforrást az Azure-ban. Ezt az erőforrást az Azure Portalon nyithatja meg az alkalmazásból gyűjtött telemetriai adatok megtekintéséhez és elemzéséhez. Az erőforrást egy kapcsolati sztring azonosítja. Amikor telepíti az Alkalmazás Elemzések csomagot az alkalmazás figyeléséhez, konfigurálja a kapcsolati sztring, hogy tudja, hová küldje a telemetriát.

Minden alkalmazás Elemzések erőforráshoz a dobozon kívül elérhető metrikák tartoznak. Ha az összetevők ugyanazon alkalmazás Elemzések erőforráshoz tartoznak, előfordulhat, hogy nem érdemes riasztást készíteni ezekről a metrikákról.

Mikor érdemes egyetlen alkalmazás-Elemzések erőforrást használni?

Egyetlen alkalmazás-Elemzések erőforrás használata:

  • Az együtt üzembe helyezett alkalmazásösszetevők esetében. Ezeket az alkalmazásokat általában egyetlen csapat fejleszti, és ugyanazon DevOps/ITOps-felhasználók kezelik őket.
  • Ha érdemes összesíteni a fő teljesítménymutatókat, például a válaszidőket vagy a hibaarányokat egy irányítópulton, alapértelmezés szerint mindegyikre. A metrikák kezelőjében szerepkörnév alapján választhat szegmentálást.
  • Ha nincs szükség az Azure szerepköralapú hozzáférés-vezérlésének eltérő kezelésére az alkalmazásösszetevők között.
  • Ha nincs szüksége olyan metrikákra vonatkozó riasztási feltételekre, amelyek különböznek az összetevők között.
  • Ha nem kell másként kezelnie a folyamatos exportálást az összetevők között.
  • Ha nem kell eltérő módon kezelnie a számlázást/kvótákat az összetevők között.
  • Ha nem baj, ha egy API-kulccsal azonos hozzáféréssel rendelkezik az összes összetevő adataihoz. A 10 API-kulcs pedig mindegyikhez elegendő.
  • Ha minden szerepkörben ugyanazokkal az intelligens észlelési és munkaelem-integrációs beállításokkal rendelkezik.

Megjegyzés:

Ha több alkalmazás-Elemzések erőforrást szeretne összesíteni, a meglévő alkalmazásösszetevőket egy új, konszolidált alkalmazás-Elemzések erőforrásra irányíthatja. A régi erőforrásban tárolt telemetriai adatok nem lesznek átadva az új erőforrásnak. Csak akkor törölje a régi erőforrást, ha elegendő telemetriával rendelkezik az új erőforrásban az üzletmenet folytonosságához.

Other considerations

Vegye figyelembe, hogy:

  • Előfordulhat, hogy egyéni kódot kell hozzáadnia ahhoz, hogy a jelentéssel bíró értékek be legyenek állítva a Cloud_RoleName attribútumba. Az attribútumhoz beállított értelmes értékek nélkül a portál egyik felülete sem fog működni.
  • Az Azure Service Fabric-alkalmazások és a klasszikus felhőszolgáltatások esetében az SDK automatikusan beolvassa az Azure Szerepkörkörnyezetből, és beállítja ezeket a szolgáltatásokat. Minden más típusú alkalmazás esetében ezt valószínűleg explicit módon kell beállítania.
  • Az élő metrikák nem támogatják a szerepkörnevek szerinti felosztást.

További alkalmazás-Elemzések-erőforrások létrehozása

Alkalmazások Elemzések erőforrás létrehozásához lásd: Alkalmazás Elemzések erőforrás létrehozása.

Figyelmeztetés

További hálózati költségek merülhetnek fel, ha az alkalmazás Elemzések erőforrás egy másik régióban lévő Azure-erőforrást (azaz telemetriai gyártót) figyel. A költségek attól függően változnak, hogy a telemetria melyik régióból érkezik, és hogy hová tart. Részletekért tekintse meg az Azure sávszélesség-díjszabását .

A kapcsolati sztring lekérése

A kapcsolati sztring azonosítja a létrehozott erőforrást.

Szüksége van az összes olyan erőforrás kapcsolati sztring, amelyekbe az alkalmazás adatokat fog küldeni.

Szűrés a buildszámra

Az alkalmazás új verziójának közzétételekor el kell tudnia különíteni a telemetriát a különböző buildektől.

Beállíthatja az Alkalmazásverzió tulajdonságot, hogy szűrhesse a keresési és a metrikaböngésző eredményeit.

Az Alkalmazásverzió tulajdonság beállításának több különböző módja is van.

  • Közvetlen beállítás:

    telemetryClient.Context.Component.Version = typeof(MyProject.MyClass).Assembly.GetName().Version;

  • Csomagolja be ezt a sort egy telemetriai inicializálóba , hogy az összes TelemetryClient példány konzisztens legyen.

  • ASP.NET: A verzió beállítása a következőben BuildInfo.config: . A webes modul felveszi a verziót a BuildLabel csomópontról. Vegye fel ezt a fájlt a projektbe, és ne felejtse el beállítani a Copy Always tulajdonságot Megoldáskezelő.

    <?xml version="1.0" encoding="utf-8"?>
    <DeploymentEvent xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/VisualStudio/DeploymentEvent/2013/06">
      <ProjectName>AppVersionExpt</ProjectName>
      <Build type="MSBuild">
        <MSBuild>
          <BuildLabel kind="label">1.0.0.2</BuildLabel>
        </MSBuild>
      </Build>
    </DeploymentEvent>
    
    
  • ASP.NET: Automatikus létrehozás BuildInfo.config a Microsoft buildmotorjában. Adjon hozzá néhány sort a .csproj fájlhoz:

    <PropertyGroup>
      <GenerateBuildInfoConfigFile>true</GenerateBuildInfoConfigFile>    <IncludeServerNameInBuildInfo>true</IncludeServerNameInBuildInfo>
    </PropertyGroup>
    

    Ez a lépés létrehoz egy yourProjectName.BuildInfo.config nevű fájlt. A közzétételi folyamat átnevezi a következőre BuildInfo.config: .

    A buildcímke helyőrzőt (AutoGen_...) tartalmaz, amikor a Visual Studióval készít. Ha azonban a Microsoft buildmotorral készült, akkor a megfelelő verziószámmal van feltöltve.

    Ha engedélyezni szeretné, hogy a Microsoft Build Engine verziószámokat hozzon létre, állítsa be a verziót a következőhöz AssemblyReference.cshasonlóan1.0.*.

Verzió- és kiadáskövetés

Az alkalmazás verziójának nyomon követéséhez győződjön meg arról, hogy a Microsoft Build Engine folyamata létrejön buildinfo.config. A fájlban adja hozzá a .csproj következőt:

<PropertyGroup>
  <GenerateBuildInfoConfigFile>true</GenerateBuildInfoConfigFile>
  <IncludeServerNameInBuildInfo>true</IncludeServerNameInBuildInfo>
</PropertyGroup>

Ha az alkalmazás Elemzések webmodul rendelkezik a buildelési információkkal, automatikusan hozzáadja az alkalmazásverziót tulajdonságként minden telemetriai elemhez. Ezért a diagnosztikai keresések vagy metrikák vizsgálatakor verzió szerint is szűrhet.

A build verziószámát csak a Microsoft Build Engine hozza létre, a Visual Studióból származó fejlesztői build nem.

Kiadási jegyzetek

Az Azure DevOps használata esetén egy jegyzetjelölőt is hozzáadhat a diagramokhoz, amikor új verziót ad ki.

Gyakori kérdések

Ez a szakasz választ ad a gyakori kérdésekre.

Hogyan áthelyezni egy alkalmazás-Elemzések erőforrást egy új régióba?

A meglévő alkalmazás Elemzések erőforrások áthelyezése egyik régióból a másikba jelenleg nem támogatott. Az összegyűjtött előzményadatok nem migrálhatók új régióba. Az egyetlen részleges kerülő megoldás a következő:

  1. Hozzon létre egy új munkaterület-alapú alkalmazást Elemzések erőforrást az új régióban.
  2. Hozza létre újra az új erőforrásban az eredeti erőforrásra jellemző összes egyedi testreszabást.
  3. Módosítsa az alkalmazást az új régió erőforrásának kapcsolati sztring használatára.
  4. Tesztelje, hogy minden a várt módon működik-e az új alkalmazás Elemzések erőforrással.
  5. Ezen a ponton megtarthatja vagy törölheti az eredeti alkalmazás Elemzések erőforrást. Ha egy klasszikus alkalmazás Elemzések erőforrást töröl, az összes előzményadat elveszik. Ha az eredeti erőforrás munkaterületen alapult, az adatai a Log Analyticsben maradnak. Az eredeti alkalmazás Elemzések erőforrás megtartása lehetővé teszi az előzményadatok elérését, amíg az adatmegőrzési beállítások elfogynak.

Az új régióban lévő erőforráshoz gyakran manuálisan újra kell létrehozni vagy frissíteni kívánt egyedi testreszabások közé tartoznak, de nem korlátozódnak a következőkre:

  • Egyéni irányítópultok és munkafüzetek újbóli létrehozása.
  • Hozza létre vagy frissítse újra az egyéni napló-/metrikariasztások hatókörét.
  • Hozza létre újra a rendelkezésre állási riasztásokat.
  • Hozza létre újra azokat az egyéni Azure-szerepköralapú hozzáférés-vezérlési beállításokat, amelyek szükségesek ahhoz, hogy a felhasználók hozzáférjenek az új erőforráshoz.
  • Replikálja a betöltési mintavételezést, az adatmegőrzést, a napi korlátot és az egyéni metrikák engedélyezését magában foglaló beállításokat. Ezeket a beállításokat a Használat és a becsült költségek panelen lehet szabályozni.
  • Az API-kulcsokra támaszkodó összes integráció, például a kibocsátási széljegyzetek és az élő metrikák biztonságos vezérlési csatornája. Új API-kulcsokat kell létrehoznia, és frissítenie kell a társított integrációt.
  • A klasszikus erőforrások folyamatos exportálását újra konfigurálni kell.
  • A munkaterület-alapú erőforrások diagnosztikai beállításait újra konfigurálni kell.

Megjegyzés:

Ha az új régióban létrehozott erőforrás lecserél egy klasszikus erőforrást, javasoljuk, hogy vizsgálja meg az új munkaterület-alapú erőforrás létrehozásának előnyeit. Másik lehetőségként migrálja a meglévő erőforrást munkaterület-alapúra.

További lépések