Telemetrie exporteren vanuit Application Insights

Wilt u uw telemetrie langer bewaren dan de standaardretentieperiode? Of wilt u het op een gespecialiseerde manier verwerken? Continue export is ideaal voor dit doel. De gebeurtenissen die u in de Application Insights-portal ziet, kunnen worden geëxporteerd naar opslag in Azure in JSON-indeling. Van daaruit kunt u uw gegevens downloaden en elke code schrijven die u nodig hebt om deze te verwerken.

Belangrijk

• Vanaf 29 februari 2024 wordt continue export buiten gebruik gesteld.
• Wanneer u migreert naar een Application Insights-resource op basis van een werkruimte, moet u diagnostische instellingen gebruiken voor het exporteren van telemetrie. Alle Application Insights-resources op basis van een werkruimte moeten diagnostische instellingen gebruiken.
• Het exporteren van diagnostische instellingen kan de kosten verhogen. Zie Export op basis van diagnostische instellingen voor meer informatie.

Voordat u continue export instelt, zijn er enkele alternatieven die u kunt overwegen:

• Met de knop Exporteren boven aan een metrische gegevens- of zoektabblad kunt u tabellen en grafieken overbrengen naar een Excel-spreadsheet.
• Log Analytics biedt een krachtige querytaal voor telemetrie. Het kan ook resultaten exporteren.
• Als u uw gegevens in Power BI wilt verkennen, kunt u dat doen zonder continue export te gebruiken als u bent gemigreerd naar een werkruimteresource.
• Met de DATA Access REST API hebt u programmatisch toegang tot uw telemetrie.
• U hebt ook toegang tot de installatie voor continue export via PowerShell.

Na continue export worden uw gegevens gekopieerd naar de opslag, waar deze zolang u wilt blijven, deze nog steeds beschikbaar zijn in Application Insights voor de gebruikelijke bewaarperiode.

Ondersteunde regio’s

Continue export wordt ondersteund in de volgende regio's:

• Azië - zuidoost
• Canada - midden
• India - centraal
• Europa - noord
• Verenigd Koninkrijk Zuid
• Australië - oost
• Japan - oost
• Korea - centraal
• Frankrijk - centraal
• Azië - oost
• VS - west
• Central US
• VS - oost 2
• VS - zuid-centraal
• VS - west 2
• Zuid-Afrika - noord
• VS - noord-centraal
• Brazilië - zuid
• Zwitserland - noord
• Australië - zuidoost
• Verenigd Koninkrijk West
• Duitsland - west-centraal
• Zwitserland - west
• Australië - centraal 2
• UAE - centraal
• Brazilië - zuidoost
• Australië - centraal
• VAE - noord
• Noorwegen - oost
• Japan - west

Notitie

Continue export blijft werken voor toepassingen in VS - oost en Europa - west als de export vóór 23 februari 2021 is geconfigureerd. Nieuwe regels voor continue export kunnen niet worden geconfigureerd voor toepassingen in VS - oost of Europa - west, ongeacht wanneer de toepassing is gemaakt.

Geavanceerde opslagconfiguratie voor continue export

Continue export biedt geen ondersteuning voor de volgende Functies of configuraties van Azure Storage:

• Gebruik van Azure Virtual Network/Azure Storage-firewalls met Azure Blob Storage.
• Azure Data Lake Storage Gen2.

Een continue export maken

Notitie

Een toepassing kan niet meer dan 3 TB aan gegevens per dag exporteren. Als er meer dan 3 TB per dag wordt geëxporteerd, wordt de export uitgeschakeld. Als u wilt exporteren zonder limiet, gebruikt u op diagnostische instellingen gebaseerde export.

1. Open continue export in de Application Insights-resource voor uw app onder Configureren aan de linkerkant en selecteer Toevoegen.

2. Kies de telemetriegegevenstypen die u wilt exporteren.

3. Maak of selecteer een Azure Storage-account waarin u de gegevens wilt opslaan. Zie de pagina Prijzen voor meer informatie over opslagprijzen.

   Selecteer Opslagaccount voor exportbestemming>toevoegen.> Maak vervolgens een nieuwe winkel of kies een bestaand archief.

   Waarschuwing

   De opslaglocatie wordt standaard ingesteld op dezelfde geografische regio als uw Application Insights-resource. Als u in een andere regio opslaat, worden er mogelijk overdrachtskosten in rekening gebracht.

4. Maak of selecteer een container in de opslag.

Notitie

Nadat u de export hebt gemaakt, worden nieuwe opgenomen gegevens naar Azure Blob Storage verzonden. Continue export verzendt alleen nieuwe telemetrie die wordt gemaakt of opgenomen nadat continue export is ingeschakeld. Gegevens die bestonden voordat continue export werd ingeschakeld, worden niet geëxporteerd. Er is geen ondersteunde manier om eerder gemaakte gegevens met terugwerkende kracht te exporteren met behulp van continue export.

Er kan een vertraging zijn van ongeveer een uur voordat gegevens in de opslag worden weergegeven.

Nadat de eerste export is voltooid, vindt u de volgende structuur in uw Blob Storage-container. (Deze structuur is afhankelijk van de gegevens die u verzamelt.)

Name	Beschrijving
Beschikbaarheid	Rapporteert beschikbaarheidswebtests.
Gebeurtenis	Aangepaste gebeurtenissen die worden gegenereerd door TrackEvent().
Uitzonderingen	Rapporteert uitzonderingen op de server en in de browser.
Berichten	Verzonden door TrackTrace en door de logboekregistratieadapters.
Metrische gegevens	Gegenereerd door api-aanroepen voor metrische gegevens.
PerformanceCounters	Prestatiemeteritems verzameld door Application Insights.
Aanvragen	Verzonden door TrackRequest. De standaardmodules gebruiken aanvragen om reactietijd van de server te rapporteren, gemeten op de server.

Continue export bewerken

Selecteer Continue export en selecteer het opslagaccount dat u wilt bewerken.

Continue export stoppen

Als u de export wilt stoppen, selecteert u Uitschakelen. Wanneer u Opnieuw inschakelen selecteert, wordt de export opnieuw gestart met nieuwe gegevens. U krijgt niet de gegevens die in de portal zijn aangekomen terwijl de export is uitgeschakeld.

Als u de export permanent wilt stoppen, verwijdert u deze. Als u dit doet, worden uw gegevens niet uit de opslag verwijderd.

Kunt u geen export toevoegen of wijzigen?

Als u exports wilt toevoegen of wijzigen, hebt u de machtiging voor Eigenaar, Inzender of Application Insights-Inzender nodig. Meer informatie over rollen.

Welke gebeurtenissen krijgt u?

De geëxporteerde gegevens zijn de onbewerkte telemetrie die we van uw toepassing ontvangen met toegevoegde locatiegegevens van het IP-adres van de client.

Gegevens die zijn verwijderd door steekproeven , worden niet opgenomen in de geëxporteerde gegevens.

Andere berekende metrische gegevens worden niet opgenomen. We exporteren bijvoorbeeld niet het gemiddelde CPU-gebruik, maar we exporteren wel de onbewerkte telemetrie van waaruit het gemiddelde wordt berekend.

De gegevens bevatten ook de resultaten van eventuele beschikbaarheidswebtests die u hebt ingesteld.

Notitie

Als uw toepassing veel gegevens verzendt, kan de steekproeffunctie werken en slechts een fractie van de gegenereerde telemetrie verzenden. Meer informatie over steekproeven.

De gegevens controleren

U kunt de opslag rechtstreeks in de portal inspecteren. Selecteer Start in het meest linkse menu. Selecteer opslagaccounts bovenaan waar Azure-services worden vermeld. Selecteer de naam van het opslagaccount en selecteer op de pagina Overzicht services-blobs>. Selecteer ten slotte de containernaam.

Als u Azure Storage in Visual Studio wilt inspecteren, selecteert u Cloud Explorer weergeven>. Als u deze menuopdracht niet hebt, moet u de Azure SDK installeren. Open het dialoogvenster Nieuw project , vouw Visual C#/Cloud uit en selecteer Microsoft Azure SDK voor .NET ophalen.

Wanneer u uw blobarchief opent, ziet u een container met een set blobbestanden. U ziet de URI van elk bestand dat is afgeleid van de naam van uw Application Insights-resource, de instrumentatiesleutel en het telemetrietype, de datum en tijd. De resourcenaam is allemaal kleine letters en de instrumentatiesleutel laat streepjes weg.

Notitie

Op 31 maart 2025 eindigt de ondersteuning voor opname van instrumentatiesleutels. Opname van instrumentatiesleutels blijft werken, maar we bieden geen updates of ondersteuning meer voor de functie. Overgang naar verbindingsreeks s om te profiteren van nieuwe mogelijkheden.

De datum en tijd zijn UTC en zijn wanneer de telemetrie is opgeslagen in het archief, niet de tijd waarop deze is gegenereerd. Als u daarom code schrijft om de gegevens te downloaden, kan deze lineair door de gegevens worden verplaatst.

Dit is de vorm van het pad:

$"{applicationName}_{instrumentationKey}/{type}/{blobDeliveryTimeUtc:yyyy-MM-dd}/{ blobDeliveryTimeUtc:HH}/{blobId}_{blobCreationTimeUtc:yyyyMMdd_HHmmss}.blob"

Hierin:

• blobCreationTimeUtc is het tijdstip waarop de blob is gemaakt in de interne faseringsopslag.
• blobDeliveryTimeUtc is het tijdstip waarop de blob wordt gekopieerd naar de exportbestemmingsopslag.

Gegevensopmaak

De gegevens worden zo opgemaakt dat:

• Elke blob is een tekstbestand dat meerdere \nrijen bevat. Het bevat de telemetrie die gedurende een periode van ongeveer een halve minuut is verwerkt.

• Elke rij vertegenwoordigt een telemetriegegevenspunt, zoals een aanvraag- of paginaweergave.

• Elke rij is een niet-opgemaakt JSON-document. Als u de rijen wilt weergeven, opent u de blob in Visual Studio en selecteert u Advanced>Format File bewerken.>

  

Tijdsduur bevindt zich in tikken, waarbij 10.000 tikken = 1 ms. Deze waarden geven bijvoorbeeld een tijd van 1 ms weer om een aanvraag vanuit de browser te verzenden, 3 ms om deze te ontvangen en 1.8 s om de pagina in de browser te verwerken:

"sendRequest": {"value": 10000.0},
"receiveRequest": {"value": 30000.0},
"clientProcess": {"value": 17970000.0}

Zie Application Insights-gegevensmodel exporteren voor gedetailleerde gegevensmodelreferenties voor de eigenschapstypen en -waarden.

De gegevens verwerken

Op kleine schaal kunt u code schrijven om uw gegevens uit elkaar te halen en deze in een spreadsheet te lezen. Voorbeeld:

private IEnumerable<T> DeserializeMany<T>(string folderName)
{
   var files = Directory.EnumerateFiles(folderName, "*.blob", SearchOption.AllDirectories);
   foreach (var file in files)
   {
      using (var fileReader = File.OpenText(file))
      {
         string fileContent = fileReader.ReadToEnd();
         IEnumerable<string> entities = fileContent.Split('\n').Where(s => !string.IsNullOrWhiteSpace(s));
         foreach (var entity in entities)
         {
            yield return JsonConvert.DeserializeObject<T>(entity);
         }
      }
   }
}

Zie Een werkrol gebruiken voor een groter codevoorbeeld.

Uw oude gegevens verwijderen

U bent verantwoordelijk voor het beheren van uw opslagcapaciteit en het verwijderen van oude gegevens, indien nodig.

Uw opslagsleutel opnieuw genereren

Als u de sleutel naar uw opslag wijzigt, werkt continue export niet meer. U ziet een melding in uw Azure-account.

Selecteer het tabblad Continue export en bewerk uw export. Bewerk dewaarde Exportbestemming , maar laat dezelfde opslag geselecteerd. Selecteer OK om te bevestigen.

Continue export wordt opnieuw gestart.

Voorbeelden exporteren

Zie voor exportvoorbeelden:

• Exporteren naar SQL met Stream Analytics
• Stream Analytics-voorbeeld 2

Op grotere schaal kunt u HDInsight Hadoop-clusters in de cloud overwegen. HDInsight biedt verschillende technologieën voor het beheren en analyseren van big data. U kunt deze gebruiken om gegevens te verwerken die zijn geëxporteerd uit Application Insights.

Veelgestelde vragen

In deze sectie vindt u antwoorden op veelgestelde vragen.

Kan ik een eenmalige download van een grafiek krijgen?

Je kunt dat doen. Selecteer Gegevens exporteren boven aan het tabblad.

Ik heb een export ingesteld, maar waarom zijn er geen gegevens in mijn winkel?

Heeft Application Insights telemetrie ontvangen van uw app sinds u de export hebt ingesteld? U ontvangt alleen nieuwe gegevens.

Ik heb geprobeerd een export in te stellen, maar waarom heb ik de toegang geweigerd?

Als het account eigendom is van uw organisatie, moet u lid zijn van de groepen Eigenaren of Inzenders.

Kan ik rechtstreeks exporteren naar mijn eigen on-premises winkel?

Nee Onze exportengine werkt momenteel alleen met Azure Storage.

Is er een limiet voor de hoeveelheid gegevens die u in mijn winkel plaatst?

Nee We blijven gegevens pushen totdat u de export verwijdert. We stoppen als we de buitenste limieten voor Blob Storage bereiken, maar die limiet is enorm. Het is aan u om te bepalen hoeveel opslagruimte u gebruikt.

Hoeveel blobs moet ik zien in de opslag?

• Voor elk gegevenstype dat u hebt geselecteerd om te exporteren, wordt elke minuut een nieuwe blob gemaakt, als er gegevens beschikbaar zijn.
• Voor toepassingen met veel verkeer worden extra partitie-eenheden toegewezen. In dit geval maakt elke eenheid elke minuut een blob.

Ik heb de sleutel opnieuw gegenereerd in mijn opslag of de naam van de container gewijzigd, maar waarom werkt de export niet?

Bewerk de export en selecteer het tabblad Doel exporteren. Laat dezelfde opslag geselecteerd als voorheen en selecteer OK om te bevestigen. Exporteren wordt opnieuw gestart. Als de wijziging binnen de afgelopen dagen was, gaan er geen gegevens verloren.

Kan ik de export onderbreken?

Ja. Selecteer Uitschakelen.

Codevoorbeelden

• Stream Analytics-voorbeeld
• Exporteren naar SQL met behulp van Stream Analytics
• Gedetailleerde naslaginformatie over gegevensmodellen voor eigenschapstypen en -waarden

Exporteren op basis van diagnose-instellingen

Exporteren van diagnostische instellingen heeft de voorkeur omdat deze extra functies biedt:

• Azure Storage-accounts met virtuele netwerken, firewalls en privékoppelingen.
• Exporteren naar Azure Event Hubs.

Het exporteren van diagnostische instellingen verschilt verder van continue export op de volgende manieren:

• Schema bijgewerkt.
• Telemetriegegevens worden verzonden wanneer deze binnenkomen in plaats van in batched uploads.

Belangrijk

Er kunnen extra kosten worden gemaakt vanwege een toename van aanroepen naar de bestemming, zoals een opslagaccount.

Exporteren naar diagnostische instellingen:

1. Diagnostische instellingen inschakelen voor klassieke Application Insights.
2. Configureer uw gegevensexport: selecteer Diagnostische instellingen>Diagnostische instelling toevoegen vanuit uw Application Insights-resource.
3. Controleer of uw nieuwe gegevensexport hetzelfde is geconfigureerd als voor continue export

Let op

Als u diagnostische logboeken wilt opslaan in een Log Analytics-werkruimte, zijn er twee punten om te voorkomen dat dubbele gegevens in Application Insights worden weergegeven:

• Het doel mag niet dezelfde Log Analytics-werkruimte zijn waarop uw Application Insights-resource is gebaseerd.
• De gebruiker van Application Insights mag geen toegang tot beide werkruimten hebben. Stel de Log Analytics-toegangsbeheermodus in op Werkruimtemachtigingen vereist. Zorg ervoor dat de gebruiker via op rollen gebaseerd toegangsbeheer van Azure alleen toegang heeft tot de Log Analytics-werkruimte waarop de Application Insights-resource is gebaseerd.

Deze stappen zijn nodig omdat Application Insights toegang heeft tot telemetrie in alle Application Insight-resources, inclusief Log Analytics-werkruimten, om zodoende volledige end-to-end-transactiebewerkingen en nauwkeurige toepassingstoewijzingen te kunnen bieden. Omdat de diagnostische instellingen dezelfde tabelnamen gebruiken, kunnen duplicaat telemetriegegevens worden weergegeven als de gebruiker toegang heeft tot meerdere resources met dezelfde gegevens.

Application Insights-gegevensmodel exporteren

Deze tabel bevat de eigenschappen van telemetrie die vanuit de Application Insights SDK's naar de portal worden verzonden. U ziet deze eigenschappen in de gegevensuitvoer van Continue export. Ze worden ook weergegeven in eigenschapsfilters in Metric Explorer en Diagnostic Search.

Aandachtspunten:

• [0] in deze tabellen wordt een punt in het pad aangegeven waar u een index moet invoegen; maar het is niet altijd 0.
• De tijdsduur is tiende van een microseconde, dus 10000000 == 1 seconde.
• Datums en tijden zijn UTC en worden gegeven in de ISO-indeling yyyy-MM-DDThh:mm:ss.sssZ

Opmerking

// A server report about an HTTP request
{
  "request": [
    {
      "urlData": { // derived from 'url'
        "host": "contoso.org",
        "base": "/",
        "hashTag": ""
      },
      "responseCode": 200, // Sent to client
      "success": true, // Default == responseCode<400
      // Request id becomes the operation id of child events
      "id": "fCOhCdCnZ9I=",  
      "name": "GET Home/Index",
      "count": 1, // 100% / sampling rate
      "durationMetric": {
        "value": 1046804.0, // 10000000 == 1 second
        // Currently the following fields are redundant:
        "count": 1.0,
        "min": 1046804.0,
        "max": 1046804.0,
        "stdDev": 0.0,
        "sampledValue": 1046804.0
      },
      "url": "/"
    }
  ],
  "internal": {
    "data": {
      "id": "7f156650-ef4c-11e5-8453-3f984b167d05",
      "documentVersion": "1.61"
    }
  },
  "context": {
    "device": { // client browser
      "type": "PC",
      "screenResolution": { },
      "roleInstance": "WFWEB14B.fabrikam.net"
    },
    "application": { },
    "location": { // derived from client ip
      "continent": "North America",
      "country": "United States",
      // last octagon is anonymized to 0 at portal:
      "clientip": "168.62.177.0",
      "province": "",
      "city": ""
    },
    "data": {
      "isSynthetic": true, // we identified source as a bot
      // percentage of generated data sent to portal:
      "samplingRate": 100.0,
      "eventTime": "2016-03-21T10:05:45.7334717Z" // UTC
    },
    "user": {
      "isAuthenticated": false,
      "anonId": "us-tx-sn1-azr", // bot agent id
      "anonAcquisitionDate": "0001-01-01T00:00:00Z",
      "authAcquisitionDate": "0001-01-01T00:00:00Z",
      "accountAcquisitionDate": "0001-01-01T00:00:00Z"
    },
    "operation": {
      "id": "fCOhCdCnZ9I=",
      "parentId": "fCOhCdCnZ9I=",
      "name": "GET Home/Index"
    },
    "cloud": { },
    "serverDevice": { },
    "custom": { // set by custom fields of track calls
      "dimensions": [ ],
      "metrics": [ ]
    },
    "session": {
      "id": "65504c10-44a6-489e-b9dc-94184eb00d86",
      "isFirst": true
    }
  }
}

Context

Alle typen telemetrie worden vergezeld van een contextsectie. Niet al deze velden worden verzonden met elk gegevenspunt.

Pad	Type	Opmerkingen
context.custom.dimensions [0]	object [ ]	Sleutel-waarde tekenreeksparen die zijn ingesteld door de parameter aangepaste eigenschappen. Sleutel maximale lengte 100, waarden max lengte 1024. Meer dan 100 unieke waarden, de eigenschap kan worden doorzocht, maar kan niet worden gebruikt voor segmentatie. Max 200 sleutels per ikey.
context.custom.metrics [0]	object [ ]	Sleutel-waardeparen die zijn ingesteld op de parameter aangepaste metingen en door TrackMetrics. Sleutel maximale lengte 100, waarden kunnen numeriek zijn.
context.data.eventTime	tekenreeks	UTC
context.data.isSynthetic	boolean	De aanvraag lijkt afkomstig te zijn van een bot of webtest.
context.data.samplingRate	Nummer	Percentage telemetrie dat wordt gegenereerd door de SDK die naar de portal wordt verzonden. Bereik 0.0-100.0.
context.device	object	Clientapparaat
context.device.browser	tekenreeks	IE, Chrome, ...
context.device.browserVersion	tekenreeks	Chrome 48.0, ...
context.device.deviceModel	tekenreeks
context.device.deviceName	tekenreeks
context.device.id	tekenreeks
context.device.locale	tekenreeks	en-GB, de-DE, ...
context.device.network	tekenreeks
context.device.oemName	tekenreeks
context.device.os	tekenreeks
context.device.osVersion	tekenreeks	Hostbesturingssyteem
context.device.roleInstance	tekenreeks	Id van serverhost
context.device.roleName	tekenreeks
context.device.screenResolution	tekenreeks
context.device.type	tekenreeks	Pc, browser, ...
context.location	object	Afgeleid van clientip.
context.location.city	tekenreeks	Afgeleid van clientip, indien bekend
context.location.clientip	tekenreeks	Laatste octagon wordt geanonimiseerd tot 0.
context.location.continent	tekenreeks
context.location.country	tekenreeks
context.location.province	tekenreeks	Provincie
context.operation.id	tekenreeks	Items die hetzelfde operation id hebben, worden weergegeven als Gerelateerde items in de portal. Meestal de request id.
context.operation.name	tekenreeks	url of aanvraagnaam
context.operation.parentId	tekenreeks	Hiermee staat u geneste gerelateerde items toe.
context.session.id	tekenreeks	Id van een groep bewerkingen uit dezelfde bron. Een periode van 30 minuten zonder een bewerking geeft het einde van een sessie aan.
context.session.isFirst	boolean
context.user.accountAcquisitionDate	tekenreeks
context.user.accountId	tekenreeks
context.user.anonAcquisitionDate	tekenreeks
context.user.anonId	tekenreeks
context.user.authAcquisitionDate	tekenreeks	Geverifieerde gebruiker
context.user.authId	tekenreeks
context.user.isAuthenticated	boolean
context.user.storeRegion	tekenreeks
internal.data.documentVersion	tekenreeks
internal.data.id	tekenreeks	Unique id dat wordt toegewezen wanneer een item wordt opgenomen in Application Insights

gebeurtenis

Aangepaste gebeurtenissen die worden gegenereerd door TrackEvent().

Pad	Type	Opmerkingen
gebeurtenis [0] aantal	geheel getal	100/(steekproeffrequentie ). Bijvoorbeeld 4 => 25%.
gebeurtenis [0] naam	tekenreeks	Gebeurtenisnaam. Maximale lengte 250.
gebeurtenis [0] URL	tekenreeks
gebeurtenis [0] urlData.base	tekenreeks
gebeurtenis [0] urlData.host	tekenreeks

Uitzonderingen

Rapporteert uitzonderingen op de server en in de browser.

Pad	Type	Opmerkingen
basicException [0] assembly	tekenreeks
basicException [0] count	geheel getal	100/(steekproeffrequentie ). Bijvoorbeeld 4 => 25%.
basicException [0] exceptionGroup	tekenreeks
basicException [0] exceptionType	tekenreeks
basicException [0] failedUserCodeMethod	tekenreeks
basicException [0] failedUserCodeAssembly	tekenreeks
basicException [0] handledAt	tekenreeks
basicException [0] hasFullStack	boolean
basicException [0] id	tekenreeks
methode basicException [0]	tekenreeks
basicException [0] bericht	tekenreeks	Uitzonderingsbericht. Maximale lengte 10.000.
basicException [0] outerExceptionMessage	tekenreeks
basicException [0] outerExceptionThrownAtAssembly	tekenreeks
basicException [0] outerExceptionThrownAtMethod	tekenreeks
basicException [0] outerExceptionType	tekenreeks
basicException [0] outerId	tekenreeks
basicException [0] parsedStack [0] assembly	tekenreeks
basicException [0] parsedStack [0] fileName	tekenreeks
basicException [0] parsedStack [0] niveau	geheel getal
basicException [0] parsedStack [0] regel	geheel getal
methode basicException [0] parsedStack [0]	tekenreeks
basicException [0] stack	tekenreeks	Maximale lengte 10.000
basicException [0] typeName	tekenreeks

Berichten traceren

Verzonden door TrackTrace en door de logboekregistratieadapters.

Pad	Type	Opmerkingen
message [0] loggerName	tekenreeks
bericht [0] parameters	tekenreeks
bericht [0] onbewerkt	tekenreeks	Het logboekbericht, maximale lengte 10.000.
message [0] severityLevel	tekenreeks

Externe afhankelijkheid

Verzonden door TrackDependency. Wordt gebruikt voor het rapporteren van prestaties en het gebruik van aanroepen naar afhankelijkheden op de server en AJAX-aanroepen in de browser.

Pad	Type	Opmerkingen
remoteDependency [0] asynchroon	boolean
remoteDependency [0] baseName	tekenreeks
remoteDependency [0] commandName	tekenreeks	Bijvoorbeeld 'home/index'
remoteDependency [0] count	geheel getal	100/(steekproeffrequentie ). Bijvoorbeeld 4 => 25%.
remoteDependency [0] dependencyTypeName	tekenreeks	HTTP, SQL, ...
remoteDependency [0] durationMetric.value	Nummer	Tijd van aanroep tot voltooiing van antwoord per afhankelijkheid
remoteDependency [0] id	tekenreeks
naam remoteDependency [0]	tekenreeks	URL. Maximale lengte 250.
remoteDependency [0] resultCode	tekenreeks	van HTTP-afhankelijkheid
remoteDependency [0] geslaagd	boolean
remoteDependency [0] type	tekenreeks	Http, Sql,...
remoteDependency [0] URL	tekenreeks	Maximale lengte 2000
remoteDependency [0] urlData.base	tekenreeks	Maximale lengte 2000
remoteDependency [0] urlData.hashTag	tekenreeks
remoteDependency [0] urlData.host	tekenreeks	Maximale lengte 200

Verzoeken

Verzonden door TrackRequest. De standaardmodules gebruiken dit om de reactietijd van de server te melden, gemeten op de server.

Pad	Type	Opmerkingen
aantal aanvragen [0]	geheel getal	100/(steekproeffrequentie ). Bijvoorbeeld: 4 => 25%.
request [0] durationMetric.value	Nummer	Tijd van aanvraag die binnenkomt om te reageren. 1e7 == 1s
aanvraag [0] id	tekenreeks	Operation id
aanvraag [0] naam	tekenreeks	GET/POST + URL-basis. Maximale lengte 250
request [0] responseCode	geheel getal	HTTP-antwoord verzonden naar client
aanvraag [0] geslaagd	boolean	Standaard == (responseCode < 400)
aanvraag [0] URL	tekenreeks	Host niet opnemen
request [0] urlData.base	tekenreeks
aanvraag [0] urlData.hashTag	tekenreeks
aanvraag [0] urlData.host	tekenreeks

Prestaties van paginaweergave

Verzonden door de browser. Meet de tijd die nodig is om een pagina te verwerken, van de gebruiker die de aanvraag initieert om voltooid weer te geven (met uitzondering van asynchrone AJAX-aanroepen).

Contextwaarden geven het client-besturingssysteem en de browserversie weer.

Pad	Type	Opmerkingen
clientPerformance [0] clientProcess.value	geheel getal	Tijd vanaf het einde van het ontvangen van de HTML om de pagina weer te geven.
clientPerformance [0] name	tekenreeks
clientPerformance [0] networkConnection.value	geheel getal	De tijd die nodig is om een netwerkverbinding tot stand te brengen.
clientPerformance [0] receiveRequest.value	geheel getal	Tijd vanaf het einde van het verzenden van de aanvraag naar het ontvangen van de HTML in antwoord.
clientPerformance [0] sendRequest.value	geheel getal	De tijd die nodig is om de HTTP-aanvraag te verzenden.
clientPerformance [0] total.value	geheel getal	Tijd vanaf het begin van het verzenden van de aanvraag naar het weergeven van de pagina.
clientPerformance [0] URL	tekenreeks	URL van deze aanvraag
clientPerformance [0] urlData.base	tekenreeks
clientPerformance [0] urlData.hashTag	tekenreeks
clientPerformance [0] urlData.host	tekenreeks
clientPerformance [0] urlData.protocol	tekenreeks

Paginaweergaven

Verzonden door trackPageView() of stopTrackPage

Pad	Type	Opmerkingen
aantal weergave [0]	geheel getal	100/(steekproeffrequentie ). Bijvoorbeeld 4 => 25%.
view [0] durationMetric.value	geheel getal	De waarde is optioneel ingesteld in trackPageView() of door startTrackPage() - stopTrackPage(). Niet hetzelfde als clientPerformance-waarden.
weergavenaam [0]	tekenreeks	Paginatitel. Maximale lengte 250
url voor weergave [0]	tekenreeks
view [0] urlData.base	tekenreeks
view [0] urlData.hashTag	tekenreeks
view [0] urlData.host	tekenreeks

Beschikbaarheid

Rapporteert beschikbaarheidswebtests.

Pad	Type	Opmerkingen
beschikbaarheid [0] availabilityMetric.name	tekenreeks	availability
beschikbaarheid [0] availabilityMetric.value	Nummer	1.0 of 0.0
beschikbaarheid [0] aantal	geheel getal	100/(steekproeffrequentie ). Bijvoorbeeld 4 => 25%.
beschikbaarheid [0] dataSizeMetric.name	tekenreeks
beschikbaarheid [0] dataSizeMetric.value	geheel getal
beschikbaarheid [0] durationMetric.name	tekenreeks
beschikbaarheid [0] durationMetric.value	Nummer	Duur van de test. 1e7==1s
beschikbaarheid [0] bericht	tekenreeks	Foutdiagnose
beschikbaarheid [0] resultaat	tekenreeks	Doorgeven/mislukken
beschikbaarheid [0] runLocation	tekenreeks	Geo-bron van http-req
beschikbaarheid [0] testName	tekenreeks
beschikbaarheid [0] testRunId	tekenreeks
beschikbaarheid [0] testTimestamp	tekenreeks

Metrische gegevens

Gegenereerd door TrackMetric().

De metrische waarde wordt gevonden in context.custom.metrics[0]

Voorbeeld:

{
  "metric": [ ],
  "context": {
  ...
    "custom": {
      "dimensions": [
        { "ProcessId": "4068" }
      ],
      "metrics": [
        {
          "dispatchRate": {
            "value": 0.001295,
            "count": 1.0,
            "min": 0.001295,
            "max": 0.001295,
            "stdDev": 0.0,
            "sampledValue": 0.001295,
            "sum": 0.001295
          }
        }
      ]  
    }
  }
}

Over metrische waarden

Metrische waarden, zowel in metrische rapporten als elders, worden gerapporteerd met een standaardobjectstructuur. Voorbeeld:

"durationMetric": {
  "name": "contoso.org",
  "type": "Aggregation",
  "value": 468.71603053650279,
  "count": 1.0,
  "min": 468.71603053650279,
  "max": 468.71603053650279,
  "stdDev": 0.0,
  "sampledValue": 468.71603053650279
}

Op dit moment, hoewel dit in de toekomst kan veranderen, zijn alle waarden die zijn gerapporteerd uit de standaard-SDK-modules, count==1 en alleen de name velden value nuttig. Het enige geval waarin ze anders zouden zijn, zou zijn als u uw eigen TrackMetric-aanroepen schrijft waarin u de andere parameters instelt.

Het doel van de andere velden is om toe te staan dat metrische gegevens worden samengevoegd in de SDK om het verkeer naar de portal te verminderen. U kunt bijvoorbeeld het gemiddelde van verschillende opeenvolgende metingen berekenen voordat u elk metrische rapport verzendt. Vervolgens berekent u de minimum-, maximum-, standaarddeviatie- en aggregatieswaarde (som of gemiddelde) en stelt u het aantal in op het aantal metingen dat wordt vertegenwoordigd door het rapport.

In de bovenstaande tabellen hebben we het zelden gebruikte aantal velden weggelaten, min, max, stdDev en sampledValue.

In plaats van metrische gegevens vooraf te aggregeren, kunt u steekproeven gebruiken als u het volume van telemetrie wilt verminderen.

Duur

Tenzij anders vermeld, worden de duur weergegeven in tienden van een microseconde, zodat 10000000,0 1 seconde betekent.

Zie ook

• Application Insights
• Continue export
• Codevoorbeelden