Datainsamling, kvarhållning och lagring i Application Insights

När du installerar Application Insights SDK i din app skickar den telemetri om din app till molnet. Som ansvarig utvecklare vill du veta exakt vilka data som skickas, vad som händer med data och hur du kan behålla kontrollen över dem. I synnerhet kan känsliga data skickas, var lagras de och hur säkert är det?

Först det korta svaret:

• Standardtelemetrimodulerna som körs "out of the box" kommer sannolikt inte att skicka känsliga data till tjänsten. Telemetrin handlar om belastnings-, prestanda- och användningsstatistik, undantagsrapporter och andra diagnostikdata. De viktigaste användardata som visas i diagnostikrapporterna är URL:er. Men din app bör i alla fall inte placera känsliga data i oformaterad text i en URL.
• Du kan skriva kod som skickar mer anpassad telemetri för att hjälpa dig med diagnostik och övervakningsanvändning. (Den här utökningsbarheten är en bra funktion i Application Insights.) Av misstag skulle det vara möjligt att skriva den här koden så att den innehåller personliga och andra känsliga data. Om ditt program fungerar med sådana data bör du tillämpa en grundlig granskningsprocess på all kod du skriver.
• När du utvecklar och testar din app är det enkelt att kontrollera vad som skickas av SDK:et. Data visas i felsökningsutdatafönstren i IDE och webbläsaren.
• Du kan välja plats när du skapar en ny Application Insights-resurs. Mer information om Tillgänglighet för Application Insights per region finns i Produkter som är tillgängliga per region.
• Granska insamlade data eftersom de kan innehålla data som tillåts under vissa omständigheter, men inte andra. Ett bra exempel på den här situationen är enhetsnamn. Enhetsnamnet från en server påverkar inte sekretessen och är användbart. Ett enhetsnamn från en telefon eller bärbar dator kan ha sekretesskonsekvenser och vara mindre användbart. Ett SDK som främst utvecklats för målservrar samlar in enhetsnamn som standard. Den här funktionen kan behöva skrivas över i både normala händelser och undantag.

Resten av den här artikeln beskriver dessa punkter mer fullständigt. Artikeln är fristående, så du kan dela den med kollegor som inte ingår i ditt närmaste team.

Vad är Application Insights?

Application Insights är en tjänst från Microsoft som hjälper dig att förbättra prestanda och användbarhet för ditt liveprogram. Det övervakar ditt program hela tiden det körs, både under testningen och efter att du har publicerat eller distribuerat det. Application Insights skapar diagram och tabeller som visar informativa mått. Du kan till exempel se vilka tider på dagen du får de flesta användare, hur dynamisk appen är och hur väl den hanteras av externa tjänster som den är beroende av. Om det uppstår fel eller prestandaproblem kan du söka igenom telemetridata för att diagnostisera orsaken. Tjänsten skickar e-post till dig om det finns några ändringar i appens tillgänglighet och prestanda.

För att få den här funktionen installerar du en Application Insights SDK i ditt program, som blir en del av dess kod. När appen körs övervakar SDK sin åtgärd och skickar telemetri till en Application Insights Log Analytics-arbetsyta, som är en molntjänst som hanteras av Microsoft Azure. Application Insights fungerar också för alla program, inte bara program som finns i Azure.

Application Insights lagrar och analyserar telemetrin. Om du vill se analysen eller sökningen via den lagrade telemetrin loggar du in på ditt Azure-konto och öppnar Application Insights-resursen för ditt program. Du kan också dela åtkomst till data med andra medlemmar i ditt team eller med angivna Azure-prenumeranter.

Du kan exportera data från Application Insights, till exempel till en databas eller till externa verktyg. Du ger varje verktyg en särskild nyckel som du får från tjänsten. Nyckeln kan återkallas om det behövs.

Application Insights SDK:er är tillgängliga för en rad olika programtyper:

• Webbtjänster som finns på dina egna Java EE- eller ASP.NET-servrar eller i Azure
• Webbklienter, d.s.a. koden som körs på en webbsida
• Skrivbordsappar och -tjänster
• Enhetsappar som Windows Phone, iOS och Android

Alla skickar telemetri till samma tjänst.

Anteckning

Stödet för inmatning av instrumentationsnycklar upphör den 31 mars 2025. Inmatningen av instrumenteringsnyckeln fortsätter att fungera, men vi kommer inte längre att tillhandahålla uppdateringar eller stöd för funktionen. Övergå till anslutningssträngar för att dra nytta av nya funktioner.

Vilka data samlar den in?

Det finns tre datakällor:

• SDK:t som du integrerar med din app antingen under utveckling eller vid körning. Det finns olika SDK:er för olika programtyper. Det finns också en SDK för webbsidor som läses in i användarens webbläsare tillsammans med sidan.

  • Varje SDK har många moduler som använder olika tekniker för att samla in olika typer av telemetri.
  • Om du installerar SDK:n under utveckling kan du använda dess API för att skicka din egen telemetri, utöver standardmodulerna. Den här anpassade telemetrin kan innehålla alla data som du vill skicka.

• På vissa webbservrar finns det även agenter som körs tillsammans med appen och skickar telemetri om cpu, minne och nätverksanvändning. Till exempel kan virtuella Azure-datorer, Docker-värdar och Java-programservrar ha sådana agenter.

• Tillgänglighetsöversikt är processer som körs av Microsoft och som skickar begäranden till din webbapp med jämna mellanrum. Resultaten skickas till Application Insights.

Vilken typ av data samlas in?

Huvudkategorierna är:

• Webbservertelemetri: HTTP-begäranden. URI, tid det tar att bearbeta begäran, svarskoden och klientens IP-adress. Session id.
• Webbsidor: Antal sidor, användare och sessioner. Sidinläsningstider. Undantag. Ajax anropar.
• Prestandaräknare: Minne, CPU, I/O och nätverksanvändning.
• Klient- och serverkontext: OPERATIVSYSTEM, nationella inställningar, enhetstyp, webbläsare och skärmupplösning.
• Undantag och krascher: Stackdumpar, build idoch CPU-typ.
• Beroenden: Anrop till externa tjänster som REST, SQL och AJAX. URI eller anslutningssträng, varaktighet, framgång och kommando.
• Tillgänglighetstester: Varaktighet för test och steg samt svar.
• Spårningsloggar och anpassad telemetri: Allt du kodar i dina loggar eller telemetri.

Mer information finns i avsnittet Data som skickas av Application Insights.

Hur kan jag kontrollera vad som samlas in?

Om du utvecklar en app med Hjälp av Visual Studio kör du appen i felsökningsläge (F5). Telemetrin visas i fönstret Utdata . Därifrån kan du kopiera den och formatera den som JSON för enkel inspektion.

Det finns också en mer läsbar vy i fönstret Diagnostik .

Öppna webbläsarens felsökningsfönster för webbsidor. Välj F12 och öppna fliken Nätverk .

Kan jag skriva kod för att filtrera telemetrin innan den skickas?

Du måste skriva ett plugin-program för telemetriprocessor.

Hur länge sparas data?

Rådatapunkter (d.v.s. objekt som du kan fråga i Analytics och inspektera i Sök) sparas i upp till 730 dagar. Du kan välja en kvarhållningstid på 30, 60, 90, 120, 180, 270, 365, 550 eller 730 dagar. Om du behöver lagra data längre än 730 dagar kan du använda diagnostikinställningar.

Data som sparas längre än 90 dagar medför extra avgifter. Mer information om Priser för Application Insights finns på prissättningssidan för Azure Monitor.

Aggregerade data (d.v.s. antal, medelvärden och andra statistiska data som visas i Metric Explorer) bevaras i ett intervall på 1 minut i 90 dagar.

Ögonblicksbilder av felsökning lagras i 15 dagar. Den här kvarhållningsprincipen anges per program. Om du behöver öka det här värdet kan du begära en ökning genom att öppna ett supportärende i Azure Portal.

Vem som kan komma åt data?

Data är synliga för dig och, om du har ett organisationskonto, dina teammedlemmar.

Det kan exporteras av dig och dina teammedlemmar och kan kopieras till andra platser och skickas vidare till andra personer.

Vad gör Microsoft med den information som min app skickar till Application Insights?

Microsoft använder endast data för att tillhandahålla tjänsten till dig.

Var lagras data?

Du kan välja plats när du skapar en ny Application Insights-resurs. Mer information om Tillgänglighet för Application Insights finns i Tillgängliga produkter per region.

Hur säkra är mina data?

Application Insights är en Azure-tjänst. Säkerhetsprinciper beskrivs i vitboken Säkerhet, sekretess och efterlevnad i Azure.

Data lagras på Microsoft Azure-servrar. För konton i Azure Portal beskrivs kontobegränsningar i dokumentet Säkerhet, Sekretess och Efterlevnad i Azure.

Åtkomst till dina data av Microsofts personal är begränsad. Vi kommer endast åt dina data med din behörighet och om det behövs för att stödja din användning av Application Insights.

Aggregerade data i alla våra kunders program, till exempel datahastigheter och genomsnittlig storlek på spårningar, används för att förbättra Application Insights.

Kan någon annans telemetri störa mina Application Insights-data?

Någon kan skicka mer telemetri till ditt konto med hjälp av instrumentationsnyckeln. Den här nyckeln finns i koden för dina webbsidor. Med tillräckligt med extra data skulle dina mått inte korrekt representera appens prestanda och användning.

Om du delar kod med andra projekt bör du komma ihåg att ta bort instrumentationsnyckeln.

Är data krypterade?

Alla data krypteras i vila och när de flyttas mellan datacenter.

Krypteras data under överföring från mitt program till Application Insights-servrar?

Ja. Vi använder HTTPS för att skicka data till portalen från nästan alla SDK:er, inklusive webbservrar, enheter och HTTPS-webbsidor.

Skapar SDK:en tillfällig lokal lagring?

Ja. Vissa telemetrikanaler bevarar data lokalt om en slutpunkt inte kan nås. Följande stycken beskriver vilka ramverk och telemetrikanaler som påverkas:

• Telemetrikanaler som använder lokal lagring skapar temporära filer i TEMP- eller APPDATA-katalogerna, som är begränsade till det specifika konto som kör ditt program. Den här situationen kan inträffa när en slutpunkt är tillfälligt otillgänglig eller om du når begränsningsgränsen. När det här problemet har lösts fortsätter telemetrikanalen att skicka alla nya och bevarade data.
• Dessa sparade data krypteras inte lokalt. Om det här problemet är ett problem granskar du data och begränsar insamlingen av privata data. Mer information finns i Exportera och ta bort privata data.
• Om en kund behöver konfigurera den här katalogen med specifika säkerhetskrav kan den konfigureras per ramverk. Kontrollera att processen som kör programmet har skrivåtkomst till den här katalogen. Kontrollera också att den här katalogen är skyddad för att undvika att telemetri läse av oavsiktliga användare.

Java

Mappen C:\Users\username\AppData\Local\Temp används för att spara data. Den här platsen kan inte konfigureras från konfigurationskatalogen, och behörigheterna för att komma åt den här mappen är begränsade till den specifika användaren med nödvändiga autentiseringsuppgifter. Mer information finns i implementering.

.NET

Som standard ServerTelemetryChannel använder den aktuella användarens lokala appdatamapp %localAppData%\Microsoft\ApplicationInsights eller temp-mapp %TMP%. Mer information finns i implementering.

Via konfigurationsfil:

<TelemetryChannel Type="Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel.ServerTelemetryChannel,   Microsoft.AI.ServerTelemetryChannel">
    <StorageFolder>D:\NewTestFolder</StorageFolder>
</TelemetryChannel>

Via kod:

• Ta bort ServerTelemetryChannel från konfigurationsfilen.

• Lägg till det här kodfragmentet i konfigurationen:

  ServerTelemetryChannel channel = new ServerTelemetryChannel();
  channel.StorageFolder = @"D:\NewTestFolder";
  channel.Initialize(TelemetryConfiguration.Active);
  TelemetryConfiguration.Active.TelemetryChannel = channel;
  

NetCore

Som standard ServerTelemetryChannel använder den aktuella användarens lokala appdatamapp %localAppData%\Microsoft\ApplicationInsights eller temp-mapp %TMP%. Mer information finns i implementering.

I en Linux-miljö inaktiveras lokal lagring om inte en lagringsmapp har angetts.

Anteckning

Med versionen 2.15.0-beta3 och senare skapas nu lokal lagring automatiskt för Linux, Mac och Windows. För icke-Windows-system skapar SDK automatiskt en lokal lagringsmapp baserat på följande logik:

• ${TMPDIR}: Om ${TMPDIR} miljövariabeln har angetts används den här platsen.
• /var/tmp: Om den tidigare platsen inte finns försöker /var/tmpvi .
• /tmp: Om båda de föregående platserna inte finns försöker tmpvi .
• Om det inte finns någon av dessa platser skapas inte lokal lagring och manuell konfiguration krävs fortfarande.

Fullständig implementeringsinformation finns i ServerTelemetryChannel lagrar telemetridata i standardmappen vid tillfälliga fel i icke-Windows-miljöer.

Följande kodfragment visar hur du anger ServerTelemetryChannel.StorageFolder i -metoden för ConfigureServices() din Startup.cs klass:

services.AddSingleton(typeof(ITelemetryChannel), new ServerTelemetryChannel () {StorageFolder = "/tmp/myfolder"});

Mer information finns i Anpassad AspNetCore-konfiguration.

Node.js

Som standard %TEMP%/appInsights-node{INSTRUMENTATION KEY} används för att bevara data. Behörigheter för att komma åt den här mappen är begränsade till den aktuella användaren och administratörerna. Mer information finns i implementeringen.

Mappprefixet appInsights-node kan åsidosättas genom att ändra körningsvärdet för den statiska variabeln Sender.TEMPDIR_PREFIX som finns i Sender.ts.

JavaScript (webbläsare)

HTML5-sessionslagring används för att spara data. Två separata buffertar används: AI_buffer och AI_sent_buffer. Telemetri som batchas och väntar på att skickas lagras i AI_buffer. Telemetri som just skickades placeras i AI_sent_buffer tills inmatningsservern svarar att den har tagits emot.

När telemetri tas emot tas den bort från alla buffertar. Vid tillfälliga fel (till exempel om en användare förlorar nätverksanslutningen) finns telemetri kvar AI_buffer tills den har tagits emot eller inmatningsservern svarar att telemetrin är ogiltig (dåligt schema eller för gammalt, till exempel).

Telemetribuffertar kan inaktiveras genom att ange enableSessionStorageBuffer till false. När sessionslagring är inaktiverat används i stället en lokal matris som beständig lagring. Eftersom JavaScript SDK körs på en klientenhet har användaren åtkomst till den här lagringsplatsen via webbläsarens utvecklarverktyg.

OpenCensus Python

Som standard använder OpenCensus Python SDK den aktuella användarmappen %username%/.opencensus/.azure/. Behörigheter för att komma åt den här mappen är begränsade till den aktuella användaren och administratörerna. Mer information finns i implementeringen. Mappen med dina sparade data namnges efter Python-filen som genererade telemetrin.

Du kan ändra lagringsfilens plats genom att skicka in parametern storage_path i konstruktorn för den exportör som du använder.

AzureLogHandler(
  connection_string='InstrumentationKey=00000000-0000-0000-0000-000000000000',
  storage_path='<your-path-here>',
)

Hur gör jag för att skicka data till Application Insights med TLS 1.2?

För att säkerställa säkerheten för data som överförs till Application Insights-slutpunkterna rekommenderar vi starkt att kunderna konfigurerar sitt program så att det använder minst TLS (Transport Layer Security) 1.2. Äldre versioner av TLS/Secure Sockets Layer (SSL) har visat sig vara sårbara. Även om de fortfarande fungerar för att tillåta bakåtkompatibilitet rekommenderas de inte. Branschen går snabbt över för att överge stödet för dessa äldre protokoll.

PCI Security Standards Council har satt en tidsfrist till den 30 juni 2018 för att inaktivera äldre versioner av TLS/SSL och uppgradera till säkrare protokoll. När Azure har tagit bort äldre stöd kan du inte skicka data till Application Insights om ditt program eller klienter inte kan kommunicera över minst TLS 1.2. Vilken metod du använder för att testa och verifiera programmets TLS-stöd varierar beroende på vilket operativsystem eller plattform och vilket språk eller ramverk programmet använder.

Vi rekommenderar inte att du uttryckligen anger att ditt program endast ska använda TLS 1.2, om det inte behövs. Den här inställningen kan bryta säkerhetsfunktioner på plattformsnivå som gör att du automatiskt kan identifiera och dra nytta av nyare säkrare protokoll när de blir tillgängliga, till exempel TLS 1.3. Vi rekommenderar att du utför en grundlig granskning av programmets kod för att söka efter hårdkodning av specifika TLS/SSL-versioner.

Plattforms-/språkspecifik vägledning

Plattform/språk	Support	Mer information
Azure App Services	Konfiguration kan krävas.	Support tillkännagavs i april 2018. Läs meddelandet för konfigurationsinformation.
Azure-funktionsappar	Konfiguration kan krävas.	Support tillkännagavs i april 2018. Läs meddelandet för konfigurationsinformation.
.NET	Stöd, långsiktigt stöd (LTS).	Detaljerad konfigurationsinformation finns i de här anvisningarna.
Application Insights-agenten	Konfiguration som stöds krävs.	Application Insights-agenten förlitar sig på OSConfiguration.NET + Configuration för att stödja TLS 1.2.
Node.js	I v10.5.0 kan konfiguration krävas.	Använd den officiella Node.js TLS/SSL-dokumentationen för alla programspecifika konfigurationer.
Java	Stöd för JDK-stöd för TLS 1.2 har lagts till i JDK 6 uppdatering 121 och JDK 7.	JDK 8 använder TLS 1.2 som standard.
Linux	Linux-distributioner brukar förlita sig på stöd för OpenSSL för TLS 1.2.	Kontrollera OpenSSL-ändringsloggen för att bekräfta att din version av OpenSSL stöds.
Windows 8.0 – 10	Stöds och aktiveras som standard.	Bekräfta att du fortfarande använder standardinställningarna.
Windows Server 2012 - 2016	Stöds och aktiveras som standard.	Bekräfta att du fortfarande använder standardinställningarna.
Windows 7 SP1 och Windows Server 2008 R2 SP1	Stöds men är inte aktiverat som standard.	Mer information om hur du aktiverar finns på sidan med TLS-registerinställningar (Transport Layer Security ).
Windows Server 2008 SP2	Stöd för TLS 1.2 kräver en uppdatering.	Se Uppdatera för att lägga till stöd för TLS 1.2 i Windows Server 2008 SP2.
Windows Vista	Stöds inte.	Ej tillämpligt

Kontrollera vilken version av OpenSSL din Linux-distribution kör

Om du vill kontrollera vilken version av OpenSSL du har installerat öppnar du terminalen och kör:

openssl version -a

Köra en TLS 1.2-testtransaktion på Linux

Om du vill köra ett preliminärt test för att se om Linux-systemet kan kommunicera via TLS 1.2 öppnar du terminalen och kör:

openssl s_client -connect bing.com:443 -tls1_2

Personliga data som lagras i Application Insights

En detaljerad diskussion om det här problemet finns i Hantera personliga data i Log Analytics och Application Insights.

Kan mina användare stänga av Application Insights?

Inte direkt. Vi tillhandahåller ingen växel som användarna kan använda för att stänga av Application Insights.

Du kan implementera en sådan funktion i ditt program. Alla SDK:er innehåller en API-inställning som inaktiverar telemetrisamling.

Data som skickas av Application Insights

SDK:erna varierar mellan plattformar och det finns flera komponenter som du kan installera. Mer information finns i Översikt över Application Insights. Varje komponent skickar olika data.

Dataklasser som skickas i olika scenarier

Din åtgärd	Dataklasser som samlas in (se nästa tabell)
Lägga till Application Insights SDK i ett .NET-webbprojekt	ServerContext Inneburit Prestandaräknare Begäranden Undantag Session användare
Installera Application Insights-agenten på IIS	Beroenden ServerContext Inneburit Prestandaräknare
Lägga till Application Insights SDK i en Java-webbapp	ServerContext Inneburit Förfrågan Session användare
Lägga till JavaScript SDK på webbsidan	ClientContext Inneburit Sida ClientPerf Ajax
Definiera standardegenskaper	Egenskaper för alla standardhändelser och anpassade händelser
Call TrackMetric	Numeriska värden Egenskaper
Samtalsspår*	Händelsenamn Egenskaper
Anropa TrackException	Undantag Stackdump Egenskaper
SDK kan inte samla in data. Exempel: – Det går inte att komma åt prestandaräknare – Undantag i telemetriinitieraren	SDK-diagnostik

Information om SDK:er för andra plattformar finns i deras dokument.

Klasserna för insamlade data

Insamlad dataklass	Innehåller (inte en fullständig lista)
Egenskaper	Alla data – bestäms av din kod
DeviceContext	Id, IP, nationella inställningar, Enhetsmodell, nätverk, nätverkstyp, OEM-namn, skärmupplösning, Rollinstans, Rollnamn, Enhetstyp
ClientContext	OPERATIVSYSTEM, nationella inställningar, språk, nätverk, fönsterupplösning
Session	session id
ServerContext	Datornamn, nationella inställningar, operativsystem, enhet, användarsession, användarkontext, åtgärd
Inneburit	Geoplats från IP-adress, tidsstämpel, operativsystem, webbläsare
Mått	Måttnamn och -värde
Händelser	Händelsenamn och värde
Sidvisningar	URL och sidnamn eller skärmnamn
Klient-prestanda	URL/sidnamn, webbläsarens inläsningstid
Ajax	HTTP-anrop från webbsida till server
Begäranden	URL, varaktighet, svarskod
Beroenden	Typ (SQL, HTTP, ...), anslutningssträng eller URI, synkronisering/asynkronisering, varaktighet, lyckad, SQL-instruktion (med Application Insights Agent)
Undantag	Typ, meddelande, anropsstackar, källfil, radnummer, thread id
Kraschar	Process id, parent process id, crash thread id; programkorrigering, id, build; undantagstyp, adress, orsak; dolda symboler och register, binära start- och slutadresser, binärt namn och sökväg, cpu-typ
Spårning	Meddelande- och allvarlighetsgrad
Prestandaräknare	Processortid, tillgängligt minne, begärandefrekvens, undantagsfrekvens, bearbeta privata byte, I/O-hastighet, varaktighet för begäran, kölängd för begäran
Tillgänglighet	Svarskod för webbtest, varaktighet för varje teststeg, testnamn, tidsstämpel, framgång, svarstid, testplats
SDK-diagnostik	Spåra meddelande eller undantag

Du kan stänga av vissa data genom att redigera ApplicationInsights.config.

Anteckning

Klient-IP används för att härleda geografisk plats, men ip-data lagras som standard inte längre och alla nolla skrivs till det associerade fältet. Mer information om hantering av personliga data finns i Hantera personliga data i Log Analytics och Application Insights. Om du behöver lagra IP-adressdata vägleder geoplats- och IP-adresshantering dig genom dina alternativ.

Kan jag ändra eller uppdatera data när de har samlats in?

Nej. Data är skrivskyddade och kan bara tas bort via rensningsfunktionen. Mer information finns i Vägledning för personliga data som lagras i Log Analytics och Application Insights.

Vanliga frågor och svar

Det här avsnittet innehåller svar på vanliga frågor.

Vad händer med Application Insight-telemetri när en server eller enhet förlorar anslutningen till Azure?

Alla våra SDK:er, inklusive webb-SDK:t, innehåller tillförlitliga transporter eller robusta transporter. När servern eller enheten förlorar anslutningen till Azure lagras telemetri lokalt i filsystemet (Server-SDK:er) eller i HTML5-sessionslagring (Webb-SDK). SDK:t försöker regelbundet skicka den här telemetrin tills vår inmatningstjänst anser att den är "inaktuell" (48 timmar för loggar, 30 minuter för mått). Inaktuell telemetri tas bort. I vissa fall, till exempel när den lokala lagringen är full, görs inte ett nytt försök.

Skickas personliga data i telemetrin?

Du kan skicka personliga data om din kod skickar sådana data. Det kan också inträffa om variabler i stackspårningar innehåller personliga data. Utvecklingsteamet bör utföra riskbedömningar för att säkerställa att personuppgifter hanteras korrekt. Läs mer om datakvarhållning och sekretess.

Alla oktetter i klientens webbadress anges alltid till 0 efter att geoplatsattributen har letats upp.

Application Insights JavaScript SDK inkluderar som standard inte några personliga data i sin automatiska komplettering. Vissa personuppgifter som används i ditt program kan dock hämtas av SDK:t (till exempel fullständiga namn i window.title eller konto-ID:t i XHR URL-frågeparametrar). Lägg till en telemetriinitierare för anpassad personlig datamaskering.