Wprowadzenie do usługi Application Insights — wgląd w metryki OpenTelemetry

Usługa Azure Monitor Application Insights to funkcja monitorowania wydajności aplikacji (APM) usługi Azure Monitor. W przypadku obsługiwanych scenariuszy można użyć platformy OpenTelemetry (OTel), neutralnej dla dostawcy, aby instrumentować aplikacje i zbierać dane telemetryczne, a następnie analizować te dane telemetryczne w usłudze Application Insights.

Doświadczenia z Application Insights

Usługa Application Insights obsługuje bibliotekę OpenTelemetry (OTel) w celu zbierania danych telemetrycznych w standardowym formacie na różnych platformach. Integracja z usługami Azure umożliwia efektywne monitorowanie i diagnostykę, poprawę możliwości obserwowania aplikacji i wydajności.

Zbadaj

• Pulpit nawigacyjny aplikacji: błyskawiczna ocena kondycji i wydajności aplikacji.
• Mapa aplikacji: wizualizacja przedstawiająca interakcje architektury aplikacji i składników.
• Metryki w czasie rzeczywistym: pulpit analityczny umożliwiający wgląd w aktywność i wydajność aplikacji.
• Widok wyszukiwania: śledzenie i diagnozowanie transakcji w celu identyfikowania problemów i optymalizowania wydajności.
• Widok dostępności: Proaktywne monitorowanie i testowanie dostępności i czasu odpowiedzi punktów końcowych aplikacji.
• Widok błędów: zidentyfikuj i przeanalizuj błędy w aplikacji, aby zminimalizować przestoje.
• Widok wydajności: Przegląd metryk dotyczących wydajności aplikacji oraz potencjalnych ograniczeń w działaniu.
• Informacje o agentach: ujednolicony widok dla monitorowania agentów sztucznej inteligencji w Microsoft Foundry, Copilot Studio oraz agentów innych firm.

Monitorowanie

• Alerty: monitoruj szeroką gamę aspektów aplikacji i wyzwalaj różne akcje.
• Metryki: szczegółowe informacje na temat danych metryk, aby zrozumieć wzorce użycia i trendy.
• Ustawienia diagnostyczne: Konfiguruj strumieniowy eksport dzienników i metryk platformy do wybranego miejsca docelowego.
• Logs: Pobieranie, konsolidowanie i analizowanie wszystkich danych zebranych w dziennikach monitorowania Azure.
• Workbooks: Twórz interaktywne raporty i pulpity nawigacyjne, które wizualizują dane monitorowania aplikacji.
• Tablice z Grafana: Twórz, dostosowuj i udostępniaj tablice Grafana dla danych z usługi Application Insights bezpośrednio w portalu Azure.
• Statystyki zestawu SDK: wizualizuj powodzenie eksportu, pominięte liczniki, liczbę ponownych prób oraz powody pominięcia z zestawów SDK i agentów usługi Application Insights.

Użycie

• Użytkownicy, sesje i zdarzenia: określ, kiedy, gdzie i jak użytkownicy wchodzą w interakcję z aplikacją internetową.
• Lejki: analizuj współczynniki konwersji, aby ustalić, gdzie użytkownicy postępują lub rezygnują z lejka.
• Przepływy: wizualizowanie ścieżek użytkowników w witrynie w celu identyfikowania obszarów o wysokim zaangażowaniu i punktów wyjścia.
• Kohorty: grupuj użytkowników według wspólnych cech, aby uprościć rozwiązywanie problemów z identyfikacją trendów, segmentacją i wydajnością.

Analiza kodu

• .NET Profiler: Przechwytywanie, identyfikowanie i wyświetlanie śladów wydajności aplikacji.
• Optymalizacje kodu: wykorzystanie sztucznej inteligencji w celu tworzenia lepszych i bardziej wydajnych aplikacji.
• Snapshot debugger: Automatyczne zbieranie migawek podczas debugowania w przypadku wystąpienia wyjątków w aplikacji .NET

Model logiczny

Diagram modelu logiki wizualizuje składniki usługi Application Insights i sposób ich interakcji.

Uwaga

Aby dane mogły dotrzeć do punktów końcowych przesyłu, należy dostosować ustawienia zapory sieciowej. Aby uzyskać więcej informacji, zobacz dostęp do punktu końcowego i konfigurację zapory Azure Monitor.

Rozpoczęcie pracy

W tej sekcji opisano wprowadzenie do zbierania danych opartych na protokole OpenTelemetry.

Punkty wejścia obejmują:

• Aplikacje internetowe po stronie serwera
• Aplikacje internetowe po stronie serwera hostowane na maszynie wirtualnej
• Aplikacje JavaScript po stronie klienta
• Azure Functions
• Agenci sztucznej inteligencji

Wskazówka

• W przypadku większości scenariuszy po stronie serwera opartej na kodzie zalecana konfiguracja korzysta z dystrybucji OpenTelemetry usługi Azure Monitor.
• Scenariusze, w których funkcja OpenTelemetry nie jest dostępna, są wyraźnie identyfikowane.

Wybierz zakładkę, która najbardziej odpowiada twojemu obciążeniu lub modelowi hostingu. Każda karta zawiera zalecaną ścieżkę zbierania danych dla tego scenariusza.

Aplikacje internetowe

Użyj tej ścieżki dla aplikacji internetowych po stronie serwera, które wdrażasz w kodzie.

1. Utwórz zasób usługi Application Insights.
2. Pobierz zasób connection string.
3. Dodaj OpenTelemetry Distro do aplikacji.
4. Skonfiguruj connection string.

Wskazówka

Niektóre platformy umożliwiają automatyczne zbieranie danych za pomocą autoinstrumentacji. Przełącz się do instrumentacji opartej na kodzie za pomocą dystrybucji OpenTelemetry , jeśli chcesz uzyskać więcej opcji konfiguracji i rozszerzalności.

VM

Użyj tej ścieżki, gdy Twoja aplikacja działa na maszynie wirtualnej lub w zestawie skalowania maszyn wirtualnych. Przepływ oparty na kodzie jest taki sam jak w przypadku innych aplikacji po stronie serwera.

1. Utwórz zasób usługi Application Insights.
2. Pobierz zasób connection string.
3. Dodaj OpenTelemetry Distro do aplikacji.
4. Skonfiguruj connection string.

Wskazówka

Niektóre platformy umożliwiają automatyczne zbieranie danych za pomocą autoinstrumentacji. Przełącz się do instrumentacji opartej na kodzie za pomocą dystrybucji OpenTelemetry , jeśli chcesz uzyskać więcej opcji konfiguracji i rozszerzalności.

JavaScript

Ta ścieżka służy do telemetrii przeglądarki, takich jak widoki stron i interakcje użytkowników. Aplikacje przeglądarki używają JavaScript SDK Application Insights, a nie biblioteki OpenTelemetry.

1. Utwórz zasób usługi Application Insights.
2. Pobierz zasób connection string.
3. Dodaj zestaw SDK języka JavaScript do aplikacji.
4. Skonfiguruj connection string.

Uwaga

Zestaw SDK języka JavaScript usługi Application Insights nie używa biblioteki OpenTelemetry. Aby uzyskać więcej informacji, zobacz Czy można używać technologii OpenTelemetry dla przeglądarek internetowych?

Funkcje

Użyj tej ścieżki dla Azure Functions. Zacznij od ustawień aplikacji funkcji, a następnie postępuj zgodnie z artykułem Funkcje, aby uzyskać instrukcje specyficzne dla języka.

1. Włącz OpenTelemetry w pliku aplikacji funkcji host.json, ustawiając "telemetryMode": "OpenTelemetry".
2. Dodaj ustawienie aplikacji APPLICATIONINSIGHTS_CONNECTION_STRINGza pomocąconnection string.
3. Zakończ instrumentację specyficzną dla języka i wszystkie wymagane ustawienia robocze w używanie OpenTelemetry za pomocą Azure Functions.

Uwaga

OpenTelemetry nie jest obecnie obsługiwane dla aplikacji działających w ramach procesu w języku C#.

Użyj tej ścieżki dla aplikacji działających w usłudze Azure Kubernetes Service (AKS). Przepływ oparty na kodzie jest taki sam jak w przypadku innych aplikacji po stronie serwera.

1. Utwórz zasób usługi Application Insights.
2. Pobierz zasób connection string.
3. Dodaj OpenTelemetry Distro do aplikacji.
4. Skonfiguruj connection string.

Uwaga

Automatyczne oprzyrządowanie dla Azure Kubernetes Service (AKS) jest dostępne jako publiczna wersja zapoznawcza.

Agenci

Użyj tej ścieżki dla agentów sztucznej inteligencji. Wybierz konfigurację zgodną z modelem hostingu.

• Hosting zarządzany

  • Azure AI Foundry: W przypadku agentów i przepływów pracy zarządzanych przez usługę Foundry rozpocznij od konfiguracji śledzenia w Foundry. W przypadku instrumentacji po stronie aplikacji można również użyć dystrybucji Azure Monitor OpenTelemetry z zestawem SDK Foundry.
  • Copilot Studio: Użyj wbudowanej konfiguracji, aby emitować dane telemetryczne do Azure Monitor. Aby uzyskać więcej informacji, zobacz Łączenie agenta programu Copilot Studio z usługą Application Insights.

• Samodzielne hostowanie

  • Microsoft Agent Framework: Jeśli tworzysz agenta od podstaw i samodzielnie hostujesz, użyj platformy Microsoft Agent Framework, aby zarządzać agentem, i wysyłać dane telemetryczne do Azure Monitor.
  • Agenci zewnętrzni: Jeśli utworzysz agenta w innym miejscu, użyj narzędzia OpenTelemetry Tracer usługi Azure AI, aby emitować telemetrię do Azure Monitor. Tych agentów można również zarejestrować w narzędziu Azure AI Foundry. Aby uzyskać wskazówki specyficzne dla frameworków, zobacz Włączanie śledzenia agentów zbudowanych na frameworkach LangChain i LangGraph oraz Włączanie śledzenia dla agentów zbudowanych na OpenAI Agents SDK.

Po rozpoczęciu przepływu danych telemetrycznych możesz przeglądać widok szczegółów agenta w Application Insights.

Jeśli zdecydujesz się zbierać pełne informacje o monitach, na przykład za pomocą EnableSensitiveData flagi w programie Agent Framework, możesz wyszukiwać monity w widoku wyszukiwania i przeglądać konwersacje, w tym komunikaty asystenta, monity systemowe i użycie narzędzi, w widoku Szczegóły transakcji .

Nadaj każdemu agentowi unikatową nazwę, aby można było je odróżnić w widoku szczegóły agenta. Jeśli składniki agenta są częścią większej aplikacji, rozważ wysłanie ich do istniejącego zasobu usługi Application Insights.

Jeśli chcesz również zobaczyć agentów w Azure AI Foundry oprócz Azure Monitor, połącz zasób usługi Application Insights z projektem Foundry.

Oceny można również skonfigurować na następujące sposoby:

• Oceny wsadowe
  • Lokalne oceny z użyciem Azure AI Evaluation SDK:Przeprowadzaj oceny na swoim komputerze deweloperskim podczas testów.
  • Oceny chmury za pomocą zestawu SDK usługi Foundry:Wykonuj oceny w Azure dla większych zestawów danych lub współpracy zespołowej.
  • Oceny oparte na portalu programu Foundry:Użyj portalu Foundry dla procesów oceny bez kodu.
• Oceny ciągłe:skonfiguruj zautomatyzowane oceny, które są uruchamiane względem ruchu produkcyjnego w celu wykrywania regresji jakości.

Po zakończeniu konfiguracji scenariusza uruchom aplikację i zaczekaj kilka minut na wyświetlenie telemetrii w usłudze Application Insights. Następnie zapoznaj się z doświadczeniami w usłudze Application Insights.

Ważne

Jeśli nadal używasz klasycznych zestawów SDK interfejsu API usługi Application Insights, zobacz Migrowanie z klasycznych zestawów SDK interfejsu API usługi Application Insights do usługi Azure Monitor OpenTelemetry.

Wskazówka

Aby przejrzeć zarchiwizowane informacje dotyczące klasycznego zestawu SDK dla platform .NET lub Node.js, zobacz API 2.x.

Inne integracje biblioteki OpenTelemetry w Azure

Użyj następujących zasobów dla usług Azure, zestawów SDK i narzędzi korzystających z bibliotek OpenTelemetry:

• Konwencje semantyczne zestawu Azure SDK
• Śledzenie Java w SDK Azure
• Możliwość obserwowania zestawu SDK usługi Azure Cosmos DB
• .NET obserwowanie za pomocą funkcji OpenTelemetry
• Potok danych Azure Monitor na brzegu i w konfiguracji wielochmurowej
• Ingestowanie OpenTelemetry do Azure Data Explorer, Azure Synapse Data Explorer i Inteligencji w Czasie Rzeczywistym
• Azure Container Apps Agent OpenTelemetry
• Omówienie pulpitu nawigacyjnego Aspiruj

Rozwiązywanie problemów

Aby uzyskać pomoc dotyczącą rozwiązywania problemów z usługą Application Insights, zobacz naszą dedykowaną dokumentację rozwiązywania problemów.

Pomoc i obsługa techniczna

pomoc techniczna Azure

W przypadku problemów z obsługą Azure otwórz zgłoszenie do wsparcia Azure.

Pytania ogólne

Opublikuj ogólne pytania na forum Pytań i odpowiedzi firmy Microsoft.

Pytania dotyczące kodowania

Opublikuj pytania dotyczące kodowania w witrynie Stack Overflow przy użyciu tagu azure-application-insights .

Społeczność opinii

Zostaw opinię dotyczącą produktu dla zespołu inżynierów w społeczności opinii.