Munkaterület-alapú Application Insights-erőforrások

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.

Feljegyzé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 integrálható az Azure Monitor és a Log Analytics szolgáltatással a képességek javítása érdekében:

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.

Képernyőkép egy munkaterület-alapú alkalmazás Elemzések erőforrásról.

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.

Képernyőkép a munkaterület nevéről.

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.

Feljegyzé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

A munkaterület-alapú alkalmazás Elemzések erőforrás létrehozása után konfigurálja a monitorozá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

@description('Name of Application Insights resource.')
param name string

@description('Type of app you are deploying. This field is for legacy reasons and will not impact the type of App Insights resource you deploy.')
param type string

@description('Which Azure Region to deploy the resource to. This must be a valid Azure regionId.')
param regionId string

@description('See documentation on tags: https://learn.microsoft.com/azure/azure-resource-manager/management/tag-resources.')
param tagsArray object

@description('Source of Azure Resource Manager deployment')
param requestSource string

@description('Log Analytics workspace ID to associate with your Application Insights resource.')
param workspaceResourceId string

resource component 'Microsoft.Insights/components@2020-02-02' = {
  name: name
  location: regionId
  tags: tagsArray
  kind: 'other'
  properties: {
    Application_Type: type
    Flow_Type: 'Bluefield'
    Request_Source: requestSource
    WorkspaceResourceId: workspaceResourceId
  }
}

Paraméterfájl

{
  "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "name": {
      "value": "my_workspace_based_resource"
    },
    "type": {
      "value": "web"
    },
    "regionId": {
      "value": "westus2"
    },
    "tagsArray": {
      "value": {}
    },
    "requestSource": {
      "value": "CustomDeployment"
    },
    "workspaceResourceId": {
      "value": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/testxxxx/providers/microsoft.operationalinsights/workspaces/testworkspace"
    }
  }
}

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

A munkaterület-alapú alkalmazás Elemzések erőforrás létrehozása után 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.

Feljegyzé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 Application Insightsból. 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. 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. Egy kapcsolati sztring azonosítja az erőforrást. 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:

  • A DevOps/ITOps felügyeletének egyszerűsítése az együtt üzembe helyezett alkalmazásokhoz, amelyeket általában ugyanaz a csapat fejlesztett ki és felügyel.
  • A fő teljesítménymutatók, például a válaszidők és a hibaarányok központosítása alapértelmezés szerint egy irányítópulton. Szükség esetén a metrikák kezelőjében szerepkör szerinti szegmentálás.
  • Ha nincs szükség különböző Azure-szerepköralapú hozzáférés-vezérlésre az alkalmazásösszetevők között.
  • Ha az azonos metrikák riasztási feltételei, a folyamatos exportálás és a számlázás/kvóták kezelése elegendő az összetevők között.
  • Ha elfogadható, hogy egy API-kulcs egyenlően fér hozzá az összes összetevő adataihoz, és 10 API-kulcs felel meg az összes összetevő igényeinek.
  • Ha minden szerepkörben ugyanazok az intelligens észlelési és munkaelem-integrációs beállítások megfelelőek.

Feljegyzé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.

Egyéb szempontok

A portálélmények aktiválásához adjon hozzá egyéni kódot, hogy értelmes értékeket rendeljen a Cloud_RoleName attribútumhoz. Ezen értékek nélkül a portálfunkciók nem működnek.

Az Azure Service Fabric-alkalmazások és a klasszikus felhőszolgáltatások esetében az SDK automatikusan konfigurálja a szolgáltatásokat az Azure Szerepkör-környezetből való olvasással. Más alkalmazástípusok esetében általában explicit módon kell beállítania.

Az élő metrikák nem oszthatnak fel adatokat szerepkörnév alapján.

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 küld.

Szűrés a buildszámra

Az alkalmazás új verziójának közzétételekor el szeretné 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 Microsoft Build Engine kizárólag a build verziószámát hozza létre, nem pedig a Visual Studióból származó fejlesztői buildet.

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 régiók közötti átvitele nem támogatott, és az előzményadatok nem migrálhatók új régióba. A kerülő megoldás a következőket foglalja magában:

  • Új munkaterület-alapú alkalmazás létrehozása Elemzések erőforrás a kívánt régióban.
  • Hozza létre újra az új erőforrás eredeti erőforrásának egyedi testreszabásait.
  • Az alkalmazás frissítése az új régió erőforrásának kapcsolati sztring.
  • Tesztelés, hogy minden a várt módon működjön az új alkalmazás Elemzések erőforrással.
  • Döntse el, hogy megtartja vagy törli az eredeti alkalmazás Elemzések erőforrást. A klasszikus erőforrás törlése az összes előzményadat elvesztését jelenti. Ha az erőforrás munkaterület-alapú, az adatok a Log Analyticsben maradnak, így az előzményadatokhoz való hozzáférés a megőrzési időszak lejártáig tart.

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.

Feljegyzé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.

Használhatok szolgáltatókat ('Microsoft.Elemzések', 'components').apiVersions[0] az Azure Resource Manager-környezetekben?

Nem javasoljuk, hogy ezt a módszert használja az API-verzió feltöltéséhez. A legújabb verzió az előzetes verziójú kiadásokat jelölheti, amelyek kompatibilitástörő változásokat tartalmazhatnak. Az API-verziók még az újabb nem új verziók esetén sem mindig kompatibilisek a meglévő sablonokkal. Bizonyos esetekben előfordulhat, hogy az API-verzió nem minden előfizetés számára érhető el.

Következő lépések