Földrajzi hely és IP-címkezelés

Ez a cikk bemutatja, hogyan működik a földrajzi helykeresés és az IP-címkezelés az Application Insightsban.

Alapértelmezett viselkedés

Alapértelmezés szerint az IP-címeket ideiglenesen gyűjti a rendszer, de nem tárolja őket.

Amikor telemetriát küld az Azure-ba, az IP-címet a rendszer egy földrajzi helykeresésben használja. Az eredmény a mezők és a mezők client_Cityclient_StateOrProvinceclient_CountryOrRegionkitöltésére szolgál. A cím ezután el lesz vetve, és 0.0.0.0 a client_IP mezőbe lesz írva.

A telemetriai típusok a következők:

• Böngészőtelemetria: Az Application Insights összegyűjti a feladó IP-címét. A betöltési végpont kiszámítja az IP-címet.
• Kiszolgálótelemetria: Az Application Insights telemetriai modul ideiglenesen összegyűjti az ügyfél IP-címét, ha a X-Forwarded-For fejléc nincs beállítva. Ha a bejövő IP-címlista több elemet tartalmaz, a rendszer az utolsó IP-címet használja a földrajzi hely mezőinek feltöltéséhez.

Ez a viselkedés a személyes adatok és IP-címek helyadatainak szükségtelen gyűjtésének elkerülésére szolgál.

Ha nem gyűjti össze az IP-címeket, a város és más földrajzi hely attribútumok szintén nem lesznek összegyűjtve.

IP-címadatok tárolása

Az IP-gyűjtés és -tárolás engedélyezéséhez az DisableIpMasking Application Insights összetevő tulajdonságának a következőre kell állítania: true.

A tulajdonság beállításának lehetőségei a következők:

• ARM-sablon
• Portál
• REST API
• PowerShell

ARM-sablon

{
       "id": "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/microsoft.insights/components/<resource-name>",
       "name": "<resource-name>",
       "type": "microsoft.insights/components",
       "location": "westcentralus",
       "tags": {
              
       },
       "kind": "web",
       "properties": {
              "Application_Type": "web",
              "Flow_Type": "Redfield",
              "Request_Source": "IbizaAIExtension",
              // ...
              "DisableIpMasking": true
       }
}

Portál

Ha csak egyetlen Application Insights-erőforrás viselkedését kell módosítania, használja az Azure Portalt.

1. Nyissa meg az Application Insights-erőforrást, majd válassza az Automation>Export sablont.

2. Válassza az Üzembe helyezés lehetőséget.

   

3. Válassza a Sablon szerkesztése lehetőséget.

   

   Feljegyzés

   Ha az előző képernyőképen látható hibát tapasztalja, megoldhatja azt. A következőt írja: "Az erőforráscsoport olyan helyen található, amelyet a sablon egy vagy több erőforrása nem támogat. Válasszon másik erőforráscsoportot." Ideiglenesen válasszon ki egy másik erőforráscsoportot a legördülő listából, majd jelölje ki újra az eredeti erőforráscsoportot.

4. A JSON-sablonban keresse meg properties a fájlt.resources Adjon hozzá egy vesszőt az utolsó JSON-mezőhöz, majd adja hozzá a következő új sort: "DisableIpMasking": true. Ezután válassza a Mentés lehetőséget.

   

5. Válassza a Felülvizsgálat + létrehozás>Létrehozás lehetőséget.

   Feljegyzés

   Ha a "Sikertelen üzembe helyezés" szöveget látja, tekintse át a típussal microsoft.insights/components rendelkező példány üzembehelyezési adatait, és ellenőrizze az állapotot. Ha ez sikerül, a módosítások DisableIpMasking üzembe lettek helyezve.

6. Az üzembe helyezés befejezése után a rendszer új telemetriai adatokat rögzít.

   Ha ismét kijelöli és szerkessze a sablont, csak az újonnan hozzáadott tulajdonság nélküli alapértelmezett sablont. Ha nem látja az IP-címadatokat, és ellenőrizni szeretné, hogy be van-e "DisableIpMasking": true állítva, futtassa a következő PowerShell-parancsokat:

   # Replace `Fabrikam-dev` with the appropriate resource and resource group name.
   # If you aren't using Azure Cloud Shell, you need to connect to your Azure account
   # Connect-AzAccount 
   $AppInsights = Get-AzResource -Name 'Fabrikam-dev' -ResourceType 'microsoft.insights/components' -ResourceGroupName 'Fabrikam-dev'
   $AppInsights.Properties
   

   Ennek eredményeként a függvény visszaadja a tulajdonságok listáját. Az egyik tulajdonságnak olvasnia DisableIpMasking: truekell. Ha az új tulajdonság Azure Resource Managerrel való üzembe helyezése előtt futtatja a PowerShell-parancsokat, a tulajdonság nem létezik.

REST API

A következő REST API hasznos adatai ugyanazokat a módosításokat hajtják végre:

PATCH https://management.azure.com/subscriptions/<sub-id>/resourceGroups/<rg-name>/providers/microsoft.insights/components/<resource-name>?api-version=2018-05-01-preview HTTP/1.1
Host: management.azure.com
Authorization: AUTH_TOKEN
Content-Type: application/json
Content-Length: 54

{
       "location": "<resource location>",
       "kind": "web",
       "properties": {
              "Application_Type": "web",
              "DisableIpMasking": true
       }
}

PowerShell

A PowerShell-parancsmag Update-AzApplicationInsights letilthatja az IP-maszkolást a DisableIPMasking paraméterrel.

Update-AzApplicationInsights -Name "aiName" -ResourceGroupName "rgName" -DisableIPMasking:$true

A parancsmaggal kapcsolatos további információkért lásd: Update-AzApplicationInsights Update-AzApplicationInsights

Következő lépések

• További információ a személyes adatgyűjtésről az Azure Monitorban.
• Megtudhatja, hogyan állíthatja be a felhasználói IP-címet az OpenTelemetry használatával.