Példa: OpenTelemetria használata az Azure Monitor és az Application Insights használatával

Számos kereskedelmi alkalmazásteljesítmény-kezelési (APM) rendszer közül választhat. Az Azure-ban az elsődleges alkalmazásfigyelési termék az Application Insights, amely az Azure Monitor része. Az integrált APM-termék egyik előnye, hogy korrelálni tudja a különböző megfigyelhetőségi adatforrásokat. Az Application Insights gazdag nézetekkel és elemzési képességekkel rendelkezik.

1. Az Application Insights-disztribúció hozzáadása

Az Azure Monitor ASP.NET élményének megkönnyítése érdekében rendelkezésre áll egy burkolócsomag (az OTel-parlance disztribúciója), amely az OpenTelemetria konfigurálásának nagy részét elvégzi.

Ez a példa az OTLP-útmutatón alapul. Kövesse az 1–5. lépést az alkalmazáskód OTLP-exportőr használatával történő létrehozásához. Ebben a példában kiterjesztjük a kódot, hogy adatokat küldjünk az Application Insightsnak.

Végezze el ugyanazt a projektet az 5. lépésben, és adja hozzá a következő NuGet-csomagot:

<ItemGroup>
  <PackageReference Include="Azure.Monitor.OpenTelemetry.AspNetCore" Version="1.3.0-beta.1" />
</ItemGroup>

Feljegyzés

Cserélje le a verziót a legújabb elérhetőre

2. Az exportőr beállítása

Adja hozzá a következő OTel-inicializálási kódot:builder.Build();

if (!string.IsNullOrEmpty(builder.Configuration["APPLICATIONINSIGHTS_CONNECTION_STRING"]))
{
    otel.UseAzureMonitor();
}

UseAzureMonitor() az a varázslat, amely hozzáadja az Application Insights közös eszközkódtárait és exportőreit. Csak hozzá kell adnia az egyéni Meter és ActivitySource a neveit a regisztrációhoz.

Ugyanaz az OTel-inicializálás működik az OTLP-ben, mint az Application Insights esetében, a különbség az, hogy mely exportőröket választja ki. Mindkettőt használhatja ugyanabban az alkalmazásban, és a megfelelő környezeti változók megadásával választhat közülük.

3. Adja meg a kapcsolati sztring

Ha még nem Azure-ügyfél, akkor ingyenes fiókot hozhat létre a címen https://azure.microsoft.com/free/. Jelentkezzen be az Azure Portalra, és válasszon ki egy meglévő Application Insights-erőforrást, vagy hozzon létre egy újat a következővel https://ms.portal.azure.com/#create/Microsoft.AppInsights: .

Az Application Insights a portál felhasználói felületének jobb felső sarkában található eszközkulcson és kapcsolati sztring keresztül azonosítja az adatok tárolására és feldolgozására használt példányt.

Ha Azure-alkalmazás szolgáltatást használ, a rendszer ezt a kapcsolati sztring automatikusan környezeti változóként továbbítja az alkalmazásnak. Más szolgáltatások esetében vagy helyi futtatáskor a környezeti változóval vagy a APPLICATIONINSIGHTS_CONNECTION_STRING appsettings.json kell átadnia. Helyi futtatás esetén a legegyszerűbb, ha hozzáadja az értéket a appsettings.development.json:

"AzureMonitor": {
    "ConnectionString": "InstrumentationKey=12345678-abcd-abcd-abcd-12345678..."
}

Feljegyzés

Cserélje le az értéket a példányból származó értékre.

4. Az alkalmazás vizsgálata az Application Insightsban

Az alkalmazás futtatásakor a rendszer telemetriát küld az Application Insightsnak. Most már le kell szereznie az alkalmazás naplóit, metrikáit és elosztott nyomkövetéseit. Nyissa meg az Application Insights-erőforrást az Azure Portalon.

Naplók

Metrikák

Elosztott nyomkövetés